System Prechecks

APIs for managing System Prechecks

1. Perform System Precheck

Precheck System API is used to perform the required system level health checks and upgrade pre-checks for an upgrade to be successful. Make sure to run these checks before performing any upgrade.

Tip : Refer to: Get the Upgradables to query for the list of upgradables which can be used for performing Domain, Cluster level checks.

1.1. Prerequisites

The following data is required:
* Resource ID. Ex: Domain ID, Cluster ID.

  • Resource Type. Ex: DOMAIN, CLUSTER.

Tip : Refer to: PrecheckSpec and Resource.

Note : Supported Resource Type’s are DOMAIN, CLUSTER. For Cluster level checks, the Cluster ID’s can be retrieved based on the Host’s that are available for upgrade, Refer to: Get the Hosts and Get the Clusters API’s.

1.2. Steps

  • Invoke the API. This API returns a precheck task which can be polled and monitored.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/system/prechecks' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....' \
    -d '{
  "resources" : [ {
    "resourceId" : "bbd38966-8537-46f1-9a54-06fbfe7079c6",
    "type" : "DOMAIN"
  } ]
}'

HTTP Request

POST /v1/system/prechecks HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 110
Host: sfo-vcf01.rainpole.io
Authorization: Bearer etYWRta....

{
  "resources" : [ {
    "resourceId" : "bbd38966-8537-46f1-9a54-06fbfe7079c6",
    "type" : "DOMAIN"
  } ]
}

HTTP Response

HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /v1/system/prechecks/tasks/94949fb8-b9bb-446c-a7b8-e4175ba5caf7
Content-Length: 667

{
  "id" : "94949fb8-b9bb-446c-a7b8-e4175ba5caf7",
  "name" : "Precheck Task",
  "type" : "PRECHECK",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2021-09-13T23:54:59.499Z",
  "completionTimestamp" : "2021-09-13T23:54:59.499Z",
  "subTasks" : [ {
    "name" : "Upgrade - DOMAIN ",
    "description" : "Upgrade - DOMAIN ",
    "status" : "PENDING",
    "creationTimestamp" : "2021-09-13T23:54:59.499Z",
    "resources" : [ {
      "resourceId" : "293f9253-a1c0-4dd1-b989-f13d1b0ee1c1",
      "type" : "DOMAIN"
    } ]
  } ],
  "resources" : [ {
    "resourceId" : "293f9253-a1c0-4dd1-b989-f13d1b0ee1c1",
    "type" : "DOMAIN"
  } ],
  "isCancellable" : false
}
  • Poll the status of the task using the precheck task API with the ID from the response of the previous API.

Tip : Refer to: Get System Precheck Task.

2. Get System Precheck Task

Get Precheck Task by ID API is used to retrieve a precheck task.

2.1. Prerequisites

The following data is required

  • ID of the precheck task

2.2. Steps

  • Invoke the API. This API returns a precheck task which can be polled and monitored.

cURL Request

$ curl 'https://sfo-vcf01.rainpole.io/v1/system/prechecks/tasks/94949fb8-b9bb-446c-a7b8-e4175ba5caf7' -i -X GET \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer etYWRta....'

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 667

{
  "id" : "94949fb8-b9bb-446c-a7b8-e4175ba5caf7",
  "name" : "Precheck Task",
  "type" : "PRECHECK",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2021-09-13T23:55:00.066Z",
  "completionTimestamp" : "2021-09-13T23:55:00.066Z",
  "subTasks" : [ {
    "name" : "Upgrade - DOMAIN ",
    "description" : "Upgrade - DOMAIN ",
    "status" : "PENDING",
    "creationTimestamp" : "2021-09-13T23:55:00.066Z",
    "resources" : [ {
      "resourceId" : "293f9253-a1c0-4dd1-b989-f13d1b0ee1c1",
      "type" : "DOMAIN"
    } ]
  } ],
  "resources" : [ {
    "resourceId" : "293f9253-a1c0-4dd1-b989-f13d1b0ee1c1",
    "type" : "DOMAIN"
  } ],
  "isCancellable" : false
}

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 667

{
  "id" : "94949fb8-b9bb-446c-a7b8-e4175ba5caf7",
  "name" : "Precheck Task",
  "type" : "PRECHECK",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2021-09-13T23:55:00.066Z",
  "completionTimestamp" : "2021-09-13T23:55:00.066Z",
  "subTasks" : [ {
    "name" : "Upgrade - DOMAIN ",
    "description" : "Upgrade - DOMAIN ",
    "status" : "PENDING",
    "creationTimestamp" : "2021-09-13T23:55:00.066Z",
    "resources" : [ {
      "resourceId" : "293f9253-a1c0-4dd1-b989-f13d1b0ee1c1",
      "type" : "DOMAIN"
    } ]
  } ],
  "resources" : [ {
    "resourceId" : "293f9253-a1c0-4dd1-b989-f13d1b0ee1c1",
    "type" : "DOMAIN"
  } ],
  "isCancellable" : false
}

Last updated 2021-11-03 05:03:41 PDT

Operations



Feedback

Was this page helpful?