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

# 인스턴스의 엔드포인트 찾기
<a name="db-instance-endpoint-find"></a>

Amazon DocumentDB 콘솔 또는 AWS CLI을 사용하여 인스턴스의 엔드포인트를 찾을 수 있습니다.

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

**콘솔을 사용하여 인스턴스의 엔드포인트를 찾으려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.

1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**  
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.

1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.  
![\[클러스터 식별자 열 아래에 인스턴스가 클러스터 내에 중첩된 클러스터 목록을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)

1. 관심 있는 인스턴스의 왼쪽에 있는 확인란을 체크합니다.

1. 아래로 스크롤하여 **세부 정보** 섹션으로 이동한 다음 인스턴스 엔드포인트를 찾습니다.  
![\[인스턴스 엔드포인트가 강조 표시된 세부 정보 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-instance-endpoint.png)

1. 이 인스턴스에 연결하려면 위로 스크롤하여 **연결** 섹션으로 이동합니다. `mongo` 쉘에 대한 연결 문자열과 애플리케이션 코드에서 인스턴스에 연결하는 데 사용할 수 있는 연결 문자열을 찾습니다.  
![\[Mongo 쉘 및 애플리케이션 연결 문자열이 강조 표시된 연결 섹션을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/instance-connection-strings.png)

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

AWS CLI를 사용하여 인스턴스 엔드포인트를 찾으려면 다음 명령을 해당 인수와 함께 실행합니다.

**인수**
+ **--db-instance-identifier**—선택 사항. 엔드포인트를 반환하려는 인스턴스를 지정합니다. 생략한 경우 최대 100개의 인스턴스에 대한 엔드포인트를 반환합니다.
+ **--query**—선택 사항. 표시할 필드를 지정합니다. 엔드포인트를 찾기 위해 볼 데이터의 양을 줄여서 도와줍니다. 생략하면 인스턴스에 대한 모든 정보가 반환됩니다. `Endpoint` 필드에는 세 개의 멤버가 있습니다. 따라서 다음 예제와 같이 쿼리에 나열하면 세 멤버가 모두 반환됩니다. `Endpoint` 멤버 중 일부에만 관심이 있는 경우 두 번째 예제와 같이 쿼리의 `Endpoint`를 원하는 멤버로 교체하세요.
+ **--region**—선택 사항. `--region` 파라미터를 사용하여 명령을 적용할 리전을 지정합니다. 생략하면 기본 리전이 사용됩니다.

**Example**  
Linux, macOS, Unix의 경우:  

```
aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Windows의 경우:  

```
aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
[
    [
        "sample-cluster-instance",
        {
            "Port": 27017,
            "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
            "HostedZoneId": "Z2R2ITUGPM61AM"
        }
    ]
]
```
엔드포인트의 `HostedZoneId`를 제거하기 위해 출력을 줄이고 `Endpoint.Port` 및 `Endpoint.Address`를 지정하여 쿼리를 수정할 수 있습니다.  
Linux, macOS, Unix의 경우:  

```
aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Windows의 경우:  

```
aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
[
    [
        "sample-cluster-instance",
        27017,
        "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
    ]
]
```

인스턴스 엔드포인트가 있으므로 이제 `mongo` 또는 `mongodb`를 사용하여 인스턴스에 연결할 수 있습니다. 자세한 내용은 [엔드포인트에 연결](endpoints-connecting.md) 섹션을 참조하세요.

------