Actualización más reciente 2025-08-25 GMT+08:00

Consulta de etiquetas de subred

Función

Esta API se utiliza para consultar etiquetas de una subred especificada.

URI

GET /v2.0/{project_id}/subnets/{subnet_id}/tags

Tabla 1 describe los parámetros.

**Tabla 1** Descripción del parámetro
Nombre	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto.
subnet_id	Sí	Especifica el ID de subred, que identifica de forma exclusiva a la subred. Si utiliza la consola de gestión, el valor de este parámetro es el valor Network ID.

Mensaje de solicitud

Parámetro de solicitud

No hay

Ejemplo de la solicitud

GET https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags

Mensaje de la respuesta

Parámetro de respuesta

**Tabla 2** Parámetro de respuesta
Parámetro	Tipo	Descripción
tags	Array of tag objects	Especifica la lista de objetos tag. Para obtener más información, véase Tabla 3.

**Tabla 3** Objetos **tag**
Atributo	Tipo	Descripción
key	String	Especifica la clave de etiqueta. No se puede dejar en blanco. Puede contener un máximo de 36 caracteres. Puede contener letras, dígitos, guiones bajos (_), y guiones (-). La clave de etiqueta de una VPC debe ser única.
value	String	Especifica el valor de etiqueta. Puede contener un máximo de 43 caracteres. Puede contener letras, dígitos, guiones bajos (_), puntos (.) y guiones (-).

Ejemplo de la respuesta

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

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.

Tema principal: Gestión de etiquetas de subred