Deleting an adapter instance via REST API in VMware vRealize Operations Manager fails

Products

• VMware Aria Suite

Issue/Introduction

Symptoms:

• Unable to remove adapter instance in VMware vRealize Operations Manager.
• Re-adding an adapter instance fails with the error:
  
  Failed to create AI resource

Environment

VMware vRealize Operations Manager 6.7.x
VMware vRealize Operations Manager 6.6.x
VMware vRealize Operations Manager 7.0.x

Resolution

Before proceeding, take the cluster offline and take a snapshot or backup of the cluster.  Bring the cluster back online to proceed.
 

Note: Ensure that SSH is enabled on the master node. For more information, see Enabling SSH access in VMware vRealize Operations Manager 6.0.x (2100515).

 

To find the ID of the adapter instance you want to delete:

1. In your vRealize Operations Manager instance, navigate to Administration > Environment Overview.

Note: In later releases of vRealize Operations Manager, navigate to Administration > Inventory Explorer or Administration > Configurations > Inventory Explorer.

2. Select Adapter Instances > Solution and the adapter you are removing.

Note: Replace Solution with the name of the solution for the adapter instance you want to remove.

3. Click the arrow next to Name and highlight columns, check the ID checkbox.

Note: In later releases of vRealize Operations Manager, click the Show Columns button on the bottom left of the pane.

4. Note the ID that corresponds with your vSphere vCenter Server.

To delete the adapter via a REST API call:

1. Open a putty session to the master node and log in as root.
2. Remove the adapter by running this command:

curl -k -i -H "Content-type: application/json" -H "X-vRealizeOps-API-use-unsupported: true" -u 'username:password' -X DELETE https://IP_address/suite-api/api/adapters/ID

Note: Replace username, password, IP_address, and ID with the Administrator username and password, IP address of the vRealize Operations Manager Master node, and ID noted in step 4 respectively.

Example: curl -k -i -H "Content-type: application/json" -H "X-vRealizeOps-API-use-unsupported: true" -u 'admin:Secret123!' -X DELETE https://192.168.4.5/suite-api/api/adapters/02deda0c-b438-4413-9d83-dd7e7c9a3b3d

Additional Information

Enabling SSH access in vRealize Operations Manager 6.x