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/ Data Encryption Workshop/ Referência de API/ APIs/ APIs de gerenciamento de chaves/ Gerenciamento de tags/ Consulta de tags de projeto
Atualizado em 2023-03-31 GMT+08:00
Ver PDF
Compartilhar

Consulta de tags de projeto

Função

Essa API permite que você consulte todos os conjuntos de tags de um projeto especificado.

URI

GET /v1.0/{project_id}/kms/tags

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatoriedade

Tipo

Descrição

project_id

Sim

String

ID do projeto.

Parâmetros de solicitação

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

Parâmetro

Obrigatoriedade

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. O token pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho de resposta).
Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatoriedade

Tipo

Descrição

sequence

Não

String

Número de sequência de 36-byte de uma mensagem de solicitação. Exemplo: 919c82d4-8046-4722-9094-35c3c6524cff

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

tags

Array of Tag objects

Lista de tags, que é uma coleção de pares de chave-valor.

  • chave: chave da tag. Uma CMK pode ter no máximo 10 chaves, e cada uma delas é exclusiva e não pode estar vazia. Uma chave não pode ter valores duplicados. É composta por até 36 caracteres.
  • valor: valor da tag. Cada valor de tag pode conter no máximo 43 caracteres. Os valores estão na relação AND.
Tabela 5 Tag

Parâmetro

Tipo

Descrição

key

String

Chave. Uma chave de tag contém um máximo de 36 caracteres Unicode. Não pode ser deixado em branco. Ele não pode conter caracteres ASCII (0–31), asteriscos (*), colchetes angulares (< e >), barras invertidas () e sinais de igual (=).

values

Array of strings

Conjunto de valores de tag.

Código de status: 403

Tabela 6 Parâmetros de corpo da resposta

Parâmetro

Tipo

Descrição

error

Object

Mensagem de erro.
Tabela 7 ErrorDetail

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Informação de erro.

Exemplo de solicitações

Nenhum

Exemplo de respostas

Código de status: 200

Processamento da solicitação bem-sucedido.

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

Código de status: 403

Autenticação falhou.

{
  "error" : {
    "error_code" : "KMS.XXX",
    "error_msg" : "XXX"
  }
}

Códigos de status

Código de status

Descrição

200

Processamento da solicitação bem-sucedido.

403

Autenticação falhou.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de tags