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

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

RestoreClusterFromSnapshot

從快照還原彈性叢集。

請求語法

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

{
   "clusterName": "string",
   "kmsKeyId": "string",
   "shardCapacity": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}

URI 請求參數

請求會使用下列 URI 參數。

snapshotArn

彈性叢集快照集的 ARN 識別碼。

必要：是

請求主體

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

clusterName

彈性叢集的名稱。

類型：字串

必要：是

kmsKeyId

用來加密新 Amazon DocumentDB 彈性叢集叢集的 KMS 金鑰識別碼。

KMS 金鑰識別符是 KMS 加密金鑰的 Amazon Resource Name (ARN)。如果您使用擁有此 KMS 加密金鑰的相同 Amazon 帳戶建立叢集，則可以使用 KMS 金鑰別名而非 ARN 做為 KMS 加密金鑰。

如果未在此處指定加密金鑰，Amazon DocumentDB 會使用 KMS 為您的帳戶建立的預設加密金鑰。您的帳戶對每個 Amazon 區域都有不同的預設加密金鑰。

類型：字串

必要：否

shardCapacity

新還原的彈性叢集中每個碎片的容量。

類型：整數

必要：否

shardInstanceCount

套用至彈性叢集中所有碎片的複本執行個體數目。shardInstanceCount值 1 表示有一個寫入器執行個體，而任何其他執行個體都是可用於讀取和改善可用性的複本。

類型：整數

必要：否

subnetIds

彈性叢集的 Amazon EC2 子網路 ID。

類型：字串陣列

必要：否

tags

要分配給恢復的彈性集群的標籤名稱的列表，以鍵值對數組的形式，其中鍵是標籤名稱，值是鍵值。

類型：字串到字串映射

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

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

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

必要：否

vpcSecurityGroupIds

要與彈性叢集關聯的 EC2 VPC 安全群組清單。

類型：字串陣列

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}

回應元素

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

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

cluster

傳回還原之彈性叢集的相關資訊。

類型：Cluster 物件

錯誤

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

AccessDeniedException

當沒有足夠的權限執行動作時，就會發生例外狀況。

HTTP 狀態碼：403

ConflictException

存取衝突。

HTTP 狀態碼：409

InternalServerException

發生內部伺服器錯誤。

HTTP 狀態碼：500

ResourceNotFoundException

找不到指定的資源。

HTTP 狀態碼：404

ServiceQuotaExceededException

超出動作的服務配額。

狀態碼：

ThrottlingException

ThrottlingException 當請求被拒絕時，由於請求限制將被拋出。

HTTP 狀態碼：429

ValidationException

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

HTTP 狀態碼：400

另請參閱

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