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 Backup and Recovery/ Referência de API/ APIs do CBR/ Tags/ Adição ou exclusão de tags de um cofre em lote
Atualizado em 2023-04-26 GMT+08:00

Adição ou exclusão de tags de um cofre em lote

Função

Esta API é usada para adicionar ou excluir tags em lote de uma instância especificada. O TMS usa essa API para gerenciar tags de recursos de serviço. Um recurso pode ter no máximo 10 tags. Esta API é idempotente. Se houver chaves duplicadas no corpo da solicitação quando você adicionar tags, um erro será relatado. Se uma tag a ser adicionada tiver a mesma chave que uma tag existente, a tag será adicionada e substituirá a tag existente. Ao excluir tags, você pode fazer upload de chaves duplicadas. Ao excluir tags, se algumas tags não existirem, a exclusão é considerada bem-sucedida por padrão. O conjunto de caracteres das tags não será verificado. Uma chave e um valor podem consistir individualmente em até 127 e 255 caracteres. Quando você exclui tags, a estrutura de tags não pode estar ausente e a chave não pode ser deixada em branco ou ser uma cadeia vazia.

URI

POST /v3/{project_id}/vault/{vault_id}/tags/action

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto

vault_id

Sim

String

ID do recurso

Parâmetros de solicitação

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

Parâmetro

Obrigatório

Tipo

Descrição

Tags

Não

Array of Tag objects

Lista de tags

Esta lista não pode ser uma lista vazia.

A lista pode conter até 10 chaves.

As chaves nesta lista devem ser exclusivas.

sys_tags

Não

Array of SysTag objects

Lista de tags do sistema

Este campo está disponível apenas para a permissão op_service. Escolha este campo ou tags.

Atualmente, as chamadas TMS contêm apenas uma estrutura resource_tag. A chave é fixada como as _sys_enterprise_project_id.

O valor é o UUID ou 0. Valor 0 indica o projeto empresarial padrão.

Atualmente, apenas a operação de criação é suportada.

action

Sim

String

Operação a ser realizada. O valor pode ser definido apenas para create ou delete.

Enumeration values:

  • create
  • delete
Tabela 3 Tag

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

String

Chave

Pode conter no máximo 36 caracteres.

Não pode ser uma cadeia vazia.

Espaços antes e depois de uma chave serão descartados.

Não pode conter os seguintes caracteres: ASCII (0-31), sinais de igual (=), asteriscos (*), parênteses angulares esquerdos (<), parênteses angulares direitos (>), barras invertidas (), vírgulas (,), barras verticais (|) e barras (/).

Pode conter apenas caracteres chineses, letras, dígitos, hifens (-) e sublinhados (_).

value

Não

String

Valor

É obrigatório quando uma tag é adicionada e opcional quando uma tag é excluída.

Pode conter no máximo 43 caracteres.

Pode ser uma cadeia vazia.

Espaços antes e depois de um valor serão descartados.

Não pode conter os seguintes caracteres: ASCII (0-31), sinais de igual (=), asteriscos (*), parênteses angulares esquerdos (<), parênteses angulares direitos (>), barras invertidas (), vírgulas (,), barras verticais (|) e barras (/).

Pode conter apenas caracteres chineses, letras, dígitos, hifens (-), sublinhados (_), e pontos (.).

Tabela 4 SysTag

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

String

Chave. Chave da tag do sistema, que é obtida da lista branca e não pode ser definida aleatoriamente. Atualmente, apenas o campo _sys_enterprise_project_id é suportado e o value correspondente indica o ID do projeto empresarial.

value

Sim

String

Valor. Atualmente, somente o ID do projeto empresarial é usado. O ID de projeto empresarial padrão é 0.

Parâmetros de resposta

Código de status: 400

Tabela 5 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Para obter detalhes, consulte Códigos de erro.

error_msg

String

Mensagem de erro

Exemplo de solicitações

Exemplo de solicitação

POST  https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action

{
  "tags" : [ {
    "key" : "string",
    "value" : "string"
  }, {
    "key" : "string1",
    "value" : "string2"
  } ],
  "action" : "create"
}

Exemplo de respostas

Nenhum

Códigos de estado

Código de status

Descrição

204

No Content

400

Bad Request

Códigos de erro

Consulte Códigos de erro.