创建云主机快照PAAS - 混合云OpenAPI4.0

请求参数

Body 参数application/json

channelInfo

object

渠道侧信息

可选

当前并未处理。应是必填

paasResourceID

string

paas资源ID

可选

变配或删除时，使用和创建资源相同的paasResourceID

paasAccountID

string

paas账号

可选

资源的付费账号，通过上送IT用于内部结算，和channel无关

masterOrderID

string

中台主订单ID

可选

IaaS记入话单，用来关联订单和资源

tags

string

标签

可选

自定义map结构

metas

string

元数据

可选

自定义map结构

clientToken

string

客户端存根

必需

用于保证订单幂等性。要求单个云平台账户内唯一

regionID

string

资源池ID

必需

您可以调用regionID查看最新的天翼云资源池列表

instanceID

string

云主机ID

必需

snapshotName

string

云主机快照名称

必需

满足以下规则：长度在2～63个字符,包含字母（区分大小写）、数字和特殊字符（~!@#$%^*_-+{[]}:,.?）的组合

示例

{
    "regionID": "81f7728662dd11ec810800155d307d5b",
    "instanceID": "b6e2966d-7b1c-385e-abe4-d940caa273b7",
    "snapshotName": "test",
    "clientToken": "CO20220920101230123100032",
    "channelInfo": {
        "paasAccountID": "accountxxxxxxxxx",
        "masterOrderID": "orderxxxxxxxx",
        "paasResourceID": "resourcexxxxxx"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/paas/ecs/snapshot/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "81f7728662dd11ec810800155d307d5b",
    "instanceID": "b6e2966d-7b1c-385e-abe4-d940caa273b7",
    "snapshotName": "test",
    "clientToken": "CO20220920101230123100032",
    "channelInfo": {
        "paasAccountID": "accountxxxxxxxxx",
        "masterOrderID": "orderxxxxxxxx",
        "paasResourceID": "resourcexxxxxx"
    }
}'

返回响应

🟢200成功

application/json

Body

statusCode

integer

返回状态码

必需

800为成功，900为失败

errorCode

string

业务细分码

可选

为product.module.code三段式码

message

string

失败时的错误描述

可选

失败时的错误描述，一般为英文描述

description

string

失败时的错误描述

可选

一般为中文描述

returnObj

object

响应详情对象

可选

jobID

string

唯一任务ID

可选

，每次请求都会返回，调用方通过jobID轮询任务完成状态；定位问题时也需要提供该jobID

snapshotStatus

string

快照状态

可选

instanceID

string

云主机ID

可选

instanceName

string

云主机名称

可选

snapshotID

string

快照ID

可选

snapshotName

string

快照名称

可选

projectID

string

企业项目ID

可选

示例

{
    "returnObj": {
        "snapshotStatus": "pending",
        "projectID": "0",
        "instanceID": "b275b936-9b8d-223e-586a-c5282d96c6a1",
        "snapshotName": "test",
        "instanceName": "ecs",
        "snapshotID": "3eee1eb3-6117-2a1d-4d59-582ead37273b",
        "jobID": "7027d439-1583-4170-ba69-a54306163bb6"
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}