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.
