AttachInstances - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Adiciona instâncias existentes do Elastic Compute Service (ECS) a um cluster do Container Service for Kubernetes (ACK). Quando você precisar adicionar uma instância ECS como nó de trabalho a um cluster ACK ou readicionar um nó de trabalho ao cluster, poderá chamar esta operação.

Descrição da operação

Antes de chamar esta API, leia atentamente os Limites de uso para garantir que as instâncias ECS a serem adicionadas atendam às condições.

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

cs:AttachInstances

update

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

Nenhuma

Sintaxe da solicitação

POST /clusters/{ClusterId}/attach HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster.	c106f377e16f34eb1808d6b9362c9****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	Os parâmetros do corpo da solicitação.
instances	array	Sim	As instâncias ECS que você deseja adicionar.
	string	Não	O ID da instância ECS.	i-2zed0sswuau6o89b****
key_pair	string	Não	O nome do par de chaves usado para fazer login nas instâncias ECS. Você deve especificar este parâmetro ou login_password. Nota Este parâmetro não é suportado se você especificar nodepool_id.	security-key
password	string	Não	A senha de login SSH usada para fazer login nas instâncias ECS. Você deve especificar este parâmetro ou key_pair. A senha deve ter de 8 a 30 caracteres e conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. A senha não pode conter barras invertidas () ou aspas duplas ("). A senha é criptografada durante a transferência de dados para garantir a segurança.	Hello1234
format_disk	boolean	Não	Especifica se os dados e imagens dos contêineres devem ser armazenados em discos de dados. Valor válido: true: armazena dados e imagens de contêineres em discos de dados. false: não armazena dados ou imagens de contêineres em discos de dados. Valor padrão: false. Como os discos de dados são anexados: Se a instância ECS já tiver discos de dados anexados e o sistema de arquivos do último disco de dados não estiver inicializado, o sistema formata automaticamente este disco de dados para ext4. Em seguida, o sistema usa o disco para armazenar os dados nos diretórios /var/lib/docker e /var/lib/kubelet. Se nenhum disco de dados estiver anexado à instância ECS, o sistema não compra um novo disco de dados. Nota Se você optar por armazenar dados e imagens de contêineres em discos de dados e um disco de dados já estiver anexado à instância ECS, os dados originais neste disco de dados serão apagados. Você pode fazer backup do disco para evitar perda de dados.	false
keep_instance_name	boolean	Não	Especifica se o nome da instância deve ser mantido. Valor válido: true: mantém o nome da instância. false: não mantém o nome da instância. Valor padrão: false.	false
is_edge_worker	boolean	Não	Especifica se o nó que você deseja adicionar é um nó do Edge Node Service (ENS). Valor válido: true: o nó que você deseja adicionar é um nó ENS. false: o nó que você deseja adicionar não é um nó ENS. Valor padrão: false. Nota Se o nó que você deseja adicionar for um nó ENS, você deve definir o valor como true. Isso permite identificar o nó.	false
nodepool_id	string	Não	O ID do pool de nós ao qual o nó é adicionado. Se você não especificar este parâmetro, o nó será adicionado ao pool de nós padrão.	np615c0e0966124216a0412e10afe0****
image_id	string	Não	O ID da imagem personalizada. Se você não especificar este parâmetro, a imagem padrão do sistema será usada. Nota Se você especificar uma imagem personalizada, a imagem personalizada será usada para implantar o sistema operacional no disco do sistema do nó. Este parâmetro não é suportado se você especificar nodepool_id.	aliyun_2_1903_x64_20G_alibase_20200529.vhd
cpu_policy	string	Não	A política de gerenciamento de CPU do nó. As seguintes políticas são suportadas se a versão do Kubernetes do cluster for 1.12.6 ou posterior: static: permite que pods com características de recursos específicas no nó recebam afinidade e exclusividade de CPU aprimoradas. none: usa a afinidade de CPU padrão. Valor padrão: none Nota Este parâmetro não é suportado se você especificar nodepool_id.	none
user_data	string	Não	Os dados definidos pelo usuário no nó. Para obter mais informações, consulte Usar dados do usuário da instância para executar comandos ou scripts automaticamente na inicialização da instância. Nota Este parâmetro não é suportado se você especificar nodepool_id.	IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
rds_instances	array	Não	Uma lista de instâncias do ApsaraDB RDS.
	string	Não	O ID da instância do ApsaraDB RDS. Nota Este parâmetro não é suportado se você especificar nodepool_id.	rm-67yawhau****
runtime	runtime	Não	O runtime de contêiner. Nota Este parâmetro não é suportado se você especificar nodepool_id.
tags	array	Não	Os rótulos que você deseja adicionar ao nó. Ao adicionar rótulos a um nó, as seguintes regras se aplicam: Um rótulo é um par chave-valor que diferencia maiúsculas de minúsculas. Você pode adicionar até 20 rótulos. A chave deve ser única e não pode exceder 64 caracteres. O valor pode estar vazio e não pode exceder 128 caracteres. Chaves e valores não podem começar com aliyun, acs:, https:// ou http://. Para obter mais informações, consulte Rótulos e Seletores. Nota Este parâmetro não é suportado se você especificar nodepool_id.
	tag	Não	Os rótulos que você deseja adicionar ao nó.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
list	array<object>	Os detalhes dos nós adicionados.
	object
code	string	O código que indica o resultado da tarefa.	200
instanceId	string	O ID da instância ECS.	i-2ze0lgm3y6iylcbt****
message	string	Indica se a instância ECS foi adicionada com sucesso ao cluster ACK.	successful
task_id	string	O ID da tarefa.	T-5a544aff80282e39ea00****

Exemplos

Resposta de sucesso

JSON formato

{
  "list": [
    {
      "code": "200",
      "instanceId": "i-2ze0lgm3y6iylcbt****",
      "message": "successful"
    }
  ],
  "task_id": "T-5a544aff80282e39ea00****"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.