List your S3 Access Grants instances
You can list your S3 Access Grants instances, including the instances that have been shared with you through AWS Resource Access Manager (AWS RAM).
You can list your S3 Access Grants instances by using the Amazon S3 console, the AWS Command Line Interface (AWS CLI), the Amazon S3 REST API, and the AWS SDKs.
To list your S3 Access Grants instances
Sign in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/.
-
In the left navigation pane, choose Access Grants.
-
On the S3 Access Grants page, choose the Region that contains the S3 Access Grants instance that you want to work with.
-
The S3 Access Grants page lists your S3 Access Grants instances and any cross-account instances that have been shared with your account. To view the details of an instance, choose View details.
To install the AWS CLI, see Installing the AWS CLI in the AWS Command Line Interface User Guide.
To use the following example command, replace the user input
placeholders
Example – List all S3 Access Grants instances for an account
This action lists the S3 Access Grants instances for an account. You can only have one S3 Access Grants instance per AWS Region. This action also lists other cross-account S3 Access Grants instances that your account has access to.
aws s3control list-access-grants-instances \ --account-id111122223333\ --regionus-east-2
Response:
{ "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default", "AccessGrantsInstanceId": "default", "CreatedAt": "2023年05月31日T17:54:07.893000+00:00" }
For information about the Amazon S3 REST API support for managing an S3 Access Grants instance, see the following sections in the Amazon Simple Storage Service API Reference:
This section provides examples of how to get the details of an S3 Access Grants instance by using the AWS SDKs.
To use the following examples, replace the user input
placeholders
- Java
-
Example – List all S3 Access Grants instances for an account
This action lists the S3 Access Grants instances for an account. You can only have one S3 Access Grants instance per Region. This action can also list other cross-account S3 Access Grants instances that your account has access to.
public void listAccessGrantsInstances() { ListAccessGrantsInstancesRequest listRequest = ListAccessGrantsInstancesRequest.builder() .accountId("111122223333") .build(); ListAccessGrantsInstancesResponse listResponse = s3Control.listAccessGrantsInstances(listRequest); LOGGER.info("ListAccessGrantsInstancesResponse: " + listResponse); }Response:
ListAccessGrantsInstancesResponse( AccessGrantsInstancesList=[ ListAccessGrantsInstanceEntry( AccessGrantsInstanceId=default, AccessGrantsInstanceArn=arn:aws:s3:us-east-2:111122223333:access-grants/default, CreatedAt=2023年06月07日T04:28:11.728Z) ] )
Warning Javascript is disabled or is unavailable in your browser.
To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.