Skip to main content

verification

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

Overview

Nameverification
TypeResource
Idcloudflare.ssl.verification

Fields

The following fields are returned by SELECT queries:

SSL Verification Details response

NameDatatypeDescription
brand_checkbooleanCertificate Authority is manually reviewing the order.
cert_pack_uuidstringCertificate Pack UUID. (example: a77f8bd7-3b47-46b4-a6f1-75cf98109948)
certificate_statusstringCurrent status of certificate. (initializing, authorizing, active, expired, issuing, timing_out, pending_deployment) (example: active)
signaturestringCertificate's signature algorithm. (ECDSAWithSHA256, SHA1WithRSA, SHA256WithRSA)
validation_methodstringValidation method in use for a certificate pack order. (http, cname, txt) (example: txt)
verification_infoobjectCertificate's required verification information.
verification_statusbooleanStatus of the required verification information, omitted if verification status is unknown.
verification_typestringMethod of verification. (cname, meta tag) (example: cname)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectzone_idretryGet SSL Verification Info for a Zone.
editupdatecertificate_pack_id, zone_id, validation_methodEdit SSL validation method for a certificate pack. A PATCH request will request an immediate validation check on any certificate, and return the updated status. If a validation method is provided, the validation will be immediately attempted using that method.

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
certificate_pack_idstring
zone_idstringThe Cloudflare zone ID.
retryboolean

SELECT examples

Get SSL Verification Info for a Zone.

SELECT
brand_check,
cert_pack_uuid,
certificate_status,
signature,
validation_method,
verification_info,
verification_status,
verification_type
FROM cloudflare.ssl.verification
WHERE zone_id = '{{ zone_id }}' -- required
AND retry = '{{ retry }}'
;

UPDATE examples

Edit SSL validation method for a certificate pack. A PATCH request will request an immediate validation check on any certificate, and return the updated status. If a validation method is provided, the validation will be immediately attempted using that method.

UPDATE cloudflare.ssl.verification
SET
validation_method = '{{ validation_method }}'
WHERE
certificate_pack_id = '{{ certificate_pack_id }}' --required
AND zone_id = '{{ zone_id }}' --required
AND validation_method = '{{ validation_method }}' --required
RETURNING
errors,
messages,
result,
success;