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

# Amazon DocumentDB Amazon 리소스 이름(ARN) 이해
<a name="documentdb-arns"></a>

에서 생성하는 리소스 AWS 는 각각 Amazon 리소스 이름(ARN)으로 고유하게 식별됩니다. 특정 Amazon DocumentDB(MongoDB 호환) 작업의 경우 ARN을 지정하여 Amazon DocumentDB 리소스를 고유하게 식별해야 합니다. 예를 들어, 리소스에 태그를 추가할 경우 리소스의 ARN을 제공해야 합니다.

**Topics**
+ [ARN 생성](#documentdb-arns-constructing)
+ [ARN 찾기](#documentdb-arns-find)

## Amazon DocumentDB 리소스에 대한 ARN 구성
<a name="documentdb-arns-constructing"></a>

다음 구문을 사용하여 Amazon DocumentDB 리소스에 대한 ARN을 구성할 수 있습니다. Amazon DocumentDB는 Amazon Relational Database Service(Amazon RDS) ARN의 형식을 공유합니다. Amazon DocumentDB ARN에는 `rds`가 포함되지만 `docdb`는 포함되지 않습니다.

`arn:aws:rds:{{region}}:{{account_number}}:{{resource_type}}:{{resource_id}}`


| 리전 이름 | 리전 | 가용 영역(컴퓨팅) | 
| --- | --- | --- | 
| 미국 동부(오하이오) | `us-east-2` | 3 | 
| 미국 동부(버지니아 북부) | `us-east-1` | 6 | 
| 미국 서부(오리건) | `us-west-2` | 4 | 
| 아프리카(케이프타운) | `af-south-1` | 3 | 
| 남아메리카(상파울루) | `sa-east-1` | 3 | 
| 아시아 태평양(홍콩) | `ap-east-1` | 3 | 
| 아시아 태평양(하이데라바드) | `ap-south-2` | 3 | 
| 아시아 태평양(말레이시아) | `ap-southeast-5` | 3 | 
| 아시아 태평양(뭄바이) | `ap-south-1` | 3 | 
| 아시아 태평양(오사카) | `ap-northeast-3` | 3 | 
| 아시아 태평양(서울) | `ap-northeast-2` | 4 | 
| 아시아 태평양(싱가포르) | `ap-southeast-1` | 3 | 
| 아시아 태평양(시드니) | `ap-southeast-2` | 3 | 
| 아시아 태평양(자카르타) | `ap-southeast-3` | 3 | 
| 아시아 태평양(멜버른) | `ap-southeast-4` | 3 | 
| 아시아 태평양(태국) | `ap-southeast-7` | 3 | 
| 아시아 태평양(도쿄) | `ap-northeast-1` | 3 | 
| 캐나다(중부) | `ca-central-1` | 3 | 
| 캐나다 서부(캘거리) | `ca-west-1` | 3 | 
| 중국(베이징) 리전 | `cn-north-1` | 3 | 
| 중국(닝샤) | `cn-northwest-1` | 3 | 
| 유럽(프랑크푸르트) | `eu-central-1` | 3 | 
| 유럽(취리히) | `eu-central-2` | 3 | 
| 유럽(아일랜드) | `eu-west-1` | 3 | 
| 유럽(런던) | `eu-west-2` | 3 | 
| 유럽(밀라노) | `eu-south-1` | 3 | 
| 유럽(파리) | `eu-west-3` | 3 | 
| 유럽(스페인) | `eu-south-2` | 3 | 
| 유럽(스톡홀름) | `eu-north-1` | 3 | 
| 멕시코(중부) | `mx-central-1` | 3 | 
| 중동(UAE) | `me-central-1` | 3 | 
| 이스라엘(텔아비브) | `il-central-1` | 3 | 
| AWS GovCloud(미국 서부) | `us-gov-west-1` | 3 | 
| AWS GovCloud(미국 동부) | `us-gov-east-1` | 3 | 

**참고**  
Amazon DocumentDB 아키텍처는 스토리지와 컴퓨팅을 분리합니다. 스토리지 계층의 경우 Amazon DocumentDB는 3개의 AWS 가용 영역(AZs. 위 표에 나열된 AZs는 지정된 리전에서 컴퓨팅 인스턴스를 프로비저닝하는 데 사용할 수 있는 AZs 수입니다. 예를 들어 ap-northeast-1에서 Amazon DocumentDB 클러스터를 시작하는 경우 스토리지는 3개의 AZ에 걸쳐 6가지 방식으로 복제되지만 컴퓨팅 인스턴스는 2개의 AZ에서만 사용할 수 있습니다.

다음 표는 특정 Amazon DocumentDB 리소스에 대한 ARN을 구성할 때 사용해야 하는 형식을 보여줍니다. Amazon DocumentDB는 Amazon RDS ARN의 형식을 공유합니다. Amazon DocumentDB ARN에는 `rds`가 포함되지만 `docdb`는 포함되지 않습니다.


| 리소스 유형 | ARN 형식/예 | 
| --- | --- | 
| 인스턴스(`db`) | `arn:aws:rds:{{region}}:{{account_number}}:db:{{resource_id}}`<pre>arn:aws:rds:us-east-1:{{1234567890}}:db:{{sample-db-instance}}</pre> | 
| 클러스터(`cluster`) | `arn:aws:rds:{{region}}:{{account_number}}:cluster:{{resource_id}}`<pre>arn:aws:rds:us-east-1:{{1234567890}}:cluster:{{sample-db-cluster}}</pre> | 
| 클러스터 파라미터 그룹(`cluster-pg`) | `arn:aws:rds:{{region}}:{{account_number}}:cluster-pg:{{resource_id}}`<pre>arn:aws:rds:us-east-1:{{1234567890}}:cluster-pg:{{sample-db-cluster-parameter-group}}</pre> | 
| 보안 그룹(`secgrp`) | `arn:aws:rds:{{region}}:{{account_number}}:secgrp:{{resource_id}}`<pre>arn:aws:rds:us-east-1:{{1234567890}}:secgrp:{{sample-public-secgrp}}</pre> | 
| 클러스터 스냅샷(`cluster-snapshot`) | `arn:aws:rds:{{region}}:{{account_number}}:cluster-snapshot:{{resource_id}}`<pre>arn:aws:rds:us-east-1:{{1234567890}}:cluster-snapshot:{{sample-db-cluster-snapshot}}</pre> | 
| 서브넷 그룹(`subgrp`) | `arn:aws:rds:{{region}}:{{account_number}}:subgrp:{{resource_id}}`<pre>arn:aws:rds:us-east-1:{{1234567890}}:subgrp:{{sample-subnet-10}}</pre> | 

## Amazon DocumentDB 리소스 ARN 찾기
<a name="documentdb-arns-find"></a>

 AWS Management Console 또는를 사용하여 Amazon DocumentDB 리소스의 ARN을 찾을 수 있습니다 AWS CLI.

------
#### [ Using the AWS Management Console ]

콘솔을 사용해 ARN을 찾으려면 ARN을 보려는 리소스를 탐색하여 해당 리소스의 세부 정보를 확인합니다.

예를 들어, 클러스터 세부 정보 페이지의 **구성** 탭을 선택하여 클러스터의 ARN을 가져올 수 있습니다. 다음 스크린샷과 같이 **구성 및 상태** 섹션에서 ARN을 찾을 수 있습니다.

![세부 정보 창의 구성 및 상태 섹션에 있는 ARN을 보여주는 콘솔 스크린샷입니다.](https://docs.aws.amazon.com/ko_kr/documentdb/latest/devguide/images/documentdb-arn.png)


------
#### [ Using the AWS CLI ]

특정 Amazon DocumentDB 리소스에 AWS CLI 대해를 사용하여 ARN을 가져오려면 해당 리소스에 대한 `describe` 작업을 사용합니다. 다음 표에는 각 AWS CLI 작업과 작업과 함께 사용하여 ARN을 가져오는 ARN 속성이 나와 있습니다.


| AWS CLI 명령 | ARN 속성 | 
| --- | --- | 
| `describe-db-instances` | `DBInstanceArn` | 
| `describe-db-clusters` | `DBClusterArn` | 
| `describe-db-parameter-groups` | `DBParameterGroupArn` | 
| `describe-db-cluster-parameter-groups` | `DBClusterParameterGroupArn` | 
| `describe-db-security-groups` | `DBSecurityGroupArn` | 
| `describe-db-snapshots` | `DBSnapshotArn` | 
| `describe-db-cluster-snapshots` | `DBClusterSnapshotArn` | 
| `describe-db-subnet-groups` | `DBSubnetGroupArn` | 

**Example - 클러스터의 ARN 찾기**  
다음 AWS CLI 작업은 클러스터의 ARN을 찾습니다`sample-cluster`.  
Linux, macOS, Unix의 경우:  

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'
```
Windows의 경우:  

```
aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
[
    "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]
```

**Example - 여러 파라미터 그룹의 ARN 찾기**  
Linux, macOS, Unix의 경우:  

```
aws docdb describe-db-cluster-parameter-groups \
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'
```
Windows의 경우:  

```
aws docdb describe-db-cluster-parameter-groups ^
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
[
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp",
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6",
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6"
]
```

------