Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/Cloud Container Engine/Referência de API/APIs/Gerenciamento de tags/Adição de tags de recurso a um cluster especificado em lotes
Atualizado em 2024-09-10 GMT+08:00
Ver PDF
Compartilhar

Adição de tags de recurso a um cluster especificado em lotes

Função

Essa API é usada para adicionar tags de recurso para um cluster especificado em lotes.

  • Cada cluster suporta um máximo de 20 tags de recurso.

  • Esta API é idempotente. Se a tag a ser adicionada tiver a mesma chave de tag e o mesmo valor de tag que uma tag existente, a tag será adicionada. Se a tag a ser adicionada tiver a mesma chave, mas um valor diferente de uma tag existente, a tag substituirá a existente.

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/create

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.

cluster_id

Sim

String

ID do cluster. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

Content-Type

Sim

String

Tipo de corpo da mensagem (formato).

X-Auth-Token

Sim

String

As solicitações para chamar uma API podem ser autenticadas usando um token ou AK/SK. Se a autenticação baseada em token for usada, esse parâmetro é obrigatório e deve ser definido como um token de usuário. Para obter detalhes, consulte Obtenção de um token de usuário.

Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

tags

Sim

Array of ResourceTag objects

Lista de tags de recursos de cluster a serem criadas. Cada cluster suporta um máximo de 20 tags de recurso.

Tabela 4 ResourceTag

Parâmetro

Obrigatório

Tipo

Descrição

key

Não

String

Chave.

  • Não pode ser nula. Máximo de caracteres: 128.

  • Use letras, dígitos e espaços no formato UTF-8.

  • Pode conter os seguintes caracteres especiais: _.:/=+-@.

  • Não é possível iniciar com _sys_.

value

Não

String

Valor.

  • Pode ser nulo, mas não o padrão. Máximo de caracteres: 255.

  • Use letras, dígitos e espaços no formato UTF-8.

  • Pode conter os seguintes caracteres especiais: _.:/=+-@.

Parâmetros de resposta

Nenhum

Exemplo de solicitações

Adição de tags de recurso a um cluster especificado em lotes

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/create

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value3"
  } ]
}

Exemplo de respostas

Nenhum

Códigos de status

Código de status

Descrição

204

Sem conteúdo

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Gerenciamento de tags