System Prechecks APIs

System Prechecks APIs

APIs for managing System Prechecks

Table of Contents

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/d0d0a50d-5376-49ba-961c-ac15b0adadb4
Content-Length: 667

{
  "id" : "d0d0a50d-5376-49ba-961c-ac15b0adadb4",
  "name" : "Precheck Task",
  "type" : "PRECHECK",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2022-09-28T07:27:20.071Z",
  "completionTimestamp" : "2022-09-28T07:27:20.071Z",
  "subTasks" : [ {
    "name" : "Upgrade - DOMAIN ",
    "description" : "Upgrade - DOMAIN ",
    "status" : "PENDING",
    "creationTimestamp" : "2022-09-28T07:27:20.071Z",
    "resources" : [ {
      "resourceId" : "511f9891-83ed-4461-9e88-852b70252995",
      "type" : "DOMAIN"
    } ]
  } ],
  "resources" : [ {
    "resourceId" : "511f9891-83ed-4461-9e88-852b70252995",
    "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/d0d0a50d-5376-49ba-961c-ac15b0adadb4' -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" : "d0d0a50d-5376-49ba-961c-ac15b0adadb4",
  "name" : "Precheck Task",
  "type" : "PRECHECK",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2022-09-28T07:27:20.756Z",
  "completionTimestamp" : "2022-09-28T07:27:20.756Z",
  "subTasks" : [ {
    "name" : "Upgrade - DOMAIN ",
    "description" : "Upgrade - DOMAIN ",
    "status" : "PENDING",
    "creationTimestamp" : "2022-09-28T07:27:20.756Z",
    "resources" : [ {
      "resourceId" : "511f9891-83ed-4461-9e88-852b70252995",
      "type" : "DOMAIN"
    } ]
  } ],
  "resources" : [ {
    "resourceId" : "511f9891-83ed-4461-9e88-852b70252995",
    "type" : "DOMAIN"
  } ],
  "isCancellable" : false
}

HTTP Response

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

{
  "id" : "d0d0a50d-5376-49ba-961c-ac15b0adadb4",
  "name" : "Precheck Task",
  "type" : "PRECHECK",
  "status" : "IN_PROGRESS",
  "creationTimestamp" : "2022-09-28T07:27:20.756Z",
  "completionTimestamp" : "2022-09-28T07:27:20.756Z",
  "subTasks" : [ {
    "name" : "Upgrade - DOMAIN ",
    "description" : "Upgrade - DOMAIN ",
    "status" : "PENDING",
    "creationTimestamp" : "2022-09-28T07:27:20.756Z",
    "resources" : [ {
      "resourceId" : "511f9891-83ed-4461-9e88-852b70252995",
      "type" : "DOMAIN"
    } ]
  } ],
  "resources" : [ {
    "resourceId" : "511f9891-83ed-4461-9e88-852b70252995",
    "type" : "DOMAIN"
  } ],
  "isCancellable" : false
}

Last updated 2023-04-27 11:11:39 PDT

Operations
GET
Get Precheck Task
Get Precheck Task by ID
POST
Precheck System
Precheck System