기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateLogicallyAirGappedBackupVault
이 요청은 백업을 복사할 수 있는 논리적 컨테이너를 생성합니다.
이 요청에는 이름, 리전, 최대 보존 일수, 최소 보존 일수가 포함되며 선택에 따라 태그와 작성자 요청 ID를 포함할 수 있습니다.
참고
여권 번호처럼 민감한 데이터를 백업 저장소 이름에 포함하지 마세요.
Request Syntax
PUT /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"MaxRetentionDays": number,
"MinRetentionDays": number
}URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- backupVaultName
-
생성하려는 저장소의 이름입니다.
패턴:
^[a-zA-Z0-9\-\_]{2,50}$필수 항목 여부: 예
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- BackupVaultTags
-
새로 생성된 저장소에 포함할 태그입니다.
유형: 문자열 간 맵
필수 항목 여부: 아니요
- CreatorRequestId
-
생성 요청의 ID입니다.
이 파라미터는 선택 사항입니다. 이를 사용할 경우 이 파라미터에는 1~50개의 영숫자 또는 '-_.' 문자를 포함해야 합니다.
타입: 문자열
필수 항목 여부: 아니요
- MaxRetentionDays
-
저장소가 복구 시점을 유지하는 최대 보존 기간을 지정하는 설정입니다. 이 파라미터가 지정되지 않으면 AWS Backup 은 저장소의 복구 시점에 최대 보존 기간을 적용하지 않습니다(무제한 저장 가능).
이 설정이 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최대 보존 기간보다 짧거나 같은 수명 주기 정책이 있어야 합니다. 작업 보존 기간이 최대 보존 기간보다 길면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다.
타입: Long
필수 항목 여부: 예
- MinRetentionDays
-
이 설정은 저장소가 복구 시점을 유지하는 최소 보존 기간을 지정합니다. 이 파라미터가 지정되지 않으면 최소 보존 기간이 적용되지 않습니다.
이 설정이 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최소 보존 기간보다 길거나 같은 수명 주기 정책이 있어야 합니다. 작업 보존 기간이 최소 보존 기간보다 짧으면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다.
타입: Long
필수 항목 여부: 예
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- BackupVaultArn
-
생성하려는 저장소의 Amazon 리소스 이름(ARN)입니다.
타입: 문자열
- BackupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 논리적 에어 갭 처리 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다. 백업 저장소는 소문자, 숫자, 하이픈(-)으로 구성됩니다.
유형: String
패턴:
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
저장소가 생성된 날짜 및 시간입니다.
이 값은 Unix 형식의 협정 세계시(UTC)로 표시되며, 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087를 나타냅니다.
유형: 타임스탬프
- VaultState
-
저장소의 현재 상태입니다.
타입: 문자열
유효 값:
CREATING | AVAILABLE | FAILED
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- AlreadyExistsException
-
필수 리소스가 이미 존재합니다.
HTTP 상태 코드: 400
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- InvalidRequestException
-
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- LimitExceededException
-
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
HTTP 상태 코드: 500
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
