As tags permitem agrupar e gerenciar instâncias do ECI, o que simplifica a filtragem e as operações em lote.
Informações básicas
Ao usar a OpenAPI ou o console do Elastic Container Instance para gerenciar instâncias do ECI, utilize tags para rotular instâncias com os mesmos requisitos de gerenciamento ou de negócios.
Observe os seguintes limites para tags:
Cada tag consiste em um par chave-valor. A chave da tag deve ser única por recurso.
As tags são específicas da região.
Cada instância do ECI aceita no máximo 20 tags.
-
Não é possível excluir tags individualmente.
NotaA exclusão de uma instância do ECI também remove suas tags.
Crie uma instância do ECI com tags
API
Ao chamar a operação da API CreateContainerGroup para criar uma instância do ECI, use o parâmetro Tag para definir as tags. A tabela a seguir descreve os parâmetros relacionados. Para mais informações, consulte CreateContainerGroup.
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
Tag.N.Key |
String |
version |
Chave da tag. O valor de N varia de 1 a 20. A chave não pode ser uma string vazia e deve ser única. Pode ter até 64 caracteres e não pode começar com |
|
Tag.N.Value |
String |
2.0 |
Valor da tag. O valor de N varia de 1 a 20. O valor pode ser uma string vazia. Pode ter até 128 caracteres, não pode começar com |
Console
Ao criar uma instância do ECI na página de compra do Elastic Container Instance, adicione tags na seção Other Settings.
Por exemplo, adicione uma tag com a chave version e o valor 2.0, além de outra tag com a chave type e o valor eci. Para adicionar mais tags, clique em + Add Tag.
Consulte as tags de instâncias do ECI
API
A chamada à API DescribeContainerGroups para consultar uma instância do ECI retorna as tags vinculadas no campo Tags da resposta. Nesse campo, Key representa a chave da tag e Value representa o valor da tag. Para mais informações, consulte DescribeContainerGroups.
Console
No console do Elastic Container Instance, na página Container Groups, localize a instância desejada e passe o ponteiro do mouse sobre o ícone de tag na coluna Tags para visualizar as tags vinculadas.
Filtre instâncias do ECI por tags
Após adicionar tags às instâncias do ECI, utilize-as para filtragem e autorização.
API
Ao chamar a operação da API DescribeContainerGroups para consultar instâncias do ECI, passe parâmetros relacionados a Tag para filtrar os resultados. Para mais informações, consulte DescribeContainerGroups.
Console
No console do Elastic Container Instance, na página Container Groups, filtre as instâncias do ECI por tags.
Na barra de pesquisa, selecione o filtro Elastic Container Group Tag e insira um par chave-valor, como version:2.0. A página exibirá apenas as instâncias do ECI correspondentes a essa condição de tag.
Se você usar usuários do RAM para gerenciar recursos do ECI, poderá utilizar autorização baseada em tags. Esse recurso permite conceder a um usuário do RAM permissões para operar apenas em recursos do ECI com tags específicas. Para mais informações, consulte Autorizar usuários do RAM com base em tags.
Atualize as tags de instâncias do ECI
Antes de atualizar as tags, consulte quais tags estão vinculadas à instância do ECI. Durante uma atualização, só é possível adicionar novas tags ou modificar as existentes; não é possível excluir tags.
API
Ao chamar a operação da API UpdateContainerGroup para atualizar uma instância do ECI, passe novos parâmetros de Tag para modificar as tags. A tabela a seguir descreve os parâmetros relacionados. Para mais informações, consulte UpdateContainerGroup.
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
Tag.N.Key |
String |
version |
Chave da tag. O valor de N varia de 1 a 20. A chave não pode ser uma string vazia e deve ser única. Pode ter até 64 caracteres e não pode começar com |
|
Tag.N.Value |
String |
2.0 |
Valor da tag. O valor de N varia de 1 a 20. O valor pode ser uma string vazia. Pode ter até 128 caracteres, não pode começar com |
Console
Para atualizar as tags de uma instância existente do ECI, acesse a página Container Groups no console do Elastic Container Instance, localize a instância e modifique suas tags.
Na área de configuração de tags, insira os pares chave-valor. Por exemplo, adicione uma tag com a chave version e o valor 3.0, além de outra tag com a chave type e o valor eci. Clique em + Add Tag para adicionar mais tags. É possível adicionar até 20 tags no total.