Atlas cluster 업데이트
지정된 클러스터의 설정을 수정합니다.
--file 플래그를 사용하여 JSON 구성 파일에서 수정 사항을 지정할 수 있습니다.
cluster 이름을 변경하거나 cluster의 MongoDB 버전을 다운그레이드할 수 없습니다.
복제본 세트는 단일 샤드 클러스터로만 업데이트할 수 있습니다. 복제본 세트를 멀티 샤드 클러스터로 업데이트할 수 없습니다. 자세한 내용은 https://www.mongodb.com/ko-kr/docs/atlas/ scale-cluster/#convert-a-replica-set- to-a-sharded-cluster 및 https://www.mongodb.com/ko-kr/docs/upcoming/tutorial/convert-replica-set-to-replicated-shard-cluster.
이 명령을 사용하려면 프로젝트 cluster 관리자 역할이 있는 사용자 계정 또는 API 키로 인증해야 합니다. Atlas는 M10+ cluster에 대해서만 이 명령을 지원합니다.
구문
atlas clusters update [clusterName] [options]
arguments
이름 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
clusterName | 문자열 | 거짓 | 업데이트할 cluster의 이름입니다. |
옵션
이름 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
--disableTerminationProtection | 거짓 | cluster에 대한 종료 방지 기능을 비활성화합니다. 종료 방지 기능이 비활성화된 cluster를 삭제할 수 있습니다. --enableTerminationProtection, --file과 상호 배타적입니다. | |
--diskSizeGB | float | 거짓 | 호스트 루트 볼륨의 용량(단위: 기가바이트[GB])입니다. --file과 상호 배타적입니다. |
--enableTerminationProtection | 거짓 | cluster에 대한 종료 방지 기능을 활성화합니다. 종료 방지 기능이 활성화된 cluster는 삭제할 수 없습니다. --disableTerminationProtection, --file과 상호 배타적입니다. | |
-f, --file | 문자열 | 거짓 | 클러스터 설정을 정의하는 선택적 JSON 구성 파일의 경로입니다. Atlas CLI의 클러스터 구성 파일에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/cluster-config-file-atlascli를 참조하세요. --tier, --diskSizeGB, --enableTerminationProtection, --disableTerminationProtection, --tag와 상호 배타적입니다. |
-h, --help | 거짓 | 업데이트 도움말 | |
--mdbVersion | 문자열 | 거짓 | 클러스터의 주요 MongoDB 버전입니다. |
-o, --output | 문자열 | 거짓 | 출력 형식입니다. 유효한 값은 json, json-path, go-템플릿 또는 go-템플릿 파일입니다. 전체 출력을 보려면 -o json 옵션을 사용합니다. |
--projectId | 문자열 | 거짓 | 사용할 프로젝트를 식별하는 16진수 문자열입니다. 이 옵션은 구성 파일 또는 환경 변수의 설정을 재정의합니다. |
--tag | 키=값 | 거짓 | 클러스터에 태그를 지정하고 분류하기 위한 1~255자 길이의 키-값 쌍이 포함된 목록입니다. 이 플래그를 전달하면 기존 데이터가 대체됩니다. --file과 상호 배타적입니다. |
--tier | 문자열 | 거짓 | 클러스터의 각 데이터 보유 서버에 대한 계층. 클러스터 계층에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/cluster-tier-atlas를 참조하세요. --file과 상호 배타적입니다. |
상속된 옵션
이름 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
-P, --profile | 문자열 | 거짓 | 구성 파일에서 사용할 프로필의 이름입니다. Atlas CLI의 프로필에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings를 참조하세요. |
출력
명령이 성공하면 Atlas CLI는 다음 샘플과 유사한 출력을 반환합니다. 괄호 안의 값은 사용자의 값을 나타냅니다.
Updating cluster '<Name>'.
예제
# Update the tier for a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --tier M50
# Replace tags cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --tag key1=value1
# Remove all tags from cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --tag =
# Update the disk size for a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --diskSizeGB 20
# Update the MongoDB version for a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --mdbVersion 5.0
# Use a configuration file named cluster-config.json to update a cluster named myCluster for the project with ID 5e2211c17a3e5a48f5497de3: atlas cluster update myCluster --projectId 5e2211c17a3e5a48f5497de3 --file cluster-config.json --output json