Skip to main content

callback

Creates, updates, deletes, gets or lists a callback resource.

Overview

Namecallback
TypeResource
Idgodaddy.certificates.callback

Fields

The following fields are returned by SELECT queries:

Callback registered

NameDatatypeDescription
callbackUrlstringCallback url registered to receive stateful actions

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
certificate_callback_getselectcertificate_idThis method is used to retrieve the registered callback url for a certificate.
certificate_callback_deletedeletecertificate_idUnregister the callback for a particular certificate.
certificate_callback_replaceexeccertificate_id, callbackUrlThis method is used to register/replace url for callbacks for stateful actions relating to a certificate lifecycle. The callback url is a Webhook style pattern and will receive POST http requests with json body defined in the CertificateAction model definition for each certificate action. Only one callback URL is allowed to be registered for each certificateId, so it will replace a previous registration.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
callbackUrlstringCallback url registered/replaced to receive stateful actions
certificate_idstringCertificate id to register/replace for callback

SELECT examples

This method is used to retrieve the registered callback url for a certificate.

SELECT
callbackUrl
FROM godaddy.certificates.callback
WHERE certificate_id = '{{ certificate_id }}' -- required
;

DELETE examples

Unregister the callback for a particular certificate.

DELETE FROM godaddy.certificates.callback
WHERE certificate_id = '{{ certificate_id }}' --required
;

Lifecycle Methods

This method is used to register/replace url for callbacks for stateful actions relating to a certificate lifecycle. The callback url is a Webhook style pattern and will receive POST http requests with json body defined in the CertificateAction model definition for each certificate action. Only one callback URL is allowed to be registered for each certificateId, so it will replace a previous registration.

EXEC godaddy.certificates.callback.certificate_callback_replace 
@certificate_id='{{ certificate_id }}' --required,
@callbackUrl='{{ callbackUrl }}' --required
;