Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2022-12-26 GMT+08:00

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

Tabela 1 Parâmetros de caminho

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.

Tabela 2 Parâmetros de consulta

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

Tabela 3 Parâmetros de cabeçalho 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.
Tabela 4 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

referer

Sim

Referer object

Especifica as configurações de referência.

Tabela 5 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

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

referer

RefererRsp object

Especifica as configurações de referência.

Tabela 7 RefererRsp

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.