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/ Consulta de lista de certificados

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

Ver PDF

Consulta de lista de certificados

Função

Esta API é usada para consultar a lista de certificados.

URI

GET /v1/{project_id}/waf/certificate

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

**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.
page	Não	Integer	Número de página dos dados a serem retornados durante a consulta de paginação. O valor padrão é 1, indicando que os dados na primeira página são retornados. Padrão: 1
pagesize	Não	Integer	Número de resultados em cada página durante a consulta de paginação. Faixa de valor: 1 a 100. O valor padrão é 10, indicando que cada página contém 10 resultados. Padrão: 10
name	Não	String	Nome do certificado
host	Não	Boolean	Se deseja obter o nome de domínio para o qual o certificado é usado. O valor padrão é false. true: Obtenha os certificados que foram usados para nomes de domínio. false: Obtenha os certificados que não foram usados para nenhum nome de domínio. Padrão: false
exp_status	Não	Integer	Status do certificado. As opções são as seguintes: 0: não expirado; 1: expirado; 2: prestes a expirar (O certificado expirará dentro de um mês.)

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

Parâmetros de resposta

Código de estado: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
items	Array of CertificateBody objects	Certificados
total	Integer	Número total de certificados

**Tabela 5** CertificateBody
Parâmetro	Tipo	Descrição
id	String	ID do certificado.
name	String	Nome do certificado
expire_time	Long	Timestamp de expiração do certificado.
exp_status	Integer	Status do certificado. O valor pode ser: 0: O certificado é válido. 1: O certificado expirou. 2: O certificado expirará em um mês.
timestamp	Long	Carimbo de data e hora do upload do certificado.
bind_host	Array of BindHost objects	Nome de domínio associado ao certificado

**Tabela 6** BindHost
Parâmetro	Tipo	Descrição
id	String	ID do nome de domínio
hostname	String	Nome de domínio
waf_type	String	Modo de implantação da instância do WAF usado para o nome de domínio. O valor pode ser cloud para WAF na nuvem ou premium para instâncias dedicadas do WAF.
mode	String	Este parâmetro é requerido apenas pelo modo dedicado.

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

GET https://{Endpoint}/v1/{project_id}/waf/certificate?enterprise_project_id=0

Exemplo de respostas

Código de estado: 200

{
  "total" : 1,
  "items" : [ {
    "id" : "dc443ca4f29c4f7e8d4adaf485be317b",
    "name" : "demo",
    "timestamp" : 1643181401751,
    "expire_time" : 1650794100000,
    "bind_host" : [ ],
    "exp_status" : 2
  } ]
}