Amazon DocumentDB 인스턴스 수정 - Amazon DocumentDB

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

Amazon DocumentDB 인스턴스 수정

AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 인스턴스를 수정할 수 있습니다. 인스턴스를 수정하려면 인스턴스가 사용 가능 상태에 있어야 합니다. 중지된 인스턴스는 수정할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 인스턴스가 사용 가능하게 될 때까지 기다린 다음 원하는 대로 수정합니다. 자세한 내용은 Amazon DocumentDB 클러스터 중지 및 시작 섹션을 참조하세요.

Using the AWS Management Console

콘솔을 사용하여 특정 Amazon DocumentDB 인스턴스를 수정하려면 다음 단계를 완료합니다.

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

  2. 탐색 창에서 클러스터를 선택합니다.

    작은 정보

    화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(Hamburger menu icon with three horizontal lines.)을 선택합니다.

  3. 클러스터 탐색 상자에 클러스터 식별자 열이 표시됩니다. 아래 스크린샷과 유사한 클러스터 아래에 인스턴스가 나열됩니다.

    DocumentDB clusters list showing two clusters with their identifiers and roles.

  4. 수정할 인스턴스의 왼쪽에 있는 상자를 선택합니다.

  5. 작업을 선택한 후 수정을 선택합니다.

  6. 인스턴스 수정: <instance-name> 창에서 원하는 항목을 변경합니다. 다음과 같이 변경할 수 있습니다:

    • 인스턴스 규격 - 인스턴스 식별자 및 클래스. 인스턴스 식별자 명명 제약 조건:

      • 인스턴스 식별자 - 현재 리전에서 소유한 모든 인스턴스에 대해 고유한 이름을 입력합니다 AWS 계정. 인스턴스 식별자는 [1-63]개의 영숫자 또는 하이픈을 포함해야 하며 첫 번째 문자로 문자가 있어야 하며 하이픈으로 끝나거나 연속적으로 두 개의 하이픈을 포함할 수 없습니다.

      • 인스턴스 클래스 — 드롭다운 메뉴에서 Amazon DocumentDB 인스턴스의 인스턴스 클래스를 선택합니다. 자세한 내용은 인스턴스 클래스 관리 섹션을 참조하세요.

    • 인증서 권한 - 인스턴스의 서버 인증서입니다. 자세한 내용은 Amazon DocumentDB TLS 인증서 업데이트 섹션을 참조하세요.

    • 장애 조치 - 장애 조치 중에 가장 높은 승격 계층을 가진 인스턴스가 기본으로 승격됩니다. 자세한 내용은 Amazon DocumentDB 장애 조치 섹션을 참조하세요.

    • 관리 - 보류 중인 수정 또는 패치가 클러스터의 인스턴스에 적용되는 유지 관리 창입니다.

  7. 작업을 마쳤으면 계속을 선택하여 변경 사항의 요약을 확인합니다.

  8. 변경 사항을 확인한 후 즉시 적용하거나 수정 일정 아래의 다음 유지 관리 기간 중에 적용할 수 있습니다. 인스턴스 수정를 선택하여 변경 사항을 저장합니다. 또는 취소를 선택하여 변경 사항을 취소할 수 있습니다.

변경 사항을 적용하는 데 몇 분 정도 걸립니다. 사용 가능 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 Amazon DocumentDB 인스턴스 상태 모니터링 섹션을 참조하세요.

Using the AWS CLI

AWS CLI를 사용하여 특정 Amazon DocumentDB 인스턴스를 수정하려면 다음 파라미터와 함께 modify-db-instance를 사용합니다. 자세한 내용은 ModifyDBInstance을 참조하세요. 다음 코드는 sample-instance 인스턴스에 대한 인스턴스 클래스를 db.r5.large로 수정합니다.

파라미터

  • --db-instance-identifier — 필수입니다. 수정할 인스턴스의 식별자입니다.

  • --db-instance-class - 선택 사항. 인스턴스의 새 컴퓨팅 및 메모리 용량입니다(예: db.r5.large). 모든 AWS 리전에서 모든 인스턴스 클래스를 사용할 수 있는 것은 아닙니다. 인스턴스 클래스를 수정하면 변경 중에 중단이 발생합니다. 이 요청에 대해 ApplyImmediately이 true로 지정되지 않은 경우 다음 유지 관리 기간 동안 변경 사항이 적용됩니다.

  • --apply-immediately 또는 --no-apply-immediately - 선택 사항. 이 수정을 즉시 적용할지 다음 유지 관리 기간까지 대기할지 여부를 지정합니다. 이 파라미터를 생략하면 다음 유지 관리 기간 중에 수정이 수행됩니다.

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 인스턴스 상태 모니터링 섹션을 참조하세요.