기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateRecoveryPointLifecycle
복구 시점의 전환 수명 주기를 설정합니다.
수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시점을 정의합니다. AWS Backup은 사용자가 정의한 수명 주기에 따라 백업을 자동으로 전환하고 만료합니다.
콜드 스토리지로 전환할 수 있는 리소스 유형은 리소스별 기능 가용성 표에 나열되어 있습니다. AWS Backup는 다른 리소스 유형에 대해서는 이 표현식을 무시합니다.
콜드 스토리지로 전환된 백업은 콜드 스토리지에서 최소 90일 이상 저장되어야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.
중요
수명 주기가 현재 DeleteAfterDays
및 MoveToColdStorageAfterDays
파라미터를 사용하는 경우, 이 작업을 직접적으로 호출할 때 이러한 파라미터와 해당 값을 포함합니다. 이를 포함하지 않으면 계획이 null 값으로 업데이트될 수 있습니다.
이 작업은 연속 백업을 지원하지 않습니다.
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 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.
Pattern:
^[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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.