vSphere Lifecycle Manager (vLCM) Bulk Transition API's Returns "UNAUTHORIZED" Error with Empty Input Specification

Products

• VMware vCenter Server

Issue/Introduction

Symptoms:

• When invoking vSphere Lifecycle Manager's Bulk transition API's with an input specification that contains an empty list of entities (e.g., an empty list of clusters), the API returns an "UNAUTHORIZED" error instead of the expected "INVALID_ARGUMENT" error

The API's being affected:

POST https://{server}/api/esx/settings/inventory?action=extract-installed-image&vmw-task=true
POST https://{server}/api/esx/settings/inventory?action=transition&vmw-task=true
GET https://{server}/api/esx/settings/inventory/reports/transition-summary/clusters
GET https://{server}/api/esx/settings/inventory/reports/transition-summary/hosts

Example Request:

{
  "entities": {
    "type": "CLUSTER",
    "clusters": []
  }
}

Observed Error:

{
  "error_type": "UNAUTHORIZED",
  "messages": []
}

Environment

vSphere Lifecycle Manager 9.0 onwards

Cause

This issue is caused because the API requires a valid, non-empty list of entities in the input specification

Resolution

• The fix for this issue will be planned in the upcoming patch/update releases. To be notified once the fix is available, subscribe to this article.

Workaround:

• To resolve the "UNAUTHORIZED" error, ensure that you provide a valid, non-empty list of entities in the input specification when invoking vLCM's Bulk Transition  APIs.

For example, if you are querying for cluster information, the "clusters" list should contain at least one valid cluster identifier.

Example of a Corrected Request (assuming a cluster with ID "domain-c7" exists):

{
  "entities": {
    "type": "CLUSTER",
    "clusters": ["domain-c7"]
  }
}

Additional Information

Subscribe to a Broadcom knowledge article