기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetBackupPlan
지정된 BackupPlanId에 대한 BackupPlan 세부 정보를 반환합니다. 세부 정보는 JSON 형식의 백업 계획 본문과 계획 메타데이터입니다.
Request Syntax
GET /backup/plans/backupPlanId/?MaxScheduledRunsPreview=MaxScheduledRunsPreview&versionId=VersionId HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- backupPlanId
-
백업 계획을 고유하게 식별합니다.
필수 여부: 예
- MaxScheduledRunsPreview
-
미리 볼 향후 예약된 백업 실행 수입니다. 0(기본값)으로 설정하면 예약된 실행 미리 보기가 응답에 포함되지 않습니다. 유효한 범위는 0~10입니다.
유효 범위: 최소값은 0입니다. 최대 값 10.
- VersionId
-
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string" : "string"
},
"ResourceType": "string"
}
],
"BackupPlan": {
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string" : "string"
},
"ResourceType": "string"
}
],
"BackupPlanName": "string",
"Rules": [
{
"CompletionWindowMinutes": number,
"CopyActions": [
{
"DestinationBackupVaultArn": "string",
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
}
}
],
"EnableContinuousBackup": boolean,
"IndexActions": [
{
"ResourceTypes": [ "string" ]
}
],
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointTags": {
"string" : "string"
},
"RuleId": "string",
"RuleName": "string",
"ScheduleExpression": "string",
"ScheduleExpressionTimezone": "string",
"StartWindowMinutes": number,
"TargetBackupVaultName": "string"
}
]
},
"BackupPlanArn": "string",
"BackupPlanId": "string",
"CreationDate": number,
"CreatorRequestId": "string",
"DeletionDate": number,
"LastExecutionDate": number,
"ScheduledRunsPreview": [
{
"ExecutionTime": number,
"RuleExecutionType": "string",
"RuleId": "string"
}
],
"VersionId": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AdvancedBackupSettings
-
각 리소스 유형에 대한
BackupOptions목록이 포함됩니다. 백업 계획에 고급 옵션이 설정된 경우에만 목록이 채워집니다.타입: AdvancedBackupSetting객체 배열
- BackupPlan
-
백업 계획의 본문을 지정합니다.
BackupPlanName과 하나 이상의Rules집합을 포함합니다.유형: BackupPlan객체
- BackupPlanArn
-
백업 계획을 고유하게 식별하는 Amazon 리소스 이름(ARN)(예:
arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50)입니다.유형: 문자열
- BackupPlanId
-
백업 계획을 고유하게 식별합니다.
유형: 문자열
- CreationDate
-
백업 계획이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CreationDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- CreatorRequestId
-
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다.
유형: 문자열
- DeletionDate
-
백업 계획이 삭제된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
DeletionDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- LastExecutionDate
-
이 백업 계획이 마지막으로 실행된 시간입니다. 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
LastExecutionDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- ScheduledRunsPreview
-
예정된 예약된 백업 실행 목록입니다.
MaxScheduledRunsPreview파라미터가 0보다 큰 경우에만 포함됩니다. 예약된 시간, 실행 유형 및 관련 규칙 IDs와 함께 최대 10개의 향후 백업 실행이 포함됩니다.타입: ScheduledPlanExecutionMember객체 배열
- VersionId
-
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.
유형: 문자열
오류
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
- Context
- Type
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
- Context
- Type
HTTP 상태 코드: 400
- ResourceNotFoundException
-
작업에 필요한 리소스가 존재하지 않습니다.
- Context
- Type
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
- Context
- Type
HTTP 상태 코드: 500
참고
언어별 AWS SDKs