(Android™) S3 Put Bucket Policy

Demonstrates how to add or replace a policy on a bucket. The following information is quoted from the AWS REST API reference documentation at PUT Bucket Policy

This implementation of the PUT operation uses the policy subresource to add to or replace a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it. To perform this operation, you must be the bucket owner. If you are not the bucket owner but have PutBucketPolicy permissions on the bucket, Amazon S3 returns a 405 Method Not Allowed. In all other cases for a PUT bucket policy request that is not from the bucket owner, Amazon S3 returns 403 Access Denied. There are restrictions about who can create bucket policies and which objects in a bucket they can apply to. For more information, go to Using Bucket Policies.

Important: This example requires Chilkat v9.5.0.66 or greater.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

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

    // Important: This example requires Chilkat v9.5.0.66 or greater.

    CkRest rest = new CkRest();

    // Connect to the Amazon AWS REST server in the desired region.
    boolean bTls = true;
    int port = 443;
    boolean bAutoReconnect = true;
    boolean success = rest.Connect("s3-us-west-2.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");

    // This particular bucket is in the Oregon region, as opposed to the US Standard,
    // therefore the Region must be set appropriately.
    // Also note that we connected to "s3-us-west-2.amazonaws.com".
    authAws.put_Region("us-west-2");

    success = rest.SetAuthAws(authAws);

    // Note: The above REST connection and setup of the AWS credentials
    // can be done once.  After connecting, any number of REST calls can be made.
    // The "auto reconnect" property passed to rest.Connect indicates that if
    // the connection is lost, a REST method call will automatically reconnect
    // if needed.
    // --------------------------------------------------------------------------

    // Set the bucket name via the HOST header.
    // In this case, the bucket name is "chilkat.ocean".
    // Note that the Host header should use "bucketName.s3.amazonaws.com", not "bucketName.s3-us-west-2.amazonaws.com"
    rest.put_Host("chilkat.ocean.s3.amazonaws.com");

    // Build the S3 JSON Policy to be sent in the request:
    CkJsonObject json = new CkJsonObject();
    json.UpdateString("Version","2012-10-17");
    json.UpdateString("Statement[0].Action[0]","s3:GetObject");
    json.UpdateString("Statement[0].Effect","Allow");
    json.UpdateString("Statement[0].Resource","arn:aws:s3:::chilkat.ocean/");
    json.UpdateString("Statement[0].Principal","*");

    // The JSON Policy constructed by the above lines of code is:
    // (The bucket name is "chilkat.ocean")

    // 	{ 
    // 	  "Version": "2012-10-17",
    // 	  "Statement": [
    // 	    { 
    // 	      "Action": [
    // 	        "s3:GetObject"
    // 	      ],
    // 	      "Effect": "Allow",
    // 	      "Resource": "arn:aws:s3:::chilkat.ocean/",
    // 	      "Principal": "*"
    // 	    }
    // 	  ]
    // 	}

    // Add or replace the policy on the bucket.
    String responseJsonStr = rest.fullRequestString("PUT","/?policy",json.emit());
    if (rest.get_LastMethodSuccess() != true) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    // When successful, the S3 Storage service will respond with a 200 or 204 response code,
    // with an XML body.  
    if ((rest.get_ResponseStatusCode() != 200) and (rest.get_ResponseStatusCode() != 204)) {
        // Examine the request/response to see what happened.
        Log.i(TAG, "response status code = " + String.valueOf(rest.get_ResponseStatusCode()));
        Log.i(TAG, "response status text = " + rest.responseStatusText());
        Log.i(TAG, "response header: " + rest.responseHeader());
        Log.i(TAG, "response body: " + responseJsonStr);
        Log.i(TAG, "---");
        Log.i(TAG, "LastRequestStartLine: " + rest.lastRequestStartLine());
        Log.i(TAG, "LastRequestHeader: " + rest.lastRequestHeader());
        }

    Log.i(TAG, "Success.");

    // A successful response has no response body..
    // (The Amazon documentation indicates a 204 response, but in our testing we receive a 200 response..)

    // 	HTTP/1.1 204 No Content  
    // 	x-amz-id-2: Uuag1LuByR5Onimru9SAMPLEAtRPfTaOFg==  
    // 	x-amz-request-id: 656c76696e6727732SAMPLE7374  
    // 	Date: Tue, 04 Apr 2010 20:34:56 GMT  
    // 	Connection: keep-alive  
    // 	Server: AmazonS3  

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}