You use the catalog service to log in to vRealize Automation and view information about provisioned resources.

Before you begin

  • Log in to vRealize Automation as a business group manager.

  • Verify that the appliance name and fully qualified domain name of the vRealize Automation instance are available.

  • Verify that you have a valid HTTP bearer token that matches your login credentials. See REST API Authentication.

Procedure

  1. Display a list of all provisioned resources.
    $curl --insecure -s -H" Content-Type: multipart/form-data" -H "Authorization: Bearer $token" http://$vRA/catalog-service/api/consumer/requests/7aaf9baf-aa4e-47c4-997b-edd7c7983a5b/resourceViews

    For details regarding input and output of this sample, see Syntax for Getting Deployment Details.

  2. Examine the response for the HATEOAS links that you need to obtain additional information about specific deployed resources.
  3. Use the GET: Child Resources HATEOAS link to retrieve a list of child nodes of a deployment.
    $curl --insecure -s -H" Content-Type: multipart/form-data" -H "Authorization: Bearer $token" https:// $vRA/catalog-service/api/consumer/resourceViews?managedOnly=false&withExtendedData=true&withOperations=true&%24filter=parentResource%20eq%20%27c4d3db3e-e397-44ff-a1c9-0ecebdba12f4%27

    For details regarding input and output of this sample, see Syntax for Navigating to the Children of a Deployed Resource.

What to do next

Use the HATEOS links obtained from retrieving the list of child nodes to perform actions.

Note:

The vRealize Automation REST API does not support custom resource actions template API calls. However, you can perform custom resource actions programmatically by using the vRealize CloudClient.

For additional posts and articles that illustrate methods for performing actions by using the vRealize Automation REST API or vRealize CloudClient tool, see the Executing Day 2 Actions with the vRA 7 REST API blog post.