Java

S3 Add Tags to an Object

See more Amazon S3 (new) Examples

Demonstrates how to add one or more tags to an S3 object. Java

import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

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

    CkRest rest = new CkRest();

    // Connect to the Amazon AWS REST server in the desired region.
    // (for us-east-1, we use "s3.amazonaws.com", but for another region, such as us-west-2, we would use "s3-us-west-2.amazonaws.com")
    boolean bTls = true;
    int port = 443;
    boolean bAutoReconnect = true;
    success = rest.Connect("s3.amazonaws.com",port,bTls,bAutoReconnect);

    // Provide AWS credentials.
    CkAuthAws authAws = new CkAuthAws();
    authAws.put_AccessKey("AWS_ACCESS_KEY");
    authAws.put_SecretKey("AWS_SECRET_KEY");
    authAws.put_ServiceName("s3");
    authAws.put_Region("us-east-1");

    rest.SetAuthAws(authAws);

    // Set the bucket name via the HOST header.
    // In this case, the bucket name is "chilkat100".
    // Note that the Host header should use "bucketName.s3.amazonaws.com", not "bucketName.s3-us-east-1.amazonaws.com"
    // The same applies to aother regions.  The Host header should simply be <bucketName>.s3.amazonaws.com regardless of the region.
    rest.put_Host("chilkat100.s3.amazonaws.com");

    CkXml xml = new CkXml();
    xml.put_Tag("Tagging");
    xml.UpdateChildContent("TagSet|Tag|Key","plant");
    xml.UpdateChildContent("TagSet|Tag|Value","chili pepper");

    CkStringBuilder sbRequestBody = new CkStringBuilder();
    xml.GetXmlSb(sbRequestBody);

    // It is important to add the terminating "=" after the "?tagging".
    CkStringBuilder sbResponse = new CkStringBuilder();
    success = rest.FullRequestSb("PUT","/chiliPepper.gif?tagging=",sbRequestBody,sbResponse);
    if (success == false) {
        System.out.println(rest.lastErrorText());
        return;
        }

    System.out.println("Response status code: " + rest.get_ResponseStatusCode());

    // When successful, the S3 Storage service will respond with a 200 response code,
    // with an XML body.  
    if (rest.get_ResponseStatusCode() != 200) {
        // Examine the request/response to see what happened.
        System.out.println("response status code = " + rest.get_ResponseStatusCode());
        System.out.println("response status text = " + rest.responseStatusText());
        System.out.println("response header: " + rest.responseHeader());
        System.out.println("response body: " + sbResponse.getAsString());
        System.out.println("---");
        System.out.println("LastRequestStartLine: " + rest.lastRequestStartLine());
        System.out.println("LastRequestHeader: " + rest.lastRequestHeader());
        }

    System.out.println(sbResponse.getAsString());
    System.out.println("Success.");
  }
}