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/ Domain Name Service/ Referência de API/ APIs/ Gerenciamento de tags/ Consulta de tags de uma instância específica
Atualizado em 2023-04-24 GMT+08:00

Consulta de tags de uma instância específica

Função

Esta API é usada para consultar tags de uma instância específica.

Depuração

Você pode depurar esta API por meio da autenticação automática no API Explorer ou usar o código de exemplo do SDK gerado pelo API Explorer.

URI

GET /v2/{project_id}/{resource_type}/{resource_id}/tags

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto

resource_type

Sim

String

Tipo de recurso. O valor pode ser DNS-public_zone, DNS-private_zone, DNS-public_recordset, DNS-private_recordset ou DNS-ptr_record.

resource_id

Sim

String

ID do recurso

Parâmetros de solicitação

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

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. Ele pode ser obtido pela chamada de uma API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

tags

Array of tag objects

Lista de tags

Tabela 4 tag

Parâmetro

Tipo

Descrição

key

String

Chave da tag. Uma chave pode conter até 36 caracteres Unicode. Não pode ser deixada em branco. Um valor de tag não pode conter caracteres especiais (=*<>,|/) nem iniciar ou terminar com espaços.

value

String

Valor da tag. Um valor de tag contém no máximo 43 caracteres Unicode e pode ser deixado em branco. Um valor de tag não pode conter caracteres especiais (=*<>,|/) nem iniciar ou terminar com espaços.

Exemplos de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Resposta à solicitação de consulta de tags de recurso

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

Códigos de status

Código de status

Descrição

200

Resposta à solicitação de consulta de tags de recurso

Códigos de erro

Consulte Códigos de erro.