CreateRestoreAccessBackupVault
创建恢复访问权限备份保管库,该保管库提供对逻辑上受物理隔离的备份保管库中恢复点的临时访问权限,但须经过 MPA 的批准。
请求语法
PUT /restore-access-backup-vaults HTTP/1.1
Content-type: application/json
{
"BackupVaultName": "string",
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"RequesterComment": "string",
"SourceBackupVaultArn": "string"
}
URI 请求参数
该请求不使用任何 URI 参数。
请求正文
请求接受采用 JSON 格式的以下数据。
- BackupVaultName
-
要与 MPA 审批团队关联的备份保管库的名称。
类型:字符串
模式:
^[a-zA-Z0-9\-\_]{2,50}$必需:否
- BackupVaultTags
-
分配给恢复访问权限备份保管库的可选标签。
类型:字符串到字符串映射
必需:否
- CreatorRequestId
-
唯一字符串,用于标识请求并允许重试失败的请求,同时避免发生两次执行该操作的风险。
类型:字符串
必需:否
- RequesterComment
-
用于说明请求恢复对备份保管库访问权限的原因的备注。
类型:字符串
必需:否
- SourceBackupVaultArn
-
请求临时访问权限的源备份保管库(包含恢复点)的 ARN。
类型:字符串
必需:是
响应语法
HTTP/1.1 200
Content-type: application/json
{
"CreationDate": number,
"RestoreAccessBackupVaultArn": "string",
"RestoreAccessBackupVaultName": "string",
"VaultState": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- CreationDate
-
> 恢复访问权限备份保管库的创建日期和时间,采用 Unix 格式和协调世界时(UTC)
类型:时间戳
- RestoreAccessBackupVaultArn
-
可唯一标识所创建的恢复访问权限备份保管库的 ARN。
类型:字符串
- RestoreAccessBackupVaultName
-
所创建的恢复访问权限备份保管库的名称。
类型:字符串
模式:
^[a-zA-Z0-9\-\_]{2,50}$ - VaultState
-
恢复访问权限备份保管库的当前状态。
类型:字符串
有效值:
CREATING | AVAILABLE | FAILED
错误
有关所有操作返回的常见错误的信息,请参阅常见错误。
- AlreadyExistsException
-
所需的资源已存在。
- Arn
- Context
- CreatorRequestId
- Type
HTTP 状态代码:400
- InvalidParameterValueException
-
表示参数的值有问题。例如,该值超出了范围。
- Context
- Type
HTTP 状态代码:400
- InvalidRequestException
-
表示请求的输入有问题。例如,参数的类型错误。
- Context
- Type
HTTP 状态代码:400
- LimitExceededException
-
已超过请求中的限制;例如,请求中允许的最大项目数。
- Context
- Type
HTTP 状态代码:400
- MissingParameterValueException
-
表示缺少必需的参数。
- Context
- Type
HTTP 状态代码:400
- ResourceNotFoundException
-
该操作所需的资源不存在。
- Context
- Type
HTTP 状态代码:400
- ServiceUnavailableException
-
由于服务器发生临时故障而导致请求失败。
- Context
- Type
HTTP 状态代码:500
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: