Associação de um certificado para vários nomes de domínio
Função
Se você associar um certificado a vários nomes de domínio, será necessário ativar as configurações de força HTTP para os nomes de domínio.
URI
PUT /v1.0/cdn/domains/config-https-info
| 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 |
|---|---|---|---|
| https | Não | Especifica as configurações de HTTPS. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| domain_name | Sim | String | Especifica a lista de nomes de domínio. Os nomes de domínio são separados por vírgulas (,). Até 50 nomes de domínio são suportados. |
| https_switch | Sim | Integer | Especifica se deve ativar o HTTPS. Valores possíveis: 0 (desativado) e 1 (ativado). Se https_switch for definido como 1, os parâmetros do certificado devem ser especificados. |
| access_origin_way | Não | Integer | Especifica o protocolo de origem. Valores possíveis: 1 (igual às solicitações do usuário), 2 (HTTP, valor padrão) e 3 (HTTPS). Se o valor estiver vazio, HTTP é usado por padrão. |
| force_redirect_https | Não | Integer | Especifica se as solicitações devem ser forçosamente redirecionadas para HTTPS. Valores possíveis: 0 (não) e 1 (sim). É aconselhável usar force_redirect_config para configurar as configurações. |
| force_redirect_config | Não | ForceRedirect object | Especifica as configurações de redirecionamento forçado. |
| http2 | Não | Integer | Especifica se o HTTP/2 deve ser usado. Valores possíveis: 0 (não) e 1 (sim). Se este parâmetro estiver vazio, HTTP/2 não é usado por padrão. |
| cert_name | Não | String | Especifica o nome do certificado. Este parâmetro é obrigatório quando https_switch é definido como 1. O valor contém de 3 a 32 caracteres. |
| certificate | Não | String | Especifica o corpo do certificado. Este parâmetro é obrigatório quando https_switch é definido como 1. |
| private_key | Não | String | Especifica a chave privada. Este parâmetro é obrigatório quando https_switch é definido como 1. |
| certificate_type | Não | Integer | Especifica o tipo de certificado. Valores possíveis: 0 (seu próprio certificado) e 1 (certificado gerenciado pela Huawei). Se você definir esse parâmetro como 1, não será necessário inserir o corpo do certificado e a chave privada. O sistema corresponde automaticamente ao certificado com base no nome do certificado. Se você não definir este parâmetro, o valor 0 é usado por padrão. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| switch | Sim | Integer | Especifica se deve habilitar o redirecionamento forçado. Valores possíveis: 1 (ativado) e 0 (desativado). |
| redirect_type | Não | String | Especifica o protocolo para o qual as solicitações são forçosamente redirecionadas. Valores possíveis: http e https. |
Parâmetros de resposta
Código de estado: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| https | Especifica as configurações de HTTPS. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| domain_name | String | Especifica a lista de nomes de domínio. |
| https_switch | Integer | Especifica se deve ativar o HTTPS. Valores possíveis: 0 (desativado) e 1 (ativado). Se você definir esse parâmetro como 1, um certificado deve ser configurado. |
| access_origin_way | Integer | Especifica o protocolo de origem. Valores possíveis: 1 (igual às solicitações do usuário), 2 (HTTP, valor padrão) e 3 (HTTPS). |
| force_redirect_https | Integer | Especifica se as solicitações devem ser forçosamente redirecionadas para HTTPS. Valores possíveis: 0 (não) e 1 (sim). É aconselhável usar force_redirect_config para configurar as configurações. |
| force_redirect_config | ForceRedirect object | Especifica as configurações de redirecionamento forçado. |
| http2 | Integer | Especifica se o HTTP/2 deve ser usado. Valores possíveis: 0 (não) e 1 (sim). |
| cert_name | String | Especifica o nome do certificado. O valor contém de 3 a 32 caracteres. |
| certificate | String | Especifica o corpo do certificado. |
| certificate_type | Integer | Especifica o tipo de certificado. Valores possíveis: 0 (seu próprio certificado) e 1 (certificado gerenciado pela Huawei). |
| expiration_time | Long | Especifica a hora em que o certificado expira. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| switch | Integer | Especifica se deve habilitar o redirecionamento forçado. Valores possíveis: 1 (ativado) e 0 (desativado). |
| redirect_type | String | Especifica o protocolo para o qual as solicitações são forçosamente redirecionadas. Valores possíveis: http e https. |
Exemplos de solicitações
{
"https" : {
"domain_name" : "example1.com",
"access_origin_way" : 2,
"http2" : 0,
"certificate_type" : 0,
"force_redirect_config" : {
"redirect_type" : "https",
"switch" : 1
},
"https_switch" : 1,
"cert_name" : "cdn_test_cert",
"certificate" : "-----BEGIN CERTIFICATE----------END CERTIFICATE-----",
"private_key" : "-----BEGIN RSA PRIVATE KEY---------END RSA PRIVATE KEY-----"
}
} Exemplo de respostas
Código de estado: 200
OK
{
"https" : {
"domain_name" : "example1.com",
"https_switch" : 1,
"access_origin_way" : 2,
"force_redirect_https" : 1,
"force_redirect_config" : {
"redirect_type" : "https",
"switch" : 1
},
"http2" : 0,
"expiration_time" : 1925791912000,
"cert_name" : "cdn_test_cert",
"certificate" : "-----BEGIN CERTIFICATE----------END CERTIFICATE-----",
"certificate_type" : 0
}
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | OK |
Códigos de erro
Consulte Códigos de erro.
