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/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Gerenciamento de tags/ Consulta de tags de recurso
Atualizado em 2023-05-06 GMT+08:00
Ver PDF
Compartilhar

Consulta de tags de recurso

Descrição

Essa API é usada para consultar tags de um recurso especificado.

Restrições

Um máximo de 20 tags pode ser adicionado a uma instância de banco de dados. A chave de tag deve ser única.

Depuração

Você pode depurar essa API no API Explorer.

URI

  • Formato de URI

    GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/tags

  • Exemplo de URI

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/cc6345c64cec47499182467ea0dd432ain02/tags

Solicitações

Descrição do parâmetro

Tabela 1 Parâmetros de solicitação

Nome

Tipo

IN

Obrigatório

Descrição

x-auth-token

string

header

Sim

Token do usuário

project_id

string

path

Sim

ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.

instance_id

string

path

Sim

ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

Respostas

  • Descrição do parâmetro
    Tabela 2 Descrição do parâmetro

    Nome

    Obrigatório

    Tipo

    Descrição

    tags

    Sim

    Array of objects

    A lista de tags. Para obter mais informações, consulte Tabela 3.
    Tabela 3 Descrição da estrutura de dados do campo tags

    Nome

    Obrigatório

    Tipo

    Descrição

    key

    Sim

    String

    A chave da tag. O valor contém 36 caracteres Unicode e não pode ficar em branco.

    Conjunto de caracteres: 0-9, A-Z, a-z, "_" e "-".

    value

    Sim

    String

    O valor da tag. O valor contém um máximo de 43 caracteres Unicode e também pode ser uma cadeia de caracteres vazia.

    Conjunto de caracteres: 0-9, A-Z, a-z, "_", "." e "-".
  • Exemplo de resposta 
    {
  "tags": [
    {
      "key": "key1",
      "value": "value1"
    },
    {
      "key": "key2",
      "value": "value2"
    }
  ]
}

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.

Tópico principal: Gerenciamento de tags