View automation details
POST https://caas.digicert.com/automationws/v1/automation/viewAutomationDetails
Use this endpoint to view details about a specific automation instance.
Example requests and responses
Request parameters
Name | Req/Opt | Type | Description |
---|---|---|---|
accountId | required | string | Account ID. |
automationId | required | string | Automation ID. |
divisionId | required | string | Division ID. |
Response parameters
Name | Type | Description |
---|---|---|
error | object | Object with error details. |
data | object | Object with response data. |
.. autoStatusResponse | object | Object container for automation status details. |
.. .. automationStatus | string | Status of the automation. Possible values: |
.. .. requestedOn | integer | Request date and time of the automation. Format: epoch in milliseconds. An epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system. Example: |
.. .. lastRunTime | integer | Date and time when the automation was last run. |
.. .. nextRenewalDate | integer | Date and time when the automation is scheduled for renewal. |
.. .. message | string | Message when agent or sensor is down and automation is already scheduled. |
.. .. installSettings | object | Object with installation settings. |
.. .. .. installationType | string | Certificate installation type. Certificate installation can either be on-demand or scheduled for a specific time.
|
.. .. .. isAlwaysOn | boolean | Whether to auto-renew and install certificates. If Default: |
.. .. .. scheduleTime | integer | Time when automation starts. Format: epoch in milliseconds. An epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system. Example: *If you choose |
.. .. .. scheduleTimeZone | string | Time zone for the automation. Format: GMT + your timezone offset. Example: *If you choose |
.. .. .. autoRenewSettings | object | Object with auto-renew settings. |
.. .. .. .. daysBeforeExpiry | integer | Number of days to renew the certificate before certificate expiration. Min: 1 day Max: Less than the certificate validity. |
.. .. .. .. scheduleTime | integer | Time when auto-renew starts. Format: epoch in milliseconds. An epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system. Example: |
.. .. .. .. scheduleTimeZone | string | Time zone for the auto-renew. Format: GMT + your timezone offset. Example: |
.. .. .. .. isAutoReplace | boolean | For a revoked or missing certificate, Default: |
.. .. userDetailsResponse | object | Object container for user details. |
.. .. .. firstName | string | First name of user that requested the automation. |
.. .. .. lastName | string | Last name of user that requested the automation. |
.. .. .. container | object | Primary container the user is attached to. |
.. .. .. .. id | integer | Container ID. |
.. .. .. .. name | string | Name of the container. |
.. autoOrderProgressResponse | object | Object container for the automation order progress. |
.. .. csrGenResponse | object | Object container for CSR generation details. |
.. .. .. csrProgress | string | CSR generation status. |
.. .. .. causeOfFailure | string | Message describing the cause of failure. |
.. .. .. solution | string | Solution message. |
.. .. postCsrGenResponse | object | Object container for post-CSR generation failure details. |
.. .. .. postCSRProgress | string | Status of post-CSR generation failure. |
.. .. .. causeOfFailure | string | Message describing the cause of failure. |
.. .. .. solution | string | Solution message. |
.. .. certInstallResponse | object | Object container for certificate installation details. |
.. .. .. certInstallProgress | string | Status of certificate installation. Allowed values: |
.. .. .. scheduleOn | string | Time when the certificate installation is scheduled. *If |
.. .. .. causeOfFailure | string | Message describing the cause of failure. |
.. .. .. solution | string | Solution message. |
.. .. isRetryApplicable | boolean | Whether to retry the automation, if it fails. If |
.. certDetailsResponse | object | Object container for certificate details. |
.. .. commonName | string | Common name of the certificate. |
.. .. signatureHash | string | Hash type ID for the algorithm used to sign the certificate. Allowed values: See Glossary – Hash types |
.. .. orgDetail | object | Object container for organization details. |
.. .. .. name | string | Name of the organization. |
.. .. .. address | string | Address of the organization. |
.. .. .. address2 | string | Continuation of the address. |
.. .. .. city | string | City where the organization is located. |
.. .. .. state | string | State where the organization is located. |
.. .. .. country | string | Country where the organization is located. |
.. .. .. telephone | string | Organization telephone number. |
.. .. sans | string | Comma-separated list of additional subject alternative names (SANs) to secure with automated certificate requests. |
.. .. automationProfileName | string | Name of the automation profile. |
.. .. automationProfileId | integer | Profile ID associated with the automation. |
.. .. automationProfileStatus | string | Status of the automation profile. Allowed values: |
.. .. productType | string | Type of the product. Allowed values: See Glossary – Product identifiers. |
.. .. validityPeriod | string | Certificate validity. Allowed values: Example: Max value: 397 days |
.. isRequestApproval | boolean | Auto-approval of certificate request. |