(Go) Create S3 Bucket in a Region

See more Amazon S3 Examples

Demonstrates how to create an S3 bucket in a specified region. This example will create a bucket in the eu-west-2 region.

For more information, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html

Chilkat Go Downloads Go Package for Windows, MacOS, Linux, Alpine Linux, Solaris

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    rest := chilkat.NewRest()

    // Connect to the Amazon AWS REST server.
    bTls := true
    port := 443
    bAutoReconnect := true
    success := rest.Connect("s3.amazonaws.com",port,bTls,bAutoReconnect)

    // Provide AWS credentials for the REST call.
    authAws := chilkat.NewAuthAws()
    authAws.SetAccessKey("AWS_ACCESS_KEY")
    authAws.SetSecretKey("AWS_SECRET_KEY")
    authAws.SetServiceName("s3")
    success = rest.SetAuthAws(authAws)

    // We'll send a PUT request having an XML body such as this:
    // <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
    //   <LocationConstraint>BucketRegion</LocationConstraint> 
    //   </CreateBucketConfiguration>

    // Create the XML body specifying the region as "eu-west-2"
    bucketRegion := "eu-west-2"
    sbBucketRegion := chilkat.NewStringBuilder()
    sbBucketRegion.Append(bucketRegion)

    // We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
    xml := chilkat.NewXml()
    if !sbBucketRegion.ContentsEqual("us-east-1") {
        xml.SetTag("CreateBucketConfiguration")
        xml.AddAttribute("xmlns","http://s3.amazonaws.com/doc/2006-03-01/")
        xml.UpdateChildContent("LocationConstraint","eu-west-2")
    }

    // --------------------------------------------------------------
    // IMPORTANT: To create a bucket in the default us-east-1 region,
    // do not add the LocationConstraint.  Adding a LocationConstraint of "us-east-1"
    // causes an error "The specified location-constraint is not valid."
    // By default, the bucket is created in us-east-1 by sending a PUT with an empty body.
    // --------------------------------------------------------------

    // Set the bucket name via the HOST header.
    // In this case, the bucket name is "chilkateuwest2".
    rest.SetHost("chilkateuwest2.s3.amazonaws.com")

    // Make the call to create the bucket.
    var responseStr *string = new(string)
    if !sbBucketRegion.ContentsEqual("us-east-1") {
        responseStr = rest.FullRequestString("PUT","/",*xml.GetXml())
    } else {
        // If the bucket is to be created in the us-east-1 region (the default region)
        // just send a PUT with no body.
        responseStr = rest.FullRequestNoBody("PUT","/")
    }

    if rest.LastMethodSuccess() != true {
        fmt.Println(rest.LastErrorText())
        rest.DisposeRest()
        authAws.DisposeAuthAws()
        sbBucketRegion.DisposeStringBuilder()
        xml.DisposeXml()
        return
    }

    if rest.ResponseStatusCode() != 200 {
        fmt.Println("status code = ", rest.ResponseStatusCode())
        responseXml := chilkat.NewXml()
        responseXml.LoadXml(*responseStr)
        fmt.Println(*responseXml.GetXml())
        fmt.Println("Failed.")
        rest.DisposeRest()
        authAws.DisposeAuthAws()
        sbBucketRegion.DisposeStringBuilder()
        xml.DisposeXml()
        responseXml.DisposeXml()
        return
    }

    fmt.Println("Bucket in the eu-west-2 region created.")

    rest.DisposeRest()
    authAws.DisposeAuthAws()
    sbBucketRegion.DisposeStringBuilder()
    xml.DisposeXml()
    responseXml.DisposeXml()