说明

创建云硬盘快照，单个租户下的单个云硬盘在首次创建快照时，会通过订单流程创建，之后的快照不再通过订单创建；如果租户主动退订快照订单后，再次创建时仍会订单流程创建。

接口功能介绍

创建云硬盘快照，单个租户下的单个云硬盘在创建第一个快照时，会创建快照的订单，之后的快照无需创建订单；

接口约束

1、单个云硬盘支持创建快照个数最多为50个（手动快照最多40个）。

2、快照创建地域应与源云硬盘所在地域相同。

3、只有可用状态（即未挂载和已挂载状态）的云硬盘才可以创建快照。

4、同一个租户下在同一个资源池下的快照名称不能重复。

5、磁盘模式为FCSAN的云硬盘不支持创建快照，磁盘模式为ISCSI的云硬盘不支持创建快照。

URI

POST /v4/ebs_snapshot/create

请求参数

请求体body参数

响应参数

表 returnObj

表 resources

表 errorDetail

请求示例

请求头header

无

请求体body

{
    "regionID":"fc862f71-d629-4a0e-9fe0-b104963b3f05",
    "snapshotName":"snapshot-001",
    "volumeId":"36e88a58-1ebf-40ac-91b6-a8c0eca38314",
    "retentionPolicy":"forever"
}

响应示例

{
    "description" : "订单处理中，可使用订单ID查询或使用原clientToken重试下单",
    "errorCode" : "ebs.order.inProgress",
    "message" : "order in progress",
    "details": "", 
    "returnObj" : {
        "masterOrderID" : "f2533a837273484e93e9bed79f848307",
        "masterOrderNO" : "20221110210941194620",
        "regionID" : "81f7728662dd11ec810800155d307d5b"
    },
    "statusCode" : 900
}
或者
{
	"returnObj": {
	    "item_config":[{
	        "master": True,
	        "resourceType": "EBS",
	        "itemConfig": {
	            "az_name": "az1",
	            "snapshotName": "snapshot-001",
	            "volumeType": "SATA-SNAP",
	            "volumeId": "36e88a58-1ebf-40ac-91b6-a8c0eca38314",
	            "billMode": "2"
        },
	        "itemValue": "1"
	    }],
	    "cycle_type": "ON_DEMAND"
	}, 
	"details": "", 
	"message": "SUCCESS", 
	"description": "成功",
	"statusCode": 800
 }
 或者
{
	"returnObj": {
	"jobID": "f29d6cbe-6171-11ed-b9da-525400cc3b79"
	}, 
	"details": "", 
	"message": "SUCCESS", 
	"description": "成功",
	"statusCode": 800
 }

状态码

错误码

请参考通用结果码。