When using the certificate actions endpoint to renew a certificate issued by a GlobalSign Certificate Center (GCC) authority, the JSON request must include the action.properties.validityPeriod field. For example:
{ "action": { "comment": "renew", "properties": { "csr": "...", "validityPeriod": "P1Y0M0D" }, "type": "RenewAction" }} See below for a parameter reference.
Parameter names are case sensitive.
action.comment
A descriptive text on the requested action.
Mandatory: No.
action.properties.csr
The base64 encoding of a certificate request.
Mandatory: When requesting or enewing a certificate for a client‑generated key pair and CSR.
action.properties.validityPeriod
The duration for which the certificate will be valid, as an ISO‑8601 duration. See the table below for examples.
validityPeriod | Start date | Duration | End date |
|---|---|---|---|
"2018-07-06T13:00Z/2019-07-06T13:00:00Z" | July 6, 2018 at 13:00 UTC | Automatically calculated | July 6, 2019 at 13:00 UTC |
"2018-07-06T13:00Z/P1Y3M0DT0H0M" | July 6, 2018 at 13:00 UTC | 1 year and 3 months | Automatically calculated |
"P0Y3M0DT0H0M/2018-12-31T00:00Z" | Automatically calculated | 3 months | 31, 2018 at 00:00 UTC |
"P1Y3M10DT0H0M" | Current date | 1 year, 3 months, 10 days | Automatically calculated |
The selected value must comply with the GlobalSign profile maximum validity rules.
action.type
The type of action requested to the endpoint.
Endpoint | Value | Action |
|---|---|---|
CA actions | RenewAction | Renew a certificate |
CA actions | RevokeAction | Permanently invalidate a certificate |
CA domain actions | ReverifyDomainAction | Reverify a previously validated domain because the prior validation expired, failed, or must be refreshed to meet CA/Browser Forum or GlobalSign requirements. |
Mandatory: Yes.