CreateVirtualNode - Elastic Container Instance: Central de Documentação do Alibaba Cloud

Cria um nó virtual (VNode) para conectar a um cluster Kubernetes autogerenciado, permitindo que o cluster escale recursos para Elastic Container Instance (ECI).

Descrição da operação

Ao chamar esta operação para criar um nó virtual, o sistema cria automaticamente uma função vinculada ao serviço chamada AliyunServiceRoleForECIVnode para acessar serviços de nuvem relacionados, como ECI, ECS e VPC. Para mais informações, consulte Função vinculada ao serviço para nós virtuais.
Os nós virtuais são cobrados por quantidade. Cada nó virtual possui um nó residente equivalente a uma instância ECI com 2 vCPUs e 8 GiB de memória. Você será cobrado pelas taxas correspondentes da instância ECI.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

eci:CreateVirtualNode

create

*VirtualNode

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

eci:tag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região.	cn-hangzhou
ZoneId	string	Não	O ID da zona.	cn-hangzhou-b
SecurityGroupId	string	Sim	O ID do grupo de segurança. O nó virtual e as instâncias ECI criadas no nó virtual são adicionados a este grupo de segurança.	sg-2ze81zoc3yl7a3we****
VSwitchId	string	Sim	O ID do vSwitch. O vSwitch usado pelo nó virtual e pelas instâncias ECI criadas no nó virtual. Você pode especificar de 1 a 10 vSwitches que pertençam à mesma VPC.	vsw-2ze23nqzig8inprou****
VirtualNodeName	string	Não	O nome do nó virtual. O nome deve ter de 2 a 128 caracteres e pode conter letras minúsculas, dígitos, pontos (.) e hifens (-).	testNode
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-uf66jeqopgqa9hdn****
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
EnablePublicNetwork	boolean	Não	Especifica se o acesso à rede pública deve ser ativado. Valor padrão: false. Se você definir este parâmetro como true, o nó virtual expõe um endereço IP público.	false
EipInstanceId	string	Não	O ID do Elastic IP Address (EIP).	eip-uf66jeqopgqa9hdn****
KubeConfig	string	Não	O KubeConfig do cluster Kubernetes ao qual o nó virtual se conecta. O valor deve ser codificado em Base64 antes de ser transmitido.	JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi******
CustomResources	string	Não	Os recursos personalizados suportados pelo nó virtual. Se um pod ECI declarar o recurso personalizado correspondente em sua solicitação, o pod será agendado para o VNode. O formato é `resource_name=resource_count`. Separe vários recursos com vírgulas (,).	example1.com=100,example2.com=200
ClusterDomain	string	Não	O nome de domínio do cluster. Após a configuração deste parâmetro, o Kubelet configura todos os contêineres para pesquisar neste domínio, além dos domínios de pesquisa do host.	example.com
ClusterDNS	string	Não	O endereço IP do servidor DNS. Se `dnsPolicy=ClusterFirst` estiver definido em um pod ECI, este valor será usado para fornecer serviços DNS para o contêiner. Você pode especificar vários endereços IP. Separe vários endereços IP com vírgulas (,).	100.1.XX.XX
Tag	array<object>	Não	As informações de tag do nó virtual. Você pode especificar até 20 tags.
	object	Não	As informações de tag do nó virtual.
Key	string	Não	A chave da tag.	name
Value	string	Não	O valor da tag.	test
Taint	array<object>	Não	As informações de taint do nó virtual. Você pode especificar até 20 taints.
	object	Não	As informações de taint do nó virtual.
Key	string	Não	A chave do taint.	testKey
Value	string	Não	O valor do taint.	testValue
Effect	string	Não	O efeito do taint. Valores válidos: NoSchedule: Os pods não são agendados para o nó que possui este taint. NoExecute: Os pods não são agendados para o nó que possui este taint, e os pods existentes no nó são despejados. PreferNoSchedule: De preferência, os pods não são agendados para o nó que possui este taint.	NoSchedule
TlsBootstrapEnabled	boolean	Não	Especifica se o bootstrapping TLS deve ser ativado. Se você ativar esse recurso, use o certificado KubeConfig para o bootstrapping TLS. Valores válidos: true: ativado. false: desativado. Valor padrão: false.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	89164E78-FC82-4684-BE97-DCDD85D26546
VirtualNodeId	string	O ID do nó virtual.	vnd-2ze960zkdqrldeaw****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Account.Arrearage	Your account has an outstanding payment.	A conta possui um pagamento em atraso.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A solicitação de pré-verificação de dry run é válida.
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed
400	InvalidParameter.DuplicatedName	The container group include containers with duplicate names.	O grupo de contêineres contém contêineres com nomes duplicados.
400	InvalidParameter.DuplicatedVolumeName	The container group includes volumes with duplicate names.	O grupo de contêineres contém volumes com nomes duplicados.
400	IncorrectStatus	%s	O status da instância especificado é inválido.
400	ServiceNotEnabled	%s	O serviço do qual esta solicitação depende não foi ativado. Ative o serviço e tente novamente.
400	ImageSnapshot.IncorrectStatus	%s	O snapshot usado para o cache de imagem não está no estado correto.
400	ImageSnapshot.NotSupport	%s	O recurso de cache de imagem baseado em snapshots de disco em nuvem de dados ainda não está disponível em todas as regiões. Entre em contato conosco se precisar desse recurso.
400	DiskVolume.NotSupport	The disk volume is not supported.	Volumes de disco em nuvem não são suportados. Entre em contato conosco se precisar desse recurso.
400	RamRole.NotSupport	The RAM role is not supported.	A função de instância RAM não é suportada.
400	DiskNumber.LimitExceed	The maximum number of disks in an instance is exceeded.	O número de discos em nuvem anexados à instância excedeu o limite.
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.	Sua conta não possui um método de pagamento válido. Adicione um método de pagamento ou mantenha um saldo pré-pago suficiente.
400	DiskVolume.NotInSameZone	The instance to be created and the disk are not in the same zone.	A instância a ser criada e os discos em nuvem não estão na mesma zona.
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.	Você precisa solicitar a lista de permissões para configuração de alta CPU.
400	RecommendEmpty.InstanceTypeFamilyNotMatched	The recommended instance type is unavailable in the current zone. Try again later.	Nenhum tipo de instância recomendado está disponível na zona atual. Tente novamente mais tarde ou crie instâncias em outra zona.
400	LocalDiskAmountNotMatch	The number of local volumes does not match the instance type.	O número de discos locais não corresponde ao tipo de instância.
400	Payfor.CreditPayInsufficientBalance	Your payment credit line is insufficient.	Seu limite de crédito de pagamento é insuficiente.
400	InvalidOperation.KMS.InstanceTypeNotSupport	The specified instance is invalid. Only I/O optimized instances support KMS key.	A instância especificada é inválida. Apenas instâncias otimizadas para E/S suportam a configuração de Chave KMS.
400	InvalidParameter.Encrypted.KmsNotEnabled	KMS must be enabled for encrypted disks.	Discos em nuvem criptografados exigem que o Key Management Service esteja ativado.
400	InvalidParameter.KMS.EncryptedIllegal	After configuring the parameter KmsKeyId, you must enable encryption.	Após definir o parâmetro KmsKeyId, você deve ativar o atributo de criptografia.
400	Ipv6AddressNotSupportVsw	IPv6 is not supported in the specified vSwitch.	O vSwitch não tem o IPv6 ativado.
400	EipAddressPoolIpNotEnough	The ip address of specified PublicIpAddressPool is not enough.	O pool de endereços públicos EIP especificado não possui recursos de endereço suficientes.
400	VnodeDedicatedHostIdAlreadyExist	DedicatedHostId:%s of Vnode:%s already exists.	O DedicatedHostId já existe.
400	DedicatedHostQuotaExceeded	The quota of DedicatedHost is exceeded.	A cota do host dedicado foi excedida.
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.	A zona na qual você deseja criar a instância não está mais disponível para compra. Use uma zona diferente, ou o vSwitch da VPC especificada não pode ser utilizado nesta zona.
403	Forbidden.RiskControl	This operation has been identified as an abnormal operation and cannot be processed.	Esta operação foi identificada como anormal e não pode ser processada.
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.	A operação é proibida porque a conta possui um pagamento em atraso. Recarregue sua conta e tente novamente.
403	Forbidden.UserNotRealNameAuthentication	This operation is not allowed, because you have not passed the real-name verification.	A operação é proibida porque o usuário não concluiu a verificação de nome real.
403	InvalidUser.PassRoleForbidden	The RAM user is not authorized to assume a RAM role.	O usuário RAM não tem permissão para usar a função de instância RAM.
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.	Você não tem permissão para acessar o KmsKeyId especificado.
403	Forbidden.AccountClosed	The operation is forbidden. Your account has been closed.	A operação é proibida porque a conta de usuário foi desregistrada.
403	InvalidOperation.ResourceManagedByCloudProduct	The operation is forbidden. The security group has been managed by another cloud product.	O grupo de segurança é gerenciado por outro serviço de nuvem e não pode ser modificado.
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.	Um risco de segurança foi detectado no seu cartão de crédito ou débito padrão. Verifique seu cartão usando o link no e-mail.
403	CreateServiceLinkedRole.Denied	Please make sure the account has ram:CreateServiceLinkedRole permission.	Certifique-se de que a conta tenha a permissão ram:CreateServiceLinkedRole.
404	ImageSnapshot.NotFound	The specified snapshot does not exist.	O snapshot para o cache de imagem não existe.
404	InvalidDiskId.NotFound	The specified disk does not exist.	O disco em nuvem especificado não existe.
404	InvalidParameter.KMS.KeyId.NotFound	The specified KMSKeyId does not exist.	O KmsKeyId especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.