Apache CloudStack v4.4.1 User API Reference

listZones

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
pagefalse
pagesizefalse
showcapacitiesflag to display the capacity of 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
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
vlanthe vlan range of the zone
zonetokenZone Token
capacity(*)the capacity of the Zone
capacitytotalthe total capacity available
capacityusedthe capacity currently in use
clusteridthe Cluster ID
clusternamethe Cluster 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