Configuración de una lista de referencia
Función
Esta API se utiliza para configurar una lista de referencias. Los usuarios son identificados y filtrados en función de la lista, por lo que se pueden controlar las fuentes de acceso.
URI
PUT /v1.0/cdn/domains/{domain_id}/referer
|
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. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
enterprise_project_id |
No |
String |
Proyecto de empresa al que pertenece el nombre de dominio que se va a modificar. 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
|
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. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
referer |
Sí |
Referer object |
Especifica la configuración de referencia. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
referer_type |
Sí |
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 |
No |
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 |
No |
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. Valor predeterminado: false. |
Parámetros de respuesta
Código de estado: 200
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
referer |
RefererRsp object |
Especifica la configuración de referencia. |
|
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
PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff8080**********************d71/referer?enterprise_project_id=0
{
"referer" : {
"referer_type" : 1,
"referer_list" : "www.example1.com;www.example2.com",
"include_empty" : false
}
}
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.
