Bundles APIs
APIs for managing Bundles
Table of Contents
1. [Unsupported from VCF 9.0] Upload a Bundle
Note : This API is no longer supported from VCF 9.0. Please refer to POST v1/product-binaries API instead. Offline: |
- Upload a Bundle API is used to upload Bundles which are downloaded using Bundle Transfer Utility tool.
Tip : Please refer to the SDDC Manager documentation for more information on the Bundle Transfer Utility tool.
1.1. Prerequisites
The following data is required:
Bundle file path.
Bundle manifest file path.
Bundle manifest signature file path.
Tip : Refer to: BundleUploadSpec.
1.2. Steps
- 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 410 Gone
Content-Type: application/json
Content-Length: 272
{
"errorCode" : "API_NO_LONGER_SUPPORTED",
"arguments" : [ "9.0", "POST v1/product-binaries" ],
"message" : "This API is no longer supported from VCF 9.0.",
"remediationMessage" : "Please refer to POST v1/product-binaries instead.",
"referenceToken" : "3B4HKB"
}
- 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.
1.3. Related APIs
[_uploadbundle] API [_getbundles] API [_getbundle] API [_startbundledownloadbyid] API [_gettasks] API [_gettask] API [_uploadproductbinaries] API
2. Get the Bundles
- Get the Bundles API is used to get all the bundles.
2.1. Prerequisites
None
2.2. Steps
- 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" : "3bf80382-ddbf-4e0d-b472-dbcff042317b",
"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" : "d92b058e-3f16-4189-ae06-6f8bf4984b22",
"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
} ]
}
2.3. Related APIs
[_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
The following data is required:
- ID of the Bundle
3.2. Steps
- Invoke the API.
cURL Request
$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles/3bf80382-ddbf-4e0d-b472-dbcff042317b' -i -X GET \
-H 'Accept: application/json' \
-H 'Authorization: Bearer etYWRta....'
HTTP Request
GET /v1/bundles/3bf80382-ddbf-4e0d-b472-dbcff042317b 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" : "d92b058e-3f16-4189-ae06-6f8bf4984b22",
"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
}
3.3. Related APIs
[_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
The following data is required
- ID of the bundle to be downloaded.
Tip : Refer to: BundleUpdateSpec and BundleDownloadSpec.
4.2. Steps
- Invoke the API. This API returns a task which can be polled and monitored.
cURL Request
$ curl 'https://sfo-vcf01.rainpole.io/v1/bundles/3bf80382-ddbf-4e0d-b472-dbcff042317b' -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/3bf80382-ddbf-4e0d-b472-dbcff042317b 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/b701123d-42e5-4aae-95b6-d2154d650a8d
Content-Length: 395
{
"id" : "b701123d-42e5-4aae-95b6-d2154d650a8d",
"name" : "Download BUNDLE - PSC:6.7.0-13010631 VCENTER:6.7.0-13010631",
"type" : "BUNDLE_DOWNLOAD",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2025-03-21T09:42:55.763Z",
"resources" : [ {
"resourceId" : "3bf80382-ddbf-4e0d-b472-dbcff042317b",
"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.
4.3. Related APIs
[_uploadbundle] API
[_getbundles] API
[_getbundle] API
[_startbundledownloadbyid] API
[_gettasks] API
[_gettask] API
Last updated 2025-03-21 15:13:04 +0530
Operations
GET
Get Bundles
Retrieve a list of bundles
POST
Upload Bundle Deprecated
[Unsupported] Upload a bundle to SDDC Manager or VCF Installer
GET
Get Bundle
Retrieve a bundle by its ID
DELETE
Delete Bundle
Delete a bundle by bundle ID
PATCH
Start Bundle Download By ID
Start immediate, schedule or cancel download of a bundle by ID
GET
Get Bundle Download Status
Retrieve a the download status for bundles
GET
Get Bundles For Skip Upgrade
Retrieve a list of bundles to skip upgrade a domain