AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

This action creates an Amazon S3 on Outposts bucket. To create an S3 bucket, see Create Bucket in the Amazon S3 API Reference.

Creates a new Outposts bucket. By creating the bucket, you become the bucket owner. To create an Outposts bucket, you must have S3 on Outposts. For more information, see Using Amazon S3 on Outposts in Amazon S3 User Guide.

Not every string is an acceptable bucket name. For information on bucket naming restrictions, see Working with Amazon S3 Buckets.

S3 on Outposts buckets support:

For a complete list of restrictions and Amazon S3 feature limitations on S3 on Outposts, see Amazon S3 on Outposts Restrictions and Limitations.

For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and x-amz-outpost-id in your API request, see the Examples section.

The following actions are related to CreateBucket for Amazon S3 on Outposts:

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateBucketAsync.

Namespace: Amazon.S3Control
Assembly: AWSSDK.S3Control.dll
Version: 3.x.y.z

Syntax

C#
public virtual CreateBucketResponse CreateBucket(
         CreateBucketRequest request
)

Parameters

request
Type: Amazon.S3Control.Model.CreateBucketRequest

Container for the necessary parameters to execute the CreateBucket service method.

Return Value


The response from the CreateBucket service method, as returned by S3Control.

Exceptions

ExceptionCondition
BucketAlreadyExistsException The requested Outposts bucket name is not available. The bucket namespace is shared by all users of the Outposts in this Region. Select a different name and try again.
BucketAlreadyOwnedByYouException The Outposts bucket you tried to create already exists, and you own it.

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

See Also