VMware Cloud Foundation on Dell EMC VxRail API Reference Guide
4. Definitions
4.1. AddOnInfo
AddOn contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
displayName |
Add On display name |
string |
displayVersion |
Add On display version |
string |
name |
Component name |
string |
vendor |
vendor |
string |
version |
Add on software version |
string |
4.2. AdvancedOptions
Advanced Options used to add Cluster
Name | Description | Schema |
---|---|---|
evcMode |
EVC mode for new cluster, if needed |
string |
highAvailability |
High availability settings for the cluster |
4.3. AliasSpec
Version Alias update Specification. This specification gets used in the Version Alias Update API.
Name | Description | Schema |
---|---|---|
aliases |
Aliases for bundle component type and version. |
< string > array |
forceUpdate |
Flag for force update version alias configuration. |
boolean |
4.4. AuthenticatedResource
Represents the credential resource in the system
Name | Description | Schema |
---|---|---|
domainName |
Domain name |
string |
resourceId |
Resource ID |
string |
resourceIp |
Resource IP address |
string |
resourceName |
Resource name |
string |
resourceType |
Resource type |
string |
serviceType |
Service type |
string |
targetType |
Target type |
string |
4.5. Avn
Defines an Application virtual Network (AVN) and its attributes
Name | Description | Schema |
---|---|---|
domainName |
AVN search domain |
string |
gateway |
Gateway of the AVN subnet |
string |
id |
The UUID of the AVN |
string |
mtu |
MTU for the AVN |
integer (int32) |
name |
User provided name of the AVN |
string |
portGroupName |
Port group name identifying the AVN on the distributed switch |
string |
regionType |
The region type of AVN; X_REGION or REGION_A |
string |
routerName |
Name of routing NSX edge AVN is connected to |
string |
subnet |
Subnet assigned to the AVN |
string |
subnetMask |
Subnet mask for the network assigned to the AVN |
string |
4.6. BackupConfiguration
Backup configuration used to configure backup of NSX and SDDC manager
Name | Description | Schema |
---|---|---|
backupLocations |
List of backup locations |
< BackupLocation > array |
backupSchedules |
List of backup schedules |
< BackupSchedule > array |
encryption |
Encryption passphrase used to encrypt and decrypt backup file |
|
isConfigured |
Backup configuration status of both FTP server and passphrase |
boolean |
4.7. BackupConfigurationSpec
Backup configuration Specification
Name | Description | Schema |
---|---|---|
backupLocations |
List of backup locations |
< BackupLocation > array |
backupSchedules |
List of backup schedules |
< BackupSchedule > array |
encryption |
Encryption passphrase to encrypt and decrypt backup file |
4.8. BackupLocation
Backup location to backup VCF resources
Name | Description | Schema |
---|---|---|
directoryPath |
Full directory path to save the backup files |
string |
password |
Backup server password |
string |
port |
Port number for the backup server to connect |
integer (int32) |
protocol |
Protocol to be used for transferring files |
string |
server |
IP address of the backup server |
string |
sshFingerprint |
SSH fingerprint of the backup server |
string |
username |
Password for backup server username |
string |
4.9. BackupResource
Element specification to trigger backup
Name | Description | Schema |
---|---|---|
resourceType |
Resource type |
string |
4.10. BackupSchedule
Backup schedule configuration
Name | Description | Schema |
---|---|---|
daysOfWeek |
List of days of the week to schedule backup |
< string > array |
frequency |
Backup frequency |
string |
hourOfDay |
Hour of the day to schedule backup |
integer (int32) |
minuteOfHour |
Minute of the hour to schedule backup |
integer (int32) |
resourceType |
Resource type to configure backup schedule |
string |
4.11. BackupSpec
Backup Specification
Name | Description | Schema |
---|---|---|
elements |
List of elements to be backed up |
< BackupResource > array |
4.12. BackupTask
Name | Description | Schema |
---|---|---|
errors |
List of errors in case of a failure |
< Error > array |
id |
Backup task ID |
string |
name |
Backup task name |
string |
resources |
Backup resources, to get the backup details |
< Resource > array |
status |
Backup task status |
string |
4.13. BaseAlias
Base Alias representation
Name | Description | Schema |
---|---|---|
aliases |
List of Alias versions |
< string > array |
version |
Base version |
string |
4.14. BaseCredential
Represents credentials of a resource in the system
Name | Description | Schema |
---|---|---|
credentialType |
Credential type |
string |
password |
Password |
string |
username |
Username |
string |
4.15. BaseImageDetails
BaseImage contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
displayName |
BaseImage display name |
string |
displayVersion |
BaseImage display version |
string |
releaseDate |
BaseImage release date |
4.16. BaseImageInfo
BaseImage contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
details |
BaseImage details |
|
version |
BaseImage Version |
string |
4.17. BgpNeighbour
NSX Edge BGP Neighbour Specification
Name | Description | Schema |
---|---|---|
autonomousSystem |
BGP neighbour autonomous system ID |
integer (int64) |
forwardingIp |
BGP forwarding IP address |
string |
holdDownTimeSeconds |
BGP neighbour hold down time (in seconds) |
integer (int32) |
keepAliveTimeSeconds |
BGP neighbour keep alive time (in seconds) |
integer (int32) |
neighbourIp |
BGP neighbour IP address |
string |
password |
BGP neighbour password |
string |
protocolIp |
BGP protocol IP address |
string |
weight |
BGP neighbour weight |
integer (int32) |
4.18. BootstrapSpec
Name | Description | Schema |
---|---|---|
federationName |
Example : |
string |
memberJoinDetail |
Example : MemberDetail |
4.19. Bundle
Bundle contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
components |
Bundle Components |
< BundleComponent > array |
description |
Bundle Description |
string |
downloadStatus |
Bundle Download Status |
string |
id |
Bundle ID |
string |
isCompliant |
Is compliant with the current VCF version |
boolean |
isCumulative |
Is Bundle Cumulative |
boolean |
releasedDate |
Bundle Release Date |
|
severity |
Bundle Severity |
string |
sizeMB |
Bundle Size in MB |
number (double) |
type |
Bundle Type |
string |
vendor |
Bundle Vendor |
string |
version |
Bundle Version |
string |
4.20. BundleComponent
Bundle Software Component
Name | Description | Schema |
---|---|---|
description |
Bundle Component Description |
string |
fromVersion |
Bundle Component’s from/source version before Upgrade |
string |
id |
ID of Resource/Software Component |
string |
imageType |
Bundle Component Image Type |
string |
releasedDate |
Bundle Component Release Date |
|
toVersion |
Bundle Component’s to/target version after Upgrade |
string |
type |
Type of Resource/Software Component |
string |
vendor |
Bundle Component Vendor |
string |
4.21. BundleDownloadSpec
Bundle Download Specification. This specification gets used in the Bundle Download API
Name | Description | Schema |
---|---|---|
downloadNow |
Flag for enabling Download Now. If true, scheduledTimestamp is ignored |
boolean |
scheduledTimestamp |
Bundle Download Scheduled Time |
4.22. BundleUpdateSpec
Bundle Update Specification.
Name | Description | Schema |
---|---|---|
bundleDownloadSpec |
Bundle Download Specification. |
|
compatibilitySetsFilePath |
Path to the software compatibility sets file |
string |
4.23. BundleUploadSpec
Bundle Upload Specification. This specification is used in the Bundle Upload API
Name | Description | Schema |
---|---|---|
bundleFilePath |
Bundle Upload File Path |
string |
compatibilitySetsFilePath |
Path to the software compatibility sets file |
string |
manifestFilePath |
Bundle Upload Manifest File Path |
string |
partnerExtensionSpec |
Partner extensions for bundle upload |
|
signatureFilePath |
Bundle Upload Signature File Path |
string |
4.24. CPU
Name | Description | Schema |
---|---|---|
free |
Example : |
number (double) |
total |
Example : |
number (double) |
unallocated |
Example : |
number (double) |
unit |
Example : |
enum (GHZ, GB, TB, HZ, KHZ, MHZ, THZ, B, PB) |
used |
Example : |
number (double) |
4.25. Calendar
Name | Description | Schema |
---|---|---|
calendarType |
Example : |
string |
firstDayOfWeek |
Example : |
integer (int32) |
lenient |
Example : |
boolean |
minimalDaysInFirstWeek |
Example : |
integer (int32) |
time |
Example : |
string (date-time) |
timeInMillis |
Example : |
integer (int64) |
timeZone |
Example : TimeZone |
|
weekDateSupported |
Example : |
boolean |
weekYear |
Example : |
integer (int32) |
weeksInWeekYear |
Example : |
integer (int32) |
4.26. CapacitySummary
Name | Description | Schema |
---|---|---|
aggregatedCapacity |
Example : ResourceCapacity |
|
domainCount |
Example : |
integer (int32) |
domainInfo |
Example : |
< DomainInfo > array |
domainTypeInfo |
Example : |
< DomainSummary > array |
4.27. Ceip
Defines VCF CEIP status and instance id
Name | Description | Schema |
---|---|---|
instanceId |
Instance Id of VCF |
string |
status |
CEIP status |
string |
4.28. CeipUpdateSpec
Specification for CEIP state change
Name | Description | Schema |
---|---|---|
status |
User provided CEIP operation |
string |
4.29. Certificate
Represents certificate and its attributes
Name | Description | Schema |
---|---|---|
expirationStatus |
Certificate expiry status |
string |
getCertificateError |
Error if certificate cannot be fetched |
string |
isInstalled |
Whether the certificate is installed or not |
boolean |
issuedBy |
The certificate authority that issued the certificate |
string |
issuedTo |
To whom the certificate is issued |
string |
keySize |
The keysize of the certificate |
string |
notAfter |
The timestamp after which certificate is not valid |
|
notBefore |
The timestamp before which certificate is not valid |
|
numberOfDaysToExpire |
Number of days left for the certificate to expire |
integer (int32) |
pemEncoded |
The PEM encoded certificate content |
string |
publicKey |
The public key of the certificate |
string |
publicKeyAlgorithm |
The public key algorithm of the certificate |
string |
serialNumber |
The serial number of the certificate |
string |
signatureAlgorithm |
Algorithm used to sign the certificate |
string |
subject |
Complete distinguished name to which the certificate is issued |
string |
subjectAlternativeName |
The alternative names to which the certificate is issued |
< string > array |
thumbprint |
Thumbprint generated using certificate content |
string |
thumbprintAlgorithm |
Algorithm used to generate thumbprint |
string |
version |
The X.509 version of the certificate |
string |
4.30. CertificateAuthority
The Certificate Authority (CA) details
Name | Description | Schema |
---|---|---|
commonName |
OpenSSL CA domain name |
string |
country |
ISO 3166 country code where company is legally registered |
string |
id |
CA type. Only supports Microsoft and OpenSSL CAs |
string |
locality |
The city or locality where company is legally registered |
string |
organization |
The name under which company is legally registered |
string |
organizationUnit |
Organization with which the certificate is associated |
string |
serverUrl |
Microsoft CA server url |
string |
state |
The full name of the state where company is legally registered |
string |
templateName |
Microsoft CA server template name |
string |
username |
Microsoft CA server username |
string |
4.31. CertificateAuthorityCreationSpec
This specification contains Certificate Authority (CA) creation details
Name | Description | Schema |
---|---|---|
microsoftCertificateAuthoritySpec |
Microsoft Certificate Authority specification |
|
openSSLCertificateAuthoritySpec |
OpenSSL Certificate Authority specification |
4.32. CertificateOperationSpec
This specification contains certificate operation request details
Name | Description | Schema |
---|---|---|
operationType |
The Certificates operation type |
string |
resources |
Resource(s) in a domain |
< Resource > array |
4.33. CertificatesGenerationSpec
This specification contains certificates generation request details
Name | Description | Schema |
---|---|---|
caType |
CA type. Only supports Microsoft and OpenSSL CAs |
string |
resources |
Resource(s) in a domain |
< Resource > array |
4.34. Cluster
Cluster representation
Name | Description | Schema |
---|---|---|
hosts |
List of hosts associated with the cluster |
< HostReference > array |
id |
ID of the cluster |
string |
isDefault |
Status of the cluster if default or not |
boolean |
isStretched |
Status of the cluster if Stretched or not |
boolean |
name |
Name of the cluster |
string |
primaryDatastoreName |
Name of the primary datastore |
string |
primaryDatastoreType |
Storage type of the primary datastore |
string |
vdsSpecs |
Distributed switches to added to the cluster |
< VdsSpec > array |
4.35. ClusterCompactionSpec
This specification contains the parameters required to remove one or more vSphere hosts from existing cluster in a workload domain
Name | Description | Schema |
---|---|---|
force |
Force removal of vSphere host |
boolean |
hosts |
List of vSphere hosts to be removed |
< HostReference > array |
4.36. ClusterCreationSpec
This specification contains contains the parameters required to add a cluster to an existing workload Domain
Name | Description | Schema |
---|---|---|
computeSpec |
Cluster specification to be added to the domain |
|
domainId |
ID of the domain to which the clusters will be added |
string |
4.37. ClusterCriterion
Represents a criterion for querying the cluster
Name | Description | Schema |
---|---|---|
arguments |
Arguments required for a particular criterion |
< string, string > map |
description |
Description of the criterion |
string |
name |
Name of the criterion |
string |
4.38. ClusterExpansionSpec
This specification contains the parameters required to add one or more vSphere hosts to an existing cluster in a workload domain
Name | Description | Schema |
---|---|---|
hostSpecs |
List of vSphere host information from the free pool to consume in the workload domain |
< HostSpec > array |
interRackExpansion |
Is inter-rack cluster(true for L2 non-uniform and L3 : At least one of management, uplink, Edge and host TEP networks is different for hosts of the cluster, false for L2 uniform :����All hosts in cluster have identical management, uplink, Edge and host TEP networks) expansion. Required, only if Cluster contains NSX-T Edge Cluster |
boolean |
vsanNetworkSpecs |
vSAN Network Pool Spec |
< VSANNetworkSpec > array |
witnessSpec |
Witness host Info |
4.39. ClusterQueryResponse
Represents a cluster query response.
Name | Description | Schema |
---|---|---|
queryInfo |
Query info |
|
result |
Query result |
4.40. ClusterReference
Represents a reference to the cluster
Name | Description | Schema |
---|---|---|
id |
ID of the cluster |
string |
4.41. ClusterSpec
This specification contains the parameters required to add a cluster to a workload domain
Name | Description | Schema |
---|---|---|
advancedOptions |
Advanced options used for cluster creation |
|
clusterImageId |
ID of the Cluster Image to be used with the cluster |
string |
datastoreSpec |
Cluster storage configuration; e.g. VSAN, NFS |
|
hostSpecs |
List of vSphere host information from the free pool to consume in the workload domain |
< HostSpec > array |
name |
Name of the new cluster that will be added to the specified workload domain |
string |
networkSpec |
Network configuration for the cluster |
|
vxRailDetails |
Contains the VxRail Manager details |
4.42. ClusterStretchSpec
This spec contains the parameters required to convert a Standard vSAN cluster to a Stretched cluster
Name | Description | Schema |
---|---|---|
hostSpecs |
List of vSphere host information from the free pool to consume in the workload domain |
< HostSpec > array |
isEdgeClusterConfiguredForMultiAZ |
Edge cluster configured for multi AZ |
boolean |
secondaryAzOverlayVlanId |
Secondary AZ Overlay Vlan Id |
integer (int32) |
vsanNetworkSpecs |
vSAN Network Pool Specs |
< VSANNetworkSpec > array |
witnessSpec |
Witness host information |
4.43. ClusterUnstretchSpec
This spec contains the parameters required to convert a Stretched cluster to a Standard vSAN cluster
4.44. ClusterUpdateSpec
This specification contains the parameters required to perform update operation on cluster
Name | Description | Schema |
---|---|---|
clusterCompactionSpec |
Parameters required to perform cluster compaction, optional otherwise |
|
clusterExpansionSpec |
Parameters required to perform cluster expansion, optional otherwise |
|
clusterStretchSpec |
Parameters required to perform Stretch operation on cluster, optional otherwise |
|
clusterUnstretchSpec |
Parameters required to perform Unstretch operation on cluster, optional otherwise |
|
markForDeletion |
Prepare the cluster for deletion |
boolean |
prepareForStretch |
Prepare the cluster for stretch |
boolean |
4.45. ComponentDetails
Component contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
displayName |
Component display name |
string |
displayVersion |
Component display version |
string |
vendor |
Component vendor |
string |
4.46. ComponentInfo
Component contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
details |
Component details |
|
version |
Component Version |
string |
4.47. ComputeSpec
This specification contains the parameters required to add each cluster to a workload domain
Name | Description | Schema |
---|---|---|
clusterSpecs |
List of clusters to be added to workload domain |
< ClusterSpec > array |
4.48. Cpu
Represents information about CPUs on a host
Name | Description | Schema |
---|---|---|
cores |
Number of CPU cores |
integer (int32) |
cpuCores |
Information about each of the CPU cores |
< CpuCore > array |
frequencyMHz |
Total CPU frequency in MHz |
number (double) |
usedFrequencyMHz |
Used CPU frequency in MHz |
number (double) |
4.49. CpuCore
Represents a CPU core
Name | Description | Schema |
---|---|---|
frequencyMHz |
CPU frequency in MHz |
number (double) |
manufacturer |
Hardware manufacturer of the CPU |
string |
model |
Hardware model of the CPU |
string |
4.50. Credential
Represents a credential and the resource to which it is associated with
Name | Description | Schema |
---|---|---|
creationTimestamp |
The timestamp at which credential was created |
|
credentialType |
Credential type |
string |
id |
Credential ID |
string |
modificationTimestamp |
The timestamp at which credential was last modified |
|
password |
Password |
string |
resource |
The resource which owns the credential |
|
username |
Username |
string |
4.51. CredentialsSubTask
Represents the credentials sub-task in the system
Name | Description | Schema |
---|---|---|
creationTimestamp |
Credential sub-task creation timestamp |
|
credentialType |
Credential sub-task credential type |
string |
dependentSubTasks |
List of dependent sub-tasks of the credential sub-task |
< CredentialsSubTask > array |
description |
Credential sub-task description |
string |
entityType |
Credential sub-task entity type |
string |
errors |
List of errors in case of a failure |
< Error > array |
name |
Credential sub-task name |
string |
newPassword |
Credential sub-task new password |
string |
oldPassword |
Credential sub-task old password |
string |
status |
Credential sub-task status |
string |
username |
Credential sub-task username |
string |
4.52. CredentialsTask
Represents the credentials task in the system
Name | Description | Schema |
---|---|---|
creationTimestamp |
Credential task creation timestamp |
|
errors |
List of errors in case of a failure |
< Error > array |
id |
Credential task ID |
string |
name |
Credential task name |
string |
status |
Credential task status |
string |
subTasks |
List of credential sub-tasks of the credential task |
< CredentialsSubTask > array |
type |
Credential task type |
string |
4.53. CredentialsUpdateSpec
This specification contains password operation request details
Name | Description | Schema |
---|---|---|
elements |
List of resource credentials to be changed |
< ResourceCredentials > array |
operationType |
Operation type |
string |
4.54. Csr
The Certificate Signing Request (CSR) details
Name | Description | Schema |
---|---|---|
csrEncodedContent |
The CSR encoded content |
string |
resource |
Resource associated with CSR |
4.55. CsrGenerationSpec
This specification contains Certificate Signing Request (CSR) details
Name | Description | Schema |
---|---|---|
country |
ISO 3166 country code where company is legally registered |
string |
email |
Contact email address |
string |
keyAlgorithm |
The public key algorithm of the certificate |
string |
keySize |
Certificate public key size |
string |
locality |
The city or locality where company is legally registered |
string |
organization |
The name under which company is legally registered |
string |
organizationUnit |
Organization with which the certificate is associated |
string |
state |
The full name of the state where company is legally registered |
string |
4.56. CsrsGenerationSpec
This specification contains CSR Generation request details
Name | Description | Schema |
---|---|---|
csrGenerationSpec |
The CSR specification to generate CSR for resource(s) |
|
resources |
Resource(s) in a domain |
< Resource > array |
4.57. Datastore
Name | Description | Schema |
---|---|---|
capacity |
Example : |
number (double) |
datastoreName |
Example : |
string |
datastoreType |
Example : |
enum (VSAN, VMFS, NFS) |
freeSpace |
Example : |
number (double) |
unallocated |
Example : |
number (double) |
unit |
Example : |
enum (GHZ, GB, TB, HZ, KHZ, MHZ, THZ, B, PB) |
used |
Example : |
number (double) |
4.58. DatastoreSpec
This specification contains cluster storage configuration
Name | Description | Schema |
---|---|---|
nfsDatastoreSpecs |
Cluster storage configuration for NFS |
< NfsDatastoreSpec > array |
vmfsDatastoreSpec |
Cluster storage configuration for VMFS |
|
vsanDatastoreSpec |
Cluster storage configuration for vSAN |
4.59. DateTimeDetail
Name | Description | Schema |
---|---|---|
dateTime |
Example : |
string |
timestamp |
Example : |
integer (int64) |
4.60. DepotAccount
VMware Depot Account Information
Name | Description | Schema |
---|---|---|
message |
Message explaining depot status |
string |
password |
Depot Password for Access |
string |
status |
Depot Status |
string |
username |
Depot Username for Access |
string |
4.61. DepotSettings
VMware Depot Settings. At least one of vmwareAccount or dellEmcSupportAccount value must be provided
Name | Description | Schema |
---|---|---|
dellEmcSupportAccount |
Dell EMC Support Account |
|
vmwareAccount |
VMware Depot Account |
4.62. Disk
Represents a disk
Name | Description | Schema |
---|---|---|
capacityMB |
Total capacity of the disk in MB |
number (double) |
diskType |
Type of the disk. |
string |
manufacturer |
Hardware manufacturer of the disk |
string |
model |
Hardware model of the disk |
string |
4.63. DnsConfiguration
DNS Configuration
Name | Description | Schema |
---|---|---|
dnsServers |
List of DNS servers |
< DnsServer > array |
4.64. DnsServer
DNS server details
Name | Description | Schema |
---|---|---|
ipAddress |
IP address/FQDN of DNS server |
string |
isPrimary |
Is DNS server primary |
boolean |
4.65. DnsSpec
Spec contains parameters of Domain Name System
Name | Description | Schema |
---|---|---|
domain |
Tenant domain |
string |
nameserver |
Primary nameserver to be configured for vCenter/PSC/ESXi’s/NSX |
string |
secondaryNameserver |
Secondary nameserver to be configured for vCenter/PSC/ESXi’s/NSX |
string |
subdomain |
Tenant Sub domain |
string |
4.66. Domain
Represents a domain
Name | Description | Schema |
---|---|---|
clusters |
List of clusters associated with the workload domain |
< ClusterReference > array |
id |
ID of the workload domain |
string |
name |
Name of the workload domain |
string |
type |
Type of the workload domain |
string |
vcenters |
List of vCenters associated with the workload domain |
< VcenterReference > array |
4.67. DomainCreationSpec
This specification contains the parameters required to create a new workload domain
Name | Description | Schema |
---|---|---|
computeSpec |
Specification representing the clusters to be added to the workload domain |
|
domainName |
Name of the workload domain |
string |
nsxTSpec |
Specification details for NSX-T configuration |
|
vcenterSpec |
Specification details for vCenter |
4.68. DomainInfo
Name | Description | Schema |
---|---|---|
domainCapacity |
Example : ResourceCapacity |
|
domainId |
Example : |
string |
name |
Example : |
string |
status |
Example : |
string |
type |
Example : |
string |
4.69. DomainReference
Represents a domain reference
Name | Description | Schema |
---|---|---|
id |
ID of the domain |
string |
name |
Name of the domain |
string |
4.70. DomainSummary
Name | Description | Schema |
---|---|---|
aggregatedCapacity |
Example : ResourceCapacity |
|
domainCount |
Example : |
integer (int32) |
type |
Example : |
string |
4.71. DomainUpdateSpec
Contains the parameters required to perform update operation on domain
Name | Description | Schema |
---|---|---|
clusterSpec |
Cluster Specification for the domain |
|
markForDeletion |
Enable deletion for the domain |
boolean |
nsxTSpec |
NSX-T Specification for the domain |
4.72. DvsSpec
Spec contains parameters for DVS
Name | Description | Schema |
---|---|---|
dvsName |
DVS Name |
string |
isUsedByNsxt |
Flag indicating whether the DVS is used by NSX-T |
boolean |
mtu |
DVS MTU (default value is 9000) |
integer (int32) |
networks |
Types of networks in this portgroup |
< string > array |
niocSpecs |
List of NIOC specs for networks |
< NiocSpec > array |
vmnics |
Vmnics to be attached to the DVS |
< string > array |
4.73. EdgeCluster
EdgeCluster representation
Name | Description | Schema |
---|---|---|
clusters |
List of clusters associated with the edge cluster |
< ClusterReference > array |
id |
ID of the egde cluster |
string |
name |
Name of the edge cluster |
string |
nsxtCluster |
NSX-T cluster associated with the edge cluster |
4.74. EdgeClusterCreationSpec
This specification contains the parameters required to add a NSX-T edge cluster spanning multiple VI clusters.
Name | Description | Schema |
---|---|---|
asn |
ASN to be used for the edge cluster |
integer (int64) |
edgeAdminPassword |
Edge Password for admin user |
string |
edgeAuditPassword |
Edge Password for audit |
string |
edgeClusterName |
Name for the edge cluster. |
string |
edgeClusterProfileSpec |
Specifications for Edge Node |
|
edgeClusterProfileType |
Type of edge cluster profile |
string |
edgeClusterType |
Type of edge cluster |
string |
edgeFormFactor |
Edge Form Factor |
string |
edgeNodeSpecs |
Specifications for Edge Node |
< NsxTEdgeNodeSpec > array |
edgeRootPassword |
Edge Password for root user. |
string |
mtu |
Maximum transmission unit |
integer (int32) |
tier0Name |
Name for the T0 . |
string |
tier0RoutingType |
Tier 0 Routing type -eg eBGP, Static |
string |
tier0ServicesHighAvailability |
High-availability Mode for Tier-0 |
string |
tier1Name |
Name for the T1 . |
string |
4.75. Encryption
Restore Specification
Name | Description | Schema |
---|---|---|
passphrase |
Passphrase |
string |
4.76. Endpoint
Represents an Endpoint in a Domain
Name | Description | Schema |
---|---|---|
type |
Type of the Endpoint |
string |
url |
Url of the Endpoint |
string |
4.77. Error
Error response containing a minor error code, a localized error message, a localized remediation message and optionally a reference token to correlate the error with the logs
Name | Description | Schema |
---|---|---|
arguments |
The arguments used to localize the message, Can be used by scripts to automate the error processing. |
< string > array |
causes |
The underlying cause exceptions. |
< ErrorCause > array |
context |
The error context (e.g. the component where it occurred). |
< string, string > map |
errorCode |
The minor error code |
string |
message |
The localized error message |
string |
nestedErrors |
The nested errors when the error is a composite one |
< Error > array |
referenceToken |
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues. |
string |
remediationMessage |
The localized remediation error message |
string |
4.78. ErrorCause
Describes a single error cause
Name | Description | Schema |
---|---|---|
message |
The message describing the reason for the error |
string |
type |
The type of the error cause |
string |
4.79. ErrorResponse
Name | Description | Schema |
---|---|---|
arguments |
Example : |
< string > array |
cause |
Example : |
< ErrorCause > array |
context |
Example : |
< string, string > map |
errorCode |
Example : |
string |
message |
Example : |
string |
nestedErrors |
Example : |
< ErrorResponse > array |
referenceToken |
Example : |
string |
remediationMessage |
Example : |
string |
4.80. FcSpec
Cluster storage configuration for VMFS on FC
Name | Description | Schema |
---|---|---|
datastoreName |
Datastore name used for cluster creation |
string |
4.81. FederationOperationError
Name | Description | Schema |
---|---|---|
error |
Example : |
string |
errorPack |
Example : LocalizableErrorCodePack |
|
suggestedRemedy |
Example : |
string |
suggestedRemedyPack |
Example : LocalizableErrorCodePack |
4.82. FederationTask
Name | Description | Schema |
---|---|---|
created |
Example : DateTimeDetail |
|
errors |
Example : |
< FederationOperationError > array |
lastUpdated |
Example : DateTimeDetail |
|
operation |
Example : |
enum (BOOTSTRAP, START, STOP, TEARDOWN, INVITE_MEMBER, EVICT_MEMBER, JOIN, HANDLE_JOIN, HANDLE_CONTROLLER_JOIN, LEAVE, HANDLE_LEAVE, HANDLE_CONTROLLER_LEAVE, HANDLE_CERT_ROTATION) |
payload |
Example : RemoteResponsePayload |
|
progressDetails |
Example : |
string |
remoteOperationTask |
Example : FederationTask |
|
status |
Example : |
enum (NOT_STARTED, SUCCEEDED, FAILED, IN_PROGRESS, UNKNOWN) |
taskId |
Example : |
string |
4.83. HardwareSupportInfo
Hardware support contains base os, components, hardware support, addOn metadata to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
packages |
Hardware support packages |
< string, HardwareSupportPackageInfo > map |
4.84. HardwareSupportPackage
Configured Hardware Support Manager details
Name | Description | Schema |
---|---|---|
name |
Hardware Support Manager Name |
string |
pkg |
Hardware Support Package |
4.85. HardwareSupportPackageInfo
Hardware Support Package contains metadata regarding the package, version to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
pkg |
Hardware support package name |
string |
version |
Hardware support package version |
string |
4.86. HardwareSupportPackages
Available Hardware Support Manager details
Name | Description | Schema |
---|---|---|
name |
Hardware Support Manager Name |
string |
packages |
Hardware Support Packages |
< PackageSpec > array |
4.87. HardwareSupportSpec
Hardware Support Specification for Firmware Upgrade
Name | Description | Schema |
---|---|---|
name |
Hardware Support Manager name |
string |
packageSpec |
Package for Hardware Support Managers |
4.88. HighAvailability
This specification contains high availability settings
Name | Description | Schema |
---|---|---|
enabled |
Example : |
boolean |
4.89. Host
Represents an Esxi host in the system
Name | Description | Schema |
---|---|---|
bundleRepoDatastore |
Bundle repositry datastore for this host |
string |
cluster |
Information about the cluster this host is part of |
|
compatibleStorageType |
Information about the host compatible storage type |
string |
cpu |
Information about CPUs on the host |
|
domain |
Information about the domain this host is part of |
|
esxiVersion |
ESXi software version of the host |
string |
fqdn |
FQDN of the host |
string |
hardwareModel |
Hardware model of the host |
string |
hardwareVendor |
Hardware vendor of the host |
string |
hybrid |
Information about the storage type of the host, true if the host is hybrid. |
boolean |
id |
ID of the host |
string |
ipAddresses |
Information about IP addresses assigned to the host |
< IpAddress > array |
memory |
Information about memory on the host |
|
networkpool |
Information about the network pool this host is part of |
|
physicalNics |
Information about physical NICs on the host |
< PhysicalNic > array |
status |
Status of the host |
string |
storage |
Information about storage on the host |
4.90. HostCommissionSpec
This specification contains the input to commission a host to VMware Cloud Foundation
Name | Description | Schema |
---|---|---|
fqdn |
FQDN of the host |
string |
networkPoolId |
ID of the network pool to associate the host with |
string |
networkPoolName |
Name of the network pool to associate the host with |
string |
password |
Password of the host |
string |
storageType |
Storage Type |
string |
username |
Username of the host |
string |
4.91. HostCount
Name | Description | Schema |
---|---|---|
total |
Example : |
integer (int32) |
unallocated |
Example : |
integer (int32) |
used |
Example : |
integer (int32) |
4.92. HostCriterion
Represents a criterion for querying the host
Name | Description | Schema |
---|---|---|
arguments |
Arguments required for a particular criterion |
< string, string > map |
description |
Description of the criterion |
string |
name |
Name of the criterion |
string |
4.93. HostDecommissionSpec
This specification contains host details required to decommission a host from VMware Cloud Foundation
Name | Description | Schema |
---|---|---|
fqdn |
FQDN of the host |
string |
4.94. HostNetworkSpec
This specification contains network details required when adding a vSphere host to a cluster
Name | Description | Schema |
---|---|---|
vmNics |
List of the vSphere host vmNics |
< VmNic > array |
4.95. HostQueryResponse
Represents a host query response.
Name | Description | Schema |
---|---|---|
queryInfo |
Query info |
|
result |
Query result |
4.96. HostReference
Represents an ESXi host reference
Name | Description | Schema |
---|---|---|
fqdn |
FQDN of the host |
string |
id |
ID of the host |
string |
ipAddress |
IP address of the host |
string |
4.97. HostSpec
This specification contains information required to add vSphere host to a cluster
Name | Description | Schema |
---|---|---|
azName |
Availability Zone Name |
string |
hostName |
Host name of the vSphere host |
string |
hostNetworkSpec |
Network Details of the vSphere host |
|
id |
ID of a vSphere host in the free pool |
string |
ipAddress |
IP address of the vSphere host |
string |
licenseKey |
License key of a vSphere host in the free pool |
string |
password |
SSH password of the vSphere host |
string |
username |
Username of the vSphere host |
string |
4.98. HostVmknicSpec
Spec contains parameters for ESXi Host Vmknic
Name | Description | Schema |
---|---|---|
ipAddress |
Vmknic IP address |
string |
macAddress |
Vmknic mac address |
string |
portgroup |
Portgroup |
string |
4.99. Instant
Name | Description | Schema |
---|---|---|
epochSecond |
Example : |
integer (int64) |
nano |
Example : |
integer (int32) |
4.100. InventoryInfo
Name | Description | Schema |
---|---|---|
hostCount |
Example : HostCount |
4.101. InvitationSpec
Name | Description | Schema |
---|---|---|
inviteeFqdn |
Example : |
string |
inviteeRole |
Example : |
enum (CONTROLLER, MANAGER, MEMBER, NOT_JOINED) |
tokenExpiryHours |
Example : |
number (float) |
4.102. IpAddress
Represents IP address
Name | Description | Schema |
---|---|---|
ipAddress |
IP address |
string |
type |
Type of IP addresss |
string |
4.103. IpAllocation
Defines an IP address with gateway and subnet
Name | Description | Schema |
---|---|---|
cidr |
Classless Inter-Domain Routing (CIDR) |
string |
gateway |
Gateway |
string |
ipAddress |
IP Address |
string |
subnet |
Subnet |
string |
4.104. IpPool
Represents an IP Pool of a network in a network pool
Name | Description | Schema |
---|---|---|
end |
End IP address of the IP pool |
string |
start |
Start IP address of the IP pool |
string |
4.105. IpRange
Spec contains parameters for range of IP addresses
Name | Description | Schema |
---|---|---|
endIpAddress |
End IP Address |
string |
startIpAddress |
Start IP Address |
string |
4.106. LicenseKey
Defines a license key and its attributes
Name | Description | Schema |
---|---|---|
description |
Description of the license key |
string |
id |
The ID of the license key |
string |
isUnlimited |
Indicates if the license key has unlimited usage |
boolean |
key |
The 29 alpha numeric character license key with hyphens |
string |
licenseKeyUsage |
License key usage details |
|
licenseKeyValidity |
License key validity details |
4.107. LicenseKeyUsage
Defines license key usage
Name | Description | Schema |
---|---|---|
licenseUnit |
Units of the license key |
string |
remaining |
The remaining/free units of the license key |
integer (int32) |
total |
The total units of the license key |
integer (int32) |
used |
The consumed/used units of the license key |
integer (int32) |
4.108. LicenseKeyValidity
Defines license key validity details
Name | Description | Schema |
---|---|---|
expiryDate |
The license key expiry date |
|
licenseKeyStatus |
The validity status of the license key |
string |
4.109. LocalizableErrorCodePack
Name | Description | Schema |
---|---|---|
arguments |
Example : |
< object > array |
component |
Example : |
string |
defaultMessage |
Example : |
string |
localBundle |
Example : |
string |
messageKey |
Example : |
string |
4.110. MapOfstringAndComponentInfo
Type : < string, ComponentInfo > map
4.111. MapOfstringAndHardwareSupportPackageInfo
Type : < string, HardwareSupportPackageInfo > map
4.112. MapOfstringAndstring
Type : < string, string > map
4.113. MemberCapacityInfo
Name | Description | Schema |
---|---|---|
summary |
Example : CapacitySummary |
4.114. MemberDetail
Name | Description | Schema |
---|---|---|
city |
Example : |
string |
coordinate |
Example : PositionCoordinate |
|
country |
Example : |
string |
fqdn |
Example : |
string |
role |
Example : |
enum (CONTROLLER, MANAGER, MEMBER, NOT_JOINED) |
siteName |
Example : |
string |
siteType |
Example : |
enum (DATACENTER, ROBO, EDGE) |
state |
Example : |
string |
4.115. MemberFact
Name | Description | Schema |
---|---|---|
error |
Example : FederationOperationError |
|
federationName |
Example : |
string |
memberDetail |
Example : MemberDetail |
|
permissions |
Example : |
< enum (BOOTSTRAP, TEARDOWN, INVITE_MEMBER, EVICT, LIST_INVENTORY, JOIN, LEAVE) > array |
4.116. MemberHealth
Name | Description | Schema |
---|---|---|
healthCode |
Example : |
enum (GREEN, YELLOW, RED) |
healthDetails |
Example : |
< string > array |
4.117. MemberInfo
Name | Description | Schema |
---|---|---|
memberDetails |
Example : MemberDetail |
|
memberHealth |
Example : MemberHealth |
|
memberInventory |
Example : MemberInventory |
|
memberLiveness |
Example : MemberLiveliness |
4.118. MemberInventory
Name | Description | Schema |
---|---|---|
capacity |
Example : MemberCapacityInfo |
|
creationTime |
Example : Instant |
|
inventoryInfo |
Example : InventoryInfo |
|
softwareInfo |
Example : MemberSoftwareInfo |
4.119. MemberJoinSpec
Name | Description | Schema |
---|---|---|
commonName |
Example : |
string |
controllerFqdn |
Example : |
string |
joinToken |
Example : |
string |
memberJoinDetail |
Example : MemberDetail |
4.120. MemberLiveliness
Name | Description | Schema |
---|---|---|
livelinessCode |
Example : |
enum (GREEN, YELLOW, RED) |
livelinessDetails |
Example : |
< string > array |
4.121. MemberSoftwareInfo
Name | Description | Schema |
---|---|---|
pendingUpdates |
Example : |
integer (int32) |
4.122. MembershipInvitation
Name | Description | Schema |
---|---|---|
controllerFqdn |
Example : |
< string > array |
error |
Example : FederationOperationError |
|
invitationToken |
Example : |
string |
inviteeFqdn |
Example : |
string |
inviteeRole |
Example : |
enum (CONTROLLER, MANAGER, MEMBER, NOT_JOINED) |
4.123. Memory
Represents information about memory on a host
Name | Description | Schema |
---|---|---|
totalCapacityMB |
Total memory in MB |
number (double) |
usedCapacityMB |
Used memory in MB |
number (double) |
4.124. MessageBusServerInfo
Name | Description | Schema |
---|---|---|
brokerId |
Example : |
integer (int32) |
fqdn |
Example : |
string |
hostAddress |
Example : |
string |
port |
Example : |
integer (int32) |
4.125. MessageBusServerInfoList
Name | Description | Schema |
---|---|---|
messageBusServersInfo |
Example : |
< MessageBusServerInfo > array |
4.126. MessagePack
A messasge pack representing a localizable message and suitable for machine processing. Contains a message key unique in the scope of the specified component, as well as the arguments needed to generate the localized message.
Name | Description | Schema |
---|---|---|
arguments |
The arguments used to localize the message. Can be used by scripts to automate the response processing. |
< string > array |
component |
The component the message belongs to |
string |
message |
The localized message (if not provided by another property) |
string |
messageKey |
The machine-readable key of the message |
string |
4.127. MicrosoftCertificateAuthoritySpec
This specification contains Microsoft CA configuration details
Name | Description | Schema |
---|---|---|
secret |
CA server password |
string |
serverUrl |
CA server url |
string |
templateName |
CA server template name |
string |
username |
CA server username |
string |
4.128. NasVolumeSpec
NAS configuration for NFS based cluster
Name | Description | Schema |
---|---|---|
path |
Shared directory path used for NFS based cluster creation |
string |
readOnly |
Readonly is used to identify whether to mount the directory as readOnly or not |
boolean |
serverName |
NFS Server name used for cluster creation |
< string > array |
userTag |
User tag used to annotate NFS share |
string |
4.129. Network
Represents a network in a network pool
Name | Description | Schema |
---|---|---|
freeIps |
List of free IPs to use |
< string > array |
gateway |
Gateway for the network |
string |
id |
The ID of the network |
string |
ipPools |
List of IP pool ranges to use |
< IpPool > array |
mask |
Subnet mask for the subnet of the network |
string |
mtu |
MTU of the network |
integer (int32) |
subnet |
Subnet associated with the network |
string |
type |
Network Type of the network |
string |
usedIps |
List of used IPs |
< string > array |
vlanId |
VLAN ID associated with the network |
integer (int32) |
4.130. NetworkDetailsSpec
This specification contains network parameters required for new virtual machines being added to a workload domain
Name | Description | Schema |
---|---|---|
dnsName |
DNS name of the virtual machine, e.g., vc-1.domain1.vsphere.local |
string |
gateway |
IPv4 gateway the VM can use to connect to the outside world |
string |
ipAddress |
IPv4 address of the virtual machine |
string |
subnetMask |
Subnet mask |
string |
4.131. NetworkPool
Represents a network pool in the system
Name | Description | Schema |
---|---|---|
id |
The ID of the network pool |
string |
name |
User specified name of the network pool |
string |
networks |
Representing the networks associated with the network pool |
< Network > array |
4.132. NetworkPoolReference
Represents a network pool reference
Name | Description | Schema |
---|---|---|
id |
ID of the network pool |
string |
name |
Name of the network pool |
string |
4.133. NetworkSpec
This specification contains cluster network configuration
Name | Description | Schema |
---|---|---|
nsxClusterSpec |
NSX configuration to add to the cluster |
|
vdsSpecs |
Distributed switches to add to the cluster |
< VdsSpec > array |
4.134. NfsDatastoreSpec
This specification contains cluster storage configuration for NFS
Name | Description | Schema |
---|---|---|
datastoreName |
Datastore name used for cluster creation |
string |
nasVolume |
NAS volume configuration for NFS based cluster |
4.135. NiocBandwidthAllocationSpec
This specification contains network traffic per resource type
Name | Description | Schema |
---|---|---|
niocTrafficResourceAllocation |
DvsHostInfrastructureTrafficResourceAllocation |
|
type |
DvsHostInfrastructureTrafficResource resource type |
string |
4.136. NiocSpec
Spec contains parameters for Network IO Control
Name | Description | Schema |
---|---|---|
trafficType |
Traffic Type |
string |
value |
NIOC Value |
string |
4.137. NiocTrafficResourceAllocation
Specify network traffic for a resource
Name | Description | Schema |
---|---|---|
limit |
Example : |
integer (int64) |
reservation |
Example : |
integer (int64) |
4.138. NsxClusterSpec
This specification contains NSX configuration for cluster
Name | Description | Schema |
---|---|---|
nsxTClusterSpec |
NSX-T spec for the new cluster, required for NSX-T based workload domains, optional otherwise |
4.139. NsxManagerSpec
This specification contains the parameters required to install and configure NSX Manager in a workload domain
Name | Description | Schema |
---|---|---|
name |
Name of the NSX Manager virtual machine |
string |
networkDetailsSpec |
Network speciication details of the NSX Manager virtual machine |
4.140. NsxTCluster
NSX-T Cluster representation
Name | Description | Schema |
---|---|---|
domains |
Information about the domains associated with the cluster |
< DomainReference > array |
id |
ID of the cluster |
string |
isShared |
Boolean to identify if the NSX-T cluster can be shared among workload domains |
boolean |
isVlcmCompatible |
Boolean to identify if the NSX-T cluster is compatible with Vlcm |
boolean |
nodes |
Information about the NSX-T managers associated with the cluster |
< NsxTManager > array |
vip |
VIP (Virtual IP Address) of the cluster |
string |
vipFqdn |
FQDN for VIP of the cluster |
string |
4.141. NsxTClusterReference
Represents an NSX-T Cluster reference
Name | Description | Schema |
---|---|---|
id |
ID of the NSX-T cluster |
string |
vip |
VIP (Virtual IP Address) of the NSX-T cluster |
string |
vipFqdn |
FQDN for VIP of the NSX-T cluster |
string |
4.142. NsxTClusterSpec
This specification contains NSX-T configuration for a new cluster.
Name | Description | Schema |
---|---|---|
geneveVlanId |
Vlan id of Geneve |
integer (int32) |
4.143. NsxTEdgeClusterProfileSpec
This specification contains edge cluster profile configurations
Name | Description | Schema |
---|---|---|
bfdAllowedHop |
BFD allowed Hop |
integer (int64) |
bfdDeclareDeadMultiple |
BFD Declare Dead Multiple |
integer (int64) |
bfdProbeInterval |
BFD Probe |
integer (int64) |
edgeClusterProfileName |
Name for the edge cluster profile. |
string |
standbyRelocationThreshold |
Standby Relocation Threshold |
integer (int64) |
4.144. NsxTEdgeNodeSpec
This specification contains configuration inputs required to deploy and configure an edge node
Name | Description | Schema |
---|---|---|
clusterId |
Cluster on which the edge needs to be deployed |
string |
edgeNodeName |
Edge Node Name |
string |
edgeTep1IP |
Edge TEP 1 IP |
string |
edgeTep2IP |
Edge TEP 2 IP |
string |
edgeTepGateway |
Edge TEP Gateway IP |
string |
edgeTepVlan |
Edge TEP VLAN |
integer (int32) |
interRackCluster |
Is inter-rack cluster(true for L2 non-uniform and L3 : At least one of management, uplink, Edge and host TEP networks is different for hosts of the cluster, false for L2 uniform :����All hosts in cluster have identical management, uplink, Edge and host TEP networks) |
boolean |
managementGateway |
Management Gateway IP |
string |
managementIP |
Management Interface IP |
string |
uplinkNetwork |
Specifications of uplinks for the Edge Node |
< NsxTEdgeUplinkNetwork > array |
4.145. NsxTEdgeUplinkNetwork
This specification contains input parameters required to configure uplink network for NSX-T edge node VM
Name | Description | Schema |
---|---|---|
asnPeer |
ASN of Peer |
integer (int64) |
bgpPeerPassword |
BGP Peer Password |
string |
peerIP |
BGP Peer IP |
string |
uplinkInterfaceIP |
Uplink IP |
string |
uplinkVlan |
Uplink Vlan |
integer (int32) |
4.146. NsxTManager
NSX-T Manager representation
Name | Description | Schema |
---|---|---|
fqdn |
FQDN of the manager |
string |
ipAddress |
IP address of the manager |
string |
name |
NSX-T Manager VM name in vCenter |
string |
4.147. NsxTSpec
This specification contains the parameters required to install and configure NSX-T in a workload domain
Name | Description | Schema |
---|---|---|
licenseKey |
NSX license value |
string |
nsxManagerAdminPassword |
NSX manager admin password (basic auth and SSH) |
string |
nsxManagerSpecs |
Specification details of the NSX Manager virtual machine |
< NsxManagerSpec > array |
vip |
Virtual IP address which would act as proxy/alias for NSX-T Managers |
string |
vipFqdn |
FQDN for VIP so that common SSL certificates can be installed across all managers |
string |
4.148. NsxtEdgeCluster
Nsxt Edge Cluster Upgrade Resource
Name | Description | Schema |
---|---|---|
id |
Edge cluster id |
string |
name |
Edge cluster name |
string |
resourceHealth |
Current resource health status |
string |
upgradeStatus |
Upgrade status with respect to the bundle |
string |
version |
The current version of the edge cluster.If a partial upgrade is done, this will be the least version among the edges in the edge cluster |
string |
4.149. NsxtEdgeClusterUpgradeSpec
Host transport node cluster upgrade input
Name | Description | Schema |
---|---|---|
edgeClusterId |
Resource ID of the edge transport node cluster |
string |
edgeParallelUpgrade |
disable/enable parallel upgrade of edges within the cluster |
boolean |
4.150. NsxtEdgeSpec
NSX-T edge specification
Name | Description | Schema |
---|---|---|
asn |
NSX-T edge asn |
integer (int64) |
bgpNeighbours |
NSX-T edge bgp neighbour |
< BgpNeighbour > array |
edgeAdminPassword |
NSX-T edge admin password |
string |
edgeAuditPassword |
NSX-T edge audit password |
string |
edgeClusterName |
NSX-T edge cluster name |
string |
edgeFormFactor |
NSX-T edge form factor |
enum (Oneamong:compact, large, quadlarge, xlarge) |
edgeNodeSpecs |
NSX-T edge node specification |
< SddcNsxtEdgeNodeSpec > array |
edgeRootPassword |
NSX-T edge root password |
string |
edgeServicesSpecs |
NSX-T Edge Services specification |
|
tier0ServicesHighAvailability |
NSX-T tier0 service high availability |
string |
4.151. NsxtHostCluster
Nsxt Host Cluster Upgrade Resource
Name | Description | Schema |
---|---|---|
availableHardwareSupportManagers |
Available Hardware Support Managers for Firmware upgrade |
< HardwareSupportPackages > array |
configuredHardwareSupportManagers |
Configured Hardware Support Managers for Firmware upgrade |
< HardwareSupportPackage > array |
domainId |
Id of the domain the Host cluster belongs to |
string |
id |
Host cluster VCF cluster id |
string |
name |
Cluster name |
string |
primaryCluster |
Flag to determine if primary cluster for vLCM |
boolean |
resourceHealth |
Current resource health status |
string |
totalUnits |
Total number of hosts in the Host cluster |
integer (int32) |
upgradeStatus |
Upgrade status with respect to the bundle |
string |
upgradedUnits |
Number of hosts which are already upgraded |
integer (int32) |
version |
The current version of the host node cluster.If a partial upgrade is done, this will be the least version among the hosts |
string |
vlcmEnabled |
Example : |
boolean |
4.152. NsxtHostClusterUpgradeSpec
Host trnasport node cluster upgrade input
Name | Description | Schema |
---|---|---|
hostClusterId |
Resource ID of the host transport node cluster |
string |
hostParallelUpgrade |
Flag for disabling/enabling parallel upgrade within the cluster |
boolean |
liveUpgrade |
Flag for disabling/enabling live upgrade of hosts in the transportnode clusters |
boolean |
4.153. NsxtInterface
NSX-T edge node interface specification
Name | Description | Schema |
---|---|---|
interfaceCidr |
NSX-T edge node interface CIDR |
string |
name |
NSX-T edge node interface name |
string |
4.154. NsxtLogicalSegment
NSX-T edge node logical segment specification
Name | Description | Schema |
---|---|---|
name |
NSX-T edge node logical switch name |
string |
networkType |
NSX-T edge node logical segment network type |
enum (Oneamong:X_REGION, REGION_SPECIFIC) |
4.155. NsxtManagerCluster
Nsxt Manager Cluster Upgrade Resource
Name | Description | Schema |
---|---|---|
id |
Manager cluster id |
string |
name |
Manager cluster name |
string |
resourceHealth |
Current resource health status |
string |
upgradeStatus |
Upgrade status with respect to the bundle |
string |
version |
The current version of the manager cluster.If a partial upgrade is done, this will be the least version among the managers in the manager cluster |
string |
4.156. NsxtManagerSpec
Spec contains parameters for NSX-T manager
Name | Description | Schema |
---|---|---|
hostname |
NSX-T Manager hostname |
string |
ip |
NSX-T Manager IP Address |
string |
4.157. NsxtResources
Nsxt Upgrade Resources for an NSXT instance
Name | Description | Schema |
---|---|---|
bundleId |
Bundle id used to compute the upgradability |
string |
domainId |
Domain id associated with the NSX-T cluster |
string |
nsxtEdgeClusters |
List of edge clusters that are candidates for upgrade |
< NsxtEdgeCluster > array |
nsxtHostClusters |
List of host clusters that are candidates for upgrade |
< NsxtHostCluster > array |
nsxtManagerCluster |
Manager cluster that is a candidate for upgrade |
|
nsxtUpgradeCoordinator |
Upgrade coordinator pertaining to the NSX-T instance |
4.158. NsxtTransportZone
Spec contains required parameters for NSX-T Transport Zone
Name | Description | Schema |
---|---|---|
networkName |
Transport zone network name |
string |
zoneName |
Transport zone name |
string |
4.159. NsxtUpgradeCoordinator
NSXT Upgrade coordinator Upgrade Resource
Name | Description | Schema |
---|---|---|
enabledOn |
The IP of the manager on which UC is enabled |
string |
id |
Upgrade coordinator id |
string |
resourceHealth |
Current resource health status |
string |
upgradeStatus |
Upgrade status with respect to the bundle |
string |
version |
The current version of the UC |
string |
4.160. NsxtUpgradeOptions
NSXT Upgrade options
Name | Description | Schema |
---|---|---|
isEdgeClustersUpgradeParallel |
Flag for disabling/enabling parallel upgrade of edge transportnode clusters |
boolean |
isEdgeOnlyUpgrade |
Flag for performing edge-only upgrade |
boolean |
isHostClustersUpgradeParallel |
Flag for disabling/enabling parallel upgrade of host transportnode clusters |
boolean |
4.161. NsxtUpgradeUserInputSpec
Nsxt Upgrade User Input Specification
Name | Description | Schema |
---|---|---|
nsxtEdgeClusterUpgradeSpecs |
List of edge clusters information if explicit selection is to be made |
< NsxtEdgeClusterUpgradeSpec > array |
nsxtHostClusterUpgradeSpecs |
List of host clusters information if explicit selection is to be made |
< NsxtHostClusterUpgradeSpec > array |
nsxtId |
Identifier of the NSXT instance |
string |
nsxtUpgradeOptions |
List of host clusters information if explicit selection is to be made |
4.162. NtpConfiguration
NTP Configuration
Name | Description | Schema |
---|---|---|
ntpServers |
List of NTP servers |
< NtpServer > array |
4.163. NtpServer
NTP server details
Name | Description | Schema |
---|---|---|
ipAddress |
IP address/FQDN of NTP server |
string |
4.164. OpenSSLCertificateAuthoritySpec
This specification contains OpenSSL CA configuration details
Name | Description | Schema |
---|---|---|
commonName |
OpenSSL CA domain name |
string |
country |
ISO 3166 country code where company is legally registered |
string |
locality |
The city or locality where company is legally registered |
string |
organization |
The name under which company is legally registered |
string |
organizationUnit |
Organization with which the certificate is associated |
string |
state |
The full name of the state where company is legally registered |
string |
4.165. Package
Hardware Support Package Specification
Name | Description | Schema |
---|---|---|
name |
Package name |
string |
version |
Package version |
string |
4.166. PackageSpec
Hardware Support Package Specification
Name | Description | Schema |
---|---|---|
name |
Package name |
string |
version |
Package version |
string |
4.167. Page
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< object > array |
4.168. PageOfBundle
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Bundle > array |
4.169. PageOfCertificate
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Certificate > array |
4.170. PageOfCertificateAuthority
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< CertificateAuthority > array |
4.171. PageOfCluster
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Cluster > array |
4.172. PageOfClusterCriterion
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< ClusterCriterion > array |
4.173. PageOfCredential
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Credential > array |
4.174. PageOfCredentialsTask
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< CredentialsTask > array |
4.175. PageOfCsr
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Csr > array |
4.176. PageOfDomain
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Domain > array |
4.177. PageOfEdgeCluster
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< EdgeCluster > array |
4.178. PageOfEndpoint
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Endpoint > array |
4.179. PageOfHost
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Host > array |
4.180. PageOfHostCriterion
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< HostCriterion > array |
4.181. PageOfLicenseKey
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< LicenseKey > array |
4.182. PageOfNetwork
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Network > array |
4.183. PageOfNetworkPool
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< NetworkPool > array |
4.184. PageOfNsxTCluster
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< NsxTCluster > array |
4.185. PageOfPsc
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Psc > array |
4.186. PageOfRole
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Role > array |
4.187. PageOfSddcManager
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< SddcManager > array |
4.188. PageOfSddcTask
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< SddcTask > array |
4.189. PageOfSsoDomainEntity
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< SsoDomainEntity > array |
4.190. PageOfTask
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Task > array |
4.191. PageOfUpgradable
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Upgradable > array |
4.192. PageOfUpgradablesClusterResource
Represents a page of elements of a Upgradables Cluster Resource
Name | Description | Schema |
---|---|---|
elements |
The list of Upgradables Cluster Resource elements included in this page |
< UpgradablesClusterResource > array |
4.193. PageOfUser
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< User > array |
4.194. PageOfValidation
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Validation > array |
4.195. PageOfVcenter
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Vcenter > array |
4.196. PageOfVcfService
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< VcfService > array |
4.197. PageOfVersionAliasesForBundleComponentType
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< VersionAliasesForBundleComponentType > array |
4.198. PageOfVrslcm
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< Vrslcm > array |
4.199. PageOfstring
Represents a page of elements of a single type
Name | Description | Schema |
---|---|---|
elements |
The list of elements included in this page |
< string > array |
4.200. PartnerExtensionSpec
Specification for partner extensions. This specification is used in the Bundle Upload API
Name | Description | Schema |
---|---|---|
partnerBundleMetadataFilePath |
Path to the bundle metadata file. The metadata file can have details of multiple bundles |
string |
partnerBundleVersion |
Version of partner bundle to be uploaded. Should match one of the bundle versions available in the partner bundle metadata file |
string |
4.201. Personality
Personality contains bits to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
createdBy |
Personality created by |
string |
description |
Personality description |
string |
displayName |
Personality displayName |
string |
imageChecksum |
Personality image checksum |
string |
imageSize |
Personality image size |
string |
kbArticles |
Personality kb articles |
|
personalityId |
Personality id |
string |
personalityName |
Personality name |
string |
releaseDate |
Personality Release date |
integer (int64) |
softwareInfo |
Personality software spec |
|
tags |
Personality tags |
< string > array |
version |
Personality Version |
string |
vsphereExportedIsoPath |
Personality depot path |
string |
vsphereExportedJsonPath |
Personality depot path |
string |
vsphereExportedZipPath |
Personality depot path |
string |
4.202. PersonalitySpec
Personality Specification for vLCM based upgrade
Name | Description | Schema |
---|---|---|
hardwareSupportSpecs |
Hardware Support Specifications for Firmware upgrade |
< HardwareSupportSpec > array |
personalityId |
Personality ID for vLCM based Upgrade |
string |
4.203. PersonalityUploadSpec
Personality upload specification. This spec is used in personality upload API.
Name | Description | Schema |
---|---|---|
name |
Personality name |
string |
uploadMode |
Personality upload mode |
string |
uploadSpecRawMode |
Personality upload spec for upload from RAW files |
|
uploadSpecRawWithFileUploadIdMode |
Personality upload spec for upload using file upload id |
|
uploadSpecReferredMode |
Personality upload spec for upload from REFERRED vcenter cluster |
4.204. PersonalityUploadSpecRaw
Personality upload specification for uploading the personality from raw files exported from avCenter cluster. This mode of uplaoding personality is useful when the source vCenter cluster isoutside the target VCF deployment.
Name | Description | Schema |
---|---|---|
personalityISOFilePath |
Personality ISO File Path |
string |
personalityInfoJSONFilePath |
Personality Info JSON File Path |
string |
personalityJSONFilePath |
Personality JSON File Path |
string |
personalityZIPFilePath |
Personality Zip File Path |
string |
4.205. PersonalityUploadSpecRawWithFileUploadId
Personality upload specification for uploading the personality from raw files exported from a vCenter cluster. This mode of uploading personality is useful when the source vCenter cluster is outside the target VCF deployment. User can upload files from a source location to SDDC Manager using v1/personalities/files API, which returns a file upload id. The id is then passed in this spec with Personality Upload Mode RAW_WITH_FILE_UPLOAD_ID.
Name | Description | Schema |
---|---|---|
fileUploadId |
Personality file upload id. This id is obtained by calling v1/personalities/files and uploading files into SDDC Manager |
string |
4.206. PersonalityUploadSpecReferred
Personality upload specification for uploading the personality from a referred vCentercluster. This mode of uplaoding personality is useful when the source vCenter cluster isinternal to the target VCF deployment.
Name | Description | Schema |
---|---|---|
clusterId |
Source cluster UUID from VCF inventory |
string |
vCenterId |
Example : |
string |
vcenterId |
Example : |
string |
4.207. PhysicalNic
Represents a physical NIC
Name | Description | Schema |
---|---|---|
deviceName |
Device name of the physical NIC |
string |
macAddress |
Mac address of the physical NIC |
string |
4.208. PortgroupSpec
This specification contains vCenter port group configurations
Name | Description | Schema |
---|---|---|
name |
Port group name |
string |
transportType |
Port group transport type |
string |
4.209. PositionCoordinate
Name | Description | Schema |
---|---|---|
latitude |
Example : |
number (double) |
longitude |
Example : |
number (double) |
4.210. PrecheckSpec
Precheck Specification. This specification gets used in the Precheck API
Name | Description | Schema |
---|---|---|
bundleId |
If specified, indicate the bundle applicability in the result |
string |
resources |
List of resources for Precheck supported type DOMAIN, CLUSTER |
< Resource > array |
4.211. Psc
Psc representation
Name | Description | Schema |
---|---|---|
domain |
Information about the domain this PSC is part of |
|
fqdn |
FQDN of the Psc |
string |
id |
ID of the Psc |
string |
ipAddress |
IP Address of the Psc |
string |
isReplica |
Indicates if the Psc is a replica |
boolean |
ssoDomainName |
SSO Domain name of the Psc |
string |
ssoSubDomainName |
SSO sub domain name of the Psc |
string |
4.212. PscSpec
Spec contains parameters for deployment/configuration of Platform Services Controller
Name | Description | Schema |
---|---|---|
adminUserSsoPassword |
Admin user sso passwordPassword needs to be a strong password with at least one Uppercase alphabet, one lowercase alphabet, one digit and one special character specified in braces [!$%^] and 8-20 characters in length,and 3 maximum identical adjacent characters! |
string |
pscId |
PSC Name |
string |
pscSsoSpec |
PSC SSO Domain |
4.213. PscSsoSpec
Spec contains parameters for Platform Services Controller SSO
Name | Description | Schema |
---|---|---|
replicationPartner |
PSC Replication Partner, Its mandatory for secondary regionIf deploying 2 PSC’s, For 2nd PSC in Primary Region/Secondary Region - Its hostname of first PSCFor Secondary Region 1st PSC - User specified |
string |
ssoDomain |
PSC SSO Domain,its mandatory for secondary region and if deploying 2 PSC’s |
string |
4.214. QueryInfo
Represents the query info.
Name | Description | Schema |
---|---|---|
completed |
Example : |
boolean |
errorResponse |
Error response if the query has failed |
|
failure |
Example : |
boolean |
processing |
Example : |
boolean |
status |
Status of the query |
string |
4.215. RefreshToken
This contains refresh token id for the user API access.
Name | Description | Schema |
---|---|---|
id |
Refresh token id that can be used to request new access token |
string |
4.216. RemoteResponsePayload
Name | Description | Schema |
---|---|---|
assignedBrokerId |
Example : |
integer (int32) |
assignedZkId |
Example : |
integer (int32) |
mbServers |
Example : MessageBusServerInfoList |
|
srServers |
Example : SchemaRegistryServerInfoList |
|
zkServers |
Example : ZookeeperServerInfoList |
4.217. RemoteSiteSpec
Spec contains parameters for Remote site products
Name | Description | Schema |
---|---|---|
clusterName |
Remote region cluster name for mapping |
string |
datacenterName |
Remote region datacenter name for mapping |
string |
logicalSwitchNames |
Logical switch names for network mapping |
< string > array |
nsxCredentials |
Remote region NSX credentials |
|
nsxIp |
Remote region NSX IP address |
string |
placeholderDatastore |
Remote region placeholder datastore |
string |
pscAddress |
Remote region PSC address |
string |
remoteRegionVmFolders |
Remote region VM folders for explicit mapping |
< string, string > map |
vcCredentials |
Remote region VC/PSC credentials |
|
vcMgmtIp |
Remote region vC IP address |
string |
4.218. Resource
Represents the resource in the system
Name | Description | Schema |
---|---|---|
fqdn |
Resource FQDN |
string |
name |
Name of the resource |
string |
resourceId |
Resource ID |
string |
type |
Resource type |
string |
4.219. ResourceCapacity
Name | Description | Schema |
---|---|---|
cpu |
Example : CPU |
|
datastores |
Example : |
< Datastore > array |
hostCount |
Example : HostCount |
|
memory |
Example : Memory |
4.220. ResourceCredentials
Represents a resource along with its list of credentials to be changed.
Name | Description | Schema |
---|---|---|
credentials |
Credentials of the resource |
< BaseCredential > array |
resourceId |
Resource ID |
string |
resourceName |
Resource name |
string |
resourceType |
Authenticated Resource Type |
string |
4.221. ResourcePoolSpec
Spec contains parameters for Resource Pool
Name | Description | Schema |
---|---|---|
cpuLimit |
CPU limit, default -1 (unlimited) |
integer (int64) |
cpuReservationExpandable |
Is CPU reservation expandable, default true |
boolean |
cpuReservationMhz |
CPU reservation in Mhz |
integer (int64) |
cpuReservationPercentage |
CPU reservation percentage, from 0 to 100, default 0 |
integer (int32) |
cpuSharesLevel |
CPU shares level, default 'normal' |
enum (custom, high, low, normal) |
cpuSharesValue |
CPU shares value, only required when shares level is 'normal' |
integer (int32) |
memoryLimit |
Memory limit, default -1 (unlimited) |
integer (int64) |
memoryReservationExpandable |
Is Memory reservation expandable, default true |
boolean |
memoryReservationMb |
Memory reservation in MB |
integer (int64) |
memoryReservationPercentage |
Memory reservation percentage, from 0 to 100, default 0 |
integer (int32) |
memorySharesLevel |
Memory shares level. default 'normal' |
enum (custom, high, low, normal) |
memorySharesValue |
Memory shares value, only required when shares level is '0' |
integer (int32) |
name |
Resource Pool name |
string |
type |
Type of resource pool |
enum (management, compute, network) |
4.222. ResourceUpgradeSpec
Resource Upgrade Specification
Name | Description | Schema |
---|---|---|
personalitySpec |
Personality Specifications for vLCM based upgrade |
|
resourceId |
Resource ID for Upgrade |
string |
scheduledTimestamp |
Upgrade Scheduled Time |
|
shutdownVms |
If Resource Type is UNASSIGNED_HOST, set flag for enabling shutting down VM’s before Upgrade |
boolean |
toVersion |
If Resource Type is UNASSIGNED_HOST, set the target version for Upgrade |
string |
upgradeNow |
Flag for enabling Upgrade Now. If true, scheduledTimestamp is ignored |
boolean |
4.223. RestoreSpec
Restore Specification
Name | Description | Schema |
---|---|---|
backupFile |
Backup file name |
string |
elements |
List of elements to be restored |
< BackupResource > array |
encryption |
Encryption |
4.224. Role
Represents role and its attributes
Name | Description | Schema |
---|---|---|
description |
The description of the role |
string |
id |
The ID of the role |
string |
name |
The name of the role |
string |
4.225. RoleReference
Represents a role reference
Name | Description | Schema |
---|---|---|
id |
ID of the role |
string |
4.226. SchemaRegistryServerInfo
Name | Description | Schema |
---|---|---|
hostAddress |
Example : |
string |
port |
Example : |
integer (int32) |
protocol |
Example : |
string |
4.227. SchemaRegistryServerInfoList
Name | Description | Schema |
---|---|---|
schemaRegistryServersInfo |
Example : |
< SchemaRegistryServerInfo > array |
4.228. SddcClusterSpec
Spec contains parameters for vCenter Cluster
Name | Description | Schema |
---|---|---|
clusterEvcMode |
vCenter cluster EVC mode |
string |
clusterName |
vCenter Cluster Name |
string |
hostFailuresToTolerate |
Host failures to tolerate |
integer (int32) |
hostProfileComplianceCheckHour |
Hour at which the scheduled compliance check runs |
integer (int32) |
hostProfileComplianceCheckMinute |
Minute at which the scheduled compliance check runs |
integer (int32) |
hosts |
vCenter Cluster Host IDs |
< string > array |
personalityName |
Cluster Personality Name |
string |
resourcePoolSpecs |
Resource Pool Specs |
< ResourcePoolSpec > array |
vmFolders |
Virtual Machine folders map |
< string, string > map |
4.229. SddcCredentials
Credentials contains the username and password
Name | Description | Schema |
---|---|---|
password |
Password |
string |
username |
Username |
string |
4.230. SddcHostSpec
Spec contains parameters for Host
Name | Description | Schema |
---|---|---|
association |
Host Association: Location/Datacenter |
string |
credentials |
Host Credentials |
|
hostname |
Host Hostname |
string |
ipAddressPrivate |
Host Private Management IP |
|
key |
Host key |
string |
serverId |
Host server ID |
string |
sshThumbprint |
Host SSH thumbprint |
string |
sslThumbprint |
Host SSL thumbprint |
string |
vSwitch |
Example : |
string |
vmknicSpecs |
List of Host Vmknic Spec |
< HostVmknicSpec > array |
vswitch |
Example : |
string |
4.231. SddcManager
Sddc Manager representation
Name | Description | Schema |
---|---|---|
domain |
Information about the domain this Sddc Manager is part of |
|
fqdn |
FQDN of the Sddc Manager |
string |
id |
ID of the Sddc Manager |
string |
ipAddress |
IP Address of the Sddc Manager |
string |
version |
Version of the Sddc Manager |
string |
4.232. SddcManagerSpec
Client input parameters for SDDC Manager Virtual Machine
Name | Description | Schema |
---|---|---|
hostname |
SddcManager Hostname |
string |
ipAddress |
Sddc manager ip address |
string |
licenseKey |
Sddc manager license key |
string |
netmask |
Sddc manager netmask |
string |
restApiCredentials |
Basic Auth Credentials for authenticating into SDDC Manager API, UserName must be adminPassword needs to be a strong password with at least one alphabet and one special character and at least 8 characters in length. |
|
rootUserCredentials |
Root user credentials for the SddcManager VM, UserName must be rootPassword needs to be a strong password with at least one alphabet and one special character and at least 8 characters in length. |
|
secondUserCredentials |
Second user credentials for the SddcManager VM, UserName must be vrackPassword needs to be a strong password with at least one alphabet and one special character and at least 8 characters in length. |
4.233. SddcNetworkSpec
Defines a network spec
Name | Description | Schema |
---|---|---|
activeUplinks |
Active Uplinks for teaming policy, specify uplink1 for failover_explicit VSAN Teaming Policy |
< string > array |
excludeIpAddressRanges |
IP Addresse ranges to be excluded |
< string > array |
excludeIpaddresses |
IP Addresses to be excluded |
< string > array |
gateway |
Gateway |
string |
includeIpAddress |
IP Addresses to be included |
< string > array |
includeIpAddressRanges |
IP Addresse ranges to be included |
< IpRange > array |
mtu |
MTU size |
string |
networkType |
Network Type |
string |
portGroupKey |
Portgroup key name |
string |
standbyUplinks |
Standby Uplinks for teaming policy, specify uplink2 for failover_explicit VSAN Teaming Policy |
< string > array |
subnet |
Subnet |
string |
subnetMask |
Subnet Mask |
string |
teamingPolicy |
Teaming Policy for VSAN and VMOTION network types, Default is loadbalance_loadbased |
string |
vlanId |
VLAN Id |
string |
4.234. SddcNsxtEdgeNodeSpec
NSX-T edge node specification
Name | Description | Schema |
---|---|---|
edgeNodeHostname |
NSX-T edge node fqdn |
string |
edgeNodeName |
NSX-T edge node name |
string |
edgeVtep1Cidr |
NSX-T edge node vtep 1 cidr |
string |
edgeVtep2Cidr |
NSX-T edge node vtep 2 cidr |
string |
interfaces |
NSX-T edge node interfaces |
< NsxtInterface > array |
managementCidr |
NSX-T edge node management cidr |
string |
4.235. SddcNsxtEdgeServicesSpec
NSX-T Edge Services Specification
Name | Description | Schema |
---|---|---|
tier0GatewayName |
NSX-T Edge Tier-0 Gateway Name |
string |
tier1GatewayName |
NSX-T Edge Tier-1 Gateway Name |
string |
4.236. SddcNsxtSpec
Spec contains parameters for NSX-T deployment and configurations
Name | Description | Schema |
---|---|---|
logicalSegments |
NSX-T logical segment |
< NsxtLogicalSegment > array |
nsxtAdminPassword |
NSX-T admin password. The password must be at least 12 characters long. Must contain at-least 1 uppercase, 1 lowercase, 1 special character and 1 digit. In addition, a character cannot be repeated 3 or more times consectively. |
string |
nsxtAuditPassword |
NSX-T audit password. The password must be at least 12 characters long. Must contain at-least 1 uppercase, 1 lowercase, 1 special character and 1 digit. In addition, a character cannot be repeated 3 or more times consectively. |
string |
nsxtEdgeSpec |
NSX-T edge specification |
|
nsxtLicense |
NSX-T Manager license |
string |
nsxtManagerSize |
NSX-T Manager size |
string |
nsxtManagers |
NSX-T Managers |
< NsxtManagerSpec > array |
overLayTransportZone |
NSX-T OverLay Transport zone |
|
rootLoginEnabledForNsxtManager |
If true, allow root login for NSX-T Manager and deny if false |
boolean |
rootNsxtManagerPassword |
NSX-T Manager root password. Password should have 1) At least eight characters, 2) At least one lower-case letter, 3) At least one upper-case letter 4) At least one digit 5) At least one special character, 6) At least five different characters , 7) No dictionary words, 6) No palindromes |
string |
sshEnabledForNsxtManager |
If true, enable SSH for NSX-T Manager and disable if false |
boolean |
transportVlanId |
Transport VLAN ID |
integer (int32) |
vip |
Virtual IP address which would act as proxy/alias for NSX-T Managers |
string |
vipFqdn |
FQDN for VIP so that common SSL certificates can be installed across all managers |
string |
vlanTransportZone |
NSX-T VLAN transport zone |
4.237. SddcSpec
Spec contains parameters for creating/bringing up an SDDC
Name | Description | Schema |
---|---|---|
ceipEnabled |
Enable VCF Customer Experience Improvement Program |
boolean |
certificatesPassphrase |
Passphrase for the vCenter / NSX certificates |
string |
clusterSpec |
Cluster Spec |
|
dnsSpec |
DNS Spec |
|
dvSwitchVersion |
The version of the distributed virtual switches to be used |
string |
dvsSpecs |
List of Dvs Specs |
< DvsSpec > array |
esxLicense |
License for the ESXi hosts |
string |
excludedComponents |
Components to be excluded |
< string > array |
hostSpecs |
List of Host Specs |
< SddcHostSpec > array |
managementPoolName |
A String identifying the network pool associated with the management domain |
string |
networkSpecs |
List of Network Specs |
< SddcNetworkSpec > array |
nsxtSpec |
NSX-T Spec |
|
ntpServers |
List of NTP servers |
< string > array |
pscSpecs |
PSC VM spec |
< PscSpec > array |
remoteSiteSpec |
Remote site spec |
|
sddcId |
Client string that identifies an SDDC by name or instance name. . Used for management domain name. |
string |
sddcManagerSpec |
Sddc Manager Virtual Machine spec |
|
shouldCleanupVsan |
Flag indicating whether cleanup vSAN should be ran |
boolean |
skipEsxThumbprintValidation |
Skip ESXi thumbprint validation |
boolean |
taskName |
Name of the task to execute |
string |
vcenterSpec |
vCenter Spec |
|
vsanSpec |
VSAN Spec |
|
vxManagerSpec |
VxManager Spec |
|
vxRailSpec |
VxRail environment details |
4.238. SddcSubTask
Represents a SDDC sub-task
Name | Description | Schema |
---|---|---|
creationTimestamp |
Sub-Task Creation Time |
|
description |
Sub-Task Description |
string |
errors |
List of errors in case of a failure |
< Error > array |
localizableDescriptionPack |
Localizable SDDC Task description |
|
localizableNamePack |
Localizable SDDC Task name |
|
name |
Sub-Task Name |
string |
processingStateDescription |
Processing category description, e.g., VC Deployment, VSAN configuration etc |
string |
processingStateName |
Processing category name, e.g., VC Deployment, VSAN configuration etc |
string |
sddcId |
SDDC ID |
string |
status |
Task Status |
string |
updateTimestamp |
Last Update Time of Sub-Task |
4.239. SddcTask
Represents a SDDC task
Name | Description | Schema |
---|---|---|
creationTimestamp |
SDDC Task creation timestamp |
|
id |
SDDC ID |
string |
localizableNamePack |
Localizable SDDC Task name |
|
name |
Task name |
string |
sddcSubTasks |
All SDDC Sub-Tasks |
< SddcSubTask > array |
status |
SDDC Task status |
string |
4.240. SddcVcenterSpec
Spec contains parameters for vCenter
Name | Description | Schema |
---|---|---|
licenseFile |
License File |
string |
rootVcenterPassword |
vCenter root password. The password must be between 8 characters and 20 characters long. It must also contain at least one uppercase and lowercase letter, one number, and one character from '! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { Ι } ~' and all characters must be ASCII. Space is not allowed in password. |
string |
vcenterHostname |
vCenter hostname address |
string |
vcenterIp |
vCenter IP address |
string |
vcenterNetmask |
vCenter Netmask |
string |
vmSize |
vCenter VM size |
string |
4.241. SoftwareComponent
Name | Description | Schema |
---|---|---|
id |
ID of Resource/Software Component |
string |
type |
Type of Resource/Software Component |
string |
4.242. SoftwareInfo
SoftwareSpec contains base os, components, hardware support, addOn metadata to install/update the appropriate Cloud Foundation software components in your management domain or workload domain.
Name | Description | Schema |
---|---|---|
addOn |
Personality addOn |
|
baseImage |
Personality base image |
|
components |
Personality components |
< string, ComponentInfo > map |
hardwareSupport |
Personality hardware support |
4.243. SsoDomainEntity
Represents SSO domain entity
Name | Description | Schema |
---|---|---|
id |
The ID of the SSO domain entity |
string |
name |
The name of the SSO domain entity |
string |
type |
The type of the SSO domain entity |
string |
4.244. StackTraceElement
Name | Description | Schema |
---|---|---|
className |
Example : |
string |
fileName |
Example : |
string |
lineNumber |
Example : |
integer (int32) |
methodName |
Example : |
string |
nativeMethod |
Example : |
boolean |
4.245. Stage
Represents a Stage
Name | Description | Schema |
---|---|---|
completionTimestamp |
Example : Instant |
|
creationTimestamp |
Example : Instant |
|
description |
Stage description |
string |
name |
Stage name |
string |
status |
Stage status |
string |
type |
Stage type |
string |
4.246. Storage
Represents information about storage on a host
Name | Description | Schema |
---|---|---|
disks |
Information about disks |
< Disk > array |
totalCapacityMB |
Total storage capacity in MB |
number (double) |
usedCapacityMB |
Used storage capacity in MB |
number (double) |
4.247. SubTask
Represents a sub-task
Name | Description | Schema |
---|---|---|
completionTimestamp |
Sub-task completion timestamp |
|
creationTimestamp |
Sub-task creation timestamp |
|
description |
Sub-task description |
string |
errors |
List of errors in case of a failure |
< Error > array |
name |
Sub-task name |
string |
resources |
List of resources associated with sub-task |
< Resource > array |
stages |
List of stages of the sub-task |
< Stage > array |
status |
Sub-task status |
string |
type |
Sub-task type |
string |
4.248. Task
Represents a task
Name | Description | Schema |
---|---|---|
completionTimestamp |
Task completion timestamp |
|
creationTimestamp |
Task creation timestamp |
|
errors |
List of errors in case of a failure |
< Error > array |
id |
Task ID |
string |
isCancellable |
Represents task can be cancellable or not. |
boolean |
name |
Task name |
string |
resolutionStatus |
Resolution state |
string |
resources |
List of resources associated with task |
< Resource > array |
status |
Task status |
string |
subTasks |
List of sub-tasks of the task |
< SubTask > array |
type |
Operation that is represented by the Task in machine readable format. The value is controlled by the owners/producers of the Task. The convention is <resource>_<operation> |
string |
4.249. Throwable
Name | Description | Schema |
---|---|---|
localizedMessage |
Example : |
string |
message |
Example : |
string |
stackTrace |
Example : |
< StackTraceElement > array |
suppressed |
Example : |
< Throwable > array |
4.250. TimeZone
Name | Description | Schema |
---|---|---|
displayName |
Example : |
string |
dstsavings |
Example : |
integer (int32) |
id |
Example : |
string |
rawOffset |
Example : |
integer (int32) |
4.251. TokenCreationSpec
This specification contains user details to create authentication token.
Name | Description | Schema |
---|---|---|
apiKey |
API Key |
string |
password |
User Password |
string |
username |
Username |
string |
4.252. TokenPair
This contains the access token and the refresh token for the user API access.
Name | Description | Schema |
---|---|---|
accessToken |
Bearer token that can be used to make public API calls |
string |
refreshToken |
Refresh token that can be used to request new access token |
4.253. URL
Name | Description | Schema |
---|---|---|
authority |
Example : |
string |
content |
Example : |
object |
defaultPort |
Example : |
integer (int32) |
file |
Example : |
string |
host |
Example : |
string |
path |
Example : |
string |
port |
Example : |
integer (int32) |
protocol |
Example : |
string |
query |
Example : |
string |
ref |
Example : |
string |
userInfo |
Example : |
string |
4.254. UnmanagedResourceCredential
Represents credentials of am unmanaged resource (i.e a resource that is not managed by VCF)
Name | Description | Schema |
---|---|---|
credentialType |
Credential type |
string |
password |
Password |
string |
username |
Username |
string |
4.255. Upgradable
Upgradable represents the upgrade capability of resources. It contains the bundle(using what), resource(on which) and its associated resources/software components that can be upgraded.
Name | Description | Schema |
---|---|---|
bundleId |
Bundle ID |
string |
bundleType |
Bundle Type |
string |
resource |
Resource which is upgradable |
|
softwareComponents |
Software Components which are Upgradable |
< SoftwareComponent > array |
status |
Upgradable Status |
string |
4.256. UpgradablesClusterResource
Upgradables clusters details with hardware support managers
Name | Description | Schema |
---|---|---|
availableHardwareSupportManagers |
Available Hardware Support Managers for Firmware upgrade |
< HardwareSupportPackages > array |
configuredHardwareSupportManagers |
Configured Hardware Support Managers for Firmware upgrade |
< HardwareSupportPackage > array |
primaryCluster |
Flag for primary cluster |
boolean |
resourceId |
Resource Id |
string |
resourceType |
Resource Type |
string |
softwareInfo |
Software Spec contains base image, addOn, and components details |
|
vlcmEnabled |
Flag to determine if vLCM enabled on the cluster |
boolean |
4.257. Upgrade
Upgrade object which contain details regarding the upgrade
Name | Description | Schema |
---|---|---|
bundleId |
Bundle ID for Upgrade |
string |
id |
ID for Upgrade |
string |
parallelUpgrade |
Boolean to represent components will be upgraded in parallel on not |
boolean |
resourceType |
Resource Type for Upgrade |
string |
resourceUpgradeSpecs |
Resource Upgrade Specifications |
< ResourceUpgradeSpec > array |
status |
Overall upgrade status |
string |
taskId |
Task ID associated with upgrade |
string |
4.258. UpgradeSpec
Upgrade Specification
Name | Description | Schema |
---|---|---|
bundleId |
Bundle ID for Upgrade |
string |
nsxtUpgradeUserInputSpecs |
Resource Upgrade Specifications for NSXT upgrade |
< NsxtUpgradeUserInputSpec > array |
parallelUpgrade |
Boolean to represent components will be upgraded in parallel on not |
boolean |
resourceType |
Resource Type for Upgrade |
string |
resourceUpgradeSpecs |
Resource Upgrade Specifications |
< ResourceUpgradeSpec > array |
4.259. User
Represents user and its attributes
Name | Description | Schema |
---|---|---|
apiKey |
The API key of the user |
string |
creationTimestamp |
The timestamp at which the user was created |
string |
domain |
The domain of the user |
string |
id |
The ID of the user |
string |
name |
The name of the user |
string |
role |
The role of the user |
|
type |
The type of the user |
string |
4.260. VSANNetworkSpec
Contains the vSAN Network details
Name | Description | Schema |
---|---|---|
vsanCidr |
vSAN subnet cidr of the ESXi host |
string |
vsanGatewayIP |
vSAN Gateway IP of the ESXi host |
string |
4.261. Validation
Represents a validation with a list of one or more validation checks that are performed as part of the validation
Name | Description | Schema |
---|---|---|
description |
Description of the validation |
string |
executionStatus |
Execution status of the validation |
string |
id |
ID of the validation |
string |
resultStatus |
Result status of the validation after it has completed its execution |
string |
validationChecks |
List of one or more validation checks that are performed as part of the validation |
< ValidationCheck > array |
4.262. ValidationCheck
Represents a validation check
Name | Description | Schema |
---|---|---|
description |
Description of the validation check |
string |
errorResponse |
Error response associated with the validation check |
|
nestedValidationChecks |
List of one or more validation checks that are performed as part of the validation |
< ValidationCheck > array |
resultStatus |
Result status of the validation check after it has completed its execution |
string |
severity |
Severity of the validation check |
string |
4.263. Vcenter
vCenter representation
Name | Description | Schema |
---|---|---|
domain |
Information about the domain this vCenter is part of |
|
fqdn |
FQDN of the vCenter |
string |
id |
ID of the vCenter |
string |
ipAddress |
IP address of the vCenter |
string |
4.264. VcenterReference
Represents a vCenter reference
Name | Description | Schema |
---|---|---|
fqdn |
FQDN of the vCenter |
string |
id |
ID of the vCenter |
string |
4.265. VcenterSpec
This specification contains the installation and configuration of vCenter in a workload domain
Name | Description | Schema |
---|---|---|
datacenterName |
vCenter datacenter name |
string |
licenseKey |
vCenter license key |
string |
name |
Name of the vCenter virtual machine |
string |
networkDetailsSpec |
Network spec details of the vCenter virtual machine |
|
rootPassword |
vCenter root shell password |
string |
4.266. VcfService
VCF service representation
Name | Description | Schema |
---|---|---|
id |
ID of the service |
string |
name |
Name of the service |
string |
version |
Version of the service |
string |
4.267. VdsSpec
This specification contains vSphere distributed switch configurations
Name | Description | Schema |
---|---|---|
isUsedByNsxt |
Boolean to identify if the vSphere distributed switch is used by NSX-T |
boolean |
name |
vSphere Distributed Switch name |
string |
niocBandwidthAllocationSpecs |
List of Network I/O Control Bandwidth Allocations for System Traffic |
< NiocBandwidthAllocationSpec > array |
portGroupSpecs |
List of portgroups to be associated with the vSphere Distributed Switch |
< PortgroupSpec > array |
4.268. VersionAliasesForBundleComponentType
Version Alias representation
Name | Description | Schema |
---|---|---|
bundleComponentType |
Bundle Component Type |
string |
versionAliases |
Version Aliases |
< BaseAlias > array |
4.269. VersionAliasesForBundleComponentTypeSpec
Version Alias update Specification. This specification gets used in the Version Alias Update API.
Name | Description | Schema |
---|---|---|
forceUpdate |
Flag for force update version alias configuration. |
boolean |
versionAliasesForBundleComponentTypes |
List of version aliases for bundle component types. |
< VersionAliasesForBundleComponentType > array |
4.270. VmNic
This specification contains vmnic configurations for vSphere host
Name | Description | Schema |
---|---|---|
id |
VmNic ID of vSphere host to be associated with VDS, once added to cluster |
string |
moveToNvds |
This flag determines if the vmnic must be on N-VDS |
boolean |
vdsName |
VDS name to associate with vSphere host |
string |
4.271. VmfsDatastoreSpec
Cluster storage configuration for VMFS
Name | Description | Schema |
---|---|---|
fcSpec |
Cluster storage configuration for VMFS on FC |
< FcSpec > array |
4.272. VrealizeNetworkSpec
This specification contains input parameters for a vRealize network.
Name | Description | Schema |
---|---|---|
gateway |
The gateway address for a vRealize network |
string |
subnetMask |
The subnet mask for a vRealize network |
string |
vlanId |
The VLAN ID for a vRealize network |
string |
4.273. Vrslcm
This specification contains information related to the existing vRealize Suite Lifecycle Manager instance deployment
Name | Description | Schema |
---|---|---|
fqdn |
Fully Qualified Domain Name |
string |
id |
The ID of the vRealize Suite Lifecycle Manager instance |
string |
ipAddress |
IP Address of vRealize Suite Lifecycle Manager appliance |
string |
status |
The state of the current product instance |
string |
version |
Version of the product that is currently running on the environment |
string |
4.274. VrslcmDeploymentSpec
Spec contains parameters for creating a new vRealize Suite Lifecycle Manager instance
Name | Description | Schema |
---|---|---|
apiPassword |
The password for an admin API/UI user of vRealize Suite Lifecycle Manager |
string |
fqdn |
Fully Qualified Domain Name |
string |
networkSpec |
Deprecated: Specification for the vRealize Network that will be used for the deployment. |
|
sshPassword |
The password for a root user of vRealize Suite Lifecycle Manager appliance |
string |
4.275. VsanDatastoreSpec
This specification contains cluster storage configuration for vSAN
Name | Description | Schema |
---|---|---|
datastoreName |
Datastore name used for cluster creation |
string |
dedupAndCompressionEnabled |
Enable vSAN deduplication and compression |
boolean |
failuresToTolerate |
Number of vSphere host failures to tolerate in the vSAN cluster |
integer (int32) |
licenseKey |
License key for the vSAN data store to be applied in vCenter |
string |
4.276. VsanSpec
Spec contains parameters of Virtual SAN
Name | Description | Schema |
---|---|---|
datastoreName |
Datastore Name |
string |
hclFile |
HCL File |
string |
licenseFile |
License File |
string |
vsanDedup |
VSAN feature Deduplication and Compression flag, one flag for both features |
boolean |
vsanName |
Virtual SAN config name |
string |
4.277. VxManagerSpec
Spec contains parameters for VxManager
Name | Description | Schema |
---|---|---|
defaultAdminUserCredentials |
Default admin credentials VxManager |
|
defaultRootUserCredentials |
Default root credentials VxManager |
|
vxManagerHostName |
VxManager host name |
string |
4.278. VxRailDetails
Contains the VxRail Manager details
Name | Description | Schema |
---|---|---|
adminCredentials |
VxRail Manager admin credentials |
|
rootCredentials |
VxRail Manager root credentials |
4.279. VxRailSpec
Spec contains parameters for VxRail
Name | Description | Schema |
---|---|---|
vxRailObjectNames |
Map of VxRail object types and names |
< string, string > map |
4.280. WitnessSpec
Spec contains the Witness host parameters that are part of each stretched cluster
Name | Description | Schema |
---|---|---|
fqdn |
Management ip of the witness host |
string |
vsanCidr |
vSAN subnet cidr of the witness host |
string |
vsanIp |
vSAN IP of the witness host |
string |
4.281. ZookeeperServerInfo
Name | Description | Schema |
---|---|---|
clientPort |
Example : |
integer (int32) |
electionPort |
Example : |
integer (int32) |
fqdn |
Example : |
string |
hostAddress |
Example : |
string |
peerPort |
Example : |
integer (int32) |
securePort |
Example : |
integer (int32) |
zkId |
Example : |
integer (int32) |
zkRole |
Example : |
string |
4.282. ZookeeperServerInfoList
Name | Description | Schema |
---|---|---|
zookeeperServersInfo |
Example : |
< ZookeeperServerInfo > array |