기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 클러스터 수정
클러스터를 수정하려면 클러스터가 *사용 가능* 상태에 있어야 합니다. 중지된 클러스터는 수정할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 클러스터가 *사용 가능*하게 될 때까지 기다린 다음 원하는 대로 수정합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
------
#### [ Using the AWS Management Console ]
다음 절차에 따라 콘솔을 사용하여 특정 Amazon DocumentDB 클러스터를 수정합니다.
**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. **클러스터 수정: ** 창에서 원하는 항목을 변경합니다. 다음 영역에서 변경할 수 있습니다.
+ **클러스터 사양** - 클러스터의 이름, 보안 그룹 및 자격 증명 관리입니다.
+ **클러스터 스토리지 구성** - 클러스터의 데이터 스토리지 모드입니다. 표준 구성과 I/O 최적화 구성 중에서 선택합니다.
+ **클러스터 옵션** - 클러스터의 포트 및 파라미터 그룹.
+ **백업** - 클러스터의 백업 보존 기간 및 백업 기간.
+ **로그 내보내기** - 감사 또는 프로파일러 로그 내보내기 활성화 또는 비활성화.
+ **유지 관리** - 클러스터의 유지 관리 기간 설정.
+ **삭제 방지** - 클러스터에서 삭제 방지 활성화 또는 비활성화. 삭제 방지 기능은 기본적으로 활성화됩니다.
1. 작업을 마쳤으면 **계속**을 선택하여 변경 사항의 요약을 확인합니다.
1. 변경 사항이 만족스러우면 **클러스터 수정**을 선택하여 클러스터를 수정할 수 있습니다. 또는 **뒤로** 또는 **취소**를 선택하여 각각 변경 사항을 편집하거나 취소할 수 있습니다.
변경 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 클러스터를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 클러스터의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
`modify-db-cluster` 작업에 따라 AWS CLI를 사용하여 지정된 클러스터를 수정합니다. 자세한 내용은 *Amazon DocumentDB API 참조*의 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) 섹션을 참조하세요.
**파라미터**
+ **--db-cluster-identifier** - 필수입니다. 수정하려는 Amazon DocumentDB 클러스터의 식별자입니다.
+ **--backup-retention-period** - 선택 사항. 자동 백업이 보존되는 일수입니다. 유효한 값은 1–35입니다.
+ **--storage-type** - 선택 사항. 클러스터 스토리지 구성입니다. 유효한 값은 `standard` (표준) 또는 `iopt1` (I/O 최적화)입니다.
+ **--db-cluster-parameter-group-name** - 선택 사항. 클러스터에 사용할 클러스터 파라미터 그룹의 이름입니다.
+ **--manage-master-user-password** - 선택 사항. Amazon DocumentDB가 Secrets Manager에서 마스터 사용자 암호를 생성하고 해당 수명 주기 동안 이를 관리합니다.
+ **--rotate-master-user-password** - 선택 사항. Secrets Manager는 기존 보안 암호에 대한 새 보안 암호 버전을 생성합니다. 새 버전의 보안 암호에는 새 기본 사용자 암호가 포함됩니다. Amazon RDSAurora는 새 보안 암호 버전의 암호와 일치하도록 클러스터의 기본 사용자 암호를 변경합니다.
기본 암호를 교체할 때 **--apply-immediately** 옵션을 지정해야 합니다.
+ **--master-user-password** - 선택 사항. 기본 데이터베이스 사용자의 새 암호입니다.
암호 제약:
+ 길이는 [8-100]자의 인쇄 가능한 ASCII 문자입니다.
+ 다음을 제외한 인쇄 가능한 ASCII 문자를 사용할 수 있습니다.
+ **/**(슬래시)
+ **"**(큰 따옴표)
+ **@**(at 기호)
+ **--new-db-cluster-identifier** - 선택 사항. 클러스터의 이름을 변경할 때 클러스터의 새 클러스터 식별자입니다. 이 값은 소문자 문자열로 저장됩니다.
명명 제약 조건:
+ 길이는 [1\$163] 글자, 숫자 또는 하이픈입니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
+ 리전별로 Amazon RDS, Amazon Neptune 및 Amazon DocumentDB의 모든 클러스터 AWS 계정에 대해 고유해야 합니다.
+ **--preferred-backup-window** - 선택 사항. 자동 백업이 생성되는 일별 시간 범위를 UTC(협정 세계시)로 표시합니다.
+ 형식: `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window** - 선택 사항. 시스템 유지 관리를 실행할 수 있는 주 단위 시간 범위(UTC)입니다.
+ 형식: `ddd:hh24:mm-ddd:hh24:mm`
+ 유효한 요일: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, `Sat`
+ **--deletion-protection** 또는 **--no-deletion-protection** - 선택 사항. 이 클러스터에서 삭제 방지를 활성화해야 하는지 여부. 삭제 방지는 삭제 방지를 비활성화하도록 클러스터를 수정할 때까지 실수로 클러스터가 삭제되는 것을 방지합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하십시오.
+ **--apply-immediately** 또는 **--no-apply-immediately** - `--apply-immediately`를 사용하여 즉시 변경합니다. `--no-apply-immediately`를 사용하여 클러스터의 다음 유지 관리 기간에 변경합니다.
**Example**
다음 코드는 클러스터 `sample-cluster`에 대한 백업 보존 기간을 변경합니다.
Linux, macOS, Unix의 경우:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Windows의 경우:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
변경 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 클러스터를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 클러스터의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 단원을 참조하십시오.
------