一键快速创建实例、启动实例，并完成应用部署（异步任务）。

实例创建结果通过任务执行回调返回，详细信息，参考 回调服务接入指南。

前提条件

• 单次调用仅支持创建一个实例，并将一批指定应用安装到创建的实例中；

• 若指定安装的应用列表中有应用 ID 错误或异常，整个任务将不会被执行；应用安装任务执行过程中，若其中某个应用安装失败，不影响该任务下的其他应用执行安装；

• 确保指定的业务下有足够的运行资源，若运行资源不足，则会导致实例启动失败，对应的应用安装任务将不会被执行。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考 公共请求参数。

Body 参数

AppInfo 结构说明

返回结果

通用返回参数，请参考 ResponseMetadata 结构说明。

Result 字段包含以下参数：

示例

请求示例

POST https://open.volcengineapi.com?Action=CreatePodOneStep
&Version=2022-08-01
&<通过header传入的公共请求参数>

{
    "product_id":"1591495366954455040",
    "pod_name":"测试实例01",
    "image_id":"img-76161282",
    "data_size":"4Gi",
    "dc":"gdsz-ctcucm-01-5f53d8b4",
    "configuration_code":"basic",
    "app_list":[
        {
        "app_id":"7280422115605076795",
        "version_id":7280422115605093179
        }
    ],
    "overlay_settings": [
        {
        "settings_type":"global",
        "settings_name":"locale_language",
        "settings_value":"en-US",
        "settings_value_type":"string"
        },
        {
        "settings_type":"secure",
        "settings_name":"statusbar_switch",
        "settings_value":"off",
        "settings_value_type":"string"
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "Action": "CreatePodOneStep",
        "Region": "cn-north-1",
        "RequestId": "202310261458***B0460DEA2E06713F3",
        "Service": "ACEP",
        "Version": "2022-08-01"
    },
    "Result": {
        "pod_id": "7294157141458xxxxxx",
        "task_id": "7294157141458xxxxxx",
        "task_action": "CreatePod"
    }
}

错误码