AWSS3GetPreSignedURLRequest

Objective-C

@interface AWSS3GetPreSignedURLRequest : NSObject

Swift

class AWSS3GetPreSignedURLRequest

The GetPreSignedURLRequest contains the parameters used to create a pre signed URL.

See

AWSS3PreSignedURLBuilder

  • Returns whether the client has enabled accelerate mode for getting and putting objects. The default is NO.

    Declaration

    Objective-C

    @property (nonatomic, assign, unsafe_unretained, readwrite,
          getter=isAccelerateModeEnabled) BOOL accelerateModeEnabled;

    Swift

    var accelerateModeEnabled: Int32 { get set }

  • The name of the bucket

    Declaration

    Objective-C

    @property (nonatomic, strong) NSString *_Nonnull bucket;
  • key

    The name of the S3 object

    Declaration

    Objective-C

    @property (nonatomic, strong) NSString *_Nonnull key;

  • Specifies the verb used in the pre-signed URL. accepted AWSHTTPMethodGET, AWSHTTPMethodPUT, AWSHTTPMethodHEAD.

    Declaration

    Objective-C

    @property (nonatomic) int HTTPMethod;

    Swift

    var httpMethod: Int32 { get set }

  • The time when the signature expires, specified as an NSDate object.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSDate *_Nonnull expires;

  • AWSS3GetPreSignedURLRequest will automatically refresh temporary credential if expiration duration in less than minimumCredentialsExpirationInterval. Only applied for credential provider using temporary token (e.g. CognitoIdentityProvider). Default value is 3000 seconds.

    Declaration

    Objective-C

    @property (nonatomic) NSTimeInterval minimumCredentialsExpirationInterval;

    Swift

    var minimumCredentialsExpirationInterval: Int32 { get set }

  • Expected content-type of the request. If set, the content-type will be included in the signature and future requests must include the same content-type header value to access the presigned URL. This parameter is ignored unless AWSHTTPMethod is equal to AWSHTTPMethodPUT. Default is nil.

    Declaration

    Objective-C

    @property (nonatomic) NSString *_Nullable contentType;

    Swift

    var contentType: UnsafeMutablePointer<Int32>? { get set }

  • Expected content-md5 header of the request. If set, this header value will be included when calculating the signature and future requests must include the same content-md5 header value to access the presigned URL. This parameter is ignored unless HTTPMethod is equal to AWSHTTPMethodPUT. Default is nil.

    Declaration

    Objective-C

    @property (nonatomic) NSString *_Nullable contentMD5;

    Swift

    var contentMD5: UnsafeMutablePointer<Int32>? { get set }

  • This NSDictionary can contains additional request headers to be included in the pre-signed URL. Default is emtpy.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSDictionary<NSString *, NSString *> *_Nonnull requestHeaders;

  • This NSDictionary can contains additional request parameters to be included in the pre-signed URL. Adding additional request parameters enables more advanced pre-signed URLs, such as accessing Amazon S3’s torrent resource for an object, or for specifying a version ID when accessing an object. Default is emtpy.

    Declaration

    Objective-C

    @property (nonatomic, readonly) NSDictionary<NSString *, NSString *> *_Nonnull requestParameters;

  • Set an additional request header to be included in the pre-signed URL.

    Declaration

    Objective-C

    - (void)setValue:(NSString *_Nullable)value
    forRequestHeader:(nonnull NSString *)requestHeader;

    Swift

    func setValue(_ value: Any!, forRequestHeader requestHeader: Any!)

    Parameters

    value

    The value of the request parameter being added. Set to nil if parameter doesn’t contains value.
    requestHeader

    The name of the request header.

  • Set an additional request parameter to be included in the pre-signed URL. Adding additional request parameters enables more advanced pre-signed URLs, such as accessing Amazon S3’s torrent resource for an object, or for specifying a version ID when accessing an object.

    Declaration

    Objective-C

    - (void)setValue:(NSString *_Nullable)value
    forRequestParameter:(nonnull NSString *)requestParameter;

    Swift

    func setValue(_ value: Any!, forRequestParameter requestParameter: Any!)

    Parameters

    value

    The value of the request parameter being added. Set to nil if parameter doesn’t contains value.
    requestParameter

    The name of the request parameter, as it appears in the URL’s query string (e.g. AWSS3PresignedURLVersionID).