本接口用于修改已有云手机实例的配置，支持更新一个或批量更新多个实例。可调整的配置项包括实例的名称、套餐规格、使用镜像、屏幕布局、带宽限制等。 ## 使用说明 * **云盘存储**业务支持使用本接口更新**存储容量**和**套餐规格**。 * 如需更改实例的**套餐规格**和**屏幕布局**，请先将实例关机，更新后的配置将在实例再次开机时生效。 * **套餐规格**支持由低配置变更为高配置，也支持由高配置变更为低配置，变更前请确保当前业务下已购入对应套餐。 * **本地存储**业务在实例处于**已关机且备份完成**的状态下，支持使用本接口更新**实例规格**。 * 按照云机规格的 ServerTypeCode 参数值，将云机规格分为以下两类： * **g2 类型**：云机规格的 ServerTypeCode 参数值为 `g2.8c12g`、`g2.8c16g.basic`、`g2.8c16g.plus` * **g3 类型**：云机规格的 ServerTypeCode 参数值为 `g3.host8c24g256g` **g2 类型** 内的实例规格支持互相更配、**g3 类型** 内的实例规格支持互相更配，**g2 类型** 和 **g3 类型** 之间不支持跨类型更配。关于云机规格的 ServerTypeCode 参数说明，请参见[本地存储资源规格](https://www.volcengine.com/docs/6394/1473600#%E6%9C%AC%E5%9C%B0%E5%AD%98%E5%82%A8%E8%B5%84%E6%BA%90%E8%A7%84%E6%A0%BC)。 * 支持由低配变更为高配、高配变更为低配，但需要注意变更前实例已使用的存储容量需要小于目标实例规格存储容量的 80%。 ## 注意事项本接口的单用户 **QPS 限制为 50 次/秒**。超过限制，API 调用会被限流。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=UpdatePod&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |`UpdatePod` |接口名称。当前 API 的名称为 `UpdatePod`。 | |Version |String |是 |`2025-05-01` |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201xxxxxx |业务 ID，管理云手机资源、开展云手机业务的标识。可登录 [云手机控制台](https://console.volcengine.com/ACEP)，在已创建的业务卡片中获取。 | |PodId |String |否 |7337159054625xxxxxx |实例 ID，用于指定需要更新配置的目标实例。

说明

如需修改单个实例配置，请使用本参数；

如需修改多个实例配置，请根据实际需要使用 PodIdList传入目标实例 ID 列表。

说明

默认情况下，更新镜像前需将云手机实例关机，新的镜像将在实例下次启动时生效。如需在实例开机状态下更新镜像，请将 Force 参数设置为 true，更新完成后实例将自动重启。

不支持跨版本镜像更换。例如：不支持由 AOSP10 更换为 AOSP11，反之亦然。

说明

修改套餐前，请确保当前业务下已购入目标套餐规格的实例资源。可通过 ListPodResource 接口查询。

云盘存储 业务需在实例关机状态下执行，实例重启后更新生效。

本地存储 业务需在实例处于 已关机且备份完成 的状态下执行。

| |DisplayLayoutId |String |否 |single\-display\-landscape |屏幕布局 ID，用于指定想要使用的屏幕显示配置。

您可以选择系统提供的屏幕布局，也可以使用通过 [CreateDisplayLayoutMini](https://www.volcengine.com/docs/6394/1262191) 接口创建的自定义屏幕布局。

* 若使用**系统屏幕布局**，可选项包括：

* `single-display-landscape`：1080p 横屏，分辨率 1920\*1080 像素，像素密度 320 dpi，帧率 60fps。

* `single-display-portrait`：1080p 竖屏，分辨率 1080\*1920 像素，像素密度 320 dpi，帧率 60fps。

* `single-display-portrait-720p`：高清竖屏，分辨率 720\*1080 像素，像素密度 320 dpi，帧率 30fps。

* 若使用**自定义屏幕布局**，可选项可通过 [ListDisplayLayoutMini](https://www.volcengine.com/docs/6394/1221495) 接口获取。 | |PodIdList |Array of String |否 |["7337159054625xxxxxx","7337159054626xxxxxx"] |实例 ID 列表，用于指定需要更新配置的多个目标实例。

说明

如需修改多个实例配置，请根据实际需要使用本参数传入目标实例 ID 列表。支持批量操作的实例数量上限为 200。

如需修改单个实例配置，请使用 PodId。

说明

需保证为实例匹配的自定义路由规则归属 Zone 与实例所在 Zone 一致。

| |DNSId |String |否 |dns\-7616xxxx |自定义 DNS 规则 ID，已调用 [CreateDNSRule](https://www.volcengine.com/docs/6394/1351364) 接口创建自定义 DNS 解析规则后，可使用本参数为实例关联或更新 DNS 规则。

可选的 DNS 规则 ID 可通过 [ListDNSRule](https://www.volcengine.com/docs/6394/1351360) 接口查询。

说明

需保证为实例匹配的 DNS 规则归属机房与实例所在机房一致。

| |PortMappingRuleIdList |Array of String |否 |["733279472xxx1098924"] |端口映射规则 ID 列表。 | |IPWhiteList |String |否 |10.xxx.xx.01,10.xxx.xx.02 |私有参数。支持配置白名单 IP，对白名单 IP 不限速。同时对 pod 访问的其他 IP 进行整体限速。以 ',' 分割。 | |IsSelinuxOn |Boolean |否 |true |实例是否开启 SELinux。默认值为空，表示不设置实例维度的 SELinux 策略。取值如下：

* `true`：开启。

* `false`：关闭。 | ## 返回参数本接口无特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=UpdatePod&Version=2025-05-01 { "ProductId": "1749281594201xxxxxx", "PodId": "7337159054625xxxxxx", "PodName": "测试更新实例", "ImageId": "img-7616xxxx", "DataSize": "4Gi", "ConfigurationCode": "ultimate", "DisplayLayoutId": "single-display-landscape", "PodIdList": [ "7337159054625xxxxxx", "7337159054626xxxxxx" ], "Force": true, "UpBandwidthLimit": 5, "DownBandwidthLimit": 8, "CustomRouteId": "cr-7616xxxx", "DNSId": "dns-7616xxxx", "PortMappingRuleIdList": [ "733279472xxx1098924" ], "IPWhiteList": "10.xxx.xx.01,10.xxx.xx.02", "IsSelinuxOn": true } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "UpdatePod", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" } } ``` ## 错误码您可访问[公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。