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

# 使用適用於 Java 的 AWS CLI 和 開發套件取得 S3 on Outposts 儲存貯體
<a name="S3OutpostsGetBucket"></a>

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

下列範例說明如何使用 AWS CLI 和 取得 S3 on Outposts 儲存貯體 適用於 Java 的 AWS SDK。

**注意**  
當您透過 AWS CLI AWS SDKs 使用 Amazon S3 on Outposts 時，您可以為 Outpost 提供存取點 ARN，以取代儲存貯體名稱。存取點 ARN 採用以下形式，其中 `region` 是 Outpost 所在區域的 AWS 區域 代碼：  
`arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point`   
如需 S3 on Outposts ARN 的詳細資訊，請參閱 [適用於 S3 on Outposts 的資源 ARN](S3OutpostsIAM.md#S3OutpostsARN)。

## 使用 AWS CLI
<a name="S3OutpostsGetBucketCLI"></a>

下列 S3 on Outposts 範例使用 AWS CLI取得儲存貯體。若要執行此命令，請以您自己的資訊取代每個 `user input placeholder`。如需此命令詳細資訊，請參閱 *AWS CLI 參考*中的 [get-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/get-bucket.html)。

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

## 使用適用於 Java 的 AWS 開發套件
<a name="S3OutpostsGetBucketJava"></a>

下列 S3 on Outposts 範例使用適用於 Java 的開發套件，取得一個儲存貯體。如需詳細資訊，請參閱 *Amazon Simple Storage Service API 參考*中的 [GetBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html)。

```
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());

}
```