Skip to main content

Self-Service Manage Nodepools

note

This documentation is currently a work in progress and this feature will be available soon

Overview

The Self-Service Manage Nodepools feature allows users to interact with their cluster nodepools directly through the REST API. API definition can be found on trustnest APIM

Access Requirements

To manage nodepools, you must request K8SAAS APIM Access

Who can interact with nodepool?

Only members of the group <CLUSTER_NAME>-k8saas-devops-cluster-role have the necessary permissions to execute operations related to managing cluster nodepools.

The self-service Provide access allow to add members to <CLUSTER_NAME>-k8saas-devops-cluster-role's group.

How to interact with operations

There are two types of operations you can perform:

  1. Instantaneous Operations: These operations (GET) are synchronous and return results immediately within their payload.
  2. Long-Term Operations: These operations (PUT, POST and DELETE) are asynchronous. Once initiated, users must poll the Task Status API to check the current status of the operation.

Operation Workflow

selfservice-manage-nodepool

Task Status Flow

selfservice-manage-task-status

Operations available

Request TypeDescriptionAPI Details(require APIM access)
DELETEDelete k8saas nodepooldetails
GETRetrieve the details of a specific nodepool in a k8saas clusterdetails
GETRetrieve the list of nodepools in a specific k8saas clusterdetails
GETRetrieve the status of a specific task in a k8saas clusterdetails
POSTStart k8saas nodepooldetails
POSTStop k8saas nodepooldetails
PUTUpdate the details of a specific nodepool in a k8saas clusterdetails