SDDC Manager API Reference Guide Operations Index
All available SDDC Manager API Reference Guide Operations
Retrieve a list of NSX ALB Clusters
Create NSX ALB cluster
Perform validiation of the NsxAlbControllerClusterSpec specification
Validate NSX ALB compatibility version
Retrieve a list of ALB Clusters
Deploy an ALB cluster
Perform validiation of the AlbControllerClusterSpec specification
Validate ALB compatibility version
Retrieve an NSX ALB Cluster by its ID
Deletes an NSX ALB Cluster by its ID
Retrieve a list of NSX ALB Clusters Form Factors
Retrieve an ALB Cluster by its ID
Deletes an ALB Cluster by its ID
Retrieve a list of ALB Clusters Form Factors
Get cluster capacity of domain for ALB deployment
Retrieve the backup configuration for SDDC Manager and NSX Manager
Configure the backup configuration for SDDC Manager and NSX Manager
Update the backup configuration for SDDC Manager and NSX Manager
Validation API for backup configuration for SDDC Manager and NSX Manager
Start a restore operation
Start a backup operation
Retrieve the backup location details
Retrieve the restore task
Import a vCenter as a VI domain
Perform checks against a vCenter before importing it as a domain in SDDC Manager
Perform synchronization of SDDC Manager state with any changes performed out-of-band in the vSphere environment
Get a Brownfield task of import operation by its ID
Get a Brownfield task of check operation by its ID
Get a Brownfield task of synchronization operation by its ID
Get all Bundles. Returns uploaded bundles and bundles available via depot access.
Upload Bundle to SDDC Manager or VCF Installer. This is useful when you do not have internet connectivity for downloading bundles from the online depot to SDDC Manager or VCF Installer. The Bundles are manually downloaded from Depot using Bundle Transfer utility. This API is no longer supported from VCF 9.0. Please refer to POST v1/product-binaries instead.
Get a Bundle
Delete a Bundle by bundle ID.
Update a Bundle for scheduling/triggering download. If download is started, this can be used to cancel a download. Only one download can triggered for a Bundle.
Get all download status for all bundles matching the criteria. Returns the download information (status, error, taskId) for all bundles matching the criteria (release version, bundle Id, image type).
Get bundles for skip upgrade a domain from current version to target version (for SDDC Manager only). NOTE: This operation is not applicable if appliance is in VCF Installer mode.
Get CEIP status and instance id
Opt-in or Opt-out of CEIP
View detailed metadata about the certificate(s) of all the resources in a domain
Replace resource certificates
Set certificate auto-renewal configuration for a domain
Validate resource certificates
Get available CSR(s) in json format
Generate CSR(s) for the selected resource(s) in the domain.
Warning: Avoid using wildcard certificates. Instead, use subdomain-specific certificates that are rotated often. A compromised wildcard certificate can lead to security repercussions
Get latest generated certificate(s) in a domain.
Generate certificate(s) for the selected resource(s) in a domain. CA must be configured and CSR must be generated beforehand.
Replace certificate(s) for the selected resource(s) in a domain
Get certificate authorities information
Creates a certificate authority. This is required to generate signed certificates by supporting CAs.
Update the configuration of a Certificate Authority
Set certificate auto-renewal configuration for all domains at once
Get the resource certificate validation result
Download available CSR(s) in tar.gz format
Get certificate authority information
Deletes CA configuration file
Get information about the last assessment run
Trigger a run of the selected checks. Use returned run ID to check the status.
Query for check-sets for the given resources
Get the result for a given check run
Trigger partial retry of a completed check run
Get tags assigned to a cluster by its ID
Assign Tags to Cluster
Remove tags from a cluster
Retrieve a list of clusters
Create a cluster and add to an existing domain
Perform validation of the ClusterUpdateSpec specification
Get cluster network configuration
This is deprecated due to performance reasons. Use /v1/hosts directly for all use cases.
Get the list of all datastores associated with the cluster.
Mount a datastore to a cluster
Post a datastore query
Get the list of VDSes of a cluster.
Import Vds to inventory for the given cluster
Perform validation of the DatastoreMountSpec specification
Perform validation of the DatastoreMountSpec specification
Perform validation of the ClusterCreationSpec specification
Get a cluster by its ID
Delete a cluster from a domain if it has been previously initialized for deletion
Update a Cluster by adding or removing Hosts, Stretching a standard vSAN cluster, Unstretching a stretched cluster or by marking for deletion
Gets the status of given cluster updates validation workflow by given validation id
Get Cluster Tag Manager Url
Get tags assignable to a cluster
The response retrieved is only applicable for pure L2 domain clusters
Get cluster network configuration criteria
Get image compliance for a Cluster
Deprecating this inline with /v1/clusters/{id}/hosts/queries
Deprecating this inline with /v1/clusters/{id}/hosts/queries
Get all datastore criteria
Get a criterion to query for datastore
Deprecating this inline with /v1/clusters/{id}/hosts/queries
Get Datastore query response
Gets the status of given cluster create validation workflow by given validation id
Get tags assigned to clusters
Unmount a datastore from a cluster
Get Compatibility Matrices
Update compatibility matrix content for a source using a JSON file
Get Compatibility Matrix
Get Compatibility Matrix Metadata
Get Compatibility Matrix content
Get compliance audit history for a domain
Compliance audit of resource
Get compliance audit task
Retry compliance audit task
Get compliance audit for a domain
Get compliance audit items for a domain
Get a list of all compliance standards
Get a list of all compliance configurations
Get compliance audit history
Get compliance audit
Get compliance audit items
For selective reconciliation, provide a config spec.
Get configs associated with the given criteria, all if no criteria is provided
Get config reconciliation task associated with the given task Id
Fetch expiration details of passwords for a list of credentials
Retrieve a list of credentials
Update passwords for given list of resources by supplying new passwords or rotate the passwords using system generated passwords
Retrieve a credential task by ID
Cancel a failed credential task by its ID
Retry a failed credentials task for a given ID
Retrieve a credential by its ID
Retrieve a list of credential tasks
Retrieve a credential sub task by its ID
Retriece a credential taks by resource ID
Retrive a password expiration task by ID
Get the depot configuration. In a fresh setup, this would be empty.
Update depot settings. Depot settings can be updated with VMware Depot account
Delete the depot configuration if it is present within VCF.
Get the depot sync information.
Sync depot metadata such as bundle manifest, pvc.
Get tags assigned to a domain
Assign tags to a domain
remove Tags From Domain
Retrieve a list of domains
Create a domain
Perform validation of the DomainUpdateSpec specification
Perform Domain Isolation Prechecks
Post a datastore query
Post a cluster query
Post clusters query
Perform validation of the DomainCreationSpec specification
Get a domain by its ID
Remove a domain if it has been previously initialized for deletion
Update a Domain
Enable Overlay over Management Network for NSX VLAN Backed Domain
Gets the status of given domain update validation workflow by given validation id
Get Domain Tag Manager Url
Get tags assignable to a domain
Retrieve a list of endpoints or URLs for a domain by its ID
Get Datacenters in domain by its ID
Get the capabilities of a domain
Get the status of the Domain Isolation Precheck
Get Datastore query response
Get all datastore criteria
Get a criterion to query for datastore
Get cluster query response
Get clusters query response
Get all cluster criteria
Get a criterion to query for cluster
Gets the status of given domain create validation workflow by given validation id
Get tags assigned to all domains
Get the capabilities of all domains
Retrieve VCF security FIPS mode.
Gets a list of components, the SKU they are part of and the available patch versions,per release version. By default it provide release components of all the release equal and above 5.x
Filter applicable patches (current/target VCF releases) per product type per domain. NOTE: This operation is not applicable if appliance is in VCF Installer mode.
Filter applicable patches (current/target VCF/VVF releases) per product type
Get Tags assigned to Host
Assign tags to a host
Remove Tags From Host
Get all hosts
Commission the Hosts
Decommission the Hosts
Perform validation of the HostCommissionSpec specification
Validate the input specification to commission the Hosts
Post a query
Post host(s) prechecks
Get a host by its ID
Get Host Tag Manager Url
Get tags assignable to a host
Retrieve the results of a host commission validation by its ID
Get Tags assigned to Hosts
Get query response
Get host(s) prechecks response
Get all criteria
Get a criterion
Get a list precheck result with warnings/errors
Get a list of all identity providers
Add a new external identity provider
Generates a new sync client token
Add an identity source to an embedded IDP by id, if it exists
Get a specific identity provider using its id
Delete an Identity Provider by its identifier, if it exists
Update the identity provider by its identifier, if it exists
Delete an Identity Source by domain name, if it exists
Update the identity source associated with the embedded IDP by name, if it exists
Get the SDDC Manager WS1B OIDC Information
Update a license key for a resource
Start a license check for a resource
Retrieve a list of license keys
Add a a new license key
Update the license key
Retrieve the results of a license check by its ID
Retrieve licensing information
Get the Licensing information of system
Get the Licensing information of a domain
Retrieve a license key
Remove a license key
Get product types
Get manifest. There should be only one valid manifest in the System.
Save/Load manifest. Make sure manifest is a valid one. If manifest already exists, it gets overridden.
Get the Network Pools
Create a Network Pool
Add an IP Pool to a Network of a Network Pool
Delete an IP Pool from a Network of a Network Pool
Get a Network Pool by ID, if it exists
Delete the Network Pool by the ID, if it exists and is unused
Update a Network Pool by ID, if it exists
Get the Networks that are part of a Network Pool
Get a Network that is part of a Network Pool
Get Notifications
Scale out NSX cluster from 1 node to 3 nodes i.e. scale-out
Start a query with NSX Criteria
Retrieve a list of NSX clusters
Retrieve list of all NSX transport zones
Retrive a list of NSX IP Address Pools by the NSX cluster ID
Retrieve an NSX IP Address Pool by its name
Retrieve the details of an NSX cluster by its ID
Get NSX cluster query response
Get all NSX criteria
Get a NSX criterion
Retrieve a list of NSX Edge Clusters
Create an NSX Edge Cluster
Perform validation of the EdgeClusterUpdateSpec specification
Perform validiation of the EdgeClusterCreationSpec specification
Retrieve an NSX Edge Cluster by its ID
Expand or shrink an NSX Edge Cluster
Get the Edge Cluster criterion list for the NSX query
Retrieve the results of a NSX Edge Cluster validation by its ID
Upload personality files to SDDC Manager
Get the Personalities which are available via depot access.
Upload Personality to SDDC Manager.
Delete the personality based on either name or id
Get the Personality for id
Upload the product binaries to SDDC Manager. The API looks up the product binaries in the product version catalog based on provided inputs and updates the LCM database.
Get product version catalog. There should be only one valid product version catalog in the System.
Upload product version catalog. Make sure product version is a valid one. This API is no longer supported from VCF 9.0. Please refer to POST v1/product-version-catalogs instead.
Get product version catalog content. There should be only one valid product version catalog in the System.
Upload product version catalog and corresponding signature file.
Update product version catalog patches with a corresponding signature file.
Monitor the progress of a product version catalog upload operation given it's upload task ID.
Get the current Proxy configuration
Update Proxy configuration
Retrieve a list of Platform Service Controller (PSC)
Retrieve details of a Platform Service Controller (PSC)
Get all Releases, with option to get current release for a domain, get release by version or get future releases for a versionor get all the applicable target release.
Returns release for the lowest deployed VCF version for a domain on the environment. If Management domain is ahead of WLD domain, VCF BOM version for the WLD domain will be returned. NOTE: This operation is not applicable if appliance is in VCF Installer mode.
Returns all known to the system future target versions for a domain. If some of them are not allowed (e.g. stepping stone), then message explains the reason. If the domain does not have a product configured at that point, then that product will not be included in the BOM or patch bundle list in each release. NOTE: This operation is not applicable if appliance is in VCF Installer mode.
Post repository images query
Get repository images query response
Get Resource Functionalities
Update Resources Functionalities
Get Resource Functionalities Allowed Global Configuration
Update Resources Functionalities Is Allowed Global Configuration
Get Resource Warnings
Create a new Resource Warning
Get a Resource Warning by ID
Fetch all SDDC Manager Upgradables
Retrieve a list of SDDC Managers
Retrieve the details of an SDDC Manager by its id
Retrieve the history of SDDC Manager by its id
Returns a list of local OS user accounts from the SDDC Manager appliance
Retrieve a list of Support Bundle tasks
Start a Support Bundle operation using SoS
Retieve a list of Health Check tasks
Start a Health Check operation using SoS
Retrive the status of the Support Bundle operation
Download a Support Bundle tar.gz by ID
Retrieve the status of the Health Check operations
Download a Health Check tar.gz by its ID
Retrieve the system configuration.
Updates paramters of the system configuration.
Get the details of VCF Management Components containing each component's FQDN, deployment type, and deployment status
Get appliance information such as the version and the appliance's role.
Retrieve the NTP configuration
Update the NTP configuration
Retrieve the DNS configuration
Update the DNS configuration
Retrieve a list of NTP configuation validations
Perform validation of the NtpConfiguration specification
Retrieve a list of DNS configuation validations
Perform validation of the DnsConfiguration specification
Retrieve the results of a NTP configuration validation by its ID
Retrieve the results of a DNS configuration validation by its ID
Validate the selected target upgrade release BOM or custom BOM for the specified Domain ID
Get last selected upgrade version for the specified Domain ID.
Delete last selected upgrade version for the specified Domain ID
Update last selected upgrade version for the specified Domain ID
Get last selected upgrade version for all management and workload domains.
Monitor the progress of domain target state validation task by it's Validation ID.
Get a Task by ID, if it exists
Cancel a Task by ID, if it exists
Retry a failed Task by ID, if it exists
Get the tasks
Creates access token and refresh token for user access
Refresh the access token associated with the given refresh token
Invalidate the provided refresh token
Retrieve all trusted certificates from the appliance.
Add a trusted certificate to the appliance's trust store.
Delete a trusted certificate from the appliance's trust store.
Sync UMDS
Fetches the list of Upgradables for a given domain. If a target version is provided, Upgradables that are required for given target version become Available. The Upgradables providesinformation that can be use for Precheck API and also in the actual Upgrade API call.This API is used only for management domain, for all cases please use v1/system/upgradables.
Get the list NSX upgradable reosurce with resource metadata info
Fetches the list of available hardware support managers and configured hardware support managers for the give resource along with the hardware support packages and Software details.
Fetches the list of Upgradables in the System. Only one Upgradable becomes AVAILABLE for Upgrade. The Upgradables provides information that can be use for Precheck API and also in the actual Upgrade API call. Conflict (409) error can return if inventory cache is not seeded.
Retrieve a list of upgrades
Schedule/Trigger Upgrade of a Resource. Ex: Resource can be DOMAIN, CLUSTER etc. Performing upgrades are supported on VMware Cloud Foundation BOM resources and above. Supports scheduling/triggering of only 'parallel' upgrades and only Resource 'cluster' that are managed using both vSphere Lifecycle Manager Baselines and vSphere Lifecycle Manager Images in the same request.
Perform Upgrade Prechecks
Retrieve an upgrade by ID
Commit/Reschedule an existing upgrade. It moves the upgrade from DRAFT state to SCHEDULED state and/or changes the upgrade scheduled date/time.
Gets upgrade precheck details
Get the list of resources for a given domain which the bundle will be applied; Note: Domain ID is ignored for SDDC Manager (EVORACK) bundle type since the bundle is always applied to all the management domains
Get a list of all users
Add list of users
Get information on the local account
Disable local account
Update the password for local account only if the old password is correct, or if user configures the local account for the first time
Retrieve a list of users assigned access via SDDC Manager
Get a list of all SSO domains
Get a list of all entities in the SSO domain
Get a list of all roles
Delete the user by the ID, if it exists
Retrieve a list of vCenter Servers
Retrieve a vCenter Server by its ID
Download vSAN HCL if online connectivity is available. Timestamp of vSAN HCL on SDDC Manager is checked with what is available online before download. vSAN HCL is downloaded only if new data is available.
Get vSAN HCL configuration
Update vSAN HCL configuration
Attributes of vSAN HCL data such as timestamp of last update
Get vSAN health check status for all cluster on the domain
Update vSAN health check status for domain
Get vSAN health check update task status for a given task Id
Get vSAN health check status for a given Query Id
Get the VASA Providers
Add a VASA Provider
Get the users of a VASA Provider
Add the users to a VASA Provider
Get the storage containers of a VASA Provider
Add the storage containers to a VASA Provider
Validate VasaProvider input specification
Get a VASA Provider
Delete a VASA Provider
Update a VASA Provider
Update the user of a VASA Provider
Delete a storage container of a VASA Provider
Update the storage container of a VASA Provider
Get the status of the validation of the VASA Provider
Get the details of VCF Management Components containing each component's FQDN, deployment type, and deployment status
Triggers VCF Management Components deployment workflow from SDDC Manager and returns a URL in the headers to track the operation status
Validates the input spec to VCF Management Components deployment workflow from SDDC Manager and returns a URL in the headers to track the operation status
Retrieve the results of VCF Management Components validation by its ID
Gets all VCF Management Components tasks
Gets VCF Management Components task by its ID
Gets VCF Management Components task spec by its task ID
Gets VCF Management Components latest task
Retrieve a list of SDDC Manager services
Retrieve an SDDC Manager service by its ID
Get the Version Alias Configuration.
Update Version Alias Configurations.
Update Version Alias Configuration.
Delete Version Alias Configuration by bundle component type, version, and aliases.
Removes Version Alias Configuration by component type