class Aws::S3::Types::DeleteObjectRequest
@see docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectRequest AWS API Documentation
@return [Integer]
each-other or individually.
‘x-amz-if-match-size` conditional headers in conjunction with
You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
</note>
<note markdown=“1”> This functionality is only supported for directory buckets.
Success (No Content)` response.
matches or if the object doesn’t exist, the operation returns a `204
operation returns a `412 Precondition Failed` error. If the `Size`
provided size in bytes. If the `Size` value does not match, the
If present, the object is deleted only if its size matches the
@!attribute [rw] if_match_size
@return [Time]
</note>
<note markdown=“1”> This functionality is only supported for directory buckets.
operation returns a `204 Success (No Content)` response.
the `Timestamp` matches or if the object doesn’t exist, the
match, the operation returns a `412 Precondition Failed` error. If
matches the provided `Timestamp`. If the `Timestamp` values do not
If present, the object is deleted only if its modification times
@!attribute [rw] if_match_last_modified_time
@return [String]<br>: tools.ietf.org/html/rfc7232<br><br><br><br></note>
<note markdown=“1”> This functionality is only supported for directory buckets.
For more information about conditional requests, see [RFC 7232].
Content) response`.
object doesn’t exist, the operation will return a ‘204 Success (No
`412 Precondition Failed` error. If the ETag matches or if the
ETags. If the ETag value does not match, the operation returns a
The `If-Match` header field makes the request method conditional on
@!attribute [rw] if_match
@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 [Boolean]
</note>
<note markdown=“1”> This functionality is not supported for directory buckets.
have the `s3:BypassGovernanceRetention` permission.
restrictions to process this operation. To use this header, you must
Indicates whether S3 Object Lock should bypass Governance-mode
@!attribute [rw] bypass_governance_retention
@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]
</note>
of the version ID is supported.
<note markdown=“1”> For directory buckets in this API operation, only the `null` value
Version ID used to reference a specific version of the object.
@!attribute [rw] version_id
@return [String]
</note>
<note markdown=“1”> This functionality is not supported for directory buckets.
versioning is configured with MFA delete enabled.
device. Required to permanently delete a versioned object if
space, and the value that is displayed on your authentication
The concatenation of the authentication device’s serial number, a
@!attribute [rw] mfa
@return [String]
Key name of the object to delete.
@!attribute [rw] key
@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 bucket name of the bucket containing the object.
@!attribute [rw] bucket