Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Data Encryption Workshop/ Referencia de la API/ APIs/ API de gestión de claves/ Gestión de etiquetas/ Consulta de etiquetas de proyecto
Actualización más reciente 2022-11-03 GMT+08:00
Ver PDF
Compartir

Consulta de etiquetas de proyecto

Función

Esta API le permite consultar todos los conjuntos de etiquetas de un proyecto especificado.

URI

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

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario. El token se puede obtener llamando a la API de IAM (valor de X-Subject-Token en el encabezado de respuesta).
Tabla 3 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

sequence

No

String

Número de secuencia de 36 bytes de un mensaje de solicitud. Ejemplo: 919c82d4-8046-4722-9094-35c3c6524cff

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

tags

Array of Tag objects

Lista de etiquetas, que es una colección de pares clave-valor.

  • key: clave de etiqueta. Un CMK puede tener un máximo de 10 teclas, y cada una de ellas es única y no puede estar vacía. Una clave no puede tener valores duplicados. Consta de hasta 36 caracteres.
  • value: Valor de la etiqueta. Cada valor de etiqueta puede contener un máximo de 43 caracteres. Los valores están en la relación AND.
Tabla 5 Tag

Parámetro

Tipo

Descripción

key

String

Clave. Una clave de etiqueta contiene un máximo de 36 caracteres Unicode. No se puede dejar en blanco. No puede contener caracteres ASCII (0-31), asteriscos (*), corchetes angulares (< y >), barras invertidas (), y signos iguales (=).

values

Array of strings

Conjunto de valores de etiqueta.

Código de estado: 403

Tabla 6 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error

Object

Mensaje de error.
Tabla 7 ErrorDetail

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Información de error.

Solicitudes de ejemplo

Ninguno

Ejemplo de respuestas

Código de estado: 200

El procesamiento de la solicitud se ha realizado correctamente.

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

Código de estado: 403

Error de autenticación.

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

Códigos de estado

Código de estado

Descripción

200

El procesamiento de la solicitud se ha realizado correctamente.

403

Error de autenticación.

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de etiquetas