You can use the REST API catalog service to reprovision a provisioned machine, or perform other entitled and enabled actions .

Input

Use the supported input parameters to control the command output.

The JSON Template Values table describes the information used in, in conjunction with the JSON template format, to create a JSON text file to include in the reprovision command request.

Table 1. JSON Template Values

Property

Description

resourceRef : id

Specifies the resource ID of the resource on which the operation is to be performed.

resourceActionRef : id

Specifies the resource action ID on which the operations is to be performed.

organization

Specifies the organization to which the resource belongs. Supply the tenant and subtenant information as necessary. The tenant corresponds to the organization and the subtenant corresponds to the business group.

State

Specifies the state of the request. At the time of requesting, the state is SUBMITTED.

The other possible state values are UNSUBMITTED, SUBMITTED, DELETED, PENDING_PRE_APPROVAL, PRE_APPROVAL_SEND_ERROR, PRE_APPROVED, PRE_REJECTED, IN_PROGRESS, PROVIDER_SEND_ERROR, PROVIDER_COMPLETED, PROVIDER_FAILED, PENDING_POST_APPROVAL, POST_APPROVAL_SEND_ERROR, POST_APPROVED, POST_REJECTION_RECEIVED, ROLLBACK_ERROR, POST_REJECTED, SUCCESSFUL, and FAILED.

requestNumber

Contains Get information that is generated by the system.

requestData

Specifies other custom request data.

JSON Input File Template

Use the following JSON template to create a JSON text file that contains the information required to reprovision a machine.

This example reprov_action.json file contains a resource action request for the reprovision action (resourceActionRef and id) to be performed on the specified machine (resourceRef and id). The organization content include the names and labels of the tenant and business group.

{
    "@type": "ResourceActionRequest",
    "resourceRef": {
        "id": "b3adbe4f-274d-4a0c-8757-7843b8cb2ba4"
    },
    "resourceActionRef": {
        "id": "a1caee9b-d67f-41e8-a7b3-131616a0f6ac"
    },
    "organization": {
        "tenantRef": "MYCOMPANY",
        "tenantLabel": "QETenant",
        "subtenantRef": "eab762cb-6e75-4379-83ef-171a71c9f00e",
        "subtenantLabel": "MyTestAgentBusinessGroup"
    },
    "state": "SUBMITTED",
    "requestNumber": 0,
    "requestData": {
        "entries": []
    }
}

curl Command

The following example command calls the JSON text file and reprovisions a machine.

curl --insecure -H "Content-Type: application/json" 
-H "Authorization: Bearer $token" 
https://$host/catalog-service/api/consumer/requests --d @C:\reprov_action.json.txt