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> Web Application Firewall> Referência de API> API> Gerenciamento de certificado> Aplicação de um certificado a um nome de domínio

Atualizado em 2022-11-02 GMT+08:00

Ver PDF

Aplicação de um certificado a um nome de domínio

Função

Essa API é usada para aplicar um certificado a um nome de domínio.

URI

POST /v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto. Para obtê-lo, vá para o console de gerenciamento do Huawei Cloud e passe o cursor sobre seu nome de usuário. Na janela exibida, escolha My Credentials.Em seguida, na área Projects, visualize Project ID correspondente.
certificate_id	Sim	String	ID do certificado HTTPS. Ele pode ser obtido chamando a API ListCertificates.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
enterprise_project_id	Não	String	Você pode obter o ID chamando a API ListEnterpriseProject do EPS.

Parâmetros de solicitação

**Tabela 3** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho da resposta).
Content-Type	Sim	String	Tipo de conteúdo. Padrão: application/json;charset=utf8

**Tabela 4** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
cloud_host_ids	Não	Array of strings	ID do nome de domínio HTTPS no modo cloud. Você pode obtê-lo chamando a API ListHost.
premium_host_ids	Não	Array of strings	ID do nome de domínio HTTPS em modo dedicado. Você pode obtê-lo chamando a API ListPremiumHost.

Parâmetros de resposta

Código de estado: 200

**Tabela 5** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
id	String	ID do certificado.
name	String	Nome do certificado
timestamp	Long	Timestamp.
expire_time	Long	Data de vencimento
bind_host	Array of CertificateBundingHostBody objects	Lista de nomes de domínio

**Tabela 6** CertificateBundingHostBody
Parâmetro	Tipo	Descrição
id	String	ID do nome de domínio
hostname	String	Nome de domínio
waf_type	String	Modo WAF (Cloud: cloud; Dedicado: premium) Valores de enumeração: cloud premium

Código de estado: 400

**Tabela 7** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro
error_msg	String	Mensagem de erro

Código de estado: 401

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro
error_msg	String	Mensagem de erro

Código de estado: 500

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro
error_msg	String	Mensagem de erro

Exemplos de solicitações

POST https://{Endpoint}/v1/{project_id}/waf/certificate/{certificate_id}/apply-to-hosts?enterprise_project_id=0

{
  "cloud_host_ids" : [ "85e554189d494c0f97789e93531c9f90" ],
  "premium_host_ids" : [ "4e9e97c425fc463c8f374b90124e8392" ]
}

Exemplo de respostas

Código de estado: 200

{
  "id" : "3ac1402300374a63a05be68c641e92c8",
  "name" : "www.abc.com",
  "timestamp" : 1636343349139,
  "expire_time" : 1650794100000,
  "bind_host" : [ {
    "id" : "e350cf556da34adab1f017523d1c05ed",
    "hostname" : "www.demo.com",
    "waf_type" : "cloud",
    "bandwidth" : 0,
    "qps" : 0
  } ]
}