AWS SDK Version 2 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.

.NET Framework 4.5
 
Creates a new bucket.

Namespace: Amazon.S3
Assembly: AWSSDK.dll
Version: (assembly version)

Syntax

C#
public abstract PutBucketResponse PutBucket(
         PutBucketRequest request
)

Parameters

request
Type: Amazon.S3.Model.PutBucketRequest

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

Return Value
Type: Amazon.S3.Model.PutBucketResponse
The response from the PutBucket service method, as returned by S3.

Examples

This example shows how to create a bucket in a specific region and with a canned ACL configuring the bucket to be public readable.

PutBucket sample


// Create a client
AmazonS3Client client = new AmazonS3Client();

// Construct request
PutBucketRequest request = new PutBucketRequest
{
    BucketName = "SampleBucket",
    BucketRegion = S3Region.EU,         // set region to EU
    CannedACL = S3CannedACL.PublicRead  // make bucket publicly readable
};

// Issue call
PutBucketResponse response = client.PutBucket(request);

                

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5