Boomi Platform API Reference (1.0.0) - DeployedExpiredCertificate
The Deployed Expired Certificate object provides access to the deployed X.509 certificate information used to populate the Certificates panel on the Runtime Management page. In addition, querying the Deployed Expired Certificate object enables programmatic generation of alerts of expiring certificates so you can manage certificates easier.
Required Privileges
You need these privileges in the target environment:
Write access
- N/A
Read access
- API — Use the Boomi Platform API to access account data.
Queries for a DeployedExpiredCertificate object(s)
If a QUERY omits an explicit timespan filter — that is, the query does not use expirationBoundary in an expression — it applies a default timespan filter using the value of 30 and the LESS_THAN operator. This filter specifies expired certificates and certificates expiring within 30 days.
For general information about the structure of QUERY filters, their sample payloads, and how to handle the paged results, refer to Query filters and Query paging.
Authorizations:
Request Body schema: optional
Possible properties include: containerId, containerName, environmentId, environmentName, expirationBoundary
required | object | ||||||||||
| |||||||||||
Responses
Response Schema:
| numberOfResults | integer <int32> |
| queryToken | string By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request. |
Array of objects (DeployedExpiredCertificate) |
Request samples
- Payload
{- "QueryFilter": {
- "expression": {
- "operator": "and",
- "nestedExpression": [
- {
- "argument": [
- "456789a-bcdef-0123-4567-89abcdef0123"
], - "operator": "EQUALS",
- "property": "environmentId"
}, - {
- "argument": [
- "0",
- "14"
], - "operator": "BETWEEN",
- "property": "expirationBoundary"
}
]
}
}
}Response samples
- 200
- 403
- 410
- 503
{- "result": [
- {
- "@type": "DeployedExpiredCertificate",
- "accountId": "account-123456",
- "certificateName": "Southwest X.509",
- "certificateId": "6789abcd-ef01-2345-6789-abcdef012345",
- "certificateType": "X.509",
- "containerId": "23456789-abcd-ef01-2345-6789abcdef01",
- "containerName": "southwest",
- "environmentName": "prod",
- "environmentId": "456789a-bcdef-0123-4567-89abcdef0123",
- "location": "Environment",
- "expirationDate": "2019-07-11T19:33:23Z"
}, - {
- "@type": "DeployedExpiredCertificate",
- "accountId": "account-123456",
- "certificateName": "Northeast X.509",
- "certificateId": "543210fe-dcba-9876-5432-10fedcba987654",
- "certificateType": "X.509",
- "containerId": "98765432-10fe-dcba-9876-543210fedcba",
- "containerName": "northeast",
- "environmentName": "prod",
- "environmentId": "456789a-bcdef-0123-4567-89abcdef0123",
- "location": "Environment",
- "expirationDate": "2019-07-24T06:20:34Z"
}
], - "numberOfResults": 100,
- "@type": "QueryResult"
}Retrieves additional results for a DeployedExpiredCertificate query
To learn about using queryMore, refer to the topic Query paging.
Authorizations:
Request Body schema: text/plainrequired
Responses
Response Schema:
| numberOfResults | integer <int32> |
| queryToken | string By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request. |
Array of objects (DeployedExpiredCertificate) |
Response samples
- 200
- 403
- 410
- 503
{- "result": [
- {
- "@type": "DeployedExpiredCertificate",
- "accountId": "account-123456",
- "certificateName": "Southwest X.509",
- "certificateId": "6789abcd-ef01-2345-6789-abcdef012345",
- "certificateType": "X.509",
- "containerId": "23456789-abcd-ef01-2345-6789abcdef01",
- "containerName": "southwest",
- "environmentName": "prod",
- "environmentId": "456789a-bcdef-0123-4567-89abcdef0123",
- "location": "Environment",
- "expirationDate": "2019-07-11T19:33:23Z"
}, - {
- "@type": "DeployedExpiredCertificate",
- "accountId": "account-123456",
- "certificateName": "Northeast X.509",
- "certificateId": "543210fe-dcba-9876-5432-10fedcba987654",
- "certificateType": "X.509",
- "containerId": "98765432-10fe-dcba-9876-543210fedcba",
- "containerName": "northeast",
- "environmentName": "prod",
- "environmentId": "456789a-bcdef-0123-4567-89abcdef0123",
- "location": "Environment",
- "expirationDate": "2019-07-24T06:20:34Z"
}
], - "numberOfResults": 100,
- "@type": "QueryResult"
}