{ "info": { "_postman_id": "0fc646a9-d9a8-4d0b-bf9e-13d2a29188af", "name": "VMware vSphere Automation REST Clusters API", "description": "RESTful API for managing VMware vSphere virtualization platform resources including virtual machines, hosts, datastores, clusters, networks, and related infrastructure. The vSphere Automation API provides modern REST endpoints for vCenter Server operations using JSON payloads and session-based or OAuth authentication. This API supersedes the legacy SOAP-based vSphere Web Services API for most automation use cases.\n\nContact Support:\n Name: Broadcom Developer Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "lastUpdatedBy": "35240", "uid": "35240-0fc646a9-d9a8-4d0b-bf9e-13d2a29188af" }, "item": [ { "name": "vcenter", "item": [ { "name": "cluster", "item": [ { "name": "{cluster}", "item": [ { "name": "Vmware Get Cluster Details", "id": "6504b1d8-ff17-402e-ad1c-d983708e519d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster/:cluster", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster", ":cluster" ], "variable": [ { "id": "ca2dbde2-47fc-4194-a748-e3703dc783a8", "key": "cluster", "value": "", "description": "(Required) Identifier of the cluster (e.g., domain-c7)" } ] }, "description": "Returns detailed information about the specified cluster including DRS and HA configuration." }, "response": [ { "id": "c2c2cac7-7334-4046-860e-95056f0a375f", "name": "Cluster details", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "vmware-api-session-id", "value": "" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster/:cluster", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster", ":cluster" ], "variable": [ { "key": "cluster" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"name\": \"\",\n \"resource_pool\": \"\"\n}", "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-c2c2cac7-7334-4046-860e-95056f0a375f" }, { "id": "0223002c-40e6-49a1-b3d8-0a4086e6cb84", "name": "Not authenticated", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "vmware-api-session-id", "value": "" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster/:cluster", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster", ":cluster" ], "variable": [ { "key": "cluster" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-0223002c-40e6-49a1-b3d8-0a4086e6cb84" }, { "id": "d4f751cd-4b35-446c-885b-54973f896084", "name": "Cluster not found", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "vmware-api-session-id", "value": "" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster/:cluster", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster", ":cluster" ], "variable": [ { "key": "cluster" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-d4f751cd-4b35-446c-885b-54973f896084" } ], "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-6504b1d8-ff17-402e-ad1c-d983708e519d" } ], "id": "87f873e5-7597-423d-a866-f9e3882a2cbf", "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-87f873e5-7597-423d-a866-f9e3882a2cbf" }, { "name": "Vmware List Clusters", "id": "b7dc5101-c003-427c-ac15-19f849655d97", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster?filter.clusters=&filter.clusters=&filter.names=&filter.names=&filter.folders=&filter.folders=&filter.datacenters=&filter.datacenters=", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster" ], "query": [ { "description": "Identifiers of clusters to filter by", "key": "filter.clusters", "value": "" }, { "description": "Identifiers of clusters to filter by", "key": "filter.clusters", "value": "" }, { "description": "Names of clusters to filter by", "key": "filter.names", "value": "" }, { "description": "Names of clusters to filter by", "key": "filter.names", "value": "" }, { "description": "Folders that must contain the clusters", "key": "filter.folders", "value": "" }, { "description": "Folders that must contain the clusters", "key": "filter.folders", "value": "" }, { "description": "Datacenters that must contain the clusters", "key": "filter.datacenters", "value": "" }, { "description": "Datacenters that must contain the clusters", "key": "filter.datacenters", "value": "" } ] }, "description": "Returns a list of clusters in the vCenter inventory matching the specified filter criteria." }, "response": [ { "id": "6d67c376-1448-4958-a57f-df5494a4f19b", "name": "List of clusters matching the filter", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "vmware-api-session-id", "value": "" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster?filter.clusters=&filter.names=&filter.folders=&filter.datacenters=", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster" ], "query": [ { "description": "Identifiers of clusters to filter by", "key": "filter.clusters", "value": "" }, { "description": "Names of clusters to filter by", "key": "filter.names", "value": "" }, { "description": "Folders that must contain the clusters", "key": "filter.folders", "value": "" }, { "description": "Datacenters that must contain the clusters", "key": "filter.datacenters", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"cluster\": \"\",\n \"name\": \"\",\n \"ha_enabled\": \"\",\n \"drs_enabled\": \"\"\n },\n {\n \"cluster\": \"\",\n \"name\": \"\",\n \"ha_enabled\": \"\",\n \"drs_enabled\": \"\"\n }\n]", "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-6d67c376-1448-4958-a57f-df5494a4f19b" }, { "id": "7a493fad-73fc-4638-abe1-e375b1326d14", "name": "Invalid filter parameters", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "vmware-api-session-id", "value": "" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster?filter.clusters=&filter.names=&filter.folders=&filter.datacenters=", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster" ], "query": [ { "description": "Identifiers of clusters to filter by", "key": "filter.clusters", "value": "" }, { "description": "Names of clusters to filter by", "key": "filter.names", "value": "" }, { "description": "Folders that must contain the clusters", "key": "filter.folders", "value": "" }, { "description": "Datacenters that must contain the clusters", "key": "filter.datacenters", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-7a493fad-73fc-4638-abe1-e375b1326d14" }, { "id": "f4aff8d8-ebba-437d-8f67-2a0feaeec05f", "name": "Not authenticated", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "vmware-api-session-id", "value": "" } ], "url": { "raw": "{{baseUrl}}/vcenter/cluster?filter.clusters=&filter.names=&filter.folders=&filter.datacenters=", "host": [ "{{baseUrl}}" ], "path": [ "vcenter", "cluster" ], "query": [ { "description": "Identifiers of clusters to filter by", "key": "filter.clusters", "value": "" }, { "description": "Names of clusters to filter by", "key": "filter.names", "value": "" }, { "description": "Folders that must contain the clusters", "key": "filter.folders", "value": "" }, { "description": "Datacenters that must contain the clusters", "key": "filter.datacenters", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-f4aff8d8-ebba-437d-8f67-2a0feaeec05f" } ], "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-b7dc5101-c003-427c-ac15-19f849655d97" } ], "id": "3119004b-3f61-4a68-9904-82e89af456a6", "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-3119004b-3f61-4a68-9904-82e89af456a6" } ], "id": "268ca2ca-630d-41e4-933b-f4a598656341", "createdAt": "2026-07-28T03:27:53.000Z", "updatedAt": "2026-07-28T03:27:53.000Z", "uid": "35240-268ca2ca-630d-41e4-933b-f4a598656341" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "vmware-api-session-id", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "vcenter", "value": "vcenter.example.com" }, { "key": "baseUrl", "value": "https://{{vcenter}}/api" } ] }