檢視 S3 Access Grants 執行個體的詳細資訊

您可以檢視定 AWS 區域中 Amazon S3 Access Grants 執行個體的詳細資訊。您也可以列出 S3 存取授與執行個體，包括透過 AWS Resource Access Manager (AWS RAM) 與您共用的執行個體。

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS 開發套件，檢視 S3 存取授予執行個體的詳細資訊，或列出 S3 存取授與執行個體。

使用 S3 主控台

檢視 S3 Access Grants 執行個體

1. 登入 AWS Management Console 並開啟 Amazon S3 主控台，網址為 https://console.aws.amazon.com/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 執行個體的詳細資訊

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"
}

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

此動作會列出帳戶的 S3 Access Grants 執行個體。每個執行個體只能有一個 S3 存取授與執行個體 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

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

• GetAccessGrantsInstance

• GetAccessGrantsInstanceForPrefix

• ListAccessGrantsInstances

使用 AWS 軟體開發套件

本節提供如何使用 AWS SDK 取得 S3 存取授與執行個體詳細資訊的範例。

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

Java

範例 – 取得 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)

範例 – 列出帳戶的所有 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
)
]
)