Listing all zones¶
Certificate requests are submitted to DevOpsACCELERATE through a zone. The administrator defines zones for use by your organization. A zone contains an Issuing Template. The Issuing Template contains policy information for that zone.
If you need information about a zone, use the projectzones
function to list every zone, and then select a zone ID based on the zone type.
DevOpsACCELERATE is pre-configured with the following zones:
-
Default
: You can use this zone to issue certificates for internal use. -
Internet
: You can use this zone to issue certificates that are intended to be externally visible.
To list all projectzones
-
If you have not already done so, obtain an API key.
-
Use the
projectzones
function to list details for all configured zones. For additional help, use the parameter descriptions from ourdocumentation. For example:
GET https://api.venafi.cloud/v1/certificateissuingtemplates tppl-api-key: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-
From the JSON response, record the zone id for future reference. The zone id is a required parameter when submitting certificate requests to Venafi Cloud.
Example response
HTTP 1.1 OK
{
"projectzones":[
{
"id":"ffb9b170-0e7d-11e7-ae35-1b52a158cd01",
"companyId":"ffb4a860-0e7d-11e7-ae35-1b52a158cd01",
"tag":"Default",
"zoneType":"OTHER",
"certificateIssuingTemplateId":"ffb91530-0e7d-11e7-ae35-1b52a158cd01",
"defaultcertificateissuingtemplates":"ffb91530-0e7d-11e7-ae35-1b52a158cd01",
"systemGenerated":true,
"creationDate":"2020-03-21T21:33:18.169+0000"
}
]
}