接口功能介绍

查询云主机备份列表

接口约束

1. 使用限制，本接口只支持在拉萨3、上海7、广州6、郴州2、长沙3、北京5、内蒙6、南京3、重庆2、合肥2、成都4、晋中、昆明2、乌鲁木齐27、福州25、衡阳3、长沙37、张家界2、华北2、央企北京1、华东1、上海32、上海33、上海36资源池进行公测
   2. 当前页面接口为旧版 API，未来根据实际使用情况可能退役，推荐使用新版本接口，新版本接口更加规范，覆盖场景更全。

URI

POST /v4/ecs/backup-list

路径参数
无

Query参数
无

请求参数

请求头header参数
无

请求体body参数

响应参数

表 returnObj

表 results

表 blockDeviceMappingS

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

{
	"regionID": "81f7728662dd11ec810800155d307d5b",
	"pageNo": 1,
	"pageSize": 50,
	"repositoryID": "62a7cd2f-55a4-4a65-bb64-6f8352b4f55f",
	"instanceBackupID": "b6e2966d-7b1c-385e-abe4-d940caa273b7",
	"queryContent": ""
}

响应示例

{
	"returnObj": {
		"currentCount": 1,
		"totalCount": 1,
		"totalPage": 1,
		"results": [{
			"status": "ACTIVE",
			"instanceBackupName": "openapi-test-0001-0016",
			"volumeCount": 1,
			"repoFreezing": false,
			"usedSize": 835228300,
			"block_device_mappings": [{
				"backup_id": "0634f102-b14c-42fa-bc35-38f669a9c52a",
				"mount_device": "/dev/vda",
				"is_bootable": true,
				"volume_type": "SATA-public",
				"device_name": "vda",
				"volume_size": 40,
				"boot_index": 1,
				"boot_volume": true,
				"volume_id": "25e2248b-a5ca-4e27-b1be-76155ef16dbd",
				"container": "a7135589f022439c1edefc74b9336f7a",
				"service_metadata": "a8b318a7-c07f-6eb4-8fb9-72a897cc9f65/volume_25e2248b-a5ca-4e27-b1be-76155ef16dbd/20221031025806/az_nova_backup_0634f102-b14c-42fa-bc35-38f669a9c52a",
				"delete_on_termination": true
			}],
			"repositoryID": "0da07640-6e76-4642-8a65-xxxxxxxxxxx",
			"updateAt": "2022-10-31T03:09:03Z",
			"size": 40,
			"finishTime": "2022-10-31T03:09:03Z",
			"instanceID": "9e32a0de-f7a5-058a-85f1-xxxxxxxxxxxxx",
			"description": "openapi-test",
			"deleted": false,
			"createAt": "2022-10-31T02:58:04Z",
			"repoExpired": false,
			"projectID": "0",
			"instanceBackupID": "a8b318a7-c07f-6eb4-8fb9-xxxxxxxxxxxx",
			"repositoryName": "repo-97e8"
		}]
	},
	"message": "SUCCESS",
	"description": "成功",
	"statusCode": 800
}

状态码

请参考 状态码

错误码

请参考 错误码