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
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
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. |
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 (.). |
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
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.