StartRestoreJob - AWS Backup
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

StartRestoreJob

復原由 Amazon Resource Name （） 識別的已儲存資源ARN。

請求語法

PUT /restore-jobs HTTP/1.1
Content-type: application/json

{
   "CopySourceTagsToRestoredResource": boolean,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Metadata": { 
      "string" : "string" 
   },
   "RecoveryPointArn": "string",
   "ResourceType": "string"
}

URI 請求參數

請求不會使用任何URI參數。

請求主體

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

CopySourceTagsToRestoredResource

這是選擇性的參數。如果此參數等於 True，則備份中包含的標籤將複製到還原的資源。

這僅適用於透過 建立的備份 AWS Backup。

類型：布林值

必要：否

IamRoleArn

AWS Backup 用於建立目標資源IAM的角色的 Amazon Resource Name （ARN）；例如：arn:aws:iam::123456789012:role/S3Access。

類型：字串

必要：否

IdempotencyToken

客戶所選擇的字串，可用來區分在其他方面相同的 StartRestoreJob 呼叫。重試具有相同等冪性字符的成功請求會導致出現成功消息，但未執行任何動作。

類型：字串

必要：否

Metadata

一組中繼資料鍵值對。

您可以在備份資源時，透過呼叫 GetRecoveryPointRestoreMetadata 取得有關資源的組態中繼資料。但是，除了 GetRecoveryPointRestoreMetadata 提供的值之外，還可能需要還原資源。例如，如果原始資源已存在，您可能需要提供新資源名稱。

如需每個資源中繼資料的詳細資訊，請參閱下列內容：

類型：字串到字串映射

必要：是

RecoveryPointArn

唯一識別復原點ARN的 ；例如 arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。

類型：字串

必要：是

ResourceType

請開始作業以還原下列其中一個資源的復原點：

  • Aurora - Amazon Aurora

  • DocumentDB - Amazon DocumentDB

  • CloudFormation - AWS CloudFormation

  • DynamoDB - Amazon DynamoDB

  • EBS - Amazon Elastic Block Store

  • EC2 - Amazon Elastic Compute Cloud

  • EFS - Amazon Elastic File System

  • FSx - Amazon FSx

  • Neptune - Amazon Neptune

  • RDS - Amazon Relational Database Service

  • Redshift - Amazon Redshift

  • Storage Gateway - AWS Storage Gateway

  • S3 - Amazon Simple Storage Service

  • Timestream - Amazon Timestream

  • VirtualMachine - 虛擬機器

類型：字串

模式：^[a-zA-Z0-9\-\_\.]{1,50}$

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "string"
}

回應元素

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

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

RestoreJobId

可唯一識別還原復原點的任務。

類型：字串

錯誤

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

InvalidParameterValueException

表示參數的值出現問題。例如，值超出範圍。

HTTP 狀態碼：400

InvalidRequestException

表示請求的輸入出現問題。例如，參數的類型錯誤。

HTTP 狀態碼：400

MissingParameterValueException

表示缺少必要的參數。

HTTP 狀態碼：400

ResourceNotFoundException

動作所需的資源不存在。

HTTP 狀態碼：400

ServiceUnavailableException

由於伺服器發生臨時故障，請求失敗。

HTTP 狀態碼：500

另請參閱

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