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.
