GetBackup - 查询备份_密钥管理服务(KMS)-阿里云帮助中心

查询指定备份信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
yundun-hsm:GetBackup	get	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
BackupId	string	否	备份 ID。	backup-fdb897sdf****

返回参数

名称	类型	描述	示例值
	object	响应信息。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	4C467B38-3910-447D-87BC-AC049166F216
Backup	object	返回的备份信息。
BackupId	string	备份 ID。	backup-fdb897sdf****
CreateTime	long	备份创建时间，精确到毫秒。时间戳格式。	1682417553781
ExpireTime	long	备份过期时间，精确到毫秒。时间戳格式。	1682417553781
InstanceId	string	备份关联的密码机实例 ID。	hsm-cn-5yd35431****
Name	string	备份名称。	backup-te****
RegionId	string	地域 ID。	cn-hangzhou
Remark	string	备份备注。	test
Status	string	备份状态。 NEW：未启用 EXPIRED：已过期 ENABLED：已启用	NEW
MaxImageCount	string	最大镜像数量。	3
Type	string	备份类型。 DEFAULT：默认备份 NORMAL：普通备份	DEFAULT
BackupPeriod	long	自动备份周期，单位天数。	3
NextImageCreateTime	long	镜像下一次创建时间，精确到毫秒。时间戳格式。	1682417553781
BackupHourInDay	string	备份时间，24 小时制整点时间。	10
SpInstanceId	string	售卖域备份 ID。仅中国内地密码机备份有此属性。	backup-fdb897sdfg53****
AutoImageCount	long	自动备份镜像数量。	1
OwnerInstanceId	string	备份所属的密码机实例 ID。仅非中国内地密码机备份有此属性，且与 InstanceId 一致。	hsm-cn-huoahd****
ReleaseTime	long	备份释放时间，精确到毫秒。时间戳格式。	1641275680000

示例

正常返回示例

JSON格式

{
  "RequestId": "4C467B38-3910-447D-87BC-AC049166F216",
  "Backup": {
    "BackupId": "backup-fdb897sdf****",
    "CreateTime": 1682417553781,
    "ExpireTime": 1682417553781,
    "InstanceId": "hsm-cn-5yd35431****",
    "Name": "backup-te****",
    "RegionId": "cn-hangzhou",
    "Remark": "test",
    "Status": "NEW",
    "MaxImageCount": "3",
    "Type": "DEFAULT",
    "BackupPeriod": 3,
    "NextImageCreateTime": 1682417553781,
    "BackupHourInDay": "10",
    "SpInstanceId": "backup-fdb897sdfg53****",
    "AutoImageCount": 1,
    "OwnerInstanceId": "hsm-cn-huoahd****",
    "ReleaseTime": 1641275680000
  }
}

错误码

HTTP status code	错误码	错误信息
403	NoPermission	caller has no permission

访问错误中心查看更多错误码。