GET
/
cloud
/
v1
/
tasks
/
{task_id}
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
task = client.cloud.tasks.get(
    "task_id",
)
print(task.id)
{
  "acknowledged_at": "<string>",
  "acknowledged_by": 123,
  "client_id": 123,
  "created_on": "2019-06-25T08:42:42Z",
  "created_resources": {
    "ai_clusters": [
      "<string>"
    ],
    "api_keys": [
      "<string>"
    ],
    "caas_containers": [
      "<string>"
    ],
    "ddos_profiles": [
      123
    ],
    "faas_functions": [
      "<string>"
    ],
    "faas_namespaces": [
      "<string>"
    ],
    "file_shares": [
      "<string>"
    ],
    "floatingips": [
      "<string>"
    ],
    "healthmonitors": [
      "<string>"
    ],
    "images": [
      "<string>"
    ],
    "inference_instances": [
      "<string>"
    ],
    "instances": [
      "<string>"
    ],
    "k8s_clusters": [
      "<string>"
    ],
    "k8s_pools": [
      "<string>"
    ],
    "l7polices": [
      "<string>"
    ],
    "l7rules": [
      "<string>"
    ],
    "laas_topic": [
      "<string>"
    ],
    "listeners": [
      "<string>"
    ],
    "loadbalancers": [
      "<string>"
    ],
    "members": [
      "<string>"
    ],
    "networks": [
      "<string>"
    ],
    "pools": [
      "<string>"
    ],
    "ports": [
      "<string>"
    ],
    "postgresql_clusters": [
      "<string>"
    ],
    "projects": [
      123
    ],
    "registry_registries": [
      "<string>"
    ],
    "registry_users": [
      "<string>"
    ],
    "routers": [
      "<string>"
    ],
    "secrets": [
      "<string>"
    ],
    "servergroups": [
      "<string>"
    ],
    "snapshots": [
      "<string>"
    ],
    "subnets": [
      "<string>"
    ],
    "volumes": [
      "<string>"
    ]
  },
  "data": "<any>",
  "detailed_state": "CLUSTER_CLEAN_UP",
  "error": "<string>",
  "finished_on": "<string>",
  "id": "26986bc0-748a-4448-b836-0a2aa465eb06",
  "job_id": "<string>",
  "lifecycle_policy_id": 123,
  "project_id": 123,
  "region_id": 123,
  "request_id": "<string>",
  "schedule_id": "<string>",
  "state": "RUNNING",
  "task_type": "create_vm",
  "updated_on": "<string>",
  "user_client_id": 123,
  "user_id": 123
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

​
task_id
string
required

Task ID

Response

200 - application/json

OK

​
created_on
string | null
required

Created timestamp

Examples:

"2019-06-25T08:42:42Z"

​
id
string
required

The task ID

Examples:

"26986bc0-748a-4448-b836-0a2aa465eb06"

​
state
enum<string>
required

The task state

Available options:
ERROR,
FINISHED,
NEW,
RUNNING
​
task_type
string
required

The task type

Examples:

"create_vm"

​
user_id
integer
required

The user ID that initiated the task

Examples:

123

​
acknowledged_at
string | null

If task was acknowledged, this field stores acknowledge timestamp

​
acknowledged_by
integer | null

If task was acknowledged, this field stores user_id of the person

Examples:

123

​
client_id
integer | null

The client ID

Examples:

123

​
created_resources
object | null

If the task creates resources, this field will contain their IDs

​
data
any

Task parameters

​
detailed_state
enum<string> | null

Task detailed state that is more specific to task type

Available options:
CLUSTER_CLEAN_UP,
CLUSTER_RESIZE,
CLUSTER_RESUME,
CLUSTER_SUSPEND,
ERROR,
FINISHED,
IPU_SERVERS,
NETWORK,
POPLAR_SERVERS,
POST_DEPLOY_SETUP,
VIPU_CONTROLLER
​
error
string | null

The error value

​
finished_on
string | null

Finished timestamp

​
job_id
string | null

Job ID

​
lifecycle_policy_id
integer | null

Lifecycle policy ID

​
project_id
integer | null

The project ID

Examples:

123

​
region_id
integer | null

The region ID

Examples:

123

​
request_id
string | null

The request ID

​
schedule_id
string | null

Schedule ID

​
updated_on
string | null

Last updated timestamp

​
user_client_id
integer | null

Client, specified in user's JWT

Examples:

123