调用InsertCluster接口创建集群。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
POST /pop/v5/resource/cluster HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
ClusterName | String | Query | 是 | ****_product_test2 |
集群名。 |
ClusterType | Integer | Query | 是 | 2 |
集群类型。
|
NetworkMode | Integer | Query | 是 | 2 |
网络类型。
|
LogicalRegionId | String | Query | 否 | cn-beijing:td**** |
自定义命名空间的RegionId。 格式为: |
VpcId | String | Query | 否 | vpc-2zef6ob8mrlzv8x3q**** |
VPC网络ID。若选择VPC网络,此参数为必选。 |
OversoldFactor | Integer | Query | 否 | 2 |
(参数已不适用) Docker集群CPU超卖:
|
IaasProvider | String | Query | 否 | ALIYUN |
IaaS资源供应商。 <note>选择阿里云时,需要使用全大写的拼音,例如 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Cluster | Struct |
创建的集群实体。 |
|
ClusterId | String | 8705ad13-5d86-47fc-b68f-257b59ed**** |
集群ID。 |
ClusterName | String | ****_product_test2 |
集群名称。 |
ClusterType | Integer | 2 |
集群类型。
|
IaasProvider | String | ALIYUN |
供应商。 |
NetworkMode | Integer | 2 |
网络类型。
|
OversoldFactor | Integer | 1 |
(参数已不适用) Docker集群CPU超卖。
|
RegionId | String | cn-beijing |
集群所属地域。 |
VpcId | String | vpc-2zef6ob8mrlzv8x3q**** |
VPC网络ID。 |
Code | Integer | 200 |
接口状态。 |
Message | String | success |
附加信息。 |
RequestId | String | b197-40ab-9155-**** |
请求ID。 |
示例
请求示例
POST /pop/v5/resource/cluster HTTP/1.1
公共请求头
{
"ClusterName": "****_product_test2",
"ClusterType": "2",
"NetworkMode": "2"
}
正常返回示例
XML
格式
<InsertClusterResponse>
<Message>success</Message>
<RequestId>b197-40ab-9155-****</RequestId>
<Cluster>
<OversoldFactor>1</OversoldFactor>
<VpcId>vpc-2zef6ob8mrlzv8x3q****</VpcId>
<ClusterId>8705ad13-5d86-47fc-b68f-257b59ed****</ClusterId>
<ClusterName>****_product_test2</ClusterName>
<RegionId>cn-beijing</RegionId>
<ClusterType>2</ClusterType>
<NetworkMode>2</NetworkMode>
<IaasProvider>ALIYUN</IaasProvider>
</Cluster>
<Code>200</Code>
</InsertClusterResponse>
JSON
格式
{
"Message": "success",
"RequestId": "b197-40ab-9155-****",
"Cluster": {
"OversoldFactor": 1,
"VpcId": "vpc-2zef6ob8mrlzv8x3q****",
"ClusterId": "8705ad13-5d86-47fc-b68f-257b59ed****",
"ClusterName": "****_product_test2",
"RegionId": "cn-beijing",
"ClusterType": 2,
"NetworkMode": 2,
"IaasProvider": "ALIYUN"
},
"Code": 200
}
错误码
访问错误中心查看更多错误码。