# AWS RAM 사용을 통해 S3 on Outposts 공유
Amazon S3 on Outposts는 AWS Resource Access Manager([AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html)) 사용을 통해 조직 내 여러 계정에서 S3 용량 공유를 지원합니다. S3 on Outposts 공유를 사용하면 다른 사용자가 Outpost에서 버킷, 엔드포인트 및 액세스 포인트를 생성하고 관리할 수 있도록 허용할 수 있습니다.
이 주제에서는 AWS RAM을 사용하여 S3 on Outposts 및 관련 리소스를 AWS 조직의 다른 AWS 계정과 공유하는 방법을 보여줍니다.
## 사전 조건
+ Outpost 소유자 계정에는 AWS Organizations에 조직이 구성되어 있습니다. 자세한 내용은 [AWS Organizations 사용 설명서](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_create.html)의 *조직 생성*을 참조하세요.
+ 조직에는 S3 on Outposts 용량을 공유하려는 AWS 계정이 포함됩니다. 자세한 내용은 *AWS Organizations 사용 설명서*의 [AWS 계정에 초대 전송](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_invites.html#orgs_manage_accounts_invite-account) 섹션을 참조하세요.
+ 공유하고자 하는 다음 옵션 중 하나를 선택합니다. 엔드포인트에 액세스할 수 있도록 두 번째 리소스(**서브넷** 또는 **Outposts**)를 선택해야 합니다. 엔드포인트는 S3 on Outposts에 저장된 데이터에 액세스하기 위한 네트워킹 요구 사항입니다.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/AmazonS3/latest/s3-outposts/outposts-sharing-with-ram.html)
## 절차
1. Outpost를 소유한 AWS 계정을 사용하여 AWS Management Console에 로그인하고, [https://console.aws.amazon.com/ram/home](https://console.aws.amazon.com/ram/home)에서 AWS RAM 콘솔을 엽니다.
1. AWS RAM에서 AWS Organizations 대상 공유를 활성화했는지 확인합니다. 자세한 내용은 *AWS RAM 사용 설명서*에서 [AWS Organizations 내에서 리소스 공유 사용](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs)을 참조하세요.
1. [사전 조건](#outposts-ram-prereqs)에서 옵션 1이나 옵션 2를 사용하여 리소스 공유를 생성합니다. S3 on Outposts 리소스가 여러 개 있는 경우 공유하려는 리소스의 Amazon 리소스 이름(ARN)을 선택합니다. 엔드포인트를 활성화하려면 서브넷 또는 Outpost를 공유합니다.
리소스 공유를 생성하는 방법에 대한 자세한 내용은 *AWS RAM 사용 설명서*의 [리소스 공유 생성](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create)을 참조하세요.
1. 리소스를 공유하는 AWS 계정에서 이제 S3 on Outposts를 사용할 수 있어야 합니다. [사전 조건](#outposts-ram-prereqs)에서 선택한 옵션에 따라 계정 사용자에게 다음 정보를 제공합니다.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/AmazonS3/latest/s3-outposts/outposts-sharing-with-ram.html)
**참고**
사용자는 AWS RAM 콘솔, AWS Command Line Interface(AWS CLI), AWS SDK 또는 REST API를 사용하여 리소스가 공유되었는지 확인할 수 있습니다. 사용자는 [get-resource-shares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-shares.html) CLI 명령을 사용하여 기존 리소스 공유를 볼 수 있습니다.
## 사용 예제:
S3 on Outposts 리소스를 다른 계정과 공유한 후 해당 계정에서 Outpost의 버킷과 객체를 관리할 수 있습니다. **서브넷** 리소스를 공유하는 경우 해당 계정에서 생성한 엔드포인트를 사용할 수 있습니다. 다음 예제에서는 사용자가 AWS CLI를 사용하여 리소스를 공유한 후 Outpost와 상호 작용하는 방법을 보여줍니다.
**Example : 버킷 생성**
다음 예제에서는 Outpost `{{op-01ac5d28a6a232904}}`에서 {{amzn-s3-demo-bucket1}}이라는 버킷을 생성합니다. 이 명령을 사용하기 전에 각 `{{user input placeholder}}`를 사용 사례에 적합한 값으로 바꿉니다.
```
aws s3control create-bucket --bucket {{{{amzn-s3-demo-bucket1}}}} --outpost-id {{op-01ac5d28a6a232904}}
```
이 명령에 대한 자세한 내용은 *AWS CLI 참조*의 [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/create-bucket.html)을 참조하세요.
**Example : 액세스 포인트 생성**
다음 예제에서는 아래 테이블의 예제 파라미터를 사용하여 Outpost에 액세스 포인트를 생성합니다. 이 명령을 사용하기 전에 `{{user input placeholder}}` 값과 AWS 리전 코드를 사용 사례에 적합한 값으로 바꿉니다.
| **파라미터** | **값** |
| --- | --- |
| 계정 ID | {{111122223333}} |
| 액세스 포인트 이름 | {{example-outpost-access-point}} |
| Outpost ID | {{op-01ac5d28a6a232904}} |
| Outpost 버킷 이름 | {{amzn-s3-demo-bucket1}} |
| VPC ID | {{vpc-1a2b3c4d5e6f7g8h9}} |
계정 ID 파라미터는 공유 사용자인 버킷 소유자의 AWS 계정 ID여야 합니다.
```
aws s3control create-access-point --account-id {{111122223333}} --name {{example-outpost-access-point}} \
--bucket arn:aws:s3-outposts:{{us-east-1}}:{{111122223333}}:outpost/{{op-01ac5d28a6a232904}}/bucket/{{{{amzn-s3-demo-bucket1}}}} \
--vpc-configuration VpcId={{vpc-1a2b3c4d5e6f7g8h9}}
```
이 명령에 대한 자세한 내용은 *AWS CLI 참조*의 [create-access-point](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/create-access-point.html)를 참조하세요.
**Example : 객체 업로드**
다음 예제에서는 사용자의 로컬 파일 시스템에서 AWS 계정 {{`111122223333`}}에서 소유하는 Outpost {{`op-01ac5d28a6a232904`}}에 있는 액세스 포인트 {{`example-outpost-access-point`}}를 통해 이름이 {{`images/my_image.jpg`}}인 객체로 {{`my_image.jpg`}} 파일을 업로드합니다. 이 명령을 사용하기 전에 `{{user input placeholder}}` 값과 AWS 리전 코드를 사용 사례에 적합한 값으로 바꿉니다.
```
aws s3api put-object --bucket arn:aws:s3-outposts:{{us-east-1}}:{{111122223333}}:outpost/{{op-01ac5d28a6a232904}}/accesspoint/{{example-outpost-access-point}} \
--body {{my_image.jpg}} --key {{images/my_image.jpg}}
```
이 명령에 대한 자세한 내용은 *AWS CLI 참조*의 [put-object](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html)를 참조하세요.
이 작업으로 인해 리소스를 찾을 수 없음 오류가 발생하거나 응답하지 않는 경우 VPC에 공유 엔드포인트가 없을 수 있습니다.
공유 엔드포인트가 있는지 확인하려면 [list-shared-endpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3outposts/list-shared-endpoints.html) AWS CLI명령을 사용하세요. 공유 엔드포인트가 없는 경우 Outpost 소유자와 협력하여 엔드포인트를 생성하세요. 자세한 내용은 *Amazon Simple Storage Service API 참조*의 [ListSharedEndpoints](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3outposts_ListSharedEndpoints.html)를 참조하세요.
**Example : 엔드포인트 생성**
다음 예제에서는 Outpost에 대한 엔드포인트를 생성합니다. 이 명령을 사용하기 전에 Outpost ID, 서브넷 ID 및 보안 그룹 ID의 `{{user input placeholder}}` 값을 사용 사례에 적합한 값으로 바꿉니다.
리소스 공유에 **Outpost** 리소스가 포함된 경우 사용자가 이 작업만을 수행할 수 있습니다.
```
aws s3outposts create-endpoint --outposts-id {{op-01ac5d28a6a232904}} --subnet-id {{XXXXXX}} --security-group-id {{XXXXXXX}}
```
이 명령에 대한 자세한 내용은 *AWS CLI 참조*의 [create-endpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3outposts/create-endpoint.html)를 참조하세요.