class Aws::S3::Types::ListMultipartUploadsRequest


@see docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploadsRequest AWS API Documentation
@return [String]<br>: docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html<br><br><br><br></note>
<note markdown=“1”> This functionality is not supported for directory buckets.
Requester Pays Buckets] in the *Amazon S3 User Guide*.
objects from Requester Pays buckets, see [Downloading Objects in
charges to copy the object. For information about downloading
Requester Pays enabled, the requester will pay for corresponding
requests. If either the source or destination S3 bucket has
request. Bucket owners need not specify this parameter in their
Confirms that the requester knows that they will be charged for the
@!attribute [rw] request_payer
@return [String]
denied).
request fails with the HTTP status code ‘403 Forbidden` (access
you provide does not match the actual owner of the bucket, the
The account ID of the expected bucket owner. If the account ID that
@!attribute [rw] expected_bucket_owner
@return [String]
</note>
<note markdown=“1”> This functionality is not supported for directory buckets.
the specified `upload-id-marker`.
list only if they have an upload ID lexicographically greater than
uploads for a key equal to the key-marker might be included in the
upload-id-marker parameter is ignored. Otherwise, any multipart
listing should begin. If key-marker is not specified, the
Together with key-marker, specifies the multipart upload after which
@!attribute [rw] upload_id_marker
@return [String]
</note>
end in a delimiter (`/`) are supported.
<note markdown=“1”> **Directory buckets** - For directory buckets, only prefixes that
groups in the same way that you’d use a folder in a file system.)
different grouping of keys. (You can think of using ‘prefix` to make
specified prefix. You can use prefixes to separate a bucket into
Lists in-progress uploads only for those keys that begin with the
@!attribute [rw] prefix
@return [Integer]
that can be returned in a response.
return in the response body. 1,000 is the maximum number of uploads
Sets the maximum number of multipart uploads, from 1 to 1,000, to
@!attribute [rw] max_uploads
@return [String]
</note>
aren’t sorted lexicographically based on the object keys.
In the ‘ListMultipartUploads` response, the multipart uploads
response.
`key-marker` to the `NextKeyMarker` value from the previous
additional multipart uploads, you only need to set the value of
parameter isn’t supported by directory buckets. To list the
obfuscated and isn’t a real object key. The ‘upload-id-marker`
* **Directory buckets** - For directory buckets, `key-marker` is
than the specified `upload-id-marker`.
those multipart uploads have upload IDs lexicographically greater
key equal to the `key-marker` might also be included, provided
If `upload-id-marker` is specified, any multipart uploads for a
included in the list.
lexicographically greater than the specified `key-marker` will be
If `upload-id-marker` is not specified, only the keys
should begin.
this parameter specifies the multipart upload after which listing
`key-marker` is an object key. Together with `upload-id-marker`,
<note markdown=“1”> * **General purpose buckets** - For general purpose buckets,
Specifies the multipart upload after which listing should begin.
@!attribute [rw] key_marker
@return [String]<br>: docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines<br>[1]: docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html<br><br><br><br></note>
as `test_file%283%29.png`.
code values. For example, the object `test_file(3).png` will appear
in an object’s key name will be percent-encoded according to UTF-8
<note markdown=“1”> When using the URL encoding type, non-ASCII characters that are used
object key names, see [Object key naming guidelines].
the response. For more information about characters to avoid in
can add this parameter to request that Amazon S3 encode the keys in
from 0 to 10. For characters that aren’t supported in XML 1.0, you
parse certain characters, such as characters with an ASCII value
contain any Unicode character. However, the XML 1.0 parser can’t
the response. Responses are encoded only in UTF-8. An object key can
Encoding type used by Amazon S3 to encode the [object keys] in
@!attribute [rw] encoding_type
@return [String]
</note>
supported delimiter.
<note markdown=“1”> **Directory buckets** - For directory buckets, ‘/` is the only
response.
`CommonPrefixes` result element are not returned elsewhere in the
starts at the beginning of the key. The keys that are grouped under
If you don’t specify the prefix parameter, then the substring
prefix are grouped under a single result element, ‘CommonPrefixes`.
specified, and the first occurrence of the delimiter after the
All keys that contain the same string between the prefix, if
Character you use to group keys.
@!attribute [rw] delimiter
@return [String]<br>: docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html<br>[2]: docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html<br>[1]: docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html<br><br><br><br>Outposts?][3] in the *Amazon S3 User Guide*.
more information about S3 on Outposts, see [What is S3 on
must be the Outposts access point ARN or the access point alias. For
When you use this action with S3 on Outposts, the destination bucket
AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
Outposts hostname takes the form `
you must direct requests to the S3 on Outposts hostname. The S3 on
**S3 on Outposts** - When you use this action with S3 on Outposts,
</note>
directory buckets.
<note markdown=“1”> Access points and Object Lambda access points are not supported by
[Using access points] in the *Amazon S3 User Guide*.
bucket name. For more information about access point ARNs, see
Services SDKs, you provide the access point ARN in place of the
When using this action with an access point through the Amazon Web
AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
The access point hostname takes the form
point ARN, you must direct requests to the access point hostname.
bucket name or specify the access point ARN. When using the access
you must provide the alias of the access point in place of the
**Access points** - When you use this action with an access point,
*Amazon S3 User Guide*.
naming restrictions, see [Directory bucket naming rules] in the
amzn-s3-demo-bucket–usw2-az1–x-s3`). For information about bucket
follow the format ` bucket-base-name–zone-id–x-s3` (for example, `
the chosen Zone (Availability Zone or Local Zone). Bucket names must
requests are not supported. Directory bucket names must be unique in
Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
bucket, you must use virtual-hosted-style requests in the format `
**Directory buckets** - When you use this operation with a directory
The name of the bucket to which the multipart upload was initiated.
@!attribute [rw] bucket