Approve a Machine Request

To approve a machine request, you first get a work item ID, then specify the ID in the approval.

Prerequisites

  • Log in to vRealize Automation as an approver with at least one of the following qualifications:
    • You are designated as an approver in an approval policy.
    • You belong to a group which has been designated as an approval group in an approval policy.
    • You are designated as a delegate for someone who is an approver.
  • 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. List all available work item IDs. 
    curl --insecure -H "Content-Type: application/json" 
-H "Authorization: Bearer $token" 
https://$vRA/workitem-service/api/workitems
    For details regarding input and output for this request, see Syntax for Listing Work Items.
  2. Examine the response to find the workItemId
  3. Get details for a specific work item ID.

    Use the workItemId to get the details for this work item. In this example, the workItemId is 5e3e9519-78ea-4409-a52c-e4aa3bc56511. 

    curl --insecure -H "Content-Type: application/json" 
-H "Authorization: Bearer $token" 
https://$vRA/workitem-service/api/workitems/5e3e9519-78ea-4409-a52c-e4aa3bc56511
    For details regarding input and output for this request, see Syntax for Getting Work Item Details.
  4. Construct a JSON file that contains the work item ID information that you need to approve a machine request.
    1. Copy the appropriate JSON input file template to a new file in an XML editor that maintains formatting.
    2. Substitute the input variables in the template with the values you obtained for your specific work item ID, for example 5e3e9519-78ea-4409-a52c-e4aa3bc56511.
    3. Save the file with a new name, for example, approve.json.
    For details regarding input and output for this request, see Syntax for Constructing a JSON File to Approve a Machine Request.
  5. Approve the submitted machine request by specifying the work item ID and including the JSON file as part of the command line. 
    curl --insecure -H "Content-Type:application/json" 
-H "Authorization: Bearer $token" 
https://$vRA/workitem-service/api/workitems/5e3e9519-78ea-4409-
a52c-e4aa3bc56511/actions/com.mycompany.csp.core.approval.action.approve 
--d @approve.json
    For details regarding input and output for this request, see Syntax for Approving a Submitted Machine Request.

Results

If the command is successful, the HTTP status is 201 Created. If the command is not successful, the HTTP status is 204 No Content.