Bundles APIs

Bundles APIs

APIs for managing Bundles

Table of Contents

1. Upload a Bundle

Offline:

  • Upload a Bundle API is used to upload Bundles which are downloaded using Bundle Transfer Utility tool.

Tip : Please refer to the VMware Cloud Foundation documentation for more information on the Bundle Transfer Utility tool.

1.1. Prerequisites API

The following data is required:

  • Bundle file path.

  • Bundle manifest file path.

  • Bundle manifest signature file path.

Tip : Refer to: BundleUploadSpec.

1.2. Steps API

  • Invoke the API. This API returns a task which can be polled and monitored.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "bundleFilePath" : "/home/vcf/bundles/bundle-11237.tar",
  "manifestFilePath" : "/home/vcf/bundles/bundle-11237.manifest",
  "signatureFilePath" : "/home/vcf/bundles/bundle-11237.manifest.sig"
}'

HTTP Request

POST /v1/bundles HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 198
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "bundleFilePath" : "/home/vcf/bundles/bundle-11237.tar",
  "manifestFilePath" : "/home/vcf/bundles/bundle-11237.manifest",
  "signatureFilePath" : "/home/vcf/bundles/bundle-11237.manifest.sig"
}

HTTP Response

HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /v1/tasks/2745cd32-4cd1-45bf-a206-846f96cb485d
Content-Length: 391

{
  "id" : "2745cd32-4cd1-45bf-a206-846f96cb485d",
  "name" : "Upload BUNDLE - PSC:6.7.0-13010631 VCENTER:6.7.0-13010631",
  "type" : "BUNDLE_UPLOAD",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2024-06-21T02:47:49.764Z",
  "resources" : [ {
    "resourceId" : "15727f9a-db55-4102-9bd0-57f2c8ba2de0",
    "type" : "BUNDLE"
  } ],
  "isCancellable" : false,
  "isRetryable" : false
}
  • Poll the status of the task using the task API with the ID from the response of the previous API.

Tip : Refer to: Get a Task.

[_uploadbundle] API [_getbundles] API [_getbundle] API [_startbundledownloadbyid] API [_gettasks] API [_gettask] API

2. Get the Bundles

  • Get the Bundles API is used to get all the bundles.

2.1. Prerequisites API

None

2.2. Steps API

  • Invoke the API.

cURL Request

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

HTTP Request

GET /v1/bundles 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: 1809

{
  "elements" : [ {
    "id" : "15727f9a-db55-4102-9bd0-57f2c8ba2de0",
    "type" : "VMWARE_SOFTWARE",
    "description" : "ESX update bundle -  13004448(67EP7)==>13010696 (vsphere67U2)",
    "version" : "253.0.0-111959",
    "severity" : null,
    "vendor" : "VMware",
    "releasedDate" : "2019-05-10T10:29:10.645Z",
    "isCumulative" : false,
    "isCompliant" : null,
    "sizeMB" : 4.3201446533203125E-4,
    "downloadStatus" : "SUCCESSFUL",
    "components" : [ {
      "description" : "ESX_HOST Update Bundle",
      "vendor" : "VMware",
      "releasedDate" : "2019-05-10T10:29:10.645Z",
      "toVersion" : "6.7.0-13006603",
      "fromVersion" : "6.7.0-13004448",
      "imageType" : "INSTALL",
      "id" : "a65d9d83-88b9-475f-a2ba-ee5d9be34f8d",
      "type" : "HOST",
      "isUserInputRequired" : null
    } ],
    "applicabilityStatus" : null,
    "applicabilityOrder" : null,
    "isPartiallyUpgraded" : null
  }, {
    "id" : "d3563be0-e0d8-43b9-b6b6-3eb3586d4893",
    "type" : "VMWARE_SOFTWARE",
    "description" : "vCenter update bundle",
    "version" : "253.0.0-111959",
    "severity" : null,
    "vendor" : "VMware",
    "releasedDate" : "2019-05-10T10:29:10.645Z",
    "isCumulative" : false,
    "isCompliant" : null,
    "sizeMB" : 4.3201446533203125E-4,
    "downloadStatus" : "SUCCESSFUL",
    "components" : [ {
      "description" : "vCenter Update Bundle",
      "vendor" : "VMware",
      "releasedDate" : "2019-05-10T10:29:10.645Z",
      "toVersion" : "6.7.0-13006603",
      "fromVersion" : "6.7.0-13004448",
      "imageType" : "INSTALL",
      "id" : "a67d9d83-88b9-475f-a2ba-ee5d9be34f4d",
      "type" : "VCENTER",
      "isUserInputRequired" : null
    } ],
    "applicabilityStatus" : null,
    "applicabilityOrder" : null,
    "isPartiallyUpgraded" : null
  } ]
}

[_uploadbundle] API [_getbundles] API [_getbundle] API [_startbundledownloadbyid] API

3. Get a Bundle

  • Get a Bundle API is used to get a specific bundle.

3.1. Prerequisites API

The following data is required:

  • ID of the Bundle

3.2. Steps API

  • Invoke the API.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles/15727f9a-db55-4102-9bd0-57f2c8ba2de0' -i -X GET \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Request

GET /v1/bundles/15727f9a-db55-4102-9bd0-57f2c8ba2de0 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: 821

{
  "id" : "d3563be0-e0d8-43b9-b6b6-3eb3586d4893",
  "type" : "VMWARE_SOFTWARE",
  "description" : "vCenter update bundle",
  "version" : "253.0.0-111959",
  "severity" : null,
  "vendor" : "VMware",
  "releasedDate" : "2019-05-10T10:29:10.645Z",
  "isCumulative" : false,
  "isCompliant" : null,
  "sizeMB" : 4.3201446533203125E-4,
  "downloadStatus" : "SUCCESSFUL",
  "components" : [ {
    "description" : "vCenter Update Bundle",
    "vendor" : "VMware",
    "releasedDate" : "2019-05-10T10:29:10.645Z",
    "toVersion" : "6.7.0-13006603",
    "fromVersion" : "6.7.0-13004448",
    "imageType" : "INSTALL",
    "id" : "a67d9d83-88b9-475f-a2ba-ee5d9be34f4d",
    "type" : "VCENTER",
    "isUserInputRequired" : null
  } ],
  "applicabilityStatus" : null,
  "applicabilityOrder" : null,
  "isPartiallyUpgraded" : null
}

[_uploadbundle] API [_getbundles] API [_getbundle] API [_startbundledownloadbyid] API

4. Update Bundle for Downloading

Online:

  • Update a Bundle for downloading from depot API is used to Download Bundles from the depot.

Tip : Refer to: Update Depot Settings to configure My VMware and Dell EMC Support Account in SDDC Manager.

4.1. Prerequisites API

The following data is required

  • ID of the bundle to be downloaded.

Tip : Refer to: BundleUpdateSpec and BundleDownloadSpec.

4.2. Steps API

  • Invoke the API. This API returns a task which can be polled and monitored.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles/15727f9a-db55-4102-9bd0-57f2c8ba2de0' -i -X PATCH \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "bundleDownloadSpec" : {
    "downloadNow" : true
  }
}'

HTTP Request

PATCH /v1/bundles/15727f9a-db55-4102-9bd0-57f2c8ba2de0 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 59
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "bundleDownloadSpec" : {
    "downloadNow" : true
  }
}

HTTP Response

HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /v1/tasks/2d9f2ce1-3528-440a-a589-3203a19d6eb1
Content-Length: 395

{
  "id" : "2d9f2ce1-3528-440a-a589-3203a19d6eb1",
  "name" : "Download BUNDLE - PSC:6.7.0-13010631 VCENTER:6.7.0-13010631",
  "type" : "BUNDLE_DOWNLOAD",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2024-06-21T02:47:47.917Z",
  "resources" : [ {
    "resourceId" : "15727f9a-db55-4102-9bd0-57f2c8ba2de0",
    "type" : "BUNDLE"
  } ],
  "isCancellable" : false,
  "isRetryable" : false
}
  • Poll the status of the task using the task API with the ID from the response of the previous API.

Tip : Refer to: Get a Task.

[_uploadbundle] API [_getbundles] API [_getbundle] API [_startbundledownloadbyid] API [_gettasks] API [_gettask] API
Last updated 2024-06-21 01:22:12 -0700

Operations
DELETE
Delete Bundle
Delete a bundle by bundle ID
GET
Get Bundle
Retrieve a bundle by its ID
GET
Get Bundles
Retrieve a list of bundles
GET
Get Bundles For Skip Upgrade
Retrieve a list of bundles for skip upgrade by domain ID
PATCH
Start Bundle Download By ID
Start immediate download or schedule download of a bundle by ID
PATCH
Update Bundle Compatibility Sets Deprecated
Update the software compatability set for all bundles
POST
Upload Bundle
Upload a bundle to SDDC Manager