接口请求域名： edgezone.intl.tencentcloudapi.com 。
创建物理机实例，系统自动分配物理机资源并完成装机。如果用户未在当前可用区开通计费，系统自动开通。支持并发分配物理机资源，异步执行网络分配和装机任务。
默认接口请求频率限制：20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：CreateInstances。 |
| Version | 是 | String | 公共参数，本接口取值：2026-04-01。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| Zone | 是 | String | 可用区代码，如 ap-guangzhou-1。 |
| InstanceType | 是 | String | 机型规格，如 BMS5.MEDIUM8。 |
| InstanceName | 是 | String | 实例名称。 |
| PrivateNetworkId | 是 | String | 内网网络实例ID，格式如 net-xxx。 |
| PublicNetworkId | 是 | String | 公网网络实例ID，格式如 net-xxx。 |
| ImageId | 否 | String | 镜像ID，如 img-centos-7.9。 |
| InstanceCount | 否 | Integer | 创建数量，默认1，最大50。 |
| VersionNumber | 否 | String | 镜像版本号，仅公共镜像有版本概念。 |
| EnableIpv6 | 否 | Boolean | 是否启用公网IPv6，默认false。启用后系统会在分配IPv4后额外分配一个IPv6地址。 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InstanceIdSet | Array of String | 创建成功的实例ID列表。 |
| FailedCount | Integer | 创建失败的实例个数。仅部分失败时返回，全部成功时不返回该字段。 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
在广州一区创建一台物理机实例，使用 CentOS 7.9 镜像，并启用 IPv6。
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-centos-7.9",
"InstanceName": "my-epm-instance",
"InstanceCount": 1,
"VersionNumber": "7.9.2009",
"PrivateNetworkId": "net-private-001",
"PublicNetworkId": "net-public-001",
"EnableIpv6": true
}
{
"Response": {
"InstanceIdSet": [
"ins-abcd1234"
],
"RequestId": "eac6b301-a322-493a-8e36-83b295459397"
}
}
批量创建3台物理机实例。
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-centos-7.9",
"InstanceName": "batch-instance",
"InstanceCount": 3,
"PrivateNetworkId": "net-private-001",
"PublicNetworkId": "net-public-001"
}
{
"Response": {
"InstanceIdSet": [
"ins-abcd1234",
"ins-efgh5678",
"ins-ijkl9012"
],
"RequestId": "b5d7b923-6a8c-4e2f-9f01-4e7e8d3c1a2b"
}
}
批量创建3台物理机实例，其中2台创建成功，1台因资源不足创建失败。
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-centos-7.9",
"InstanceName": "batch-instance",
"InstanceCount": 3,
"PrivateNetworkId": "net-private-001",
"PublicNetworkId": "net-public-001"
}
{
"Response": {
"InstanceIdSet": [
"ins-abcd1234",
"ins-efgh5678"
],
"FailedCount": 1,
"RequestId": "c7e8f012-3a4b-5c6d-7e8f-9a0b1c2d3e4f"
}
}
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation | 操作失败。 |
| InvalidParameterValue | 参数取值错误。 |
| LimitExceeded.InstanceQuota | LimitExceeded.InstanceQuota |
| ResourceInsufficient | 资源不足。 |
文档反馈