接口请求域名： edgezone.intl.tencentcloudapi.com 。
创建物理机实例，系统自动分配物理机资源并完成装机。如果用户未在当前可用区开通计费，系统自动开通。支持并发分配物理机资源，异步执行网络分配和装机任务。
默认接口请求频率限制：20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：CreateInstances。 |
| Version | 是 | String | 公共参数，本接口取值：2026-04-01。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| Zone | 是 | String | 可用区代码，如 ap-guangzhou-1。 |
| InstanceType | 是 | String | 机型规格，如 BMS5.MEDIUM8。 |
| PrivateNetworkId | 是 | String | 内网网络实例ID，格式如 net-xxx。 |
| PublicNetworkId | 是 | String | 公网网络实例ID，格式如 net-xxx。 |
| InstanceName | 否 | String | 实例名称。 |
| ImageId | 否 | String | 镜像ID，如 img-centos-7.9。 |
| InstanceCount | 否 | Integer | 创建数量，默认1，最大50。 |
| Password | 否 | String | 登录密码，与SSHKey二选一 |
| SSHKey | 否 | String | SSH密钥公钥字符串，与Password二选一 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InstanceIdSet | Array of String | 创建成功的实例ID列表。 |
| FailedCount | Integer | 创建失败的实例个数。仅部分失败时返回，全部成功时不返回该字段。 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: edgezone.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateInstances
<公共请求参数>
{
"Zone": "ap-guangzhou-1",
"InstanceType": "BMS5.MEDIUM8",
"ImageId": "img-hmk3il0q",
"InstanceName": "my-epm-instance",
"InstanceCount": 1,
"PrivateNetworkId": "net-private-001",
"PublicNetworkId": "net-public-001"
}{
"Response": {
"InstanceIdSet": [
"epm-abcd1234"
],
"RequestId": "eac6b301-a322-493a-8e36-83b295459397"
}
}云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation | 操作失败。 |
| InvalidParameterValue | 参数取值错误。 |
| LimitExceeded.InstanceQuota | LimitExceeded.InstanceQuota |
| ResourceInsufficient | 资源不足。 |
文档反馈