POST Certificates/Retry
Allows the Application object to retry the last unsuccessful lifecycle stage of a particular certificate. Application objects only participate in stages of the certificate lifecycle that involve certificate provisioning. For more information, see the Administration Guide.
Requirements
- Permissions: The caller must have Read permission and Write permission to the Certificate object
- Token scope: Certificate:Manage
Headers
-
Content type: Content-Type:application/json.
Parameters
Name |
Description |
---|---|
CertificateDN | The Distinguished Name (DN) of the certificate. |
WorkToDoTimeout |
(Optional) The maximum wait time to retry a certificate stage. Overrides the Platforms tree setting for the Certificate API ToDo Timeout setting. The maximum number of seconds to wait for the ToDo operation to complete. The default is zero seconds with a maximum value of 120 seconds. For example:WorkToDoTimeout: 60. For more information, see Certificates API configuration. |
Returns
The response includes information about errors. On error, Certificates/Retry returns a HTTP 400 Bad Request and one of the following error messages:
-
Access error. Certificates/Retry requires write permissions for certificate [ CertificateDN].
-
Failed to add work for application [Consumer]. Retry for this application will not occur. Failure details: [ErrorMessage] Result Code: [ Certificates WorkToDo result codes ].
-
Failed to add work for certificate [CertificateDN]. Retry for this cert and any associate applications will not occur. Failure details: [Error Message] Result Code: [ Certificates WorkToDo result codes ].
-
Invalid CertificateDN format. The Certificate DN contained null or white spaces for [ CertificateDN].
-
Retry canceled. No retry is required for the certificate. [error]
For valid requests, Certificates/Retry returns a HTTP 200 message and the following data in the message body:
Name |
Description |
---|---|
HTTP 200 |
For valid requests, this call returns a HTTP 200 message and the following data in the message body:
|
HTTP 400 |
For invalid requests, this call returns a HTTP 400 BadRequest and the following data in the message body:
|
Example: Retry the previous lifecycle stage
Request
POST https://tpp.venafi.example/vedsdk/Certificates/Retry Authorization:Bearer 4MyGeneratedBearerTknz== { "CertificateDN":"\\VED\\Policy\\test_retry122017141215963\\cert_122017141215969" }
Response
HTTP/1.1 200 OK { "Success":true }