VMware Cloud Foundation Installer API Reference Guide Operations Index

VMware Cloud Foundation Installer API Reference Guide Operations Index

All available VMware Cloud Foundation Installer API Reference Guide Operations

Bundles
GET
Get Bundles

Get all Bundles. Returns uploaded bundles and bundles available via depot access.

POST
Upload Bundle Deprecated

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
Get Bundle

Get a Bundle

DELETE
Delete Bundle

Delete a Bundle by bundle ID.

PATCH
Start Bundle Download By 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
Get Bundle Download Status

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
Get Bundles For Skip Upgrade

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.

Ceip
GET
Get Ceip Status

Get CEIP status and instance id

PATCH
Set Ceip Status

Opt-in or Opt-out of CEIP

Depot Settings
GET
Get Depot Settings

Get the depot configuration. In a fresh setup, this would be empty.

PUT
Update Depot Settings

Update depot settings. Depot settings can be updated with VMware Depot account

DELETE
Delete Depot Settings

Delete the depot configuration if it is present within VCF.

GET
Get Depot Sync Info

Get the depot sync information.

PATCH
Sync Depot Metadata

Sync depot metadata such as bundle manifest, pvc.

Flexible Product Patches
GET
Get Release Components By Sku

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

GET
Get Custom Patches

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.

GET
Get Custom Patches By Sku

Filter applicable patches (current/target VCF/VVF releases) per product type

Proxy Configuration
GET
Get Proxy Configuration

Get the current Proxy configuration

PATCH
Update Proxy Configuration

Update Proxy configuration

Releases
GET
Get Releases

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.

GET
Get System 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.

GET
Get Future Releases

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.

System
GET
Get System Configuration

Retrieve the system configuration.

PATCH
Update System Configuration

Updates paramters of the system configuration.

GET
Get System Vcf Management Components

Get the details of VCF Management Components containing each component's FQDN, deployment type, and deployment status

GET
Get Appliance Info

Get appliance information such as the version and the appliance's role.

Tasks
GET
Get Task

Get a Task by ID, if it exists

DELETE
Cancel Task

Cancel a Task by ID, if it exists

PATCH
Retry Task

Retry a failed Task by ID, if it exists

GET
Get Tasks

Get the tasks

Tokens
POST
Create Token

Creates access token and refresh token for user access

PATCH
Refresh Access Token

Refresh the access token associated with the given refresh token

DELETE
Invalidate Refresh Token

Invalidate the provided refresh token

Trusted Certificates
GET
Get Trusted Certificates

Retrieve all trusted certificates from the appliance.

POST
Add Trusted Certificate

Add a trusted certificate to the appliance's trust store.

DELETE
Delete Trusted Certificate

Delete a trusted certificate from the appliance's trust store.

Vcf Installer
GET
Get Sddc Tasks

Retrieve all VCF (or VVF) installation tasks

POST
Deploy Sddc

Start the workflow to install VCF (or VVF) based on the given SDDC specification.

POST
Discover Vcf Ops

Discover VCF Operations instance and its adjacent topology such as its cluster nodes, management node, vCenters, etc.

POST
Discover Vcenter

Discover vCenter instance and its adjacent topology such as NSX instances associated with it.

GET
Get Sddc Spec Validations

Retrieve a list of VCF (or VVF) installation validations

POST
Validate Sddc Spec

VCF Installer specification incorporates all the client inputs regarding VCF (or VVF) components constituting the installation.

POST
Get Network Config Profiles

Get network profiles compatible with the storage type and hosts subject to installation.

POST
Get Installer Type

Get the VCF Installer mode that specifies whether the VCF Installer appliance is collocated with the VCF (or VVF) installation or is located externally.

GET
Get Sddc Task By ID

Retrieve a VCF (or VVF) installation task by its ID

PATCH
Retry Sddc

Retry a failed VCF (or VVF) installation.

GET
Get Sddc Spec By ID

Retrieve a VCF (or VVF) input specification for an already started installation by its task ID

GET
Get Sddc Spec Validation

Retrieve the results of VCF (or VVF) installation validation by its ID

GET
Get Latest Sddc Spec Validation

Retrieve the results of latest VCF (or VVF) installation validation

GET
Get Latest Sddc Task

Retrieve latest VCF (or VVF) installation task

Vcf Services
GET
Get Vcf Services

Retrieve a list of SDDC Manager services

GET
Get Vcf Service

Retrieve an SDDC Manager service by its ID