Upgradables APIs

Upgradables APIs

APIs for managing Upgradables

Table of Contents

1. Get the Upgradables

Get the Upgradables API provides the list of upgradables in the system. If target version API for some domain is not selected upgradables for that domain will not be returned. Each upgradable provides information about the bundle, resource and its associated software components that can be prechecked and upgraded. The upgradables can be of different types ex: AVAILABLE, PENDING, SCHEDULED etc.

1.1. Prerequisites

None

1.2. Steps

  • Invoke the API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/system/upgradables' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/system/upgradables HTTP/1.1
Accept: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

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

{
  "elements" : [ {
    "bundleId" : "ff6d66dd-6bf4-4878-bf60-66749ca33092",
    "bundleType" : "SDDC_MANAGER",
    "resource" : {
      "resourceId" : "cc79fb4f-8426-4ceb-9f9f-014853cd1308",
      "type" : "DOMAIN"
    },
    "softwareComponents" : [ {
      "id" : "c69968b8-5b4b-471b-856e-a58c86aa3d4c",
      "type" : "SDDC_MANAGER",
      "isUserInputRequired" : false
    } ],
    "status" : "AVAILABLE"
  } ]
}

2. Get the Upgradables for a Domain

(Deprecated)

This API provides the list of upgradables up to the target version for a given domain. If target version API for some domain is not selected upgradables for that domain will not be returned. Each upgradable provides information about the bundle, resource and its associated software components that can be prechecked and upgraded. The upgradables can be of different types ex: AVAILABLE, PENDING, SCHEDULED etc. This API is used only for management domain, for all cases please use [_getupgradables] API.

2.1. Prerequisites

  • ID of a domain

2.2. Steps

  • Invoke the API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/upgradables/domains/cc79fb4f-8426-4ceb-9f9f-014853cd1308' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/upgradables/domains/cc79fb4f-8426-4ceb-9f9f-014853cd1308 HTTP/1.1
Accept: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

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

{
  "elements" : [ {
    "bundleId" : "ff6d66dd-6bf4-4878-bf60-66749ca33092",
    "bundleType" : "SDDC_MANAGER",
    "resource" : {
      "resourceId" : "cc79fb4f-8426-4ceb-9f9f-014853cd1308",
      "type" : "DOMAIN"
    },
    "softwareComponents" : [ ],
    "status" : "AVAILABLE"
  } ]
}

3. Get the Target VCF Release Upgradables for a Domain

This API provides the list of upgradables for a given domain and target VCF release. Each upgradable provides information about the bundle, resource and its associated software components that can be prechecked and upgraded. The upgradables can be of different types ex: AVAILABLE, PENDING, SCHEDULED etc.

3.1. Prerequisites

  • ID of a domain

  • Version of a Target Release

3.2. Steps

  • Invoke the API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/upgradables/domains/cc79fb4f-8426-4ceb-9f9f-014853cd1308?targetVersion=4.1.0.0' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/upgradables/domains/cc79fb4f-8426-4ceb-9f9f-014853cd1308?targetVersion=4.1.0.0 HTTP/1.1
Accept: application/json
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

HTTP Response

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

{
  "elements" : [ {
    "bundleId" : "ff6d66dd-6bf4-4878-bf60-66749ca33092",
    "bundleType" : "SDDC_MANAGER",
    "resource" : {
      "resourceId" : "cc79fb4f-8426-4ceb-9f9f-014853cd1308",
      "type" : "DOMAIN"
    },
    "softwareComponents" : [ ],
    "status" : "AVAILABLE"
  } ]
}

Last updated 2023-09-23 19:05:04 -0700

Operations
GET
Get Nsx Upgrade Resources
Retrieve a list of all upgradable NSX resources for a domain by its ID
GET
Get Upgradables
Retrieve a list of all upgradable resources
GET
Get Upgradables And Resource Errors
Get the Upgradables and Resource Errors
GET
Get Upgradables By Domain
Retrieve a list of all upgradable resources for a domain by its ID
GET
Get Upgradables Clusters
Retrieve a list of upgradable packages details from HSM for a domain by its ID