paws.storage (version 0.1.7)

s3_head_bucket: This operation is useful to determine if a bucket exists and you have permission to access it

Description

This operation is useful to determine if a bucket exists and you have permission to access it. The operation returns a 200 OK if the bucket exists and you have permission to access it. Otherwise, the operation might return responses such as 404 Not Found and 403 Forbidden.

Usage

s3_head_bucket(Bucket)

Arguments

Bucket

[required] The bucket name.

Request syntax

svc$head_bucket(
  Bucket = "string"
)

Details

To use this operation, you must have permissions to perform the s3:ListBucket action. The bucket owner has this permission by default and can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 Resources.

Examples

# NOT RUN {
# This operation checks to see if a bucket exists.
# }
# NOT RUN {
svc$head_bucket(
  Bucket = "acl1"
)
# }
# NOT RUN {
# }