Configuração de uma lista de referências
Função
Essa API é usada para configurar uma lista de referências. Os usuários são identificados e filtrados com base na lista, para que as fontes de acesso possam ser controladas.
URI
PUT /v1.0/cdn/domains/{domain_id}/referer
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| domain_id | Sim | String | Especifica o ID de nome de domínio acelerado. Para obter detalhes, consulte Consulta de detalhes sobre um nome de domínio. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| enterprise_project_id | Não | String | Projeto corporativo ao qual pertence o nome de domínio a ser modificado. Este parâmetro é válido somente quando a função do projeto empresarial está ativada. O valor all indica todos os projetos. Esse parâmetro é obrigatório quando você usa um usuário do IAM para chamar essa API. |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| X-Auth-Token | Sim | String | Especifica o token do usuário. 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âmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| referer | Sim | Referer object | Especifica as configurações de referência. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| referer_type | Sim | Integer | Especifica o tipo da regra de filtragem de referência. Valores possíveis: 0 (sem filtragem de referências), 1 (lista negra) e 2 (lista branca). Valor padrão: 0. |
| referer_list | Não | String | Especifica a configuração de validação do referenciador. Múltiplos endereços IP ou nomes de domínio são suportados e devem ser separados por ponto-e-vírgula (;). Este parâmetro é obrigatório quando a validação de referência está ativada. |
| include_empty | Não | Boolean | Especifica se uma referência em branco é incluída na lista negra ou na lista branca. Se você configurar uma lista negra de referências e habilitar essa função, solicitações sem referências não serão permitidas. Se você configurar uma lista branca de referências e habilitar essa função, solicitações sem referências serão permitidas. Valor padrão: false. |
Parâmetros de resposta
Código de estado: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| referer | RefererRsp object | Especifica as configurações de referência. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| referer_type | Integer | Especifica o tipo da regra de filtragem de referência. Valores possíveis: 0 (sem filtragem de referências), 1 (lista negra) e 2 (lista branca). Valor padrão: 0. |
| referer_list | String | Especifica a configuração de validação do referenciador. Múltiplos endereços IP ou nomes de domínio são suportados e devem ser separados por ponto-e-vírgula (;). Este parâmetro é obrigatório quando a validação de referência está ativada. |
| include_empty | Boolean | Especifica se uma referência em branco é incluída na lista negra ou na lista branca. Se você configurar uma lista negra de referências e habilitar essa função, solicitações sem referências não serão permitidas. Se você configurar uma lista branca de referências e habilitar essa função, solicitações sem referências serão permitidas. Por padrão, referências em branco não são incluídas. |
Exemplos de solicitações
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
}
} Exemplo de respostas
Código de estado: 200
OK
{
"referer" : {
"referer_type" : 1,
"referer_list" : "www.example1.com;www.example2.com",
"include_empty" : false
}
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | OK |
Códigos de erro
Consulte Códigos de erro.
