使用 Amazon CLI 和适用于 Java 的 SDK 获取 S3 on Outposts 存储桶 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用 Amazon CLI 和适用于 Java 的 SDK 获取 S3 on Outposts 存储桶

通过使用 Amazon S3 on Outposts，您可以在 Amazon Outposts 上创建 S3 存储桶，并在本地为需要本地数据访问、本地数据处理和数据驻留的应用程序轻松存储和检索对象。S3 on Outposts 提供了一个新的存储类 S3 Outposts (OUTPOSTS)；该存储类使用 Amazon S3 API，并且用于在 Amazon Outposts 上的多个设备和服务器之间持久冗余地存储数据。您通过 Virtual Private Cloud (VPC) 使用访问点和端点连接与 Outposts 存储桶进行通信。您可以像在 Amazon S3 存储桶中一样在 Outpost 存储桶上使用相同的 API 和功能，包括访问策略、加密和标记。您可以通过 Amazon Web Services Management Console、Amazon Command Line Interface (Amazon CLI)、Amazon SDK 或 REST API 使用 S3 on Outposts。有关更多信息，请参阅什么是 Amazon S3 on Outposts？

以下示例显示了如何使用 Amazon CLI 和 Amazon SDK for Java 获取 S3 on Outposts 存储桶。

注意

当您通过 Amazon CLI 或 Amazon SDK 使用 Amazon S3 on Outposts 时，您可以提供 Outpost 的访问点 ARN 来代替存储桶名称。访问点 ARN 采用以下形式，其中 region 是 Outpost 归属的区域的 Amazon Web Services 区域代码：

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

有关 S3 on Outposts ARN 的更多信息，请参阅S3 on Outposts 的资源 ARN。

以下 S3 on Outposts 示例使用 Amazon CLI 获取存储桶。要使用此命令，请将每个 user input placeholder 替换为您自己的信息。有关此命令的更多信息，请参阅《Amazon 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 的 SDK 获取存储桶。有关更多信息，请参阅《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());

}