기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateRecoveryPointLifecycle
복구 시점의 전환 수명 주기를 설정합니다.
수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시기를 정의합니다. AWS Backup 정의한 수명 주기에 따라 백업이 자동으로 전환되고 만료됩니다.
콜드 스토리지로 전환된 백업은 콜드 스토리지에서 최소 90일 이상 저장되어야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.
콜드 스토리지로 전환할 수 있는 리소스 유형은 리소스별 기능 가용성 테이블에 나열되어 있습니다. AWS Backup 다른 리소스 유형에서는 이 표현식을 무시합니다.
이 작업은 연속 백업을 지원하지 않습니다.
Request Syntax
POST /backup-vaults/backupVaultName
/recovery-points/recoveryPointArn
HTTP/1.1
Content-type: application/json
{
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
,
"OptInToArchiveForSupportedResources": boolean
}
}
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- backupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다. 백업 저장소는 소문자, 숫자, 하이픈(-)으로 구성됩니다.
패턴:
^[a-zA-Z0-9\-\_]{2,50}$
필수 여부: 예
- recoveryPointArn
-
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예:
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
).필수 여부: 예
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"CalculatedLifecycle": {
"DeleteAt": number,
"MoveToColdStorageAt": number
},
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointArn": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- BackupVaultArn
-
백업 저장소를 고유하게 식별하는 ARN입니다(예:
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
).타입: 문자열
- CalculatedLifecycle
-
DeleteAt
및MoveToColdStorageAt
타임스탬프를 포함하는CalculatedLifecycle
객체입니다.유형: CalculatedLifecycle객체
- Lifecycle
-
수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시기를 정의합니다. AWS Backup 정의한 수명 주기에 따라 백업이 자동으로 전환되고 만료됩니다.
콜드 스토리지로 전환된 백업은 콜드 스토리지에서 최소 90일 이상 저장되어야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.
콜드 스토리지로 전환할 수 있는 리소스 유형은 리소스별 기능 가용성 테이블에 나열되어 있습니다. AWS Backup 다른 리소스 유형에서는 이 표현식을 무시합니다.
유형: Lifecycle객체
- RecoveryPointArn
-
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예:
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
).타입: 문자열
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- InvalidRequestException
-
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
작업에 필요한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
HTTP 상태 코드: 500
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.