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/ Criação de um nome de domínio

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

Ver PDF

Criação de um nome de domínio

Função

Esta API é usada para criar um nome de domínio.

URI

POST /v1.0/cdn/domains

Parâmetros de solicitação

**Tabela 1** 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.

**Tabela 2** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
domain	Sim	DomainBody object	Especifica o corpo para a criação de um nome de domínio.

**Tabela 3** DomainBody
Parâmetro	Obrigatório	Tipo	Descrição
domain_name	Sim	String	Especifica o nome de domínio acelerado. O nome de domínio consiste em uma ou mais partes, representando domínios em diferentes níveis. Essas partes, tecnicamente conhecidas como rótulos, são concatenadas e delimitadas por períodos (.). Um rótulo consiste em letras que não diferenciam maiúsculas de minúsculas, números e hífens (-). O nome de domínio pode conter até 50 caracteres. Não inicie ou termine um nome de domínio com hifens (-).
business_type	Sim	String	Especifica o tipo de serviço do nome de domínio. Valores possíveis: web (aceleração estática), download (aceleração de download), video (aceleração de mídia de streaming) e wholeSite (aceleração de todo o site).
sources	Sim	Array of Sources 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.
service_area	Sim	String	Especifica o escopo do serviço CDN. Valores possíveis: mainland_china (China continental), outside_mainland_china (fora da China continental) e global (global).
enterprise_project_id	Não	String	Projeto corporativo ao qual um nome de domínio de aceleração é adicionado. Este parâmetro é válido somente quando a função do projeto empresarial está ativada. Esse parâmetro é obrigatório quando você usa um usuário do IAM para chamar essa API.

**Tabela 4** Fontes
Parâmetro	Obrigatório	Tipo	Descrição
domain_id	Não	String	ID do nome de domínio.
ip_or_domain	Sim	String	Especifica o endereço IP ou nome de domínio do servidor de origem.
origin_type	Sim	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	Sim	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. Um bucket do OBS não tem um servidor de origem em espera.
enable_obs_web_hosting	Não	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.

Parâmetros de resposta

Código de estado: 200

**Tabela 5** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
domain	CreateDomainResponseBodyContent object	Especifica a resposta à solicitação para criar um nome de domínio.

**Tabela 6** CreateDomainResponseBodyContent
Parâmetro	Tipo	Descrição
id	String	Especifica o ID de nome de domínio acelerado.
domain_name	String	Especifica o nome de domínio acelerado.
business_type	String	Especifica o tipo de serviço do nome de domínio. Valores possíveis: web (aceleração estática), download (aceleração de download), video (aceleração de mídia de streaming) e wholeSite (aceleração de todo o site).
service_area	String	Especifica o escopo do serviço CDN. Valores possíveis: mainland_china (China continental), outside_mainland_china (fora da China continental) e global (global).
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 acelerado. Valores possíveis: online (CDN ativado), offline (CDN desativado), configuring (sendo configurado), configure_failed (falha na configuração), checking (sendo revisado), check_failed (rejeitado após revisão) e deleting (sendo excluído).
cname	String	Especifica o registro CNAME do nome de domínio acelerado.
sources	Array of Sources objects	Especifica o servidor de origem.
domain_origin_host	DomainOriginHost object	Especifica a configuração 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).
range_status	String	Especifica o status da recuperação com base em intervalo. Valores possíveis: off e on.
follow_status	String	Especifica o status da recuperação de redirecionamento 302. Valores possíveis: off e on.
origin_status	String	Especifica se a recuperação de conteúdo está desabilitada.
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).

**Tabela 7** Fontes
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. Um bucket do OBS não tem um servidor de origem em espera.
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.

**Tabela 8** 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

POST https://cdn.myhuaweicloud.com/v1.0/cdn/domains

{
  "domain" : {
    "domain_name" : "example1.example2.example3.com",
    "business_type" : "web",
    "sources" : [ {
      "ip_or_domain" : "10.62.53.75",
      "origin_type" : "ipaddr",
      "active_standby" : 1
    } ],
    "service_area" : "mainland_china",
    "enterprise_project_id" : "0"
  }
}

Exemplo de respostas

Código de estado: 200

{
  "domain" : {
    "sources" : [ {
      "domain_id" : "ff80*************************07b",
      "ip_or_domain" : "10.62.53.75",
      "origin_type" : "ipaddr",
      "active_standby" : 1
    } ],
    "id" : "ff80*************************07b",
    "user_domain_id" : "38***********************5024dcb",
    "domain_name" : "example11.example2.example3.com",
    "business_type" : "web",
    "service_area" : "mainland_china",
    "cname" : "example1.example2.example3.com.c.example4.com",
    "domain_status" : "configuring",
    "https_status" : 0,
    "create_time" : 1513152634467,
    "modify_time" : 1513152634467,
    "domain_origin_host" : {
      "domain_id" : "ff80*************************07b",
      "origin_host_type" : "customize",
      "customize_domain" : "example5.example6.com"
    },
    "disabled" : 0,
    "locked" : 0,
    "range_status" : "off",
    "follow_status" : "off",
    "origin_status" : "on",
    "auto_refresh_preheat" : 0
  }
}