使用 AWS CLI 和適用於 Java 的開發套件取得 S3 on Outposts 儲存貯體 - Amazon Simple Storage Service

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

使用 AWS CLI 和適用於 Java 的開發套件取得 S3 on Outposts 儲存貯體

透過 Amazon S3 on Outposts，您可以在 AWS Outposts 上建立 S3 儲存貯體，並針對需要本機資料存取權限、本機資料處理和資料駐留的應用程式，在內部部署輕鬆存放和擷取物件。S3 on Outposts 提供一個全新的儲存類別，即 S3 Outposts (OUTPOSTS)，它使用 Amazon S3 API，目的是在您的 AWS Outposts Outposts 上的多個裝置和伺服器上以持久、備援的方式存放資料。您可以使用存取點和透過 Virtual Private Cloud (VPC) 的端點連線，與您的 Outpost 儲存貯體進行通訊。就像在 Amazon S3 儲存貯體一樣，您在 Outpost 儲存貯體上可以使用同樣的 API 和功能，包括存取政策、加密和標記。您可以透過 AWS Management Console、AWS Command Line Interface (AWS CLI)、AWS SDK 或 REST API 使用 S3 on Outposts。如需詳細資訊，請參閱 什麼是 Amazon S3 on Outposts？。

下列範例示範如何使用 AWS CLI 和 AWS SDK for Java 取得 S3 on Outposts 儲存貯體。

注意

透過 AWS CLI 或 AWS SDK 使用 Amazon S3 on Outposts 使用時，您可以提供 Outposts 的存取點 ARN，以取代儲存貯體名稱。存取點 ARN 採用以下形式，其中 region 是 Outpost 所在區域的 AWS 區域 代碼：

arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point

如需 S3 on Outposts ARN 的詳細資訊，請參閱 Out ARNs posts S3 的資源。

下列 S3 on Outposts 範例使用 AWS CLI 取得儲存貯體。若要執行此命令，請以您自己的資訊取代每個 user input placeholder。如需此命令詳細資訊，請參閱 AWS CLI 參考中的 get-bucket。

aws s3control get-bucket --account-id 123456789012 --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket"

下列 S3 on Outposts 範例使用適用於 Java 的開發套件，取得一個儲存貯體。如需詳細資訊，請參閱 Amazon Simple Storage Service API 參考中的 GetBucket。

import com.amazonaws.services.s3control.model.*;

public void getBucket(String bucketArn) {

    GetBucketRequest reqGetBucket = new GetBucketRequest()
            .withBucket(bucketArn)
            .withAccountId(AccountId);

    GetBucketResult respGetBucket = s3ControlClient.getBucket(reqGetBucket);
    System.out.printf("GetBucket Response: %s%n", respGetBucket.toString());

}