# 查看已注册位置的详细信息
您可以获取使用 Amazon S3 控制台、Amazon Command Line Interface（Amazon CLI）、Amazon S3 REST API 和 Amazon SDK 在 S3 Access Grants 实例中注册的位置的详细信息。
## 使用 S3 控制台
**查看在 S3 Access Grants 实例中注册的位置**
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. 对于实例，选择**查看详细信息**。
1. 在实例的详细信息页面上，选择**位置**选项卡。
1. 找到要查看的已注册位置。要筛选已注册位置的列表，请使用搜索框。
## 使用 Amazon CLI
要安装 Amazon CLI，请参阅 *Amazon Command Line Interface 用户指南*中的[安装 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-install.html)。
要使用以下示例命令，请将 `{{user input placeholders}}` 替换为您自己的信息。
**Example – 获取已注册位置的详细信息**
```
aws s3control get-access-grants-location \
--account-id {{111122223333}} \
--access-grants-location-id {{default}}
```
响应：
```
{
"CreatedAt": "{{2023-05-31T18:23:48.107000+00:00}}",
"AccessGrantsLocationId": "{{default}}",
"AccessGrantsLocationArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/{{default}}",
"IAMRoleArn": "arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}"
}
```
**Example – 列出在 S3 Access Grants 实例中注册的所有位置**
要将结果限制为 S3 前缀或存储桶，可以选择使用 `--location-scope s3://{{bucket-and-or-prefix}}` 参数。
```
aws s3control list-access-grants-locations \
--account-id {{111122223333}} \
--region {{us-east-2}}
```
响应：
```
{"AccessGrantsLocationsList": [
{
"CreatedAt": "{{2023-05-31T18:23:48.107000+00:00}}",
"AccessGrantsLocationId": "default",
"AccessGrantsLocationArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/default",
"LocationScope": "s3://"
"IAMRoleArn": "arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}"
},
{
"CreatedAt": "{{2023-05-31T18:23:48.107000+00:00}}",
"AccessGrantsLocationId": "{{635f1139-1af2-4e43-8131-a4de006eb456}}",
"AccessGrantsLocationArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/{{635f1139-1af2-4e43-8131-a4de006eb888}}",
"LocationScope": "s3://{{amzn-s3-demo-bucket/prefixA*}}",
"IAMRoleArn": "arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}"
}
]
}
```
## 使用 REST API
有关用于获取已注册位置的详细信息或列出在 S3 Access Grants 实例中注册的所有位置的 Amazon S3 REST API 支持的信息，请参阅**《Amazon Simple Storage Service API 参考》中的以下部分：
+ [https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_GetAccessGrantsLocation.html](https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_GetAccessGrantsLocation.html)
+ [https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_ListAccessGrantsLocations.html](https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_ListAccessGrantsLocations.html)
## 使用 Amazon SDK
此部分中的示例说明了如何使用 Amazon SDK 获取已注册位置的详细信息，或列出 S3 Access Grants 实例中的所有已注册位置。
要使用以下示例，请将 `{{user input placeholders}}` 替换为您自己的信息。
------
#### [ Java ]
**Example – 获取已注册位置的详细信息**
```
public void getAccessGrantsLocation() {
GetAccessGrantsLocationRequest getAccessGrantsLocationRequest = GetAccessGrantsLocationRequest.builder()
.accountId("{{111122223333}}")
.accessGrantsLocationId("default")
.build();
GetAccessGrantsLocationResponse getAccessGrantsLocationResponse = s3Control.getAccessGrantsLocation(getAccessGrantsLocationRequest);
LOGGER.info("GetAccessGrantsLocationResponse: " + getAccessGrantsLocationResponse);
}
```
响应：
```
GetAccessGrantsLocationResponse(
CreatedAt={{2023-06-07T04:35:10.027Z}},
AccessGrantsLocationId=default,
AccessGrantsLocationArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/default,
LocationScope= s3://,
IAMRoleArn=arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}
)
```
**Example – 列出 S3 Access Grants 实例中的所有已注册位置**
要将结果限制为 S3 前缀或存储桶，可以选择在 `LocationScope` 参数中传递 S3 URI，例如 `s3://{{bucket-and-or-prefix}}`。
```
public void listAccessGrantsLocations() {
ListAccessGrantsLocationsRequest listRequest = ListAccessGrantsLocationsRequest.builder()
.accountId("{{111122223333}}")
.build();
ListAccessGrantsLocationsResponse listResponse = s3Control.listAccessGrantsLocations(listRequest);
LOGGER.info("ListAccessGrantsLocationsResponse: " + listResponse);
}
```
响应：
```
ListAccessGrantsLocationsResponse(
AccessGrantsLocationsList=[
ListAccessGrantsLocationsEntry(
CreatedAt={{2023-06-07T04:35:11.027Z}},
AccessGrantsLocationId=default,
AccessGrantsLocationArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/default,
LocationScope=s3://,
IAMRoleArn=arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}
),
ListAccessGrantsLocationsEntry(
CreatedAt={{2023-06-07T04:35:10.027Z}},
AccessGrantsLocationId={{635f1139-1af2-4e43-8131-a4de006eb456}},
AccessGrantsLocationArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/{{635f1139-1af2-4e43-8131-a4de006eb888}},
LocationScope=s3://{{amzn-s3-demo-bucket/prefixA*}},
IAMRoleArn=arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}
)
]
)
```
------