本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出 S3 存取授權執行個體
<a name="access-grants-instance-list"></a>

您可以列出 S3 Access Grants 執行個體，包括已透過 AWS Resource Access Manager () 與您共用的執行個體AWS RAM。

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 SDK 列出 S3 Access Grants 執行個體。 Amazon S3 AWS SDKs

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

**列出 S3 存取授權執行個體**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇 **Access Grants**。

1. 在 **S3 Access Grants** 頁面上，選擇包含您要使用之 S3 Access Grants 執行個體的區域。

1. **S3 Access Grants** 頁面會列出您的 S3 Access Grants 執行個體，以及與您的帳戶共用的任何跨帳戶執行個體。若要檢視執行個體的詳細資訊，請選擇**檢視詳細資訊**。

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

若要安裝 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*》中的[安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 。

若要使用下列範例命令，請以您自己的資訊取代 `{{user input placeholders}}`。

**Example – 列出帳戶的所有 S3 Access Grants 執行個體**  
此動作會列出帳戶的 S3 Access Grants 執行個體。每個 只能有一個 S3 Access Grants 執行個體 AWS 區域。此動作也會列出您的帳戶可存取的其他跨帳戶 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.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsInstances.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsInstances.html) 

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

本節提供如何使用 AWS SDKs 取得 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}}
)
]
)
```

------