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

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

OK

{
  "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
  }
}

Códigos de estado

Código de estado

Descrição

200

OK

Códigos de erro

Consulte Códigos de erro.