列出 S3 访问权限管控实例

还可以列出 S3 访问权限管控实例，包括已通过 AWS Resource Access Manager（AWS RAM）与您共享的实例。

可以使用 Amazon S3 控制台、AWS Command Line Interface（AWS CLI）、Amazon S3 REST API 和 AWS SDK 列出 S3 访问权限管控实例。

使用 S3 控制台

列出 S3 访问权限管控实例

1. 登录到AWS Management Console，然后通过以下网址打开 Amazon S3 控制台：https://console.aws.amazon.com/s3/。

2. 在左侧导航窗格中，选择 Access Grants。

3. 在 S3 Access Grants 页面上，选择包含要使用的 S3 Access Grants 实例的区域。

4. S3 Access Grants 页面列出了您的 S3 Access Grants 实例以及已与您的账户共享的所有跨账户实例。要查看实例的详细信息，请选择查看详细信息。

使用 AWS CLI

要安装 AWS CLI，请参阅 AWS Command Line Interface 用户指南中的安装 AWS CLI。

要使用以下示例命令，请将 user input placeholders 替换为您自己的信息。

例 – 列出账户的所有 S3 Access Grants 实例

此操作将列出账户的 S3 Access Grants 实例。您在每个 AWS 区域中只能具有一个 S3 Access Grants 实例。此操作还会列出您的账户有权访问的其他跨账户 S3 Access Grants 实例。

aws s3control list-access-grants-instances \
 --account-id 111122223333 \
 --region us-east-2

响应：

{
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2: 111122223333:access-grants/default",
    "AccessGrantsInstanceId": "default",
    "CreatedAt": "2023-05-31T17:54:07.893000+00:00"
}

使用 REST API

有关用于管理 S3 Access Grants 实例的 Amazon S3 REST API 支持的信息，请参阅《Amazon Simple Storage Service API 参考》中的以下部分：

• ListAccessGrantsInstances

使用 AWS SDK

此部分中的示例说明了如何使用 AWS SDK 获取 S3 Access Grants 实例的详细信息。

要使用以下示例，请将 user input placeholders 替换为您自己的信息。

Java

例 – 列出账户的所有 S3 Access Grants 实例

此操作将列出账户的 S3 Access Grants 实例。您在每个区域只能有一个 S3 Access Grants 实例。此操作还列出了您的账户有权访问的其他跨账户 S3 Access Grants 实例。

public void listAccessGrantsInstances() {
ListAccessGrantsInstancesRequest listRequest = ListAccessGrantsInstancesRequest.builder()
.accountId("111122223333")
.build();
ListAccessGrantsInstancesResponse listResponse = s3Control.listAccessGrantsInstances(listRequest);
LOGGER.info("ListAccessGrantsInstancesResponse: " + listResponse);
}

响应：

ListAccessGrantsInstancesResponse(
AccessGrantsInstancesList=[
ListAccessGrantsInstanceEntry(
AccessGrantsInstanceId=default,
AccessGrantsInstanceArn=arn:aws:s3:us-east-2:111122223333:access-grants/default,
CreatedAt=2023-06-07T04:28:11.728Z
)
]
)