Consulta de um certificado
Função
Esta API é usada para consultar um certificado.
URI
GET /v1/{project_id}/waf/certificate/{certificate_id}
| 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. |
| 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
| 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 |
|---|---|---|
| id | String | ID do certificado |
| name | String | Nome do certificado |
| content | String | Arquivo de certificado, codificação PEM |
| key | String | Chave privada do certificado, que está no formato PEM. |
| expire_time | Long | Timestamp de expiração do certificado. |
| exp_status | Integer | Status do certificado. As opções podem ser: 0: O certificado não expirou. 1: O certificado expirou. 2: O certificado está prestes a expirar. |
| timestamp | Long | Timestamp de 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/{certificate_id}?enterprise_project_id=0 Exemplo de respostas
Código de estado: 200
OK
{
"id" : "6e2be127b79f4a418414952ad5d8c59f",
"name" : "certificatename94319",
"content" : "-----BEGIN CERTIFICATE-----\nMIIB+TCCAaOgAwIBAgIUJP9I8OupQ77w0bGL2yWOQXreM4kwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUxDzANBgNVBAoMBkh1YXdlaTEcMBoGA1UEAwwTd2FmLmh1YXdlaWNsb3VkLmNvbTAeFw0yMDA3MDkwNTQ2MDRaFw0yMDA4MDgwNTQ2MDRaMFExCzAJBgNVBAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMQ8wDQYDVQQKDAZIdWF3ZWkxHDAaBgNVBAMME3dhZi5odWF3ZWljbG91ZC5jb20wXDANBgkqhkiG9w0BAQEFAANLADBIAkEA0UEbMzbvgOJTKrKcDUw9xjFqxM7BaQFM3SLsQlmD5hkzygyL1ra+cWajPJlTCxz9Ph6qldna2+OrIuTdvCcpjwIDAQABo1MwUTAdBgNVHQ4EFgQUE7ZQNcgl3lmryx1s5gy9mnC1rsYwHwYDVR0jBBgwFoAUE7ZQNcgl3lmryx1s5gy9mnC1rsYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAANBAM5wGi88jYWLgOnGbae5hH3I9lMBKxGqv17Cbm1tjWuUogVINz86lqvCpuhzLvD/vzJAqPIuDwqM8uvzjgRfZs8=\n-----END CERTIFICATE-----",
"key" : "-----BEGIN RSA PRIVATE KEY-----\nMIIBOQIBAAJBANFBGzM274DiUyqynA1MPcYxasTOwWkBTN0i7EJZg+YZM8oMi9a2vnFmozyZUwsc/T4eqpXZ2tvjqyLk3bwnKY8CAwEAAQJBAI7LMPaH/HQk/b/bVmY0qsr+me9nb9BqFLuqwzKbx0hSmWPOWFsd3rOFlSopyHqgYtAsPfvPumEdGbdnCyU8zAECIQD71768K1ejb+ei2lqZqHaczqdUNQxMh54yot9F2yVWjwIhANS1Y1Jv89WEU/ZvvMS9a4638Msv2c4GGp08RtXNYn0BAiA0H4b+cwoEbZjHf+HYg6Fo+uxu5TvSaw8287a6Qo0LyQIfVZSlYYWplT6oiX5rdLzBiap4N0gJWdsa2ihmV59LAQIgK8N+j1daq63b0bJ9k4HruhQtpgxI6U9nFBemH4zTRYM=\n-----END RSA PRIVATE KEY-----",
"timestamp" : 1650595334578,
"expire_time" : 1596865564000,
"bind_host" : [ {
"id" : "978b411657624c2db069cd5484195d1c",
"hostname" : "www.demo.com",
"waf_type" : "cloud"
} ]
} 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.