Obtenir le détail d'une opération via API

Une opération est un ticket permettant de suivre l'exécution d'une action effectuée par l'utilisateur en temps réel, notamment l'état grâce au champ status. Il n'est pas possible d'effectuer des opérations ou des actions concurrentes de modification sur un même cluster. Ces actions doivent être réalisées de manière séquentielle.

Prérequis

• Un compte NumSpot.
• Un espace NumSpot auquel le compte est associé.
• Un compte avec le rôle Kubernetes Viewer ou Kubernetes Admin sur l'espace ou les accès RBAC qui octroient le droit de lecture au cluster dont est issue l'opération.
• Un jeton de connexion associé au compte NumSpot utilisé.

Les données requises

• OPERATION_ID est l'identifiant de l'opération que l'on souhaite consulter.
• SPACE_ID est l'identifiant de l'espace NumSpot dans lequel le cluster cible a été créé.
• REGION est la région dans laquelle l'espace NumSpot a été créé.
• ACCESS_TOKEN est le jeton (token) généré via la connexion (consulter la génération d'un token d'accès).

Exemple de requête: Récupérer les informations d'une opération sur cluster Kubernetes

export REGION="myregion"
export SPACE_ID="myspaceid"
export OPERATION_ID="myoperationid"
export ACCESS_TOKEN="myaccesstoken"

curl -X GET  https://api.$REGION.numspot.com/kubernetes/spaces/$SPACE_ID/operations/$OPERATION_ID \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header 'Content-Type: application/json' 

Exemple de réponse: Récupérer les informations d'une opération sur cluster Kubernetes

{
    "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "operationType": "[OPERATION_ACTION]",
    "status": "PENDING",
    "progress": "During task",
    "target": "https://..../kubernetes/spaces/{spaceId}/clusters/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "selfLink": "https://..../kubernetes/spaces/{spaceId}/operations/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "createTime": "2024-06-12T16:04:14.267Z",
    "startTime": "2024-06-12T16:04:14.267Z",
    "endTime": "2024-06-12T16:04:14.267Z"
}

• target est l'identifiant complet du cluster au format: "space:{spaceId}:cluster:{clusterId}.
• startTime est la date à laquelle le statut de l'opération est passé de PENDING à RUNNING.
• endTime est la date à laquelle l'opération s'est terminée, passant du statut RUNNING à DONE ou FAILED.
• error indique la raison de l'erreur si l'opération est en statut FAILED.
• type indique l'action effectuée sur le cluster ou nodepool.