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/ GaussDB(for MySQL)/ Referência de API/ APIs (recomendadas)/ Gerenciamento de tags/ Adição ou exclusão de tags em lotes
Atualizado em 2024-09-29 GMT+08:00
Ver PDF
Compartilhar

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

Função

Essa API é usada para adicionar ou excluir tags de uma instância de BD especificada em lotes. Antes de chamar essa API:

URI

POST /v3/{project_id}/instances/{instance_id}/tags/action

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário em uma região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

instance_id

Sim

String

ID da instância.

Parâmetros de solicitação

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

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida.

Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token.

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us.

Valor:

  • en-us
  • zh-cn
Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

action

Sim

String

Identificador da operação.

Valor:

  • create: adicionar tags
  • delete: excluir tags

tags

Sim

Array of TagItem objects

Lista de tags.
Tabela 4 TagItem

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

String

Chave da tag. Ela contém no máximo 36 caracteres Unicode e não pode ser nula, uma cadeia vazia ou um espaço. Somente dígitos, letras maiúsculas, letras minúsculas, sublinhados (_) e hifens (-) são permitidos.

value

Não

String

Valor da tag. Ele contém um máximo de 43 caracteres Unicode. Pode ser uma cadeia vazia, mas não pode ser um espaço. Somente dígitos, letras maiúsculas, letras minúsculas, sublinhados (_), pontos (.) e hifens (-) são permitidos.

  • Se action estiver definida como create, este parâmetro é obrigatório.
  • Se action estiver definida como delete e value for especificado, as tags serão excluídas por chave e valor. Se value não for especificado, as tags serão excluídas pela chave.

Parâmetros de resposta

Código de status: 400

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

  • Adição de tags em lotes 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/61a4ea66210545909d74a05c27a7179ein07/tags/action
{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}
  • Exclusão de tags em lotes 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/61a4ea66210545909d74a05c27a7179ein07/tags/action
{
  "action" : "delete",
  "tags" : [ {
    "key" : "key1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

Exemplo de resposta

Nenhum

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.

Tópico principal: Gerenciamento de tags