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/f29b477c-bacc-4893-a019-f43dcb98aca7
Content-Length: 667
{
"id" : "f29b477c-bacc-4893-a019-f43dcb98aca7",
"name" : "Precheck Task",
"type" : "PRECHECK",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2023-05-16T03:12:15.729Z",
"completionTimestamp" : "2023-05-16T03:12:15.729Z",
"subTasks" : [ {
"name" : "Upgrade - DOMAIN ",
"description" : "Upgrade - DOMAIN ",
"status" : "PENDING",
"creationTimestamp" : "2023-05-16T03:12:15.729Z",
"resources" : [ {
"resourceId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
"type" : "DOMAIN"
} ]
} ],
"resources" : [ {
"resourceId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
"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/f29b477c-bacc-4893-a019-f43dcb98aca7' -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" : "f29b477c-bacc-4893-a019-f43dcb98aca7",
"name" : "Precheck Task",
"type" : "PRECHECK",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2023-05-16T03:12:16.006Z",
"completionTimestamp" : "2023-05-16T03:12:16.006Z",
"subTasks" : [ {
"name" : "Upgrade - DOMAIN ",
"description" : "Upgrade - DOMAIN ",
"status" : "PENDING",
"creationTimestamp" : "2023-05-16T03:12:16.006Z",
"resources" : [ {
"resourceId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
"type" : "DOMAIN"
} ]
} ],
"resources" : [ {
"resourceId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
"type" : "DOMAIN"
} ],
"isCancellable" : false
}
HTTP Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 667
{
"id" : "f29b477c-bacc-4893-a019-f43dcb98aca7",
"name" : "Precheck Task",
"type" : "PRECHECK",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2023-05-16T03:12:16.006Z",
"completionTimestamp" : "2023-05-16T03:12:16.006Z",
"subTasks" : [ {
"name" : "Upgrade - DOMAIN ",
"description" : "Upgrade - DOMAIN ",
"status" : "PENDING",
"creationTimestamp" : "2023-05-16T03:12:16.006Z",
"resources" : [ {
"resourceId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
"type" : "DOMAIN"
} ]
} ],
"resources" : [ {
"resourceId" : "ef16054d-1981-4d82-bb42-35f1b3f1a488",
"type" : "DOMAIN"
} ],
"isCancellable" : false
}
Last updated 2023-05-21 23:30:49 PDT