本接口用于同规格资源的 **新购/复购 ** 操作。若您此前已通过控制台购买过某规格的资源，可使用本接口再次订购相同规格的资源。适用的计费类型包括： * 云盘存储业务：支持复购 **预付费 ** 实例资源。 * 本地存储业务：支持复购 **预付费 ** 和 **后付费 ** 云机资源。 ## 注意事项 * 首次订购资源或退订预付费资源操作，需在 [云手机控制台](https://console.volcengine.com/home) 完成。 * 对于已订购过云盘存储业务后付费实例资源，如需增订，请使用 [UpdatePodResourceApplyNum](https://docs.volcengine.com/docs/Cloudphone/ModifyinstanceorderconcurrentquantityUpdatePodResourceApplyNum) 接口。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=SubscribeResourceAuto&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |SubscribeResourceAuto |接口名称。当前 API 的名称为 `SubscribeResourceAuto`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201\*\*\* |业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录 [云手机控制台](https://console.volcengine.com/ACEP)，在已创建的业务卡片中获取。 | |PreOrderList |Array of [PreOrder](https://docs.volcengine.com/docs/6394/2282313#preorder) |是 |\-\- |订购配置单列表。 | |AutoRenew |Boolean |否 |true |是否开启自动续费。取值：

* `true`：开启自动续费。

* `false`：（默认）不开启自动续费。 | |RoundId |String |是 |r1234 |订购请求的唯一标识。您可以根据自身业务需求，自定义设置此参数。

> 说明

> 为防止由于网络等原因造成重复请求的情况，同一 `RoundId`在 1 天内只可使用一次。
| ### PreOrder |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Dc |String |否 |tjtj\-\*\*\* |实例所属机房。若指定本参数，则订购指定机房中的实例。

> 注意

> `Dc` 和 `Region` 至少需要指定一个值，`Dc` 优先级高于 `Region`。
| |Term |Integer |否 |1 |订购实例的租期，单位为月，默认值为 1。例如“1.10 \- 2.10” 为 1 个月租期。

> 说明

> 对于资源计费方式为“包年包月”的业务，本参数必填。
| |Region |String |否 |cn\-north |实例所属机房所在的大区 ID。若指定本参数，则在指定大区内随机分配机房进行实例订购。

* 当资源所在区域选择中国大陆，即 `VolcRegion` 设置为 `inner` 时，该参数可选值包含：

* `cn-north`：华北。

* `cn-south`：华南。

* `cn-east`：华东。

* `cn-middle`：华中。

* `cn-southwest`：西南。

* 当资源所在区域选择中国香港，即 `VolcRegion` 设置为 `cn-hongkong-pop` 时，该参数可选值为 `cn-hongkong-pop`。

> 注意

> `Dc` 和 `Region` 至少需要指定一个值，`Dc` 优先级高于 `Region`。
| |ImageId |String |否 |img\-\*\*\* |自定义镜像 ID。

若不指定本参数，则默认使用平台提供的官方标准镜像。 | |ApplyNum |Long |是 |1 |本次订购期望增加的资源数量。

* 对于云盘存储方案，本参数指实例资源。

* 对于本地存储方案，本参数指云机资源。 | |ChargeType |String |否 |pod_pre_monthly |资源计费模式，取值：

* `pod_pre_monthly`：实例预付费月结。

* `pod_post_daily`：实例后付费日结。

* `host_pre_monthly`：云机预付费月结。

* `host_post_daily`：云机后付费日结。 | |VolcRegion |String |否 |inner |资源所在的物理区域，取值：

* `inner`：（默认值）中国大陆。

* `cn-hongkong-pop`：中国香港。 | |AutoCreatePod |Boolean |否 |false |是否自动创建实例，取值：

* `true`：是。

* `false`：（默认）否。 | |ServerTypeCode |String |否 |g2.8c12g |期望复购的云机规格 ID。

您可以调用 [ListConfiguration](https://docs.volcengine.com/docs/Cloudphone/QueryPackageListListConfiguration) 接口查询当前业务可以订购的资源套餐。

更多云机规格详情参见 [本地存储云机规格列表](https://www.volcengine.com/docs/6394/1473600#.5LqR5py66KeE5qC85YiX6KGo)。

> 注意

> 仅 **本地存储**方案需填写此参数，云盘存储方案无需关注。
| |DisplayLayoutId |String |否 |single\-display\-portrait |屏幕布局，全局屏幕配置。您可以调用 [ListDisplayLayoutMini](https://docs.volcengine.com/docs/Cloudphone/QuerythelistofbasicscreenlayoutsListDisplayLayoutMini) 接口获取。

可选的系统屏幕布局 ID 包括：

* `single-display-landscape`

* `single-display-portrait`

* `single-display-portrait-720p`

> 说明

* > 如未指定屏幕布局 ID，当运行资源套餐 `ConfigurationCode` 为入门型 `sample` ，云手机实例将会使用 720P 和 30fps 的默认配置。

* > 该参数适用于本地存储方案，云盘存储无需关注。
| |ConfigurationCode |String |是 |ultimate |期望复购的实例资源规格 ID，当前业务下已订购的实例规格可通过 [ListPodResource](https://docs.volcengine.com/docs/Cloudphone/QueryinstanceresourcelistListPodResource) 接口查询。

更多规格信息参见 [本地存储实例规格列表](https://www.volcengine.com/docs/6394/1473600#.5pys5Zyw5a6e5L6L) 或 [云盘存储实例规格列表](https://www.volcengine.com/docs/6394/1473600#.5LqR55uY5a6e5L6L)。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |OrderId |String |Order733\*\*\*6411607084 |实例资源订购成功，返回订单 ID。 | |HostIdList |Array of String |["host\-72\*\*\*1","host\-72\*\*\*2","host\-72\*\*\*3"] |预生成的云机 ID 列表，仅本地存储方案下返回，云盘存储方案返回 `null`。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=SubscribeResourceAuto&Version=2025-05-01 { "ProductId": "1749281594201***", "PreOrderList": [ { "Dc": "tjtj-***", "Term": 1, "Region": "cn-north", "ImageId": "img-***", "ApplyNum": 1, "ChargeType": "pod_pre_monthly", "VolcRegion": "inner", "AutoCreatePod": false, "ServerTypeCode": "g2.8c12g", "DisplayLayoutId": "single-display-portrait", "ConfigurationCode": "ultimate" } ], "AutoRenew": true, "RoundId": "r1234" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "SubscribeResourceAuto", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "OrderId": "Order733***6411607084", "HostIdList": [ "host-72***1", "host-72***2", "host-72***3" ] } } ``` ## 错误码您可以访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。