Acknowledge one task

POST /cloud/v1/tasks/{task_id}/acknowledge

Python

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.acknowledge_one(
    "task_id",
)
print(task.id)

200

{
  "created_on": "2019-06-25T08:42:42Z",
  "id": "26986bc0-748a-4448-b836-0a2aa465eb06",
  "state": "RUNNING",
  "task_type": "create_vm",
  "user_id": 123,
  "acknowledged_at": "<string>",
  "acknowledged_by": 123,
  "client_id": 123,
  "created_resources": {
    "ai_clusters": [
      "<string>"
    ],
    "api_keys": [
      "<string>"
    ],
    "baremetal_server": [
      "<string>"
    ],
    "basic_vm": [
      "<string>"
    ],
    "caas_containers": [
      "<string>"
    ],
    "clusters": [
      "<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>"
    ],
    "security_group_rules": [
      "<string>"
    ],
    "security_groups": [
      "<string>"
    ],
    "servergroups": [
      "<string>"
    ],
    "snapshots": [
      "<string>"
    ],
    "subnets": [
      "<string>"
    ],
    "volumes": [
      "<string>"
    ]
  },
  "data": {
    "block_device_config": [
      {
        "boot_index": 0,
        "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
        "name": "volume for vm1",
        "size": 1,
        "source": "image",
        "type_name": "standard"
      }
    ],
    "flavor_name": "g1s-shared-1-0.5",
    "keypair_name": null,
    "name": "cirroz1",
    "network_config": null,
    "reservation_id": "01d4925e-f5db-414a-9808-74e08aa4a741",
    "security_groups": null
  },
  "detailed_state": "CLUSTER_CLEAN_UP",
  "error": "<string>",
  "finished_on": "<string>",
  "job_id": "<string>",
  "lifecycle_policy_id": 123,
  "project_id": 123,
  "region_id": 123,
  "request_id": "<string>",
  "schedule_id": "<string>",
  "updated_on": "<string>",
  "user_client_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

Example:

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

id · string · required

The task ID

Example:

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

state · enum<string> · required

The task state

Available options: ERROR, FINISHED, NEW, RUNNING

Example:

"RUNNING"

task_type · string · required

The task type

Example:

"create_vm"

user_id · integer · required

The user ID that initiated the task

Example:

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

Example:

123

client_id · integer | null

The client ID

Example:

123

created_resources · CreatedResources · object | null

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

Show child attributes

data · any

Task parameters

Example:

{
  "block_device_config": [
    {
      "boot_index": 0,
      "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
      "name": "volume for vm1",
      "size": 1,
      "source": "image",
      "type_name": "standard"
    }
  ],
  "flavor_name": "g1s-shared-1-0.5",
  "keypair_name": null,
  "name": "cirroz1",
  "network_config": null,
  "reservation_id": "01d4925e-f5db-414a-9808-74e08aa4a741",
  "security_groups": null
}

detailed_state · enum<string> | null

Task detailed state that is more specific to task type

Available options: CLUSTER_CLEAN_UP, CLUSTER_REBUILD, CLUSTER_RESIZE, CLUSTER_RESUME, CLUSTER_SERVER_REBUILD, 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

Example:

123

region_id · integer | null

The region ID

Example:

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

Example:

123