# AWS CLI 및 Java용 SDK를 사용하여 S3 on Outposts 버킷 가져오기
<a name="S3OutpostsGetBucket"></a>

Amazon S3 on Outposts를 사용하면 AWS Outposts에서 S3 버킷을 생성하고 로컬 데이터 액세스, 로컬 데이터 처리 및 데이터 레지던시가 필요한 애플리케이션을 위해 온프레미스에서 객체를 쉽게 저장하고 검색할 수 있습니다. S3 on Outposts는 S3 Outposts(`OUTPOSTS`)라는 새로운 스토리지 클래스를 제공합니다. 이 클래스는 Amazon S3 API를 사용하며 AWS 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란 무엇인가요?](S3onOutposts.md) 섹션을 참조하세요. 

다음 예제에서는 AWS CLI 및 AWS SDK for Java를 사용하여 S3 on Outposts 버킷을 가져오는 방법을 보여줍니다.

**참고**  
AWS CLI 또는 AWS SDK를 통해 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 SDK 사용
<a name="S3OutpostsGetBucketJava"></a>

다음 S3 on Outposts 예제에서는 Java용 SDK를 사용하여 버킷을 가져옵니다. 자세한 내용은 *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());

}
```