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> Direct Connect> Referencia de la API> API> Gestión de etiquetas> Consulta de recursos por etiqueta
Actualización más reciente 2023-02-13 GMT+08:00
Ver PDF

Consulta de recursos por etiqueta

Función

Esta API se utiliza para consultar las etiquetas de todos los recursos propiedad de un inquilino en un proyecto específico. TMS utiliza esta API para enumerar las etiquetas creadas por un tenant para facilitar la creación de etiquetas y el filtrado de recursos en la consola.

URI

GET /v3/{project_id}/{resource_type}/tags

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

Especifica el ID del proyecto.

resource_type

Sí

String

Especifica el tipo de recurso de Direct Connect.

  • dc-directconnect: conexión
  • dc-vgw: gateway virtual
  • dc-vif: interfaz virtual

Valores de enumeración:

  • dc-directconnect
  • dc-vgw
  • dc-vif
  • dc-lag

Parámetros de solicitud

No hay

Parámetros de respuesta

Código de estado: 200

Tabla 2 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

tags

Array of Tag objects

Especifica las etiquetas.

request_id

String

Especifica el ID de la solicitud.
Tabla 3 Etiqueta

Parámetro

Tipo

Descripción

key

String

Especifica la clave de etiqueta. La clave puede contener un máximo de 36 caracteres de Unicode, incluidos letras, dígitos, guiones (-) y guiones bajos (_).

Mínimo: 0

Máximo: 36

value

String

Especifica el valor de etiqueta. El valor puede contener un máximo de 43 caracteres de Unicode, incluidos letras, dígitos, guiones (-), guiones bajos (_), y puntos (.).

Mínimo: 0

Máximo: 43

Ejemplo de las solicitudes

No hay

Ejemplo de las respuestas

Código de estado: 200

Operación realizada correctamente.

{
  "tags" : [ {
    "key" : 123,
    "value" : null
  } ]
}

Códigos de estado

Código de estado

Descripción

200

Operación realizada correctamente.

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de etiquetas