An organization administratorA Virtual Infrastructure Administrator or a user with adequate permissions can remove a CatalogItem by making a DELETE request to its rel="remove" link.

Removing a CatalogItem also removes the referenced vApp template or media image from the catalog's storage.

Prerequisites

  • This operation requires the rights included in the predefined Catalog Author role or an equivalent set of rights. Verify that you are logged in to the vCloud Air Compute Service as a Virtual Infrastructure Administrator.

  • Verify that the target catalog does not have an external subscription.

Procedure

  1. Retrieve the catalog item from the catalog.
  2. Locate the rel="remove" link in the CatalogItem element.
  3. Make a DELETE request to the href value of the rel="remove" link in the CatalogItem.

Example: Remove an Item from a Catalog

This request removes the source catalog item that was copied in Copy a Catalog Item.

Request: 
DELETE https://vcloud.example.com/api/catalogItem/221
Response: 
204 No Content