Apache CloudStack Root Admin API Reference


Lists zones

Request parameters

Parameter NameDescriptionRequired
availabletrue if you want to retrieve all available Zones. False if you only want to return the Zones from which you have at least one VM. Default is false.false
domainidthe ID of the domain associated with the zonefalse
idthe ID of the zonefalse
keywordList by keywordfalse
namethe name of the zonefalse
networktypethe network type of the zone that the virtual machine belongs tofalse
showcapacitiesflag to display the capacity of the zonesfalse
showiconflag to display the resource image for the zonesfalse
tagsList zones by resource tags (key/value pairs)false

Response Tags

Response NameDescription
idZone id
allocationstatethe allocation state of the cluster
descriptionZone description
dhcpproviderthe dhcp Provider for the Zone
displaytextthe display text of the zone
dns1the first DNS for the Zone
dns2the second DNS for the Zone
domainNetwork domain name for the networks in the zone
domainidthe UUID of the containing domain, null for public zones
domainnamethe name of the containing domain, null for public zones
guestcidraddressthe guest CIDR address for the Zone
iconBase64 string representation of the resource icon
internaldns1the first internal DNS for the Zone
internaldns2the second internal DNS for the Zone
ip6dns1the first IPv6 DNS for the Zone
ip6dns2the second IPv6 DNS for the Zone
localstorageenabledtrue if local storage offering enabled, false otherwise
nameZone name
networktypethe network type of the zone; can be Basic or Advanced
resourcedetailsMeta data associated with the zone (key/value pairs)
securitygroupsenabledtrue if security groups support is enabled, false otherwise
zonetokenZone Token
capacity(*)the capacity of the Zone
capacityallocatedthe capacity currently in allocated
capacitytotalthe total capacity available
capacityusedthe capacity currently in use
clusteridthe Cluster ID
clusternamethe Cluster name
namethe capacity name
percentusedthe percentage of capacity currently in use
podidthe Pod ID
podnamethe Pod name
typethe capacity type
zoneidthe Zone ID
zonenamethe Zone name
tags(*)the list of resource tags associated with zone.
accountthe account associated with the tag
customercustomer associated with the tag
domainthe domain associated with the tag
domainidthe ID of the domain associated with the tag
keytag key name
projectthe project name where tag belongs to
projectidthe project id the tag belongs to
resourceidid of the resource
resourcetyperesource type
valuetag value