Target Upgrade Version APIs

Target Upgrade Version APIs

APIs for managing domains target upgrade versions

The domain target upgrade version is the version to which we want to upgrade a domain from its current version. By choosing a target version, that has passed all validations successfully, it is saved on a per domain basis. Domain upgrades are driven by the already selected target version, so the upgrade can not start without selected target upgrade version. Without selected target upgrade version for a domain the system will not return any upgradables for that given domain. After all upgradables for a domain are successfully installed domain upgrade is completed and the domain target upgrade version is achieved. In order to start new domain upgrade new domain target upgrade version must be selected. Possible future versions for a domain can be fetched via API and are returned according to the current domain version along with their applicability.
Table of Contents

1. Fetch domains target upgrade version

Fetch domains target upgrade version API returns paged information about all domains in the system. For domains with no target version set response will return response where targetVersion will be empty string.

1.1. Steps to fetch domains target upgrade version.

  • Invoke the GET /v1/releases/domains API. This API returns information about all domains in the system.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/releases/domains' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/releases/domains HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 213

{
  "elements" : [ {
    "domainId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
    "targetVersion" : "4.1.0.0"
  }, {
    "domainId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
    "targetVersion" : "4.1.0.0"
  } ]
}

2. Fetch specific domain target version

Returns information about target upgrade version for a specific domain API. If domain has no target version set response will return response where targetVersion will be empty string.

2.1. Prerequisites

The following data is required:

  • Domain ID.

2.2. Steps

  • Invoke the GET /v1/releases/domains/{domainId} API API. This API returns information about target upgrade version for a specific domain.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/releases/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/releases/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488 HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 88

{
  "domainId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
  "targetVersion" : "4.1.0.0"
}

3. Set/Update domain target upgrade version

This API API is used to set or update domain target upgrade version. If the given domain does not have a previously stored target upgrade version, invoking the API will save the target version. If the domain already has a stored target upgrade version, invoking the API will update the version.

3.1. Prerequisites

The following data is required:

  • Domain ID.

  • Target upgrade version.

3.2. Steps

  • Invoke the save/update API API for specific domain.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/releases/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "targetVersion" : "4.3.0.0"
}'

HTTP Request

PATCH /v1/releases/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 33
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "targetVersion" : "4.3.0.0"
}

HTTP Response

HTTP/1.1 200 OK

4. Fetch possible domain target versions for a domain

This API API returns all known to the system future target versions for a specific domain. If some of them are not allowed to upgrade (e.g. stepping stone) includes localized message why.

4.1. Prerequisites

The following data is required:

  • Domain ID.

4.2. Steps

  • Invoke the GET /v1/releases/domains/{domainId}/future-releases API API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/releases/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488/future-releases' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/releases/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488/future-releases HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3224

{
  "elements" : [ {
    "applicabilityStatus" : "APPLICABLE",
    "product" : "vcf",
    "version" : "3.5.0",
    "description" : "VMware Cloud Foundation 3.5.0 Release",
    "releaseDate" : "2018-12-13T08:00:00.000Z",
    "bom" : [ {
      "name" : "DOMAIN_MANAGER",
      "version" : "3.5.0",
      "publicName" : "SDDC Manager"
    }, {
      "name" : "VCENTER",
      "version" : "6.7.0-10244745",
      "publicName" : "vCenter Server Appliance"
    }, {
      "name" : "HOST",
      "version" : "6.7.0-10764712",
      "publicName" : "VMware ESXi"
    }, {
      "name" : "NSX_MANAGER",
      "version" : "6.4.4-11197766",
      "publicName" : "NSX-V Data Center"
    }, {
      "name" : "VROPS",
      "version" : "7.0.0-10098133",
      "publicName" : "VMware vRealize Operations Manager"
    } ],
    "isApplicable" : true,
    "sku" : [ ],
    "updates" : [ ],
    "patchBundles" : [ ]
  }, {
    "reasonNotApplicable" : {
      "component" : "VCF",
      "messageKey" : "LCM_TARGET_VERSION_IS_STEPPING_STONE",
      "arguments" : [ "3.5.0" ],
      "message" : "VMware Cloud Foundation 3.5.0 is a stepping stone release that workload domains must upgrade to prior to upgrading to later releases."
    },
    "applicabilityStatus" : "NOT_APPLICABLE",
    "product" : "vcf",
    "version" : "3.0.0",
    "description" : "VMware Cloud Foundation 3.0.0 Release",
    "releaseDate" : "2018-09-20T07:00:00.000Z",
    "bom" : [ {
      "name" : "DOMAIN_MANAGER",
      "version" : "3.0.0",
      "publicName" : "SDDC Manager"
    }, {
      "name" : "VCENTER",
      "version" : "6.5.0-9451637",
      "publicName" : "vCenter Server Appliance"
    }, {
      "name" : "HOST",
      "version" : "6.5.0-9298722",
      "publicName" : "VMware ESXi"
    }, {
      "name" : "NSX_MANAGER",
      "version" : "6.4.1-8599035",
      "publicName" : "NSX-V Data Center"
    }, {
      "name" : "VROPS",
      "version" : "6.7.0-8183617",
      "publicName" : "VMware vRealize Operations Manager"
    } ],
    "isApplicable" : false,
    "notApplicableReason" : "VMware Cloud Foundation 3.5.0 is a stepping stone release that workload domains must upgrade to prior to upgrading to later releases.",
    "sku" : [ ],
    "updates" : [ ],
    "patchBundles" : [ {
      "bundleId" : "c6a58015-80a7-4f09-8974-c632001905e1",
      "bundleType" : "EVORACK",
      "bundleElements" : [ "SDDC_MANAGER_VCF" ],
      "cumulativeFromVcfVersion" : "2.3.0"
    }, {
      "bundleId" : "8de83af6-2b9b-4ae5-aa42-7279f8dd667c",
      "bundleType" : "EVORACK",
      "bundleElements" : [ "SDDC_MANAGER_VCF" ],
      "cumulativeFromVcfVersion" : "2.3.0"
    }, {
      "bundleId" : "ebb83b4c-d53e-475e-8946-13c9beb4fef8",
      "bundleType" : "VMWARE_SOFTWARE",
      "bundleElements" : [ "VCENTER" ],
      "cumulativeFromVcfVersion" : "2.3.0"
    }, {
      "bundleId" : "e7d5d5ae-094e-4388-9d71-af3107ec421b",
      "bundleType" : "VMWARE_SOFTWARE",
      "bundleElements" : [ "ESX_HOST" ],
      "cumulativeFromVcfVersion" : "2.3.0"
    }, {
      "bundleId" : "7da06d07-5dfd-4e17-955c-52e81e9744a0",
      "bundleType" : "VMWARE_SOFTWARE",
      "bundleElements" : [ "NSX_MANAGER" ],
      "cumulativeFromVcfVersion" : "2.3.0"
    } ]
  } ]
}

5. Fetch all bundles required for skip upgrade to target version for a domain

This API API returns all bundles needed to upgrade a domain from current version to target version. Also includes bundle order field and bundle applicability status. If target release is not set returns empty response. Each bundle have an applicability status for the particular domain - PENDING, AVAILABLE, IN PROGRESS, SUCCESS or FAILED.

5.1. Prerequisites

The following data is required:

  • Domain ID.

5.2. Steps

  • Invoke the GET /v1/bundles/domains/{domainId} API API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/bundles/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488 HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 22

{
  "elements" : [ ]
}

6. Fetch all bundles required for skip upgrade to target version for a domain for vxRail case

This API API returns all bundles needed to upgrade a domain from current version to target version including vxRail. Also includes bundle order field and bundle applicability status. If target release is not set returns empty response. Each bundle have an applicability status for the particular domain - PENDING, AVAILABLE, IN PROGRESS, SUCCESS or FAILED.

6.1. Prerequisites

The following data is required:

  • Domain ID.

6.2. Steps

  • Invoke the GET /v1/bundles/domains/{domainId} API API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/bundles/domains/ef16054d-1981-4d82-bb42-35f1b3f1a488 HTTP/1.1
Content-Type: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 22

{
  "elements" : [ ]
}

Last updated 2023-05-21 23:30:49 PDT

Operations
GET
Get Domain Release View
Get release view for domain.
GET
Get Domain Release View 1
Get release view for all WLDs.
PATCH
Save Domain Release View
Save/update target upgrade version for domain.