Class ListPartsRequest
- All Implemented Interfaces:
ReadLimitInfo
,Serializable
,Cloneable
Required Parameters: BucketName, Key, UploadId
- See Also:
-
Field Summary
Fields inherited from class com.amazonaws.AmazonWebServiceRequest
NOOP
-
Constructor Summary
ConstructorsConstructorDescriptionListPartsRequest
(String bucketName, String key, String uploadId) Constructs a new ListPartsRequest from the required parameters bucket name, key and upload ID. -
Method Summary
Modifier and TypeMethodDescriptionReturns the name of the bucket containing the multipart upload whose parts are being listed.Gets the optionalencodingType
parameter indicating the encoding method to be applied on the response.getKey()
Returns the key of the associated multipart upload whose parts are being listed.Returns the optional maximum number of parts to be returned in the part listing.Returns the optional part number marker indicating where in the results to being listing parts.Returns the ID of the multipart upload whose parts are being listed.boolean
Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.void
setBucketName
(String bucketName) Sets the name of the bucket containing the multipart upload whose parts are being listed.void
setEncodingType
(String encodingType) Sets the optionalencodingType
parameter indicating the encoding method to be applied on the response.void
Sets the key of the associated multipart upload whose parts are being listed.void
setMaxParts
(int maxParts) Sets the optional maximum number of parts to be returned in the part listing.void
setPartNumberMarker
(Integer partNumberMarker) Sets the optional part number marker indicating where in the results to being listing parts.void
setRequesterPays
(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.void
setUploadId
(String uploadId) Sets the ID of the multipart upload whose parts are being listed.withBucketName
(String bucketName) Sets the BucketName property for this request.withEncodingType
(String encodingType) Sets the optionalencodingType
parameter indicating the encoding method to be applied on the response.Sets the key of the associated multipart upload whose parts are being listed, and returns this updated ListPartsRequest object so that additional method calls can be chained together.withMaxParts
(int maxParts) Sets the optional maximum number of parts to be returned in the part listing and returns this updated ListPartsRequest objects so that additional method calls can be chained together.withPartNumberMarker
(Integer partNumberMarker) Sets the optional part number marker indicating where in the results to being listing parts, and returns this updated ListPartsRequest object so that additional method calls can be chained together.withRequesterPays
(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket.withUploadId
(String uploadId) Sets the ID of the multipart upload whose parts are being listed, and returns this updated ListPartsRequest object so that additional method calls can be chained together.Methods inherited from class com.amazonaws.AmazonWebServiceRequest
clone, copyBaseTo, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout
-
Constructor Details
-
ListPartsRequest
Constructs a new ListPartsRequest from the required parameters bucket name, key and upload ID.- Parameters:
bucketName
- The name of the bucket containing the parts to list.key
- The key of the associated multipart upload whose parts are being listed.uploadId
- The ID of the multipart upload whose parts are being listed.
-
-
Method Details
-
getBucketName
Returns the name of the bucket containing the multipart upload whose parts are being listed.- Returns:
- The name of the bucket containing the multipart upload whose parts are being listed.
-
setBucketName
Sets the name of the bucket containing the multipart upload whose parts are being listed.- Parameters:
bucketName
- The name of the bucket containing the multipart upload whose parts are being listed.
-
withBucketName
Sets the BucketName property for this request.- Parameters:
bucketName
- The value that BucketName is set to- Returns:
- the request with the BucketName set
-
getKey
Returns the key of the associated multipart upload whose parts are being listed.- Returns:
- The key of the associated multipart upload whose parts are being listed.
-
setKey
Sets the key of the associated multipart upload whose parts are being listed.- Parameters:
key
- The key of the associated multipart upload whose parts are being listed.
-
withKey
Sets the key of the associated multipart upload whose parts are being listed, and returns this updated ListPartsRequest object so that additional method calls can be chained together.- Parameters:
key
- The key of the associated multipart upload whose parts are being listed.- Returns:
- This updated ListPartsRequest object.
-
getUploadId
Returns the ID of the multipart upload whose parts are being listed.- Returns:
- The ID of the multipart upload whose parts are being listed.
-
setUploadId
Sets the ID of the multipart upload whose parts are being listed.- Parameters:
uploadId
- The ID of the multipart upload whose parts are being listed.
-
withUploadId
Sets the ID of the multipart upload whose parts are being listed, and returns this updated ListPartsRequest object so that additional method calls can be chained together.- Parameters:
uploadId
- The ID of the multipart upload whose parts are being listed.- Returns:
- This updated ListPartsRequest object.
-
getMaxParts
Returns the optional maximum number of parts to be returned in the part listing.- Returns:
- The optional maximum number of parts to be returned in the part listing.
-
setMaxParts
public void setMaxParts(int maxParts) Sets the optional maximum number of parts to be returned in the part listing.- Parameters:
maxParts
- The optional maximum number of parts to be returned in the part listing.
-
withMaxParts
Sets the optional maximum number of parts to be returned in the part listing and returns this updated ListPartsRequest objects so that additional method calls can be chained together.- Parameters:
maxParts
- The optional maximum number of parts to be returned in the part listing.- Returns:
- This updated ListPartsRequest object.
-
getPartNumberMarker
Returns the optional part number marker indicating where in the results to being listing parts.- Returns:
- The optional part number marker indicating where in the results to being listing parts.
-
setPartNumberMarker
Sets the optional part number marker indicating where in the results to being listing parts.- Parameters:
partNumberMarker
- The optional part number marker indicating where in the results to being listing parts.
-
withPartNumberMarker
Sets the optional part number marker indicating where in the results to being listing parts, and returns this updated ListPartsRequest object so that additional method calls can be chained together.- Parameters:
partNumberMarker
- The optional part number marker indicating where in the results to being listing parts.- Returns:
- This updated ListPartsRequest object.
-
getEncodingType
Gets the optionalencodingType
parameter indicating the encoding method to be applied on the response.- Returns:
- The encoding method to be applied on the response.
-
setEncodingType
Sets the optionalencodingType
parameter indicating the encoding method to be applied on the response. An object key can contain any Unicode character; however, XML 1.0 parser cannot parse some characters, such as characters with an ASCII value from 0 to 10. For characters that are not supported in XML 1.0, you can add this parameter to request that Amazon S3 encode the keys in the response.- Parameters:
encodingType
- The encoding method to be applied on the response. Valid values: null (not encoded) or "url".
-
withEncodingType
Sets the optionalencodingType
parameter indicating the encoding method to be applied on the response. An object key can contain any Unicode character; however, XML 1.0 parser cannot parse some characters, such as characters with an ASCII value from 0 to 10. For characters that are not supported in XML 1.0, you can add this parameter to request that Amazon S3 encode the keys in the response. Returns thisListPartsRequest
, enabling additional method calls to be chained together.- Parameters:
encodingType
- The encoding method to be applied on the response. Valid values: null (not encoded) or "url".
-
isRequesterPays
public boolean isRequesterPays()Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.If a bucket is enabled for Requester Pays, then any attempt to upload or download an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.
Enabling Requester Pays disables the ability to have anonymous access to this bucket
- Returns:
- true if the user has enabled Requester Pays option for conducting this operation from Requester Pays Bucket.
-
setRequesterPays
public void setRequesterPays(boolean isRequesterPays) Used for conducting this operation from a Requester Pays Bucket. If set the requester is charged for requests from the bucket.If a bucket is enabled for Requester Pays, then any attempt to upload or download an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.
Enabling Requester Pays disables the ability to have anonymous access to this bucket.
- Parameters:
isRequesterPays
- Enable Requester Pays option for the operation.
-
withRequesterPays
Used for conducting this operation from a Requester Pays Bucket. If set the requester is charged for requests from the bucket. It returns this updated ListPartsRequest object so that additional method calls can be chained together.If a bucket is enabled for Requester Pays, then any attempt to upload or download an object from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.
Enabling Requester Pays disables the ability to have anonymous access to this bucket.
- Parameters:
isRequesterPays
- Enable Requester Pays option for the operation.- Returns:
- The updated ListPartsRequest object.
-