class Aws::S3::Types::RenameObjectRequest
@see docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RenameObjectRequest AWS API Documentation
@return [String]
not need to pass this option.
**A suitable default value is auto-generated.** You should normally
</note>
‘IdempotentParameterMismatch` error is returned.
the parameters are different, the retry fails and an
successful request using the same client token, but one or more of
succeeds without performing any further actions. If you retry a
using the same client token and the same parameters, the retry
API requests. If you retry a request that completed successfully
in the request. You should not reuse the same client token for other
idempotent API request using `RenameObject`, specify a client token
<note markdown=“1”> `RenameObject` supports idempotency using a client token. To make an
of 33 - 126.
A unique string with a max of 64 ASCII characters in the ASCII range
@!attribute [rw] client_token
@return [Time]
since the specified time.
Renames the object if the source exists and hasn’t been modified
@!attribute [rw] source_if_unmodified_since
@return [Time]
since the specified time.
Renames the object if the source exists and if it has been modified
@!attribute [rw] source_if_modified_since
@return [String]
Failed` error.
is provided, the operation will fail and return a ‘412 Precondition
is different than the specified ETag. If an asterisk (`*`) character
Renames the object if the source exists and if its entity tag (ETag)
@!attribute [rw] source_if_none_match
@return [String]
matches the specified ETag.
Renames the object if the source exists and if its entity tag (ETag)
@!attribute [rw] source_if_match
@return [Time]
time.
Renames the object if it hasn’t been modified since the specified
@!attribute [rw] destination_if_unmodified_since
@return [Time]
modified since the specified time.
Renames the object if the destination exists and if it has been
@!attribute [rw] destination_if_modified_since
@return [String]
Expects the ‘*` character (asterisk).
already in your directory bucket.
validating that there’s not an object with the same key name
`If-None-Match` header prevents overwrites of existing data by
Precondition Failed` error, preventing an overwrite. The
send a request with ‘If-None-Match:*`, the S3 API will return a `412
the specified directory bucket. If the object does exist when you
Renames the object only if the destination does not already exist in
@!attribute [rw] destination_if_none_match
@return [String]
Expects the ETag value as a string.
Precondition Failed` error.
ETags. If the ETag values do not match, the operation returns a `412
`If-Match` header field makes the request method conditional on
during the operation matches the ETag of the object in S3. The
Renames the object only if the ETag (entity tag) value provided
@!attribute [rw] destination_if_match
@return [String]
encoded.
Specifies the source for the rename operation. The value must be URL
@!attribute [rw] rename_source
@return [String]
Key name of the object to rename.
@!attribute [rw] key
@return [String]<br>: docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html<br><br><br><br>*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
the format `bucket-base-name–zone-id–x-s3 ` (for example,
be unique in the chosen Availability Zone. Bucket names must follow
Path-style requests are not supported. Directory bucket names must
`Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
You must use virtual-hosted-style requests in the format
The bucket name of the directory bucket containing the object.
@!attribute [rw] bucket