com.amazonaws.services.s3.model

Class ListMultipartUploadsRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.ListMultipartUploadsRequest

All Implemented Interfaces:

HandlerContextAware, ReadLimitInfo, ExpectedBucketOwnerRequest, Serializable, Cloneable

public class ListMultipartUploadsRequest
extends AmazonWebServiceRequest
implements Serializable, ExpectedBucketOwnerRequest

Container for the parameters of the ListMultipartUploads operation.

Required Parameters: BucketName

See Also:

AmazonS3.listMultipartUploads(ListMultipartUploadsRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
ListMultipartUploadsRequest(String bucketName) Constructs a new ListMultipartUploadsRequest to list the multipart uploads from the specified bucket.

Method Summary

Modifier and Type	Method and Description
String	getBucketName() The name of the bucket to which the multipart upload was initiated.
String	getDelimiter() Returns the optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be combined into a single result element in the MultipartUploadListing.getCommonPrefixes() list.
String	getEncodingType() Gets the optional encodingType parameter indicating the encoding method to be applied on the response.
String	getExpectedBucketOwner() Returns he account id of the expected bucket owner.
String	getKeyMarker() Returns the optional key marker indicating where in the results to begin listing.
Integer	getMaxUploads() Returns the optional maximum number of uploads to return, or null if no maximum number of uploads has been set for this request.
String	getPrefix() Returns the optional prefix parameter that restricts the response to multipart uploads for keys that begin with the specified prefix.
String	getUploadIdMarker() Returns the optional upload ID marker indicating where in the results to begin listing.
boolean	isRequesterPays() Returns whether the requester knows that they will be charged for the request.
void	setBucketName(String bucketName) The name of the bucket to which the multipart upload was initiated.
void	setDelimiter(String delimiter) Sets the optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be combined into a single result element in the MultipartUploadListing.getCommonPrefixes() list.
void	setEncodingType(String encodingType) Sets the optional encodingType parameter indicating the encoding method to be applied on the response.
void	setExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
void	setKeyMarker(String keyMarker) Sets the optional key marker indicating where in the results to begin listing.
void	setMaxUploads(Integer maxUploads) Sets the optional maximum number of uploads to return.
void	setPrefix(String prefix) Sets the optional prefix parameter, restricting the response to multipart uploads for keys that begin with the specified prefix.
void	setRequesterPays(boolean isRequesterPays) Confirms whether the requester knows that they will be charged for the request.
void	setUploadIdMarker(String uploadIdMarker) Sets the optional upload ID marker indicating where in the results to begin listing.
ListMultipartUploadsRequest	withBucketName(String bucketName) The name of the bucket to which the multipart upload was initiated.
ListMultipartUploadsRequest	withDelimiter(String delimiter) Sets the optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the MultipartUploadListing.getCommonPrefixes() list.
ListMultipartUploadsRequest	withEncodingType(String encodingType) Sets the optional encodingType parameter indicating the encoding method to be applied on the response.
ListMultipartUploadsRequest	withExpectedBucketOwner(String expectedBucketOwner) Set the account id of the expected bucket owner.
ListMultipartUploadsRequest	withKeyMarker(String keyMarker) Sets the KeyMarker property for this request.
ListMultipartUploadsRequest	withMaxUploads(int maxUploadsInt) Sets the optional maximum number of uploads to return and returns this updated ListMultipartUploadsRequest object so that additional method calls can be chained together.
ListMultipartUploadsRequest	withPrefix(String prefix) Sets the optional prefix parameter restricting the response to multipart uploads for keys that begin with the specified prefix.
ListMultipartUploadsRequest	withRequesterPays(boolean isRequesterPays) Confirms whether the requester knows that they will be charged for the request.
ListMultipartUploadsRequest	withUploadIdMarker(String uploadIdMarker) Sets the optional upload ID marker indicating where in the results to begin listing and returns this updated ListMultipartUploadsRequest object so that additional methods can be chained together.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

addHandlerContext, clone, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getHandlerContext, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestCredentialsProvider, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ListMultipartUploadsRequest

public ListMultipartUploadsRequest(String bucketName)

Constructs a new ListMultipartUploadsRequest to list the multipart uploads from the specified bucket.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Parameters:

bucketName - The name of the bucket, or access point ARN, containing the uploads to list.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Method Detail

getExpectedBucketOwner

public String getExpectedBucketOwner()

Description copied from interface: ExpectedBucketOwnerRequest

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

Specified by:

getExpectedBucketOwner in interface ExpectedBucketOwnerRequest

withExpectedBucketOwner

public ListMultipartUploadsRequest withExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

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

Specified by:

withExpectedBucketOwner in interface ExpectedBucketOwnerRequest

setExpectedBucketOwner

public void setExpectedBucketOwner(String expectedBucketOwner)

Description copied from interface: ExpectedBucketOwnerRequest

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

Specified by:

setExpectedBucketOwner in interface ExpectedBucketOwnerRequest

getBucketName

public String getBucketName()

The name of the bucket to which the multipart upload was initiated.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, 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.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

setBucketName

public void setBucketName(String bucketName)

The name of the bucket to which the multipart upload was initiated.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Parameters:

bucketName - The name of the bucket to which the multipart upload was initiated.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

withBucketName

public ListMultipartUploadsRequest withBucketName(String bucketName)

The name of the bucket to which the multipart upload was initiated.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Parameters:

bucketName - The name of the bucket to which the multipart upload was initiated.

When using this action with an access point, 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.

When you use this action with Amazon 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 using S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see What is S3 on Outposts in the Amazon S3 User Guide.

Returns:

Returns a reference to this object so that method calls can be chained together.

getMaxUploads

public Integer getMaxUploads()

Returns the optional maximum number of uploads to return, or null if no maximum number of uploads has been set for this request.

Returns:

The optional maximum number of uploads to return.

setMaxUploads

public void setMaxUploads(Integer maxUploads)

Sets the optional maximum number of uploads to return.

Parameters:

maxUploads - The maximum number of uploads to return.

withMaxUploads

public ListMultipartUploadsRequest withMaxUploads(int maxUploadsInt)

Sets the optional maximum number of uploads to return and returns this updated ListMultipartUploadsRequest object so that additional method calls can be chained together.

Parameters:

maxUploadsInt - The optional maximum number of uploads to return.

Returns:

This updated ListMultipartUploadsRequest object.

getKeyMarker

public String getKeyMarker()

Returns the optional key marker indicating where in the results to begin listing.

Together with the upload ID marker, specifies the multipart upload after which listing should begin.

If the upload ID marker is not specified, only the keys lexicographically greater than the specified key-marker will be included in the list.

If the upload ID marker is specified, any multipart uploads for a key equal to the key-marker may also be included, provided those multipart uploads have upload IDs lexicographically greater than the specified marker.

Returns:

The optional key marker indicating where in the results to begin listing.

setKeyMarker

public void setKeyMarker(String keyMarker)

Sets the optional key marker indicating where in the results to begin listing.

Together with the upload ID marker, specifies the multipart upload after which listing should begin.

If the upload ID marker is not specified, only the keys lexicographically greater than the specified key-marker will be included in the list.

If the upload ID marker is specified, any multipart uploads for a key equal to the key-marker may also be included, provided those multipart uploads have upload IDs lexicographically greater than the specified marker.

Parameters:

keyMarker - The optional key marker indicating where in the results to begin listing.

withKeyMarker

public ListMultipartUploadsRequest withKeyMarker(String keyMarker)

Sets the KeyMarker property for this request.

Parameters:

keyMarker - The value that KeyMarker is set to

Returns:

the request with the KeyMarker set

getUploadIdMarker

public String getUploadIdMarker()

Returns the optional upload ID marker indicating where in the results to begin listing.

Together with the key marker, specifies the multipart upload after which listing should begin. If no key marker is specified, the upload ID marker is ignored. Otherwise, any multipart uploads for a key equal to the key marker may be included in the list only if they have an upload ID lexicographically greater than the specified marker.

Returns:

The optional upload ID marker indicating where in the results to begin listing.

setUploadIdMarker

public void setUploadIdMarker(String uploadIdMarker)

Sets the optional upload ID marker indicating where in the results to begin listing.

Together with the key marker, specifies the multipart upload after which listing should begin. If no key marker is specified, the upload ID marker is ignored. Otherwise, any multipart uploads for a key equal to the key marker may be included in the list only if they have an upload ID lexicographically greater than the specified marker.

Parameters:

uploadIdMarker - The optional upload ID marker indicating where in the results to begin listing.

withUploadIdMarker

public ListMultipartUploadsRequest withUploadIdMarker(String uploadIdMarker)

Sets the optional upload ID marker indicating where in the results to begin listing and returns this updated ListMultipartUploadsRequest object so that additional methods can be chained together.

Together with the key marker, specifies the multipart upload after which listing should begin. If no key marker is specified, the upload ID marker is ignored. Otherwise, any multipart uploads for a key equal to the key marker may be included in the list only if they have an upload ID lexicographically greater than the specified marker.

Parameters:

uploadIdMarker - The optional upload ID marker indicating where in the results to begin listing.

Returns:

This updated ListMultipartUploadsRequest object.

getDelimiter

public String getDelimiter()

Returns the optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be combined into a single result element in the MultipartUploadListing.getCommonPrefixes() list. These combined keys are not returned elsewhere in the response. The most commonly used delimiter is "/", which simulates a hierarchical organization similar to a file system directory structure.

Returns:

The optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be combined into a single result element in the MultipartUploadListing.getCommonPrefixes() list.

setDelimiter

public void setDelimiter(String delimiter)

Sets the optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be combined into a single result element in the MultipartUploadListing.getCommonPrefixes() list.

Parameters:

delimiter - The optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be combined into a single result element in the MultipartUploadListing.getCommonPrefixes() list.

withDelimiter

public ListMultipartUploadsRequest withDelimiter(String delimiter)

Sets the optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the MultipartUploadListing.getCommonPrefixes() list. Returns this ListMultipartUploadsRequest, enabling additional method calls to be chained together.

Parameters:

delimiter - The optional delimiter parameter that causes multipart uploads for keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the MultipartUploadListing.getCommonPrefixes() list.

Returns:

This ListMultipartUploadsRequest, enabling additional method calls to be chained together.

getPrefix

public String getPrefix()

Returns the optional prefix parameter that restricts the response to multipart uploads for keys that begin with the specified prefix. Use prefixes to separate a bucket into different sets of keys, similar to how a file system organizes files into directories.

Returns:

The optional prefix parameter restricting the response to multipart uploads for keys that begin with the specified prefix.

setPrefix

public void setPrefix(String prefix)

Sets the optional prefix parameter, restricting the response to multipart uploads for keys that begin with the specified prefix.

Parameters:

prefix - The optional prefix parameter, restricting the response to multipart uploads for keys that begin with the specified prefix.

withPrefix

public ListMultipartUploadsRequest withPrefix(String prefix)

Sets the optional prefix parameter restricting the response to multipart uploads for keys that begin with the specified prefix. Returns this ListMultipartUploadsRequest, enabling additional method calls to be chained together.

Parameters:

prefix - The optional prefix parameter restricting the response to multipart uploads for keys that begin with the specified prefix.

Returns:

This ListMultipartUploadsRequest, enabling additional method calls to be chained together.

getEncodingType

public String getEncodingType()

Gets the optional encodingType parameter indicating the encoding method to be applied on the response.

Returns:

The encoding method to be applied on the response.

setEncodingType

public void setEncodingType(String encodingType)

Sets the optional encodingType 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

public ListMultipartUploadsRequest withEncodingType(String encodingType)

Sets the optional encodingType 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 this ListMultipartUploadsRequest, 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 whether the requester knows that they will be charged for the request.

Returns:

true if the user has enabled Requester Pays option for conducting this operation from Requester Pays Bucket.

setRequesterPays

public void setRequesterPays(boolean isRequesterPays)

Confirms whether the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests.

Parameters:

isRequesterPays - if Requester Pays option is enabled for the operation.

withRequesterPays

public ListMultipartUploadsRequest withRequesterPays(boolean isRequesterPays)

Confirms whether the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests.

Parameters:

isRequesterPays - if Requester Pays option is enabled for the operation.

Returns:

The updated ListMultipartUploadsRequest object.