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/ Configuração de nome de domínio/ Associação de um certificado para vários nomes de domínio

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

Ver PDF

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

**Tabela 1** Parâmetros de consulta
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

**Tabela 2** Parâmetros de 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 3** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
https	Não	UpdateDomainMultiCertificatesRequestBodyContent object	Especifica as configurações de HTTPS.

**Tabela 4** UpdateDomainMultiCertificatesRequestBodyContent
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.

**Tabela 5** ForceRedirect
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

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
https	UpdateDomainMultiCertificatesResponseBodyContent object	Especifica as configurações de HTTPS.

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

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

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