ModifyDBClusterSnapshotAttribute - Amazon DocumentDB

ModifyDBClusterSnapshotAttribute

속성 및 값을 수동 클러스터 스냅샷에 추가하거나, 수동 DB 클러스터 스냅샷에서 속성 및 값을 제거합니다.

수동 클러스터 스냅샷을 다른 AWS 계정과 공유하려면 restoreAttributeName로 지정하고 ValuesToAdd 파라미터를 사용하여 수동 클러스터 스냅샷을 복원할 권한이 있는 AWS 계정의 ID 목록을 추가합니다. 수동 클러스터 스냅샷을 모든 AWS 계정에서 복사하거나 복원할 수 있는 퍼블릭 스냅샷으로 만들려면 all 값을 사용하십시오. 모든 AWS 계정에는 제공하지 않을 비공개 정보가 포함된 수동 클러스터 스냅샷에는 all 값을 추가하지 마십시오. 수동 클러스터 스냅샷이 암호화되어 있으면 공유할 수 있지만, 그러려면 반드시 ValuesToAdd 파라미터에 권한 있는 AWS 계정의 ID 목록을 지정해야 합니다. 이 경우에는 해당 파라미터 값으로 all을 사용할 수 없습니다.

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.

AttributeName

수정할 클러스터 스냅샷 속성의 이름입니다.

다른 AWS 계정에서 수동 DB 클러스터 스냅샷을 복사하거나 복원할 수 있도록 권한 부여를 관리하려면 이 값을 restore로 설정하십시오.

유형: 문자열

필수 항목 여부: 예

DBClusterSnapshotIdentifier

속성을 수정할 클러스터 스냅샷의 식별자입니다.

유형: 문자열

필수 항목 여부: 예

ValuesToAdd.AttributeValue.N

AttributeName에 지정된 속성에 추가할 클러스터 스냅샷 속성의 목록입니다.

다른 사람이 수동 클러스터 스냅샷을 복사하거나 AWS 계정 복원하도록 승인하려면 하나 이상의 AWS 계정 ID를 포함하도록 이 목록을 설정하십시오. 누구든지 AWS 계정 수동 클러스터 스냅샷을 복원할 수 있게 하려면 all로 설정하십시오. 모든 AWS 계정에는 제공하지 않을 비공개 정보가 포함된 수동 클러스터 스냅샷에는 all 값을 추가하지 마십시오.

유형: 문자열 배열

필수 항목 여부: 아니요

ValuesToRemove.AttributeValue.N

AttributeName에 지정된 속성에서 제거할 클러스터 스냅샷 속성의 목록입니다.

다른 사람이 수동 클러스터 스냅샷을 복사하거나 AWS 계정 복원하도록 승인을 제거하려면 하나 이상의 AWS 계정 ID를 포함하도록 이 목록을 설정하십시오. 클러스터 스냅샷을 복사하거나 복원할 수 있는 AWS 계정의 권한을 제거하려면 all로 설정하십시오. all을 지정하더라도 restore 속성에 계정 ID가 명시적으로 추가되어 있는 AWS 계정은 여전히 수동 클러스터 스냅샷을 복사하거나 복원할 수 있습니다.

유형: 문자열 배열

필수 항목 여부: 아니요

응답 요소

서비스에서 다음 요소를 반환합니다.

DBClusterSnapshotAttributesResult

클러스터 스냅샷과 관련된 특성에 대한 상세 정보입니다.

유형: DBClusterSnapshotAttributesResult 객체

오류

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier은 기존 클러스터 스냅샷을 참조하지 않습니다.

HTTP 상태 코드: 404

InvalidDBClusterSnapshotStateFault

제공된 값은 유효한 클러스터 스냅샷 상태가 아닙니다.

HTTP 상태 코드: 400

SharedSnapshotQuotaExceeded

수동 DB 스냅샷을 공유할 수 있는 최대 계정 수를 초과했습니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.