本接口用于生成边缘节点池的纳管脚本。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | CreateBatchEdgeMachine | 公共参数。该参数表示接口名称。本接口取值为 |
Version | String | 是 | 2021-03-03 | 公共参数。该参数表示接口版本。 本接口取值为 |
ClusterId | String | 是 | ccd17msvqtofo******** | 集群的 ID。 说明 集群必须处于 |
NodePoolId | String | 是 | pcd7a3l7qtof********* | 节点池 ID。 |
TTLHours | int64 | 是 | 2 | 有效时间 |
CreateClientToken | String | 否 | "doigjalfajglaarf4tejyhsed234" | 幂等创建token |
POST https://veecp.volcengineapi.com/?Action=CreateBatchEdgeMachine&Version=2021-03-03&<其他公共参数> { "ClusterId": "ccd17msvqtofo********", "NodePoolId": "pcd7a3l7qtof*********", "TTLHours": 2 }
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
Id | string | "nci5bdn7qtofk******" | 纳管脚本的 ID |
{ "ResponseMetadata": { "RequestId": "2023061514594*********", "Action": "CreateBatchEdgeMachine", "Version": "2021-03-03", "Service": "veecp_openapi", "Region": "cn-beijing" }, "Result": { "Ids": [ "nci5bdn7qtofk******" ] } }
本接口错误码如下表所示，其他错误码请参见错误码
状态码 | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | NotFound.DefaultNodePool | The default node pool is not found. | 默认节点池不存在，请先创建默认节点池。 |
400 | QuotaExceeded.Node | The number of nodes in cluster has reached the limit. | 您当前集群所要创建的节点数量超出系统限额，您可以选择其他集群，也可以提交工单申请提高限额。 |
400 | OperationDenied.NodePoolStatus | The action has been forbidden due to wrong node pool status {{statusPhase}} and [{{statusConditions}}]. | 节点池当前状态不支持该操作。请确认该接口依赖的节点池状态后重试。 |
400 | ClusterVpcMismatch.{{parameter}} | The specified {{resourceType}} {{resourceId}} is not in the VPC of cluster. | 指定的云服务器实例与集群不属于同一个私有网络，请确保两者属于同一私有网络。 |
400 | LimitExceeded.NodeInCluster | The number of nodes exceeds the cluster defined pods config limit. | Flannel 容器网络类型下，当前集群节点数超出了集群支持的最大节点数。 |
409 | AlreadyExists.{{parameter}} | The specified {{resourceType}} {{resourceId}} has already been included. | 指定的云服务器实例已加入默认节点池 |
400 | AlreadyInUse.{{parameter}} | The specified {{resourceType}} {{resourceId}} has already been used in another cluster. | 指定的云服务器实例已加入其他集群，请更换其他实例或者将该实例移除其当前所在集群。 |
400 | OperationDenied.InstanceStatus | The operation has been denied due to the wrong status of the specified ECS instance {{instanceId}}. | 云服务器实例当前状态不支持该操作。请确认调用该接口时的云服务器实例状态要求后重试。 |
400 | ZoneMismatch.Instance | The specified ECS instance {{instanceId}} is not in the cluster defined zones. | 云服务器实例不在集群支持的可用区内。当前不支持修改集群可用区配置，请使用匹配集群可用区的云服务器实例。 |
400 | OperationDenied.ClusterStatus | The action has been denied due to wrong cluster status {{statusPhase}} and [{{statusConditions}}]. | 指定集群的当前状态不支持该操作。请确认该接口依赖的集群状态后重试。 |
400 | NotSupported.{{parameter}} | The specified {{resourceType}} {{resourceContent}} is not supported. | 指定参数不支持，如 InstanceType、ImageId 等。请确认参数后重试。 |