# 获取 S3 访问权限管控实例的详细信息
<a name="access-grants-instance-view"></a>

您可以获取特定 Amazon Web Services 区域中的 Amazon S3 访问权限管控实例的详细信息。可以使用 Amazon S3 控制台、Amazon Command Line Interface（Amazon CLI）、Amazon S3 REST API 和 Amazon SDK 获取 S3 访问权限管控实例的详细信息。

## 使用 S3 控制台
<a name="access-grants-instance-view-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-view-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 访问权限管控实例的详细信息**  

```
aws s3control get-access-grants-instance \
 --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-view-rest-api"></a>

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

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

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

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

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

**Example – 获取 S3 Access Grants 实例**  

```
public void getAccessGrantsInstance() {
GetAccessGrantsInstanceRequest getRequest = GetAccessGrantsInstanceRequest.builder()
.accountId("{{111122223333}}")
.build();
GetAccessGrantsInstanceResponse getResponse = s3Control.getAccessGrantsInstance(getRequest);
LOGGER.info("GetAccessGrantsInstanceResponse: " + getResponse);
}
```
响应：  

```
GetAccessGrantsInstanceResponse(
AccessGrantsInstanceArn=arn:aws:s3:{{us-east-2}}: {{111122223333}}:access-grants/default,
CreatedAt={{2023-06-07T01:46:20.507Z}})
```

------