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

Ver PDF

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