CopyClusterSnapshot - Amazon DocumentDB
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CopyClusterSnapshot

複製彈性叢集的快照。

請求語法

POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}

URI 請求參數

請求使用下列URI參數。

snapshotArn

彈性叢集快照的 Amazon Resource Name （ARN） 識別符。

必要：是

請求主體

請求接受下列JSON格式的資料。

targetSnapshotName

從來源叢集快照建立的新彈性叢集快照的識別符。此參數不區分大小寫。

約束:

  • 必須包含 1 到 63 個字母、數字或連字號。

  • 第一個字元必須是字母。

  • 不能以連字號結尾或連續包含兩個連字號。

範例：elastic-cluster-snapshot-5

類型：字串

長度限制：長度下限為 1。長度上限為 63。

必要：是

copyTags

設定為 true，將所有標籤從來源叢集快照複製到目標彈性叢集快照。預設值為 false。

類型：布林值

必要：否

kmsKeyId

加密彈性叢集快照的 AWS KMS金鑰 ID。金鑰 ID AWS KMS是加密金鑰的 AWS KMS Amazon Resource Name （ARN） AWS KMS、金鑰識別符或 AWS KMS金鑰別名。

如果您從 AWS 帳戶複製加密的彈性叢集快照，您可以指定 的值KmsKeyId，以使用新的 AWS S 加密金鑰KMS加密複本。如果您未指定 的值KmsKeyId，則彈性叢集快照的副本會使用與來源彈性叢集快照相同的AWSKMS金鑰加密。

如果您複製未加密的彈性叢集快照並指定 KmsKeyId 參數的值，則會傳回錯誤。

類型：字串

必要：否

tags

要指派給彈性叢集快照的標籤。

類型：字串到字串映射

索引鍵長度限制：長度下限為 1。長度上限為 128。

金鑰模式：^(?!aws:)[a-zA-Z+-=._:/]+$

值長度限制：最小長度為 0。長度上限為 256。

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}

回應元素

如果動作成功，服務會傳回 HTTP 200 個回應。

服務會以 JSON 格式傳回下列資料。

snapshot

傳回特定彈性叢集快照的相關資訊。

類型：ClusterSnapshot 物件

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

AccessDeniedException

當沒有足夠的許可來執行動作時發生例外狀況。

HTTP 狀態碼：403

ConflictException

存在存取衝突。

HTTP 狀態碼：409

InternalServerException

發生內部伺服器錯誤。

HTTP 狀態碼：500

ResourceNotFoundException

找不到指定的資源。

HTTP 狀態碼：404

ServiceQuotaExceededException

已超過動作的服務配額。

HTTP 狀態碼：402

ThrottlingException

ThrottlingException 將在請求因請求限流而遭拒時擲回 。

HTTP 狀態碼：429

ValidationException

定義驗證例外狀況的結構。

HTTP 狀態碼：400

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：