AWS Code Sample
Catalog

GetAcl.java

GetAcl.java demonstrates how to the access control list (ACL) for an S3 bucket.

/* Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. This file is licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with the License. A copy of the License is located at http://aws.amazon.com/apache2.0/ This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package com.example.s3; import software.amazon.awssdk.services.s3.model.S3Exception; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3.S3Client; import software.amazon.awssdk.services.s3.model.GetBucketAclRequest; import software.amazon.awssdk.services.s3.model.GetBucketAclResponse; import software.amazon.awssdk.services.s3.model.GetObjectAclRequest; import software.amazon.awssdk.services.s3.model.GetObjectAclResponse; import software.amazon.awssdk.services.s3.model.Grant; import java.util.List; /** * Get the ACL for an existing S3 bucket. * * This code expects that you have AWS credentials set up per: * http://docs.aws.amazon.com/java-sdk/latest/developer-guide/setup-credentials.html */ public class GetAcl { public static void getBucketAcl(String bucket_name) { System.out.println("Retrieving ACL for bucket: " + bucket_name); Region region = Region.US_WEST_2; S3Client s3 = S3Client.builder().region(region).build(); GetBucketAclRequest aclReq = GetBucketAclRequest.builder() .bucket(bucket_name).build(); try { GetBucketAclResponse aclRes = s3.getBucketAcl(aclReq); List<Grant> grants = aclRes.grants(); for (Grant grant : grants) { System.out.format(" %s: %s\n", grant.grantee().id(), grant.permission()); } } catch (S3Exception e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } public static void getObjectAcl(String bucket_name, String object_key) { System.out.println("Retrieving ACL for object: " + object_key); System.out.println(" in bucket: " + bucket_name); Region region = Region.US_WEST_2; S3Client s3 = S3Client.builder().region(region).build(); GetObjectAclRequest aclReq = GetObjectAclRequest.builder() .bucket(bucket_name) .key(object_key) .build(); try { GetObjectAclResponse aclRes = s3.getObjectAcl(aclReq); List<Grant> grants = aclRes.grants(); for (Grant grant : grants) { System.out.format(" %s: %s\n", grant.grantee().id(), grant.permission()); } } catch (S3Exception e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } public static void main(String[] args) { final String USAGE = "\n" + "Usage:\n" + " GetAcl <bucket> [object]\n\n" + "Where:\n" + " bucket - the bucket to get the access control list (ACL) for\n" + " object - (optional) the object to get the ACL for.\n" + " If object is specified, the retrieved ACL will be\n" + " for the object, not the bucket.\n\n" + "Examples:\n" + " GetAcl testbucket\n" + " GetAcl testbucket testobject\n\n"; if (args.length < 1) { System.out.println(USAGE); System.exit(1); } String bucket_name = args[0]; String object_key = (args.length > 1) ? args[1] : null; if (object_key != null) { getObjectAcl(bucket_name, object_key); } else { getBucketAcl(bucket_name); } System.out.println("Done!"); } }

Sample Details

Service: s3

Author: soo-aws

Type: full-example

On this page: