

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

# Amazon DocumentDB 인스턴스 수정
<a name="db-instance-modify"></a>

 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. **인스턴스 수정: <instance-name>** 창에서 원하는 항목을 변경합니다. 다음과 같이 변경할 수 있습니다:
   + **인스턴스 규격** - 인스턴스 식별자 및 클래스. 인스턴스 식별자 명명 제약 조건:
     + **인스턴스 식별자** - 현재 리전 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) 단원을 참조하십시오.

------