Consulta de lista de certificados
Função
Esta API é usada para consultar a lista de certificados.
URI
GET /v1/{project_id}/waf/certificate
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. |
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.
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
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
Parâmetro | Tipo | Descrição |
|---|---|---|
items | Array of CertificateBody objects | Certificados |
total | Integer | Número total de certificados |
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 |
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
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro |
error_msg | String | Mensagem de erro |
Código de estado: 401
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro |
error_msg | String | Mensagem de erro |
Código de estado: 500
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
OK
{
"total" : 1,
"items" : [ {
"id" : "dc443ca4f29c4f7e8d4adaf485be317b",
"name" : "demo",
"timestamp" : 1643181401751,
"expire_time" : 1650794100000,
"bind_host" : [ ],
"exp_status" : 2
} ]
} Códigos de status
Código de status | Descrição |
|---|---|
200 | OK |
400 | Falha na solicitação. |
401 | O token não tem permissões necessárias. |
500 | Erro de servidor interno. |
Códigos de erro
Consulte Códigos de erro.
