Create Zones
Creates a zone based on the provided specifications. if you do not have all of the privileges described as follows: - Operation execution requires Zone.Manage.
Request
URLURL
https://{api_host}/api/vcenter/consumption-domains/zones
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Request Body
Request Body
ConsumptionDomainsZonesCreateSpec of mimetype application/json
Required
Specifications for the zone to be created.
{
"zone": "string"
}
string
zone
Required
Identifier of the zone. It has the following restrictions: 1. The ID must be 63 characters or less (cannot be empty), 2. The ID must begin and end with a lowercase alphanumeric character ([a-z0-9]), 3. The ID must only contain dashes (-), and lowercase alphanumerics in between, 4. The ID must be unique within the vCenter in which it is created. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.vcenter.consumption_domains.Zone. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.vcenter.consumption_domains.Zone.
string
description
Optional
Description of the zone. If unset or empty, an empty description is set.
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
201 Created returns
string
of type application/json
The identifier of the created zone. The result will be an identifier for the resource type: com.vmware.vcenter.consumption_domains.Zone.
Errors
400
com.vmware.vapi.std.errors.already_exists : if a zone with the same identifier already exists in this vCenter server. | com.vmware.vapi.std.errors.invalid_argument : if any of the input information in the createSpec is invalid.
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn’t have Zones.Manage privilege.
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
$ConsumptionDomainsZonesCreateSpec = Initialize-ConsumptionDomainsZonesCreateSpec -Zone "MyZone"
Invoke-CreateConsumptionDomainsZones -ConsumptionDomainsZonesCreateSpec $ConsumptionDomainsZonesCreateSpec
PowerCLI Client SDK All Parameters Example
$ConsumptionDomainsZonesCreateSpec = Initialize-ConsumptionDomainsZonesCreateSpec -Zone "MyZone" -Description "MyDescription"
Invoke-CreateConsumptionDomainsZones -ConsumptionDomainsZonesCreateSpec $ConsumptionDomainsZonesCreateSpec
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"description":"string","zone":"string"}' https://{api_host}/api/vcenter/consumption-domains/zones
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: create
Availability
Added in 8.0.0.1
