列出 S3 访问权限管控实例 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

列出 S3 访问权限管控实例

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

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

列出 S3 访问权限管控实例

  1. 登录到 Amazon Web Services 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 实例以及已与您的账户共享的所有跨账户实例。要查看实例的详细信息，请选择查看详细信息。

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

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

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

此操作将列出账户的 S3 Access Grants 实例。您在每个 Amazon Web Services 区域中只能具有一个 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"
}

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

此部分中的示例说明了如何使用 Amazon 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
)
]
)