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.
Central de ajuda/ Content Delivery Network/ Referência de API/ API/ Configuração de nome de domínio/ Consulta de uma lista de referências
Atualizado em 2022-12-26 GMT+08:00
Ver PDF
Compartilhar

Consulta de uma lista de referências

Função

Esta API é usada para consultar uma lista de referências.

URI

GET /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 o recurso pertence. 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 do 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.

Parâmetros de resposta

Código de estado: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

referer

RefererRsp object

Especifica as configurações de referência.
Tabela 5 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

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

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 estado

Código de estado

Descrição

200

OK

Códigos de erro

Consulte Códigos de erro.