StartRestoreJob - AWS Backup
Request SyntaxURI 요청 파라미터요청 본문응답 구문Response ElementsErrors참고

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

StartRestoreJob

Amazon 리소스 이름()으로 식별된 저장된 리소스를 복구합니다ARN.

Request Syntax

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 리소스 이름(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 - 가상 머신

유형: String

패턴: ^[a-zA-Z0-9\-\_\.]{1,50}$

필수 여부: 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "string"
}

Response Elements

작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.

다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.

RestoreJobId

복구 시점을 복원하는 작업을 고유하게 식별합니다.

유형: 문자열

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

InvalidParameterValueException

파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.

HTTP 상태 코드: 400

InvalidRequestException

요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.

HTTP 상태 코드: 400

MissingParameterValueException

필수 파라미터가 누락되었음을 나타냅니다.

HTTP 상태 코드: 400

ResourceNotFoundException

작업에 필요한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 400

ServiceUnavailableException

요청이 서버의 일시적 장애 때문에 실패했습니다.

HTTP 상태 코드: 500

참고

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