列出 S3 存取授權執行個體

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

您可以使用 Amazon S3 主控台、AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDK 來列出 S3 存取授權執行個體。

使用 S3 主控台

列出 S3 存取授權執行個體

1. 登入 AWS Management Console，並開啟位於 https://console.aws.amazon.com/s3/ 的 Amazon S3 主控台。

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

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

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

使用 AWS CLI

若要安裝 AWS CLI ，請參閱《AWS Command Line Interface 使用者指南》中的安裝 AWS CLI。

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

範例 – 列出帳戶的所有 S3 Access Grants 執行個體

此動作會列出帳戶的 S3 Access Grants 執行個體。每個 AWS 區域 只能擁有一個 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

如需有關管理 S3 Access Grants 執行個體的 Amazon S3 REST API 支援資訊，請參閱《Amazon Simple Storage Service API 參考》中的下列各節：

• ListAccessGrantsInstances

使用 AWS SDK

本節提供如何使用 AWS 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
)
]
)