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

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: create delete

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.