# 列出 S3 访问权限管控实例
<a name="access-grants-instance-list"></a>

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

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

## 使用 S3 控制台
<a name="access-grants-instance-list-console"></a>

**列出 S3 访问权限管控实例**

1. 登录到 Amazon Web Services 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.amazonaws.cn/s3/)。

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

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

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

## 使用 Amazon CLI
<a name="access-grants-instance-list-cli"></a>

要安装 Amazon CLI，请参阅 *Amazon Command Line Interface 用户指南*中的[安装 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-install.html)。

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

**Example – 列出账户的所有 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}}"
}
```

## 使用 REST API
<a name="access-grants-instance-list-rest-api"></a>

有关用于管理 S3 Access Grants 实例的 Amazon S3 REST API 支持的信息，请参阅**《Amazon Simple Storage Service API 参考》中的以下部分：
+  [https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_ListAccessGrantsInstances.html](https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_ListAccessGrantsInstances.html) 

## 使用 Amazon SDK
<a name="access-grants-instance-list-using-sdk"></a>

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

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

------
#### [ Java ]

**Example – 列出账户的所有 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}}
)
]
)
```

------