Remove an Item from a Catalog

An organization 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 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