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/Direct Connect/Referência de API/API/Gerenciamento de tags/Adição ou exclusão de tags em lotes
Atualizado em 2023-02-20 GMT+08:00
Ver PDF
Compartilhar

Adição ou exclusão de tags em lotes

Função

  • Essa API é usada para adicionar tags em lote ou excluir tags de um recurso especificado.
  • O Tag Management Service (TMS) precisa usar essa API para gerenciar tags de recursos em lotes.
  • Um recurso pode ter no máximo 10 tags.

URI

POST /v3/{project_id}/{resource_type}/{resource_id}/tags/action

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Especifica o ID do projeto.

resource_id

Sim

String

Especifica o ID do recurso.

resource_type

Sim

String

Especifica o tipo de recurso da Direct Connect.

  • dc-directconnect: conexão
  • dc-vgw: gateway virtual
  • dc-vif: interface virtual

Valores de enumeração:

  • dc-directconnect
  • dc-vgw
  • dc-vif
  • dc-lag

Parâmetros de solicitação

Tabela 2 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

action

Sim

String

Especifica a operação. As opções são as seguintes: createdelete

Valores de enumeração:

  • create
  • delete

tags

Não

Array of Tag objects

Especifica as tags.

sys_tags

Não

Array of Tag objects

Especifica as tags do sistema.

Tabela 3 Tag

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

String

Especifica a chave de tag. A chave pode conter no máximo 36 caracteres Unicode, incluindo letras, dígitos, hifens (-) e sublinhados (_).

Mínimo: 0

Máximo: 36

value

Não

String

Especifica o valor de tag. O valor pode conter no máximo 43 caracteres Unicode, incluindo letras, dígitos, hifens (-) sublinhados (_) e pontos (.).

Mínimo: 0

Máximo: 43

Parâmetros de resposta

Nenhum

Exemplos de solicitações

  • Adição de tags em lote aos recursos 
    POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/action

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}
  • Exclusão em lote de tags de recurso 
    POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/action

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

Exemplo de respostas

Nenhum

Códigos de status

Código de status

Descrição

204

Operação de adição ou exclusão de lote bem-sucedida.

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Gerenciamento de tags