You can use a sequence of Rest API catalog service commands to request a machine. This procedure provides sample command line syntax to request a machine. Supporting information regarding available input and output parameters, command-line entry samples, and sample JSON output samples is available in the following reference topics.

About this task

This procedure provides sample command line syntax for approving a machine request. Supporting information regarding available input and output parameters, command-line entry samples, and sample JSON output samples is available.

Prerequisites

  • Log in to vRealize Automation as a consumer and current business group user.

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

  • If you are not using the API Explorer, verify that you have a valid HTTP bearer token that matches your login credentials. See REST API Authentication.

Procedure

  1. List all shared catalog items in the catalog.
    curl --insecure -H "Content-Type: application/json" 
    -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/entitledCatalogItems
  2. Locate the details of a specific catalog item by name.
    curl --insecure -H "Content-Type: application/json" -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/entitledCatalogItems
  3. Locate the blueprint values to complete a machine request by listing the entitled catalog items, and then locating the catalog item that corresponds to the machine blueprint.
  4. Create a JSON file that contains the blueprint values to construct a machine request.
    1. Open a text editor and create a file, for example, request.json.

    2. Save the file with any valid file name and file extension, for example, request.json.

    3. Include the file in the command line when you submit the work item approval.

  5. Submit the machine request with the catalog service.
    curl --insecure -H "Content-Type: application/json" 
    -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/requests --verbose --data @C:/Temp/requestMachine.json
  6. View the requests with the catalog service.
    curl --insecure -H "Content-Type: application/json" -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/requests
  7. Find the corresponding resource with the catalog service using a request ID.
    curl --insecure -H "Content-Type: application/json" 
    -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/resources/?$filter=request/id+eq+%279e3
    e2e33-2361-4c0a-8dcf-ff0a347bb08e%27
  8. View the details of a machine request by using the catalog service.
    curl --insecure -H "Content-Type: application/json" -H "Authorization: Bearer $token” 
    https://$host/catalog-service/api/consumer/requests/3a5d9697-e3c8-476f-9754-29e773af