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/ Operações de nome de domínio/ Consulta de um nome de domínio

Atualizado em 2022-12-26 GMT+08:00

Ver PDF

Consulta de um nome de domínio

Função

Essa API é usada para consultar um nome de domínio acelerado.

URI

GET /v1.0/cdn/domains/{domain_id}/detail

**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
domain	DomainsWithPort object	Especifica os detalhes do nome de domínio.

**Tabela 5** DomainsWithPort
Parâmetro	Tipo	Descrição
id	String	Especifica a ID do nome de domínio.
domain_name	String	Especifica o nome de domínio.
business_type	String	Especifica o tipo de serviço do nome de domínio. Valores possíveis: web (aceleração de site), download (aceleração de download de arquivos), video (aceleração de VOD) e wholeSite (aceleração de todo o site).
user_domain_id	String	Especifica a ID de domínio do proprietário do nome de domínio.
domain_status	String	Especifica o status do nome de domínio. Valores possíveis: online (CDN ativado), offline (CDN desativado), configuring (sendo configurado), configure_failed (falha na configuração), checking (sendo revisado), check_failed (falha na revisão) e deleting (sendo excluído).
cname	String	Especifica o registro CNAME do nome de domínio.
sources	Array of SourceWithPort objects	Especifica o endereço do servidor de origem. O tipo de endereço pode ser endereço IP ou nome de domínio. Se o tipo de endereço do servidor de origem for endereço IP, apenas os endereços IPv4 são suportados. Se houver vários endereços IP, você deve especificar vários objetos para passar esses endereços, respectivamente, e os valores dos parâmetros, exceto o endereço IP nesses objetos devem ser os mesmos. Você pode especificar até 15 endereços IP para o servidor de origem principal ou em espera. Se o tipo de endereço do servidor de origem for nome de domínio, apenas um nome de domínio é suportado. O tipo de endereço pode ser endereço IP ou nome de domínio.
domain_origin_host	DomainOriginHost object	Especifica as configurações de recuperação do nome de domínio.
https_status	Integer	Especifica se a aceleração HTTPS está ativada.
create_time	Long	Especifica a hora em que o nome de domínio foi criado. O valor é o número de milissegundos desde a época UNIX (1 de janeiro de 1970).
modify_time	Long	Especifica a hora em que o nome de domínio foi modificado. O valor é o número de milissegundos desde a época UNIX (1 de janeiro de 1970).
disabled	Integer	Especifica se o domínio é proibido. Valores possíveis: 0 (não proibido) e 1 (proibido).
locked	Integer	Especifica se o domínio está bloqueado. Valores possíveis: 0 (não bloqueado) e 1 (bloqueado).
auto_refresh_preheat	Integer	Especifica se a atualização automática e o pré-aquecimento estão ativados. Valores possíveis: 0 (desativado) e 1 (ativado).
service_area	String	Especifica a área de serviço da CDN. Valores possíveis: mainland_china (China continental), outside_mainland_china (fora da China continental) e global (global).
range_status	String	Especifica se a recuperação baseada em intervalo está ativada.
follow_status	String	Especifica se a recuperação de redirecionamento está ativada.
origin_status	String	Especifica se a recuperação de conteúdo está desabilitada.
banned_reason	String	Especifica o motivo da desativação do nome de domínio.
locked_reason	String	Especifica o motivo do bloqueio do nome de domínio.
enterprise_project_id	String	ID do projeto empresarial ao qual o recurso pertence. Este parâmetro é válido somente quando a função do projeto empresarial está ativada. Se este parâmetro não for especificado, o projeto padrão será consultado. Esse parâmetro é obrigatório quando você usa um usuário do IAM para chamar essa API.

**Tabela 6** SourceWithPort
Parâmetro	Tipo	Descrição
domain_id	String	ID do nome de domínio.
ip_or_domain	String	Especifica o endereço IP ou nome de domínio do servidor de origem.
origin_type	String	Especificado o tipo do servidor de origem. Valores possíveis: ipaddr (endereço IP do servidor de origem), domain (nome de domínio do servidor de origem), e obs_bucket (nome de domínio de um bucket OBS).
active_standby	Integer	Especifica se o servidor de origem está ativo ou em espera. Valores possíveis: 1 (ativo) e 0 (em espera). Um servidor de origem ativo é obrigatório, enquanto um servidor de origem em espera é opcional.
enable_obs_web_hosting	Integer	Especifica se a hospedagem estática está ativada para um bucket do OBS. Valores possíveis: 0 (desativado) e 1 (ativado). Este parâmetro é passado somente quando origin_type é definido como obs_bucket.
http_port	Integer	Especifica a porta HTTP. Valor padrão: 80.
https_port	Integer	Especifica a porta HTTPS. Valor padrão: 443.

**Tabela 7** DomainOriginHost
Parâmetro	Tipo	Descrição
domain_id	String	Especifica a ID do nome de domínio. Para obter detalhes, consulte Consulta de detalhes sobre um nome de domínio.
origin_host_type	String	Especifica o tipo do host de recuperação.
customize_domain	String	Especifica o nome de domínio personalizado do host de recuperação.

Exemplos de solicitações

GET https://cdn.myhuaweicloud.com/v1.0/cdn/domains/12a***********************345d671/detail?enterprise_project_id=1

Exemplo de respostas

Código de estado: 200

{
  "domain" : {
    "sources" : [ {
      "domain_id" : "12a***********************345d671",
      "origin_type" : "ipaddr",
      "ip_or_domain" : "10.62.53.75",
      "active_standby" : 1,
      "http_port" : 80,
      "https_port" : 443
    } ],
    "cname" : "www.example1.com.c.example2.com",
    "id" : "12a***********************345d671",
    "user_domain_id" : "1a23***********************4a441",
    "domain_name" : "www.example1.com",
    "business_type" : "web",
    "service_area" : "mainland_china",
    "domain_status" : "online",
    "https_status" : 0,
    "create_time" : 1516861994806,
    "modify_time" : 1532405346365,
    "domain_origin_host" : {
      "domain_id" : "12a***********************345d671",
      "origin_host_type" : "customize",
      "customize_domain" : "www.example4.com"
    },
    "disabled" : 0,
    "locked" : 0,
    "range_status" : "off",
    "follow_status" : "off",
    "origin_status" : "on",
    "auto_refresh_preheat" : 0
  }
}