CreateVirtualNode - Elastic Container Instance - Centro de documentación de Alibaba Cloud

Crea un nodo virtual (VNode) para conectarse a un clúster de Kubernetes autoadministrado, lo que permite al clúster escalar recursos hacia Elastic Container Instance (ECI).

Descripción de la operación

Al llamar a esta operación para crear un nodo virtual, el sistema crea automáticamente un rol vinculado al servicio llamado AliyunServiceRoleForECIVnode para acceder a servicios en la nube relacionados como ECI, ECS y VPC. Para obtener más información, consulte Rol vinculado al servicio para nodos virtuales.
Los nodos virtuales se facturan por cantidad. Cada nodo virtual tiene un nodo residente equivalente a una instancia de ECI con 2 vCPU y 8 GiB de memoria. Se le cobrarán las tarifas correspondientes de la instancia de ECI.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

eci:CreateVirtualNode

create

*VirtualNode

acs:eci:{#regionId}:{#accountId}:virtualnode/*

eci:tag

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región.	cn-hangzhou
ZoneId	string	No	El ID de la zona.	cn-hangzhou-b
SecurityGroupId	string	Sí	El ID del security group. El nodo virtual y las instancias de ECI creadas en el nodo virtual se agregan a este security group.	sg-2ze81zoc3yl7a3we****
VSwitchId	string	Sí	El ID del vSwitch. El vSwitch utilizado por el nodo virtual y las instancias de ECI creadas en el nodo virtual. Puede especificar de 1 a 10 vSwitches que pertenezcan a la misma VPC.	vsw-2ze23nqzig8inprou****
VirtualNodeName	string	No	El nombre del nodo virtual. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras minúsculas, dígitos, puntos (.) y guiones (-).	testNode
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-uf66jeqopgqa9hdn****
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-426655440000
EnablePublicNetwork	boolean	No	Especifica si se debe habilitar el acceso a la red pública. Valor predeterminado: false. Si establece este parámetro en true, el nodo virtual expone una dirección IP pública.	false
EipInstanceId	string	No	El ID de la dirección IP elástica (EIP).	eip-uf66jeqopgqa9hdn****
KubeConfig	string	No	El KubeConfig del clúster de Kubernetes al que se conecta el nodo virtual. El valor debe estar codificado en Base64 antes de pasarse.	JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi******
CustomResources	string	No	Los recursos personalizados admitidos por el nodo virtual. Si un pod de ECI declara el recurso personalizado correspondiente en su solicitud, el pod se programa en el VNode. El formato es `resource_name=resource_count`. Separe múltiples recursos con comas (,).	example1.com=100,example2.com=200
ClusterDomain	string	No	El nombre de dominio del clúster. Después de configurar este parámetro, Kubelet configura todos los contenedores para buscar en este dominio además de los dominios de búsqueda del host.	example.com
ClusterDNS	string	No	La dirección IP del servidor DNS. Si se establece `dnsPolicy=ClusterFirst` en un pod de ECI, este valor se utiliza para proporcionar servicios DNS al contenedor. Puede especificar varias direcciones IP. Separe múltiples direcciones IP con comas (,).	100.1.XX.XX
Tag	array<object>	No	La información de etiquetas del nodo virtual. Puede especificar hasta 20 etiquetas.
	object	No	La información de etiquetas del nodo virtual.
Key	string	No	La clave de la etiqueta.	name
Value	string	No	El valor de la etiqueta.	test
Taint	array<object>	No	La información de taints del nodo virtual. Puede especificar hasta 20 taints.
	object	No	La información de taints del nodo virtual.
Key	string	No	La clave del taint.	testKey
Value	string	No	El valor del taint.	testValue
Effect	string	No	El efecto del taint. Valores válidos: NoSchedule: Los pods no se programan en el nodo que tiene este taint. NoExecute: Los pods no se programan en el nodo que tiene este taint, y los pods existentes en el nodo se desalojan. PreferNoSchedule: Se prefiere no programar pods en el nodo que tiene este taint.	NoSchedule
TlsBootstrapEnabled	boolean	No	Especifica si se debe habilitar el arranque TLS. Si habilita esta función, utilice el certificado de KubeConfig para el arranque TLS. Valores válidos: true: habilitado. false: deshabilitado. Valor predeterminado: false.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	89164E78-FC82-4684-BE97-DCDD85D26546
VirtualNodeId	string	El ID del nodo virtual.	vnd-2ze960zkdqrldeaw****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	Account.Arrearage	Your account has an outstanding payment.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed
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.
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.
400	HighCpuMemConfigRequired	You need to apply to be added to the whitelist of the specified CPU and memory.
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.
400	InvalidParameter.Encrypted.KmsNotEnabled	KMS must be enabled for encrypted disks.
400	InvalidParameter.KMS.EncryptedIllegal	After configuring the parameter KmsKeyId, you must enable encryption.
400	Ipv6AddressNotSupportVsw	IPv6 is not supported in the specified vSwitch.
400	EipAddressPoolIpNotEnough	The ip address of specified PublicIpAddressPool is not enough.
400	VnodeDedicatedHostIdAlreadyExist	DedicatedHostId:%s of Vnode:%s already exists.
400	DedicatedHostQuotaExceeded	The quota of DedicatedHost is exceeded.
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.
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.
403	OperationDenied.SecurityGroupMisMatch	The specified VSwitchId and SecurityGroupId are not in the same VPC.
403	InvalidVSwitchId.IpNotEnough	The specified VSwitch does not have enough IP addresses.
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.
403	NoPermission	The RAM role does not belong to ECS.
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://www.alibabacloud.com/help/document_detail/157290.html
403	InvalidParameter.KMS.KeyId.Forbidden	You are not authorized to access the specified KMSKeyId.
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://www.alibabacloud.com/help/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.
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.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.