Modificação de detalhes do servidor de origem
Função
Essa API é usada para modificar informações sobre o servidor de origem. Os nós CDN podem ser direcionados para o servidor de origem com base no endereço IP ou nome de domínio do servidor de origem. Um nome de domínio de origem não pode ser o mesmo que um nome de domínio acelerado.
URI
PUT /v1.0/cdn/domains/{domain_id}/origin
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âmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
origin |
Sim |
ResourceBody object |
Especifica o servidor de origem. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
sources |
Sim |
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. |
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. |
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. |
http_port |
Não |
Integer |
Especifica a porta HTTP. Valor padrão: 80. |
https_port |
Não |
Integer |
Especifica a porta HTTPS. Valor padrão: 443. |
Parâmetros de resposta
Código de estado: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
origin |
ResourceBody object |
Especifica o servidor de origem. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
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. |
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. |
Exemplos de solicitações
PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff808**********************2d71/origin?enterprise_project_id=0 { "origin" : { "sources" : [ { "ip_or_domain" : "10.62.53.75", "origin_type" : "ipaddr", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ] } }
Exemplo de respostas
Código de estado: 200
OK
{ "origin" : { "sources" : [ { "domain_id" : "12ab***********************02b71", "origin_type" : "ipaddr", "ip_or_domain" : "10.62.53.75", "active_standby" : 1, "http_port" : 80, "https_port" : 443 } ] } }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK |
Códigos de erro
Consulte Códigos de erro.