This API operation deletes an Amazon S3 on Outposts bucket. To delete an
S3 bucket, see delete_bucket in the Amazon
Simple Storage Service API.
Deletes the Amazon S3 on Outposts bucket. All objects (including all object versions and delete markers) in the bucket must be deleted before the bucket itself can be deleted. For more information, see Using Amazon S3 on Outposts in Amazon Simple Storage Service Developer Guide.
All Amazon S3 on Outposts REST API requests for this action require an
additional parameter of x-amz-outpost-id to be passed with the request
and an S3 on Outposts endpoint hostname prefix instead of s3-control.
For an example of the request syntax for Amazon S3 on Outposts that uses
the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id
derived using the access point ARN, see the
Examples
section.
Related Resources
create_bucket
get_bucket
s3control_delete_bucket(AccountId, Bucket)An empty list.
[required] The account ID that owns the Outposts bucket.
[required] Specifies the bucket being deleted.
For using this parameter with Amazon S3 on Outposts with the REST API, you must specify the name and the x-amz-outpost-id as well.
For using this parameter with S3 on Outposts with the AWS SDK and CLI,
you must specify the ARN of the bucket accessed in the format
arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/bucket/<my-bucket-name>.
For example, to access the bucket reports through outpost my-outpost
owned by account 123456789012 in Region us-west-2, use the URL
encoding of
arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/bucket/reports.
The value must be URL encoded.
svc$delete_bucket(
AccountId = "string",
Bucket = "string"
)