Class UploadPartRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.s3.model.S3Request
-
- software.amazon.awssdk.services.s3.model.UploadPartRequest
-
- All Implemented Interfaces:
SdkPojo
,ToCopyableBuilder<UploadPartRequest.Builder,UploadPartRequest>
@Generated("software.amazon.awssdk:codegen") public final class UploadPartRequest extends S3Request implements ToCopyableBuilder<UploadPartRequest.Builder,UploadPartRequest>
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
UploadPartRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description String
bucket()
The name of the bucket to which the multipart upload was initiated.static UploadPartRequest.Builder
builder()
ChecksumAlgorithm
checksumAlgorithm()
Indicates the algorithm used to create the checksum for the object when you use the SDK.String
checksumAlgorithmAsString()
Indicates the algorithm used to create the checksum for the object when you use the SDK.String
checksumCRC32()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent.String
checksumCRC32C()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent.String
checksumCRC64NVME()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent.String
checksumSHA1()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent.String
checksumSHA256()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent.Long
contentLength()
Size of the body in bytes.String
contentMD5()
The Base64 encoded 128-bit MD5 digest of the part data.boolean
equals(Object obj)
boolean
equalsBySdkFields(Object obj)
String
expectedBucketOwner()
The account ID of the expected bucket owner.<T> Optional<T>
getValueForField(String fieldName, Class<T> clazz)
int
hashCode()
String
key()
Object key for which the multipart upload was initiated.Integer
partNumber()
Part number of part being uploaded.RequestPayer
requestPayer()
Returns the value of the RequestPayer property for this object.String
requestPayerAsString()
Returns the value of the RequestPayer property for this object.Map<String,SdkField<?>>
sdkFieldNameToField()
List<SdkField<?>>
sdkFields()
SdkPartType
sdkPartType()
Indicates whether the request is a last part or not.String
sdkPartTypeAsString()
Indicates whether the request is a last part or not.static Class<? extends UploadPartRequest.Builder>
serializableBuilderClass()
String
sseCustomerAlgorithm()
Specifies the algorithm to use when encrypting the object (for example, AES256).String
sseCustomerKey()
Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data.String
sseCustomerKeyMD5()
Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.UploadPartRequest.Builder
toBuilder()
String
toString()
Returns a string representation of this object.String
uploadId()
Upload ID identifying the multipart upload whose part is being uploaded.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
bucket
public final String bucket()
The name of the bucket to which the multipart upload was initiated.
Directory buckets - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format
Bucket-name.s3express-zone-id.region-code.amazonaws.com
. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the formatbucket-base-name--zone-id--x-s3
(for example,amzn-s3-demo-bucket--usw2-az1--x-s3
). For information about bucket naming restrictions, see Directory bucket naming rules in the Amazon S3 User Guide.Access points - When you use this action with an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.
Access points and Object Lambda access points are not supported by directory buckets.
S3 on Outposts - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com
. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see What is S3 on Outposts? in the Amazon S3 User Guide.- Returns:
- The name of the bucket to which the multipart upload was initiated.
Directory buckets - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format
Bucket-name.s3express-zone-id.region-code.amazonaws.com
. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the formatbucket-base-name--zone-id--x-s3
(for example,amzn-s3-demo-bucket--usw2-az1--x-s3
). For information about bucket naming restrictions, see Directory bucket naming rules in the Amazon S3 User Guide.Access points - When you use this action with an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.
Access points and Object Lambda access points are not supported by directory buckets.
S3 on Outposts - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com
. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see What is S3 on Outposts? in the Amazon S3 User Guide.
-
contentLength
public final Long contentLength()
Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.
- Returns:
- Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.
-
contentMD5
public final String contentMD5()
The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the command from the CLI. This parameter is required if object lock parameters are specified.
This functionality is not supported for directory buckets.
- Returns:
- The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the
command from the CLI. This parameter is required if object lock parameters are specified.
This functionality is not supported for directory buckets.
-
checksumAlgorithm
public final ChecksumAlgorithm checksumAlgorithm()
Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding
x-amz-checksum
orx-amz-trailer
header sent. Otherwise, Amazon S3 fails the request with the HTTP status code400 Bad Request
. For more information, see Checking object integrity in the Amazon S3 User Guide.If you provide an individual checksum, Amazon S3 ignores any provided
ChecksumAlgorithm
parameter.This checksum algorithm must be the same for all parts and it match the checksum value supplied in the
CreateMultipartUpload
request.If the service returns an enum value that is not available in the current SDK version,
checksumAlgorithm
will returnChecksumAlgorithm.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromchecksumAlgorithmAsString()
.- Returns:
- Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will
not provide any additional functionality if you don't use the SDK. When you send this header, there must
be a corresponding
x-amz-checksum
orx-amz-trailer
header sent. Otherwise, Amazon S3 fails the request with the HTTP status code400 Bad Request
. For more information, see Checking object integrity in the Amazon S3 User Guide.If you provide an individual checksum, Amazon S3 ignores any provided
ChecksumAlgorithm
parameter.This checksum algorithm must be the same for all parts and it match the checksum value supplied in the
CreateMultipartUpload
request. - See Also:
ChecksumAlgorithm
-
checksumAlgorithmAsString
public final String checksumAlgorithmAsString()
Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding
x-amz-checksum
orx-amz-trailer
header sent. Otherwise, Amazon S3 fails the request with the HTTP status code400 Bad Request
. For more information, see Checking object integrity in the Amazon S3 User Guide.If you provide an individual checksum, Amazon S3 ignores any provided
ChecksumAlgorithm
parameter.This checksum algorithm must be the same for all parts and it match the checksum value supplied in the
CreateMultipartUpload
request.If the service returns an enum value that is not available in the current SDK version,
checksumAlgorithm
will returnChecksumAlgorithm.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromchecksumAlgorithmAsString()
.- Returns:
- Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will
not provide any additional functionality if you don't use the SDK. When you send this header, there must
be a corresponding
x-amz-checksum
orx-amz-trailer
header sent. Otherwise, Amazon S3 fails the request with the HTTP status code400 Bad Request
. For more information, see Checking object integrity in the Amazon S3 User Guide.If you provide an individual checksum, Amazon S3 ignores any provided
ChecksumAlgorithm
parameter.This checksum algorithm must be the same for all parts and it match the checksum value supplied in the
CreateMultipartUpload
request. - See Also:
ChecksumAlgorithm
-
checksumCRC32
public final String checksumCRC32()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit
CRC32
checksum of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.- Returns:
- This header can be used as a data integrity check to verify that the data received is the same data that
was originally sent. This header specifies the Base64 encoded, 32-bit
CRC32
checksum of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.
-
checksumCRC32C
public final String checksumCRC32C()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit
CRC32C
checksum of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.- Returns:
- This header can be used as a data integrity check to verify that the data received is the same data that
was originally sent. This header specifies the Base64 encoded, 32-bit
CRC32C
checksum of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.
-
checksumCRC64NVME
public final String checksumCRC64NVME()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit
CRC64NVME
checksum of the part. For more information, see Checking object integrity in the Amazon S3 User Guide.- Returns:
- This header can be used as a data integrity check to verify that the data received is the same data that
was originally sent. This header specifies the Base64 encoded, 64-bit
CRC64NVME
checksum of the part. For more information, see Checking object integrity in the Amazon S3 User Guide.
-
checksumSHA1
public final String checksumSHA1()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 160-bit
SHA1
digest of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.- Returns:
- This header can be used as a data integrity check to verify that the data received is the same data that
was originally sent. This header specifies the Base64 encoded, 160-bit
SHA1
digest of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.
-
checksumSHA256
public final String checksumSHA256()
This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 256-bit
SHA256
digest of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.- Returns:
- This header can be used as a data integrity check to verify that the data received is the same data that
was originally sent. This header specifies the Base64 encoded, 256-bit
SHA256
digest of the object. For more information, see Checking object integrity in the Amazon S3 User Guide.
-
key
public final String key()
Object key for which the multipart upload was initiated.
- Returns:
- Object key for which the multipart upload was initiated.
-
partNumber
public final Integer partNumber()
Part number of part being uploaded. This is a positive integer between 1 and 10,000.
- Returns:
- Part number of part being uploaded. This is a positive integer between 1 and 10,000.
-
uploadId
public final String uploadId()
Upload ID identifying the multipart upload whose part is being uploaded.
- Returns:
- Upload ID identifying the multipart upload whose part is being uploaded.
-
sseCustomerAlgorithm
public final String sseCustomerAlgorithm()
Specifies the algorithm to use when encrypting the object (for example, AES256).
This functionality is not supported for directory buckets.
- Returns:
- Specifies the algorithm to use when encrypting the object (for example, AES256).
This functionality is not supported for directory buckets.
-
sseCustomerKey
public final 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.This functionality is not supported for directory buckets.
- Returns:
- 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.This functionality is not supported for directory buckets.
-
sseCustomerKeyMD5
public final 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.
This functionality is not supported for directory buckets.
- Returns:
- 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.
This functionality is not supported for directory buckets.
-
requestPayer
public final RequestPayer requestPayer()
Returns the value of the RequestPayer property for this object.If the service returns an enum value that is not available in the current SDK version,
requestPayer
will returnRequestPayer.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromrequestPayerAsString()
.- Returns:
- The value of the RequestPayer property for this object.
- See Also:
RequestPayer
-
requestPayerAsString
public final String requestPayerAsString()
Returns the value of the RequestPayer property for this object.If the service returns an enum value that is not available in the current SDK version,
requestPayer
will returnRequestPayer.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromrequestPayerAsString()
.- Returns:
- The value of the RequestPayer property for this object.
- See Also:
RequestPayer
-
expectedBucketOwner
public final String expectedBucketOwner()
The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code
403 Forbidden
(access denied).- Returns:
- The account ID of the expected bucket owner. If the account ID that you provide does not match the actual
owner of the bucket, the request fails with the HTTP status code
403 Forbidden
(access denied).
-
sdkPartType
public final SdkPartType sdkPartType()
Indicates whether the request is a last part or not. This field will not be included in the request payload.If the service returns an enum value that is not available in the current SDK version,
sdkPartType
will returnSdkPartType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromsdkPartTypeAsString()
.- Returns:
- Indicates whether the request is a last part or not. This field will not be included in the request payload.
- See Also:
SdkPartType
-
sdkPartTypeAsString
public final String sdkPartTypeAsString()
Indicates whether the request is a last part or not. This field will not be included in the request payload.If the service returns an enum value that is not available in the current SDK version,
sdkPartType
will returnSdkPartType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromsdkPartTypeAsString()
.- Returns:
- Indicates whether the request is a last part or not. This field will not be included in the request payload.
- See Also:
SdkPartType
-
toBuilder
public UploadPartRequest.Builder toBuilder()
- Specified by:
toBuilder
in interfaceToCopyableBuilder<UploadPartRequest.Builder,UploadPartRequest>
- Specified by:
toBuilder
in classS3Request
-
builder
public static UploadPartRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends UploadPartRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCode
in classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equals
in classAwsRequest
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFields
in interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForField
in classSdkRequest
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToField
in interfaceSdkPojo
-
-