기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 인스턴스 수명 주기
Amazon DocumentDB 인스턴스의 수명 주기에는 인스턴스 생성, 수정, 유지 및 업그레이드, 백업 및 복원 수행, 재부팅 및 삭제가 포함됩니다. 이 섹션에서는 이러한 프로세스를 완료하는 방법에 관해 설명합니다.
**Topics**
+ [인스턴스 추가](db-instance-add.md)
+ [인스턴스 설명](db-instance-view-details.md)
+ [인스턴스 수정](db-instance-modify.md)
+ [인스턴스 재부팅](db-instance-reboot.md)
+ [인스턴스 삭제](db-instance-delete.md)
AWS Management Console 또는를 사용하여 새 Amazon DocumentDB 인스턴스를 생성할 수 있습니다 AWS CLI. 인스턴스를 클러스터에 추가하려면 클러스터가 *사용 가능* 상태에 있어야 합니다. 중지된 클러스터에는 인스턴스를 추가할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 클러스터가 *사용 가능*하게 될 때까지 기다린 다음 인스턴스를 추가합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
**참고**
콘솔을 사용하여 Amazon DocumentDB 클러스터를 작성하면 인스턴스가 동시에 자동으로 생성됩니다. 추가 인스턴스를 생성하려면 다음 절차 중 하나를 사용하세요.
# 클러스터에 Amazon DocumentDB 인스턴스 추가
------
#### [ Using the AWS Management Console ]
다음 절차에 따라 콘솔을 사용하여 클러스터에 대한 Amazon DocumentDB 인스턴스를 생성할 수 있습니다.
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. 인스턴스를 추가할 클러스터를 선택하려면 클러스터의 이름 왼쪽에 있는 버튼을 선택합니다.
1. **작업**을 선택한 다음 **인스턴스 추가**를 선택합니다.
1. **다음 항목에 인스턴스 추가: ** 페이지에서 클러스터에 추가하려는 각 인스턴스에 대해 다음 단계를 반복 실행합니다. 최대 15개까지 가능합니다.
1. **인스턴스 식별자** - 이 인스턴스의 고유 식별자를 입력하거나 Amazon DocumentDB가 클러스터 식별자를 기반으로 인스턴스 식별자를 제공하도록 허용할 수 있습니다.
인스턴스 명명 제약 조건:
+ 길이는 [1-63] 문자, 숫자 또는 하이픈입니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
+ 리전별로 Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스 AWS 계정에 대해 고유해야 합니다.
1. **인스턴스 클래스** - 드롭다운 목록에서 이 인스턴스에 대해 원하는 인스턴스 유형을 선택합니다.
1. **승격 계층** - 드롭다운 목록에서 인스턴스의 승격 계층을 선택하거나 *선호 없음*을 선택하여 Amazon DocumentDB가 인스턴스의 승격 계층을 설정할 수 있도록 합니다. 번호가 낮을수록 우선 순위가 높습니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오.
1. 더 많은 인스턴스를 추가하려면 **추가 인스턴스 추가**를 선택하고 a, b, c 단계를 반복합니다.
1. 작업을 완료합니다.
+ 클러스터에 인스턴스를 추가하려면 **생성**을 선택합니다.
+ 작업을 취소하려면 **취소**를 선택합니다.
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는 AWS CLI 를 사용하여 인스턴스의 상태를 볼 수 있습니다. 자세한 내용은 [인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
다음 파라미터와 함께 `create-db-instance` AWS CLI 작업을 사용하여 클러스터의 기본 인스턴스를 생성합니다.
+ **--db-instance-class** - 필수입니다. 인스턴스의 컴퓨팅 및 메모리 용량(예: `db.m4.large`)입니다. 모든 AWS 리전에서 모든 인스턴스 클래스를 사용할 수 있는 것은 아닙니다.
+ **--db-instance-identifier** - 필수입니다. 인스턴스를 식별하는 문자열입니다.
인스턴스 명명 제약:
+ 길이는 [1-63] 문자, 숫자 또는 하이픈입니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
+ 리전별로 Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스 AWS 계정에 대해 고유해야 합니다.
+ **--engine** — 필수입니다. `docdb`여야 합니다.
+ **--availability-zone** - 선택 사항. 이 인스턴스를 생성할 가용 영역입니다. 다른 가용 영역에서 인스턴스를 찾아서 내결함성을 높이려면 이 파라미터를 사용합니다. 자세한 내용은 [Amazon DocumentDB 고가용성 및 복제](replication.md) 섹션을 참조하십시오.
+ **--promotion-tier** - 선택 사항. 이 인스턴스의 장애 조치 우선 순위 계층입니다. 0\$115 사이여야 하며, 숫자가 작을수록 우선 순위가 높습니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오.
1. **먼저 인스턴스를 생성할 수 있는 가용 영역을 결정합니다.**
인스턴스를 생성하기 전에 사용 가능 영역을 지정하려면 다음 명령을 실행하여 Amazon DocumentDB 클러스터에 사용할 수 있는 가능 영역을 결정합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Windows의 경우:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **둘째, 리전에서 생성할 수 있는 인스턴스 클래스를 확인합니다.**
리전에서 사용 가능한 인스턴스 클래스를 확인하려면 다음 명령을 실행합니다. 출력에서 Amazon DocumentDB 클러스터에 추가할 인스턴스의 인스턴스 클래스를 선택합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Windows의 경우:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **마지막으로, Amazon DocumentDB 클러스터에 인스턴스를 추가합니다.**
인스턴스를 Amazon DocumentDB 클러스터에 추가하려면 다음 명령을 실행합니다..
Linux, macOS, Unix의 경우:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Windows의 경우:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는 AWS CLI 를 사용하여 인스턴스의 상태를 볼 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
# Amazon DocumentDB 인스턴스 설명
Amazon DocumentDB Management Console 또는 AWS CLI 을 사용하여 연결 엔드포인트, 보안 그룹 VPC, 인증 기관 및 Amazon DocumentDB 인스턴스와 관련된 매개 변수 그룹과 같은 세부 정보를 볼 수 있습니다.
------
#### [ Using the AWS Management Console ]
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. 인스턴스 목록에서 세부 정보를 볼 인스턴스의 이름을 선택합니다. 인스턴스에 대한 정보는 다음과 같은 그룹으로 구성됩니다.
+ **요약** - 엔진 버전, 클래스, 상태 및 보류 중인 유지 보수를 포함한 인스턴스에 대한 일반 정보입니다.
+ **연결 및 보안** - **연결** 섹션에는 mongo 쉘 또는 애플리케이션을 사용하여 이 인스턴스에 연결할 연결 엔드포인트가 나열됩니다. **보안 그룹** 섹션에는 이 인스턴스와 연결된 보안 그룹과 해당 VPC ID 및 설명이 나열됩니다.
+ **구성** - **세부 정보** 섹션에는 인스턴스의 Amazon 리소스 이름(ARN), 엔드포인트, 역할, 클래스 및 인증 기관을 포함하여 인스턴스의 구성 및 상태가 나열됩니다. 또한 인스턴스의 보안 및 네트워크 설정과 백업 정보가 나열됩니다. **클러스터 세부 정보** 섹션에는 이 인스턴스가 속한 클러스터의 세부 정보가 나열됩니다. **클러스터 인스턴스** 섹션에는 클러스터에 속한 모든 인스턴스가 각 인스턴스의 역할 및 클러스터 파라미터 그룹 상태와 함께 나열됩니다.
**참고**
**클러스터 디테일** 헤더 옆에 있는 **수정**을 선택하여 인스턴스와 연결된 클러스터를 수정할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 섹션을 참조하십시오.
+ **모니터링** - 이 인스턴스에 대한 CloudWatch Logs 지표. 자세한 내용은 [CloudWatch를 사용하여 Amazon DocumentDB 모니터링](cloud_watch.md) 섹션을 참조하십시오.
+ **이벤트 및 태그** — **최근 이벤트** 섹션에는 이 인스턴스의 최근 이벤트가 나열됩니다. Amazon DocumentDB는 클러스터, 인스턴스, 스냅샷, 보안 그룹 및 클러스터 매개 변수 그룹과 관련된 이벤트를 기록합니다. 이 정보에는 각 이벤트와 연결된 날짜, 시간 및 메시지가 포함됩니다. **태그** 섹션에는 이 클러스터에 연결된 태그가 나열됩니다. 자세한 내용은 [Amazon DocumentDB 리소스 태그 지정](tagging.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
를 사용하여 Amazon DocumentDB 인스턴스의 세부 정보를 보려면 아래 예제와 같이 `describe-db-clusters` 명령을 AWS CLI사용합니다. 자세한 내용은 *Amazon DocumentDB 리소스 관리 API 참조*에서 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html) 섹션을 참조하세요.
**참고**
클러스터 및 인스턴스 수명주기 관리와 같은 특정 관리 기능의 경우 Amazon DocumentDB는 Amazon RDS와 공유하는 운영 기술을 활용합니다. `filterName=engine,Values=docdb` 필터 파라미터는 Amazon DocumentDB 클러스터만 반환합니다.
1. **모든 Amazon DocumentDB 인스턴스를 나열합니다.**
다음 AWS CLI 코드는 리전의 모든 Amazon DocumentDB 인스턴스에 대한 세부 정보를 나열합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Windows의 경우:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **지정된 Amazon DocumentDB 인스턴스에 대한 모든 세부 정보 나열**
다음 코드는 `sample-cluster-instance`의 세부 정보를 나열합니다. 인스턴스 이름과 함께 `--db-instance-identifier` 파라미터를 포함하면 해당 특정 인스턴스에 대한 정보로 출력이 제한됩니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Windows의 경우:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
이 작업의 출력은 다음과 같습니다.
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# Amazon DocumentDB 인스턴스 수정
AWS Management Console 또는를 사용하여 Amazon DocumentDB 인스턴스를 수정할 수 있습니다 AWS CLI. 인스턴스를 수정하려면 인스턴스가 *사용 가능* 상태에 있어야 합니다. 중지된 인스턴스는 수정할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 인스턴스가 *사용 가능*하게 될 때까지 기다린 다음 원하는 대로 수정합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
------
#### [ Using the AWS Management Console ]
콘솔을 사용하여 특정 Amazon DocumentDB 인스턴스를 수정하려면 다음 단계를 완료합니다.
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. **작업**을 선택한 후 **수정**을 선택합니다.
1. **인스턴스 수정: ** 창에서 원하는 항목을 변경합니다. 다음과 같이 변경할 수 있습니다:
+ **인스턴스 규격** - 인스턴스 식별자 및 클래스. 인스턴스 식별자 명명 제약 조건:
+ **인스턴스 식별자** - 현재 리전 AWS 계정 에서가 소유한 모든 인스턴스에 대해 고유한 이름을 입력합니다. 인스턴스 식별자는 [1-63]개의 영숫자 또는 하이픈을 포함해야 하며 첫 번째 문자로 문자가 있어야 하며 하이픈으로 끝나거나 연속적으로 두 개의 하이픈을 포함할 수 없습니다.
+ **인스턴스 클래스** — 드롭다운 메뉴에서 Amazon DocumentDB 인스턴스의 인스턴스 클래스를 선택합니다. 자세한 내용은 [인스턴스 클래스 관리](db-instance-classes.md) 섹션을 참조하십시오.
+ **인증서 권한** - 인스턴스의 서버 인증서입니다. 자세한 내용은 [Amazon DocumentDB TLS 인증서 업데이트](ca_cert_rotation.md) 섹션을 참조하십시오.
+ **장애 조치** - 장애 조치 중에 가장 높은 승격 계층을 가진 인스턴스가 기본으로 승격됩니다. 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 섹션을 참조하십시오.
+ **관리** - 보류 중인 수정 또는 패치가 클러스터의 인스턴스에 적용되는 유지 관리 창입니다.
1. 작업을 마쳤으면 **계속**을 선택하여 변경 사항의 요약을 확인합니다.
1. 변경 사항을 확인한 후 즉시 적용하거나 **수정 일정** 아래의 다음 유지 관리 기간 중에 적용할 수 있습니다. **인스턴스 수정**를 선택하여 변경 사항을 저장합니다. 또는 **취소**를 선택하여 변경 사항을 취소할 수 있습니다.
변경 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
를 사용하여 특정 Amazon DocumentDB 인스턴스를 수정하려면 다음 파라미터`modify-db-instance`와 함께를 AWS CLI사용합니다. 자세한 내용은 [ModifyDBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)을 참조하세요. 다음 코드는 `sample-instance` 인스턴스에 대한 인스턴스 클래스를 `db.r5.large`로 수정합니다.
**파라미터**
+ **--db-instance-identifier** - 필수입니다. 수정할 인스턴스의 식별자입니다.
+ **--db-instance-class** - 선택 사항. 인스턴스의 새 컴퓨팅 및 메모리 용량입니다(예: `db.r5.large`). 모든 AWS 리전에서 모든 인스턴스 클래스를 사용할 수 있는 것은 아닙니다. 인스턴스 클래스를 수정하면 변경 중에 중단이 발생합니다. 이 요청에 대해 `ApplyImmediately`이 true로 지정되지 않은 경우 다음 유지 관리 기간 동안 변경 사항이 적용됩니다.
+ **--apply-immediately** 또는 **--no-apply-immediately** - 선택 사항. 이 수정을 즉시 적용할지 다음 유지 관리 기간까지 대기할지 여부를 지정합니다. 이 파라미터를 생략하면 다음 유지 관리 기간 중에 수정이 수행됩니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Windows의 경우:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
수정 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. AWS Management Console 또는를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다 AWS CLI. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
# Amazon DocumentDB 인스턴스 재부팅
보통 유지보수의 이유로 Amazon DocumentDB 인스턴스를 재부팅해야 하는 경우가 있습니다. 특정 항목을 변경한 경우(예: 클러스터와 연결된 클러스터 파라미터 그룹 변경) 클러스터의 인스턴스를 재부팅해야 변경 내용이 적용됩니다. AWS Management Console 또는를 사용하여 지정된 인스턴스를 재부팅할 수 있습니다 AWS CLI.
인스턴스를 재부팅하면 데이터베이스 엔진 서비스가 재시작됩니다. 재부팅하면 DB 인스턴스 상태가 `rebooting`으로 설정되면서 잠시 중단됩니다. 재부팅이 완료되면 Amazon DocumentDB 이벤트가 생성됩니다.
인스턴스를 재부팅해도 장애 조치가 발생하지 않습니다. Amazon DocumentDB 클러스터를 장애 조치하려면 AWS Management Console 또는 AWS CLI 작업을 사용합니다`failover-db-cluster`. 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 단원을 참조하십시오.
*사용 가능* 상태가 아닌 경우 인스턴스를 재부팅할 수 없습니다. 이전에 수정을 요청했거나 유지 관리 기간 작업 등 여러 가지 이유로 데이터베이스를 사용할 수 없는 경우가 있습니다. 인스턴스 상태에 대한 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하세요.
------
#### [ 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. **작업**을 선택하고 **재부팅**을 선택한 다음 **재부팅**을 선택하여 재부팅을 확인합니다.
인스턴스가 재부팅되는 데 몇 분 정도 걸릴 수 있습니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
Amazon DocumentDB 인스턴스를 재부팅하려면 `--db-instance-identifier` 파라미터와 함께 `reboot-db-instance` 작업을 사용합니다. 이 파라미터는 재부팅할 인스턴스의 식별자를 지정합니다.
다음 코드는 `sample-instance` 인스턴스를 재부팅합니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Windows의 경우:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
인스턴스가 재부팅되는 데 몇 분 정도 걸릴 수 있습니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
# Amazon DocumentDB 인스턴스 삭제
AWS Management Console 또는를 사용하여 Amazon DocumentDB 인스턴스를 삭제할 수 있습니다 AWS CLI. 인스턴스를 삭제하려면 인스턴스가 *사용 가능* 상태에 있어야 합니다. 중지된 인스턴스는 삭제할 수 없습니다. 인스턴스가 포함된 Amazon DocumentDB 클러스터가 중지된 경우 먼저 클러스터를 시작하고 인스턴스가 *사용 가능*해질 때까지 기다렸다가 인스턴스를 삭제합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
**참고**
Amazon DocumentDB에서는 모든 데이터를 클러스터 볼륨에 저장합니다. 모든 인스턴스를 클러스터에서 제거하는 경우에도 데이터가 클러스터 볼륨에 유지됩니다. 데이터에 다시 액세스해야 하는 경우 언제든지 클러스터에 인스턴스를 추가하고 중단한 지점을 선택할 수 있습니다.
------
#### [ Using the AWS Management Console ]
다음 절차에서는 콘솔을 사용하여 지정된 Amazon DocumentDB 인스턴스를 삭제합니다.
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. **작업**을 선택한 후 **삭제**를 선택합니다.
1. 클러스터의 마지막 인스턴스를 삭제하는 경우:
+ **최종 클러스터 스냅샷을 생성하시겠습니까?** — 클러스터를 삭제하기 전에 최종 스냅샷을 생성하려면 **예**를 선택합니다. 그렇지 않은 경우 **아니요**를 선택합니다.
+ **최종 스냅샷 이름** - 최종 스냅샷을 생성하도록 선택한 경우 생성된 새 클러스터 스냅샷의 클러스터 스냅샷 식별자를 입력합니다.
+ ** 인스턴스를 삭제하시겠습니까?** — 삭제 확인을 위해 **전체 클러스터 삭제**라는 문구를 필드에 입력합니다.
1. 클러스터의 마지막 인스턴스를 삭제하지 않는 경우:
+ ** 인스턴스를 삭제하시겠습니까?** — **삭제** 라는 문구를 필드에 입력하여 삭제를 확인합니다.
1. **삭제**를 선택하여 인스턴스를 삭제합니다.
인스턴스를 삭제하는 데 몇 분 정도 걸립니다. 인스턴스 상태를 모니터링하려면 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하십시오.
------
#### [ Using the AWS CLI ]
다음 절차는 AWS CLI을 사용하여 Amazon DocumentDB 인스턴스를 삭제합니다.
1. **먼저 Amazon DocumentDB 클러스터에 몇 개의 인스턴스가 있는지 확인합니다:**
클러스터에 있는 인스턴스 수를 확인하려면 다음과 같이 `describe-db-clusters` 명령을 실행합니다.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Amazon DocumentDB 클러스터에 인스턴스가 두 개 이상 있는 경우:**
지정된 Amazon DocumentDB 인스턴스를 삭제하려면 아래와 같이 `delete-db-instance` 명령을 `--db-instance-identifier` 파라미터와 함께 사용합니다. 인스턴스를 삭제하는 데 몇 분 정도 걸립니다. 인스턴스 상태를 모니터링하려면 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하십시오.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **삭제할 인스턴스가 Amazon DocumentDB 클러스터의 마지막 인스턴스인 경우:**
Amazon DocumentDB 클러스터의 마지막 인스턴스를 삭제하는 경우 해당 클러스터와 해당 클러스터에 연결된 자동 스냅샷 및 연속 백업도 삭제합니다.
클러스터의 마지막 인스턴스를 삭제하려면 클러스터를 삭제하고 선택적으로 최종 스냅샷을 생성할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하십시오.
------
## 삭제 방지
또한 Amazon DocumentDB 클러스터의 마지막 인스턴스를 삭제하면 해당 클러스터와 관련된 자동 스냅샷 및 연속 백업뿐만 아니라 클러스터도 삭제됩니다. Amazon DocumentDB는 AWS Management Console 또는를 사용하여 삭제 작업을 수행하든 관계없이 클러스터에 대한 삭제 보호를 적용합니다 AWS CLI. 삭제 방지가 활성화되어 있으면 클러스터를 삭제할 수 없습니다.
삭제 방지가 활성화된 클러스터를 삭제하려면 먼저 클러스터를 수정하고 삭제 방지를 비활성화해야 합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하십시오.