Desativação de CDN para um nome de domínio
Função
Essa API é usada para desativar o CDN para um nome de domínio.
URI
PUT /v1.0/cdn/domains/{domain_id}/disable
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. |
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
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
Parâmetro |
Tipo |
Descrição |
---|---|---|
domain |
DomainsWithPort object |
Especifica os detalhes do nome de domínio. |
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. |
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. |
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
PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff8080***********************722/disable?enterprise_project_id=0
Exemplo de respostas
Código de estado: 200
OK
{ "domain" : { "sources" : [ { "domain_id" : "ff8080***********************722", "origin_type" : "ipaddr", "ip_or_domain" : "10.62.53.75", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ], "cname" : "www.example1.example2.0002.example3.com.c.example4.com", "id" : "ff8080***********************722", "user_domain_id" : "6e358***********************a441", "domain_name" : "www.example1.example2.0002.example3.com", "business_type" : "web", "service_area" : "mainland_china", "domain_status" : "configuring", "https_status" : 0, "create_time" : 1532403213673, "modify_time" : 1532403548714, "domain_origin_host" : { "domain_id" : "ff8080***********************722", "origin_host_type" : "accelerate", "customize_domain" : "www.example1.example2.0002.example3.com" }, "disabled" : 0, "locked" : 0, "range_status" : "off", "follow_status" : "off", "origin_status" : "off", "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.