调用CreateVirtualNode创建一个虚拟节点(VNode)。

接口说明

  • 虚拟节点功能处于邀测中,如需使用,请提交工单申请。
  • 调用本接口创建虚拟节点时,系统将自动为您创建一个服务关联角色AliyunServiceRoleForECIVnode,用于访问ECI、ECS、VPC等相关云服务。更多信息,请参见虚拟节点服务关联角色

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateVirtualNode

系统规定参数。取值:CreateVirtualNode

RegionId String cn-hangzhou

地域ID。

ZoneId String cn-hangzhou-b

可用区ID。

SecurityGroupId String sg-2ze81zoc3yl7a3we****

安全组ID。虚拟节点以及该虚拟节点下的ECI实例将加入到该安全组中。

VSwitchId String vsw-2ze23nqzig8inprou****

交换机ID。虚拟节点以及虚拟节点下的ECI实例所使用的交换机。

支持指定多个(最小1个,最多10个)属于同一VPC的交换机。

VirtualNodeName String testNode

虚拟节点的名称。长度为2~128个英文字符,可以包含小写英文字符、数字、半角点号(.)或者短划线(-)。

ResourceGroupId String rg-uf66jeqopgqa9hdn****

资源组ID。

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持ASCII字符,且不能超过64个字符。更多详情,请参阅如何保证幂等性

EnablePublicNetwork Boolean false

是否支持公网。默认为false。

如果设置为true,则虚拟节点将对外暴露一个公网IP。

EipInstanceId String eip-uf66jeqopgqa9hdn****

弹性公网IP的ID。

KubeConfig String JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi******

虚拟节点要连接的K8s集群的KubeConfig。需进行Base64编码后传入。

Tag.N.Key String name

标签键。N的取值范围为1~20。

Tag.N.Value String test

标签值。N的取值范围为1~20。

Taint.N.Key String testKey

污点的Key。

Taint.N.Value String testValue

污点的Value。

Taint.N.Effect String NoSchedule

污点的Effect。取值范围:

  • NoSchedule:不将Pod调度到具有该污点的节点上。
  • NoExecute:不将Pod调度到具有该污点的节点上的同时,驱逐节点上已经存在的Pod。
  • PreferNoSchedule:尽量不将Pod调度到具有该污点的节点上。

返回数据

名称 类型 示例值 描述
RequestId String 89164E78-FC82-4684-BE97-DCDD85D26546

请求ID。

VirtualNodeId String vnd-2ze960zkdqrldeaw****

虚拟节点ID。

示例

请求示例

https://eci.aliyuncs.com/?Action=CreateVirtualNode
&RegionId=cn-hangzhou
&SecurityGroupId=sg-2ze81zoc3yl7a3we****
&VirtualNodeName=testNode
&VSwitchId=vsw-2ze23nqzig8inprou****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateVirtualNodeResponse>
    <RequestId>89164E78-FC82-4684-BE97-DCDD85D26546</RequestId>
    <VirtualNodeId>vnd-2ze960zkdqrldeaw****</VirtualNodeId>
</CreateVirtualNodeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "89164E78-FC82-4684-BE97-DCDD85D26546",
  "VirtualNodeId" : "vnd-2ze960zkdqrldeaw****"
}

错误码

HttpCode 错误码 错误信息 描述
400 Account.Arrearage Your account has an outstanding payment. 账号已经欠费。
400 DryRunOperation Request validation has been passed with DryRun flag set. 此次DryRun预检请求合格。
400 InvalidParameter.CPU.Memory The specified cpu and memory are not allowed cpu,mem不符合规格
400 InvalidParameter.DuplicatedName The container group include containers with duplicate names. 容器组内有重复名字的容器。
400 InvalidParameter.DuplicatedVolumeName The container group includes volumes with duplicate names. 容器组内有重复名字的数据卷。
400 IncorrectStatus %s 指定的实例状态不正确。
400 ServiceNotEnabled %s 该次请求所依赖的服务没有开通,请开通后再试。
400 ImageSnapshot.IncorrectStatus %s 用于镜像缓存的快照状态不正确。
400 ImageSnapshot.NotSupport %s 基于数据盘快照的镜像缓存功能暂未全网开放,如有需要请联系我们。
400 DiskVolume.NotSupport The disk volume is not supported. 云盘卷暂不支持,如有需要请联系我们。
400 RamRole.NotSupport The RAM role is not supported. ram实例角色不支持
400 DiskNumber.LimitExceed The maximum number of disks in an instance is exceeded. 实例下云盘数目超过限制。
400 InvalidPaymentMethod.InsufficientBalance No payment method is specified for your account. We recommend that you add a payment method or add funds to the prepayment balance. 您的账户暂无有效支付方式,请添加支付方式或保持预付款余额充足。
400 DiskVolume.NotInSameZone The instance to be created and the disk are not in the same zone. 即将创建的实例和云盘不在同一可用区。
400 NoPermission You are not authorized to use the "Product on ECI" feature. 您没有云产品on ECI的权限
400 HighCpuMemConfigRequired You need to apply to be added to the whitelist of the specified CPU and memory. 您需要申请CPU高配白名单
400 RecommendEmpty.InstanceTypeFamilyNotMatched The recommended instance type is unavailable in the current zone. Try again later. 当前可用区没有推荐的规格可使用,请稍后重试或者到其他的可用区创建。
400 LocalDiskAmountNotMatch The number of local volumes does not match the instance type. 本地盘数量跟实例规格不匹配
400 Payfor.CreditPayInsufficientBalance Your payment credit line is insufficient. 您的付款信用额度不足。
400 InvalidOperation.KMS.InstanceTypeNotSupport The specified instance is invalid. Only I/O optimized instances support KMS key. 指定的实例无效,只有 I/O 优化类型的实例支持设置“KMS Key”。
400 InvalidParameter.Encrypted.KmsNotEnabled KMS must be enabled for encrypted disks. 加密磁盘需要启用密钥管理服务。
400 InvalidParameter.KMS.EncryptedIllegal After configuring the parameter KmsKeyId, you must enable encryption. 设置参数“KmsKeyId”后,您必须开启加密属性。
400 Ipv6AddressNotSupportVsw IPv6 is not supported in the specified vSwitch. 该交换机暂未开通ipv6地址。
403 OperationDenied.VswZoneMisMatch The specified VSwitchId is not in the specified Zone. 指定的交换机不在可用区
403 QuotaExceeded %s quota exceeded. 用户允许创建的实例已经超过限制
403 Zone.NotOnSale The specified zone is not available for purchase. 创建实例的可用区已经关闭售卖,请更换其他可用区。或者无法在该可用区使用指定 VPC 的虚拟交换机。
403 Forbidden.RiskControl This operation has been identified as an abnormal operation and cannot be processed. 此操作已被确定为一个操作异常,无法处理。
403 Forbidden.SubUser The specified action is not available for you. 当前用户无法执行该操作
403 Forbidden.OnlyForInvitedTest Eci create action is only open to invited users during public beta. Eci公测阶段只对受邀的用户开放。
403 OperationDenied.SecurityGroupMisMatch The specified VSwitchId and SecurityGroupId are not in the same VPC. 指定的交换机和安全组不在同一个VPC下
403 InvalidVSwitchId.IpNotEnough The specified VSwitch does not have enough IP addresses. 交换机没有足够ip地址
403 Forbidden.UserBussinessStatus This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again. 用户处于欠费状态不允许创建,请充值后再尝试。
403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification. 操作被禁止,因为用户还未进行实名认证。
403 InvalidUser.PassRoleForbidden The RAM user is not authorized to assume a RAM role. 子账号用户没有权限使用RAM实例角色
403 OperationDenied.NoStock Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see https://help.aliyun.com/document_detail/157290.html 库存不足,请尝试其它系列或者其它可用区/地域的实例,推荐使用多可用区多规格配置来避免库存不足,更多信息见:https://help.aliyun.com/document_detail/157290.html
403 InvalidParameter.KMS.KeyId.Forbidden You are not authorized to access the specified KMSKeyId. 无权访问指定的 KMSKeyId。
403 NoPermission The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again. RAM 角色 "AliyunECIContainerGroupRole" 不属于 "eci.aliyuncs.com",请检查后重试。
403 Forbidden.AccountClosed The operation is forbidden. Your account has been closed. 操作被禁止,因为用户账户已注销。
403 InvalidOperation.ResourceManagedByCloudProduct The operation is forbidden. The security group has been managed by another cloud product. 安全组由其他云产品管理,禁止操作。
403 Spot.NotMatched %s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see https://help.aliyun.com/document_detail/157290.html %s. 推荐使用多可用区多规格配置来避免库存不足,更多信息见:https://help.aliyun.com/document_detail/157290.html
403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. 我们检测到您的默认信用卡或借记卡存在安全风险。请通过电子邮件中的链接进行验证。
403 CreateServiceLinkedRole.Denied Please make sure the account has ram:CreateServiceLinkedRole permission. 请确保账号拥有ram:CreateServiceLinkedRole权限
404 ImageSnapshot.NotFound The specified snapshot does not exist. 镜像缓存,快照不存在。
404 InvalidDiskId.NotFound The specified disk does not exist. 指定的云盘不存在。
404 InvalidParameter.KMS.KeyId.NotFound The specified KMSKeyId does not exist. 指定的参数“KMSKeyId”不存在。

访问错误中心查看更多错误码。