UploadPartCopyRequest Structure Reference


                    
                    
                    _members

Declaration

Swift

public static var _members: [AWSShapeMember]


                    
                    
                    bucket

The bucket name.

Declaration

Swift

public let bucket: String


                    
                    
                    copySource

Specifies the source object for the copy operation. You specify the value in one of two formats, depending on whether you want to access the source object through an access point: For objects not accessed through an access point, specify the name of the source bucket and key of the source object, separated by a slash (/). For example, to copy the object reports/january.pdf from the bucket awsexamplebucket, use awsexamplebucket/reports/january.pdf. The value must be URL encoded. For objects accessed through access points, specify the Amazon Resource Name (ARN) of the object as accessed through the access point, in the format arn:aws:s3:<Region>:<account-id>:accesspoint/<access-point-name>/object/<key>. For example, to copy the object reports/january.pdf through the access point my-access-point owned by account 123456789012 in Region us-west-2, use the URL encoding of arn:aws:s3:us-west-2:123456789012:accesspoint/my-access-point/object/reports/january.pdf. The value must be URL encoded. Amazon S3 supports copy operations using access points only when the source and destination buckets are in the same AWS Region. To copy a specific version of an object, append ?versionId=<version-id> to the value (for example, awsexamplebucket/reports/january.pdf?versionId=QUpfdndhfd8438MNFDN93jdnJFkdmqnh893). If you don’t specify a version ID, Amazon S3 copies the latest version of the source object.

Declaration

Swift

public let copySource: String


                    
                    
                    copySourceIfMatch

Copies the object if its entity tag (ETag) matches the specified tag.

Declaration

Swift

public let copySourceIfMatch: String?


                    
                    
                    copySourceIfModifiedSince

Copies the object if it has been modified since the specified time.

Declaration

Swift

public let copySourceIfModifiedSince: TimeStamp?


                    
                    
                    copySourceIfNoneMatch

Copies the object if its entity tag (ETag) is different than the specified ETag.

Declaration

Swift

public let copySourceIfNoneMatch: String?


                    
                    
                    copySourceIfUnmodifiedSince

Copies the object if it hasn’t been modified since the specified time.

Declaration

Swift

public let copySourceIfUnmodifiedSince: TimeStamp?


                    
                    
                    copySourceRange

The range of bytes to copy from the source object. The range value must use the form bytes=first-last, where the first and last are the zero-based byte offsets to copy. For example, bytes=0-9 indicates that you want to copy the first 10 bytes of the source. You can copy a range only if the source object is greater than 5 MB.

Declaration

Swift

public let copySourceRange: String?


                    
                    
                    copySourceSSECustomerAlgorithm

Specifies the algorithm to use when decrypting the source object (for example, AES256).

Declaration

Swift

public let copySourceSSECustomerAlgorithm: String?


                    
                    
                    copySourceSSECustomerKey

Specifies the customer-provided encryption key for Amazon S3 to use to decrypt the source object. The encryption key provided in this header must be one that was used when the source object was created.

Declaration

Swift

public let copySourceSSECustomerKey: String?


                    
                    
                    copySourceSSECustomerKeyMD5

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.

Declaration

Swift

public let copySourceSSECustomerKeyMD5: String?


                    
                    
                    expectedBucketOwner

The account id of the expected destination bucket owner. If the destination bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Declaration

Swift

public let expectedBucketOwner: String?


                    
                    
                    expectedSourceBucketOwner

The account id of the expected source bucket owner. If the source bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Declaration

Swift

public let expectedSourceBucketOwner: String?

key

Object key for which the multipart upload was initiated.

Declaration

Swift

public let key: String


                    
                    
                    partNumber

Part number of part being copied. This is a positive integer between 1 and 10,000.

Declaration

Swift

public let partNumber: Int


                    
                    
                    requestPayer

Undocumented

Declaration

Swift

public let requestPayer: RequestPayer?


                    
                    
                    sSECustomerAlgorithm

Specifies the algorithm to use to when encrypting the object (for example, AES256).

Declaration

Swift

public let sSECustomerAlgorithm: String?


                    
                    
                    sSECustomerKey

Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm header. This must be the same encryption key specified in the initiate multipart upload request.

Declaration

Swift

public let sSECustomerKey: String?


                    
                    
                    sSECustomerKeyMD5

Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.

Declaration

Swift

public let sSECustomerKeyMD5: String?


                    
                    
                    uploadId

Upload ID identifying the multipart upload whose part is being copied.

Declaration

Swift

public let uploadId: String


                    
                    
                    init(bucket:copySource:copySourceIfMatch:copySourceIfModifiedSince:copySourceIfNoneMatch:copySourceIfUnmodifiedSince:copySourceRange:copySourceSSECustomerAlgorithm:copySourceSSECustomerKey:copySourceSSECustomerKeyMD5:expectedBucketOwner:expectedSourceBucketOwner:key:partNumber:requestPayer:sSECustomerAlgorithm:sSECustomerKey:sSECustomerKeyMD5:uploadId:)

Undocumented

Declaration

Swift

public init(bucket: String, copySource: String, copySourceIfMatch: String? = nil, copySourceIfModifiedSince: TimeStamp? = nil, copySourceIfNoneMatch: String? = nil, copySourceIfUnmodifiedSince: TimeStamp? = nil, copySourceRange: String? = nil, copySourceSSECustomerAlgorithm: String? = nil, copySourceSSECustomerKey: String? = nil, copySourceSSECustomerKeyMD5: String? = nil, expectedBucketOwner: String? = nil, expectedSourceBucketOwner: String? = nil, key: String, partNumber: Int, requestPayer: RequestPayer? = nil, sSECustomerAlgorithm: String? = nil, sSECustomerKey: String? = nil, sSECustomerKeyMD5: String? = nil, uploadId: String)


                    
                    
                    validate(name:)

Declaration

Swift

public func validate(name: String) throws