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> Consulta de tags de um recurso associado
Atualizado em 2023-04-26 GMT+08:00

Consulta de tags de um recurso associado

Função

Esta API é usada para consultar tags de um recurso especificado. O TMS usa essa API para consultar todas as tags de um recurso especificado.

URI

GET /v3/{project_id}/vault/{vault_id}/tags

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

Nenhum

Parâmetros de resposta

Código de status: 200

Tabela 2 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

tags

Array of Tag objects

Lista de tags As chaves na lista de tags devem ser exclusivas.

sys_tags

Array of SysTag objects

Somente usuários com a permissão op_service podem obter esse campo. Atualmente, apenas resource_tag está incluído. key: _sys_enterprise_project_idvalue: ID do projeto empresarial. Valor 0 indica o projeto empresarial padrão. Esse campo não é retornado no cenário non-op_service.

Tabela 3 Tag

Parâmetro

Tipo

Descrição

key

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

String

Value

É 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

Tipo

Descrição

key

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

String

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

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

GET https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags

Exemplo de respostas

Código de status: 200

OK

{ "tags" : [ { "key" : "string", "value" : "" } ] }

Código de status: 400

Bad Request

{ "error_code" : "BackupService.9900", "error_msg" : "Invalid vault_id provided." }

Códigos de status

Código de status

Descrição

200

OK

400

Bad Request

Códigos de erro

Consulte Códigos de erro.