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/ Elastic IP/ Referencia de la API/ Las API/ Gestión de etiquetas EIP/ Consulta de etiquetas de EIP

Actualización más reciente 2022-11-08 GMT+08:00

Ver PDF

Consulta de etiquetas de EIP

Función

Esta API se utiliza para consultar etiquetas de un EIP especificado.

URI

GET /v2.0/{project_id}/publicips/{publicip_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.
publicip_id	Sí	Especifica el identificador único de un EIP.

Mensaje de solicitud

Parámetro de solicitud

**Tabla 2** Parámetro de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Ejemplo de la solicitud

GET https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags

Mensaje de la respuesta

Parámetro de respuesta

**Tabla 3** Parámetro de respuesta
Parámetro	Tipo	Descripción
tags	Array of tag objects	Especifica la lista de objetos tag. Para más detalles, consulte Tabla 4.

**Tabla 4** 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"
        }
    ]
}