Validate Domain Creation Spec
Perform validation of the DomainCreationSpec specification
Request
URI
POST
https://sfo-vcf01.rainpole.io/v1/domains/validations
COPY
Request Body
Domain Creation Spec
DomainCreationSpec of type(s) application/json
Required
Show optional properties
{
"computeSpec": {
"clusterSpecs": [
{
"datastoreSpec": {},
"hostSpecs": [
{
"id": "string"
}
],
"name": "string",
"networkSpec": {
"nsxClusterSpec": {},
"vdsSpecs": [
{
"name": "string"
}
]
}
}
]
},
"domainName": "string",
"vcenterSpec": {
"datacenterName": "string",
"name": "string",
"networkDetailsSpec": {
"ipAddress": "string"
},
"rootPassword": "string"
}
}{
"computeSpec": {
"clusterSpecs": [
{
"advancedOptions": {
"evcMode": "One among: INTEL_MEROM, INTEL_PENRYN, INTEL_NEALEM, INTEL_WESTMERE, INTEL_SANDYBRIDGE, INTEL_IVYBRIDGE, INTEL_HASWELL, INTEL_BROADWELL, INTEL_SKYLAKE, INTEL_CASCADELAKE, AMD_REV_E, AMD_REV_F, AMD_GREYHOUND_NO3DNOW, AMD_GREYHOUND, AMD_BULLDOZER, AMD_PILEDRIVER, AMD_STREAMROLLER, AMD_ZEN",
"highAvailability": {
"enabled": false
}
},
"clusterImageId": "string",
"datastoreSpec": {
"nfsDatastoreSpecs": [
{
"datastoreName": "string",
"nasVolume": {
"path": "string",
"readOnly": false,
"serverName": [
"string"
],
"userTag": "string"
}
}
],
"vmfsDatastoreSpec": {
"fcSpec": [
{
"datastoreName": "string"
}
]
},
"vsanDatastoreSpec": {
"datastoreName": "string",
"dedupAndCompressionEnabled": false,
"esaConfig": {
"enabled": false
},
"failuresToTolerate": 0,
"licenseKey": "string"
},
"vsanRemoteDatastoreClusterSpec": {
"vsanRemoteDatastoreSpec": [
{
"datastoreUuid": "string"
}
]
},
"vvolDatastoreSpecs": [
{
"name": "string",
"vasaProviderSpec": {
"storageContainerId": "string",
"storageProtocolType": "One among: ISCSI, NFS, FC",
"userId": "string",
"vasaProviderId": "string"
}
}
]
},
"hostSpecs": [
{
"azName": "string",
"hostName": "string",
"hostNetworkSpec": {
"networkProfileName": "string",
"vmNics": [
{
"id": "string",
"moveToNvds": false,
"uplink": "string",
"vdsName": "string"
}
]
},
"id": "string",
"ipAddress": "string",
"licenseKey": "string",
"password": "string",
"serialNumber": "string",
"sshThumbprint": "string",
"username": "string"
}
],
"name": "string",
"networkSpec": {
"nsxClusterSpec": {
"nsxTClusterSpec": {
"geneveVlanId": 0,
"ipAddressPoolSpec": {
"description": "string",
"ignoreUnavailableNsxtCluster": false,
"name": "string",
"subnets": [
{
"cidr": "string",
"gateway": "string",
"ipAddressPoolRanges": [
{
"end": "string",
"start": "string"
}
]
}
]
},
"ipAddressPoolsSpec": [
{
"description": "string",
"ignoreUnavailableNsxtCluster": false,
"name": "string",
"subnets": [
{
"cidr": "string",
"gateway": "string",
"ipAddressPoolRanges": [
{
"end": "string",
"start": "string"
}
]
}
]
}
],
"uplinkProfiles": [
{
"name": "string",
"supportedTeamingPolicies": {
"supportedTeamingPolicies": "string"
},
"teamings": [
{
"activeUplinks": [
"string"
],
"policy": "string",
"standByUplinks": [
"string"
]
}
],
"transportVlan": 0
}
]
}
},
"vdsSpecs": [
{
"isUsedByNsxt": false,
"nsxtSwitchConfig": {
"transportZones": [
{
"name": "string",
"transportType": "One among: VLAN, OVERLAY"
}
],
"hostSwitchOperationalMode": "One among: STANDARD, ENS, ENS_INTERRUPT"
},
"mtu": 0,
"name": "string",
"niocBandwidthAllocationSpecs": [
{
"niocTrafficResourceAllocation": {
"limit": 0,
"reservation": 0,
"sharesInfo": {
"level": "One among: low, normal, high, custom",
"shares": 0
}
},
"type": "string"
}
],
"portGroupSpecs": [
{
"activeUplinks": [
"string"
],
"standByUplinks": [
"string"
],
"teamingPolicy": "One among: loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit, loadbalance_loadbased",
"name": "string",
"transportType": "One among: VSAN, VMOTION, MANAGEMENT, PUBLIC, NFS, VREALIZE, ISCSI, EDGE_INFRA_OVERLAY_UPLINK, VM_MANAGEMENT"
}
]
}
],
"networkProfiles": [
{
"name": "string",
"description": "string",
"isDefault": false,
"nsxtHostSwitchConfigs": [
{
"ipAddressPoolName": "string",
"uplinkProfileName": "string",
"vdsName": "string",
"vdsUplinkToNsxUplink": [
{
"nsxUplinkName": "string",
"vdsUplinkName": "string"
}
]
}
]
}
]
},
"skipThumbprintValidation": false,
"vxRailDetails": {
"adminCredentials": {
"credentialType": "One among: SSH",
"password": "string",
"username": "string"
},
"arrayContextWithKeyValuePair": {
"arrayContextWithKeyValuePair": {
"arrayContextWithKeyValuePair": [
{
"arrayAssociationContext": {
"arrayAttributeIdsKeyValue": {
"arrayAttributeIdsKeyValue": "string"
},
"parent": "VxRailArrayAssociationContext Object"
},
"simpleAttributes": [
{
"attributeName": "string",
"datatype": "string",
"value": "string"
}
]
}
]
}
},
"contextWithKeyValuePair": {
"contextWithKeyValuePair": {
"contextWithKeyValuePair": [
{
"attributeName": "string",
"datatype": "string",
"value": "string"
}
]
}
},
"dnsName": "string",
"ipAddress": "string",
"networks": [
{
"freeIps": [
"string"
],
"gateway": "string",
"id": "string",
"ipPools": [
{
"end": "string",
"start": "string"
}
],
"mask": "string",
"mtu": 0,
"subnet": "string",
"type": "string",
"usedIps": [
"string"
],
"vlanId": 0
}
],
"nicProfile": "string",
"rootCredentials": {
"credentialType": "One among: SSH",
"password": "string",
"username": "string"
},
"sshThumbprint": "string",
"sslThumbprint": "string"
}
}
],
"skipFailedHosts": "false"
},
"domainName": "string",
"networkSeparationSpec": {
"enableSecurity": false,
"segmentSpec": {
"name": "string",
"vlanId": "string"
}
},
"nsxTSpec": {
"formFactor": "string",
"ipAddressPoolSpec": {
"description": "string",
"ignoreUnavailableNsxtCluster": false,
"name": "string",
"subnets": [
{
"cidr": "string",
"gateway": "string",
"ipAddressPoolRanges": [
{
"end": "string",
"start": "string"
}
]
}
]
},
"licenseKey": "string",
"nsxManagerAdminPassword": "string",
"nsxManagerAuditPassword": "string",
"nsxManagerSpecs": [
{
"name": "string",
"networkDetailsSpec": {
"dnsName": "string",
"gateway": "string",
"ipAddress": "string",
"subnetMask": "string"
}
}
],
"vip": "string",
"vipFqdn": "string"
},
"orgName": "string",
"ssoDomainSpec": {
"ssoDomainName": "string",
"ssoDomainPassword": "string"
},
"vcenterSpec": {
"datacenterName": "string",
"name": "string",
"networkDetailsSpec": {
"dnsName": "string",
"gateway": "string",
"ipAddress": "string",
"subnetMask": "string"
},
"rootPassword": "string",
"storageSize": "One among:lstorage, xlstorage",
"vmSize": "One among:xlarge, large, medium, small, tiny"
}
}
computeSpec
Required
This specification contains the parameters required to add each cluster to a workload domain
string
domainName
Required
Name of the workload domain
networkSeparationSpec
Optional
This specification contains the parameters required to provide network separation for the Isolated WLD
nsxTSpec
Optional
This specification contains the parameters required to install and configure NSX in a workload domain
string
orgName
Optional
Organization name of the workload domain
ssoDomainSpec
Optional
Spec for the SSO configuration in a VMware Cloud Foundation Domain
vcenterSpec
Required
This specification contains the installation and configuration of vCenter in a workload domain
Responses
200
Ok
Returns Validation of type(s) application/json
{
"additionalProperties": {
"additionalProperties": "string"
},
"description": "string",
"executionStatus": "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED, CANCELLATION_IN_PROGRESS",
"id": "string",
"resultStatus": "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS, CANCELLATION_IN_PROGRESS",
"validationChecks": [
{
"description": "string",
"errorResponse": {
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
},
"nestedValidationChecks": [
"ValidationCheck Object"
],
"resultStatus": "One among: IN_PROGRESS, SUCCEEDED, FAILED, SKIPPED, CANCELLED, CANCELLATION_IN_PROGRESS",
"severity": "One among: WARNING, ERROR, INFO"
}
]
}object
additionalProperties
Optional
additionalProperties
string
description
Optional
Description of the validation
string
executionStatus
Optional
Execution status of the validation
string
id
Optional
ID of the validation
string
resultStatus
Optional
Result status of the validation after it has completed its execution
array of ValidationCheck
validationChecks
Optional
List of one or more validation checks that are performed as part of the validation
400
Bad Request
Returns Error of type(s) application/json
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}array of string
arguments
Optional
The arguments used to localize the message, Can be used by scripts to automate the error processing.
object
context
Optional
The error context (e.g. the component where it occurred).
string
errorCode
Optional
The minor error code
string
errorType
Optional
The error type
string
message
Optional
The localized error message
string
referenceToken
Optional
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues.
string
remediationMessage
Optional
The localized remediation error message
500
InternalServerError
Returns Error of type(s) application/json
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}array of string
arguments
Optional
The arguments used to localize the message, Can be used by scripts to automate the error processing.
object
context
Optional
The error context (e.g. the component where it occurred).
string
errorCode
Optional
The minor error code
string
errorType
Optional
The error type
string
message
Optional
The localized error message
string
referenceToken
Optional
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues.
string
remediationMessage
Optional
The localized remediation error message
Domains Operations
PUT
Assign Tags To Domain
POST
Create Domain
DELETE
Delete Domain
GET
Get Assignable Tags For Domain
GET
Get Cluster Criteria
GET
Get Cluster Criterion
GET
Get Cluster Query Response
GET
Get Clusters Query Response
GET
Get Datastore Criterion 1
GET
Get Datastore Query Response 1
GET
Get Datastores Criteria 1
GET
Get Domain
GET
Get Domain Endpoints
GET
Get Domains
GET
Get Domain Tag Manager Url
GET
Get Tags Assigned To Domain
GET
Get Tags Assigned To Domains
POST
Post Cluster Query
POST
Post Clusters Query
POST
Post Datastore Query 1
DELETE
Remove Tags From Domain
PATCH
Update Domain
POST
Validate Domain Creation Spec