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

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"
  } ]
}