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

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

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.