기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Snowball Edge에서 Amazon S3 호환 스토리지로 S3 버킷 작업
<a name="working-s3-snow-buckets"></a>

Snowball Edge의 Amazon S3 호환 스토리지를 사용하면 Snowball Edge 디바이스에 Amazon S3 버킷을 생성하여 로컬 데이터 액세스, 로컬 데이터 처리 및 데이터 레지던시가 필요한 애플리케이션을 위해 온프레미스에 객체를 저장하고 검색할 수 있습니다. Snowball Edge의 Amazon S3 호환 스토리지는 Amazon S3 APIs를 사용하는 새로운 스토리지 클래스`SNOW`인를 제공하며 여러 Snowball Edge 디바이스에 데이터를 내구성 있고 중복적으로 저장하도록 설계되었습니다. 버킷 수명 주기 정책, 암호화, 태그 지정을 포함하여 Amazon S3에서와 같이 Snowball Edge 버킷에서 동일한 API 및 기능을 사용할 수 있습니다.

 AWS Command Line Interface (AWS CLI)를 사용하거나 AWS Java SDK를 통해 프로그래밍 방식으로 Snowball Edge에서 Amazon S3 호환 스토리지를 사용할 수 있습니다. 를 사용하면 s3api 또는 s3control 엔드포인트를 설정하고 명령을 통해 상호 작용 AWS CLI할 수 있습니다. 버킷 및 객체 작업에 동일한 엔드포인트를 사용할 수 있으므로 s3api 엔드포인트를 사용하는 것이 좋습니다.

**참고**  
s3api 엔드포인트는 Snowball Edge 소프트웨어의 버전 8004 이상에서 사용할 수 있습니다. 디바이스에 설치된 Snowball Edge 소프트웨어 버전을 찾으려면 `snowballEdge check-for-updates` 명령을 사용합니다. Snowball Edge 디바이스를 업데이트하려면 [Snowball Edge 디바이스의 소프트웨어 업데이트](https://docs.aws.amazon.com/snowball/latest/developer-guide/updating-device.html)를 참조하세요.

## 사용 AWS CLI
<a name="working-s3-snow-buckets-cli-setup"></a>

다음 지침에 따라 AWS CLI를 사용하여 디바이스에서 Amazon S3 버킷을 사용합니다.

**를 설정하려면 AWS CLI**

1. `~/.aws/config`에서 객체 엔드포인트의 프로필을 생성합니다.

   ```
   [profile your-profile]
   aws_access_key_id = your-access-id
   aws_secret_access_key = your-access-key
   region = snow
   ca_bundle = dev/apps/ca-certs/your-ca_bundle
   ```

1. 디바이스에서 인증서를 받습니다. 자세한 내용은 *[Snowball Edge Developer Guide](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#snowball-edge-certificates-cli)* 섹션을 참조하세요.

1. 가상 환경에 SDK를 설치한 경우 다음 명령을 사용하여 활성화합니다.

   ```
   source your-virtual-environment-name/bin/activate
   ```

작업을 설정한 후 s3api SDK 또는 s3control SDK를 사용하여를 사용하여 Snowball Edge의 S3 버킷에 액세스할 수 있습니다 AWS CLI.

**Example s3api SDK를 사용하여 S3 버킷에 액세스**  

```
aws s3api list-buckets --endpoint-url https://s3api-endpoint-ip --profile your-profile                    
```

**Example s3control SDK를 사용하여 S3 버킷에 액세스하는 방법**  

```
aws s3control list-regional-buckets --account-id bucket-owner --endpoint-url https://s3ctrlapi-endpoint-ip --profile your-profile                
```

**Example s3api SDK를 사용하여 S3 객체에 액세스**  

```
aws s3api list-objects-v2 --endpoint-url https://s3api-endpoint-ip --profile your-profile
```

## Java SDK 사용
<a name="working-s3-snow-buckets-python-setup"></a>

다음 예시를 사용하면 Java SDK를 통해 Amazon S3 버켓 및 객체로 작업할 수 있습니다.

```
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.http.SdkHttpClient;bg
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.regions.Region;

import java.net.URI;

AwsBasicCredentials creds = AwsBasicCredentials.create(accessKey, secretKey); // set creds by getting Access Key and Secret Key from snowball edge
SdkHttpClient httpClient = ApacheHttpClient.builder().tlsTrustManagersProvider(trustManagersProvider).build(); // set trust managers provider with client certificate from snowball edge
String s3SnowEndpoint = "10.0.0.0"; // set s3-snow object api endpoint from describe service

S3Client s3Client = S3Client.builder().httpClient(httpClient).region(Region.of("snow")).endpointOverride(new URI(s3SnowEndpoint)).credentialsProvider(StaticCredentialsProvider.create(creds)).build();
```

## 버킷 ARN 형식
<a name="working-s3-snow-buckets-format"></a>

여기에 나열된 Amazon 리소스 이름(ARN) 형식을 사용하여 Snowball Edge 디바이스의 Amazon S3 버킷을 식별할 수 있습니다.

```
arn:partition:s3:snow:account-id:device/device-id/bucket/bucket-name
```

여기서 *파티션*은 Snowball Edge 디바이스를 주문한 리전의 파티션입니다. *device-id*는 디바이스가 독립형 Snowball Edge 디바이스인 경우 job\$1id이고, Snowball Edge 클러스터가 있는 경우 *cluster\$1id*입니다.

## 버킷 위치 형식
<a name="work-s3-snow-buckets-location"></a>

버킷 위치 형식은 버킷이 생성될 Snowball Edge 디바이스를 지정합니다. 버킷 위치의 형식은 다음과 같습니다.

```
/device-id/bucket/bucket-name
```

자세한 내용은 AWS CLI 명령 참조의 [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/2.0.34/reference/s3api/create-bucket.html)을 참조하세요.