Retry a Request

If a request fails, you can retry the request to create an environment, upgrade vRealize Suite Lifecycle Manager, or download from my.vmware.com.

Prerequisites

Satisfy the following conditions before performing the tasks for this use case.

• Use POST /lcm/api/v1/login to log in to vRealize Suite Lifecycle Manager.

• Verify that you have a valid authentication token that matches your login credentials. See Request an Authentication Token.

• Verify that you have obtained the request ID from a response to create an environment, add a product, add a node, or upgrade your product.

Procedure

1. Retry a request with a request ID.

   curl -X POST "https://LCM-HostName/lcm/api/v1/request/retry/<Request-ID>" \
     -H "accept: application/json" -H "x-xenon-auth-token: $token" \
     -H "content-type: application/json" \
     -d "[ 
        { 
          "eventId": "<Retry-Event-ID>", 
          "messageId": "<Retry-Message-ID>", 
          "message": "Error Message", 
          "properties": {
            "retrykey": "newvalue"
          } 
        }
      ]" 
   

   Where the request body input parameters such as eventID, messageId, message, and properties with the retrykey list are retry parameters listed in the response to a status request. See Monitor a Request.

2. Examine the response to track the retry request.

   The output of the request includes:

   • requestId = Retry Request ID

   • requestState = Retry Request State

   • requestType = Retry Request Type

3. (Optional) Monitor the status of the request with the Retry Request ID from Step 2.

   curl -X GET "https://LCM-HostName/lcm/api/v1/request/status/<Retry-Request-ID>" -H "accept: application/json" -H "x-xenon-auth-token: $token"