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> Content Delivery Network> Referencia de la API> API> Configuración del nombre de dominio> Consulta de una lista de referencia
Actualización más reciente 2022-11-03 GMT+08:00
Ver PDF

Consulta de una lista de referencia

Función

Esta API se utiliza para consultar una lista de referencias.

URI

GET /v1.0/cdn/domains/{domain_id}/referer

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

domain_id

Sí

String

Especifica el ID de nombre de dominio acelerado. Para obtener más información, consulte Consulta de detalles sobre un nombre de dominio.
Tabla 2 Parámetros de Query

Parámetro

Obligatorio

Tipo

Descripción

enterprise_project_id

No

String

Proyecto de empresa al que pertenece el recurso. Este parámetro sólo es válido cuando la función de proyecto de empresa está habilitada. El valor all indica todos los proyectos. Este parámetro es obligatorio cuando se utiliza un usuario de IAM para llamar a esta API.

Parámetros de solicitud

Tabla 3 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Especifica el token de usuario.

The token can be obtained by calling the IAM API used to obtain a user token. The value of **X-Subject-Token** in the response header is the user token.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

referer

RefererRsp object

Especifica la configuración de referencia.
Tabla 5 RefererRsp

Parámetro

Tipo

Descripción

referer_type

Integer

Especifica el tipo de regla de filtrado de referencia. Valores posibles: 0 (sin filtro de referencia), 1 (lista negra) y 2 (lista blanca). Valor predeterminado: 0.

referer_list

String

Especifica la configuración de validación de referencia. Se admiten múltiples direcciones IP o nombres de dominio y deben estar separados por punto y coma (;). Este parámetro es obligatorio cuando la validación de referencia está habilitada.

include_empty

Boolean

Especifica si se incluye un referente en blanco en la lista negra o blanca. Si configura una lista negra de referencias y habilita esta función, no se permiten solicitudes sin referencias. Si configura una lista blanca de referencias y habilita esta función, se permiten solicitudes sin referencias. De forma predeterminada, no se incluyen referencias en blanco.

Solicitudes de ejemplo

GET https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff8080***********************d71/referer?enterprise_project_id=0

Ejemplo de respuestas

Código de estado: 200

OK

{
  "referer" : {
    "referer_type" : 1,
    "referer_list" : "www.example1.com;www.example2.com",
    "include_empty" : false
  }
}

Códigos de estado

Código de estado

Descripción

200

OK

Códigos de error

Consulte Códigos de error.