Let’s Encrypt® Certificates API (v1.0)
Managing Let's Encrypt® certificates: issuing, deleting, and listing
List Let's Encrypt® certificates
Returns a list of Let's Encrypt® certificates.
Authorizations:
iam_token_project_scoped
Responses
Response samples
- 200
- 500
Content type
application/json
{- "items": [
- {
- "created_at": "2022-02-02 22:22:22.222",
- "deleted_at": "2022-02-02 22:22:22.222",
- "domains": [
- "*.example.com",
- "example.com"
], - "error_description": "some error",
- "expire_at": "2022-22-02 22:22:22.222",
- "id": "2872c5e4-d571-44c3-acaf-e2ea2c48bd94",
- "knox_cert_id": "2872c5e4-d571-44c3-acaf-e2ea2c48bd94",
- "name": "Cert for example",
- "project_id": "2872c5e4-d571-44c3-acaf-e2ea2c48bd94",
- "status": "issuing",
- "updated_at": "2022-02-02 22:22:22.222",
- "version": 0
}
]
}
Delete Let's Encrypt® certificate
Deletes Let's Encrypt® certificate by ID.
Authorizations:
iam_token_project_scoped
path Parameters
id required | string Let's Encrypt® certificate ID. |
Responses
Response samples
- 400
- 403
- 404
- 500
Content type
application/json
{- "error_text": "Some error text",
- "status_text": "Some error status"
}
Issue new Let's Encrypt® certificate
Issues new Let's Encrypt® certificate and puts it in the storage.
Authorizations:
iam_token_project_scoped
query Parameters
dnsv2 | boolean Issue a Let's Encrypt® certificate for a zone in DNS Hosting. Existed Let's Encrypt® certificates in DNS Hosting (legacy) are supported, but new certificates will not be issued, please use DNS Hosting. |
Request Body schema: application/jsonrequired
Request with certificate issuing information.
domains required | Array of strings List of domain names for which the certificate issuing. |
name required | string Certificate display name. |
Responses
Request samples
- Payload
Content type
application/json
{- "domains": [
- "*.example.com",
- "example.com"
], - "name": "Cert for example"
}
Response samples
- 200
- 400
- 403
- 500
Content type
application/json
{- "created_at": "2022-02-02 22:22:22.222",
- "deleted_at": "2022-02-02 22:22:22.222",
- "domains": [
- "*.example.com",
- "example.com"
], - "error_description": "some error",
- "expire_at": "2022-22-02 22:22:22.222",
- "id": "2872c5e4-d571-44c3-acaf-e2ea2c48bd94",
- "knox_cert_id": "2872c5e4-d571-44c3-acaf-e2ea2c48bd94",
- "name": "Cert for example",
- "project_id": "2872c5e4-d571-44c3-acaf-e2ea2c48bd94",
- "status": "issuing",
- "updated_at": "2022-02-02 22:22:22.222",
- "version": 0
}