GET
/
cloud
/
v1
/
tasks
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
page = client.cloud.tasks.list()
page = page.results[0]
print(page.id)
{
  "count": 1,
  "results": [
    {
      "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

​
APIKey
string
header
required

API key for authentication.

Query Parameters

​
from_timestamp
string | null

ISO formatted datetime string. Filter the tasks by creation date greater than or equal to from_timestamp

​
is_acknowledged
boolean | null

Filter the tasks by their acknowledgement status

​
limit
integer
default:10

Limit the number of returned tasks. Falls back to default of 10 if not specified. Limited by max limit value of 1000

Required range: 0 < x <= 1000
Examples:

100

​
offset
integer
default:0

Offset value is used to exclude the first set of records from the result

Required range: x >= 0
Examples:

0

​
order_by
enum<string>

Sorting by creation date. Oldest first, or most recent first

Available options:
asc,
desc
​
project_id
integer[] | null

The project ID to filter the tasks by project. Supports multiple values of kind key=value1&key=value2

Examples:

123

​
region_id
integer[] | null

The region ID to filter the tasks by region. Supports multiple values of kind key=value1&key=value2

Examples:

123

​
sorting
enum<string>

(DEPRECATED Use 'order_by' instead) Sorting by creation date. Oldest first, or most recent first

Available options:
asc,
desc
​
state
enum<string>[] | null

Filter the tasks by state. Supports multiple values of kind key=value1&key=value2

Examples:

"NEW"

"RUNNING"

"FINISHED"

"ERROR"

​
task_type
string | null

Filter the tasks by their type one of ['activate_ddos_profile', 'attach_bm_to_reserved_fixed_ip', 'attach_vm_interface', 'attach_vm_to_reserved_fixed_ip', 'attach_volume', 'create_ai_cluster_gpu', 'create_bm', 'create_caas_container', 'create_dbaas_postgres_cluster', 'create_ddos_profile', 'create_faas_function', 'create_faas_namespace', 'create_fip', 'create_gpu_virtual_cluster', 'create_image', 'create_inference_instance', 'create_inference_instance_key', 'create_k8s_cluster_pool_v2', 'create_k8s_cluster_v2', 'create_l7policy', 'create_l7rule', 'create_lblistener', 'create_lbmember', 'create_lbpool', 'create_lbpool_health_monitor', 'create_loadbalancer', 'create_network', 'create_reserved_fixed_ip', 'create_router', 'create_secret', 'create_servergroup', 'create_sfs', 'create_snapshot', 'create_subnet', 'create_vm', 'create_volume', 'deactivate_ddos_profile', 'delete_ai_cluster_gpu', 'delete_caas_container', 'delete_dbaas_postgres_cluster', 'delete_ddos_profile', 'delete_faas_function', 'delete_faas_namespace', 'delete_fip', 'delete_gpu_virtual_cluster', 'delete_gpu_virtual_server', 'delete_image', 'delete_inference_instance', 'delete_k8s_cluster_pool_v2', 'delete_k8s_cluster_v2', 'delete_l7policy', 'delete_l7rule', 'delete_lblistener', 'delete_lbmember', 'delete_lbmetadata', 'delete_lbpool', 'delete_loadbalancer', 'delete_network', 'delete_reserved_fixed_ip', 'delete_router', 'delete_secret', 'delete_servergroup', 'delete_sfs', 'delete_snapshot', 'delete_subnet', 'delete_vm', 'delete_volume', 'detach_vm_interface', 'detach_volume', 'download_image', 'downscale_ai_cluster_gpu', 'downscale_gpu_virtual_cluster', 'extend_sfs', 'extend_volume', 'failover_loadbalancer', 'hard_reboot_gpu_baremetal_server', 'hard_reboot_gpu_virtual_cluster', 'hard_reboot_gpu_virtual_server', 'hard_reboot_vm', 'patch_caas_container', 'patch_dbaas_postgres_cluster', 'patch_faas_function', 'patch_faas_namespace', 'patch_lblistener', 'patch_lbpool', 'put_into_server_group', 'put_l7policy', 'put_l7rule', 'rebuild_bm', 'rebuild_gpu_baremetal_node', 'remove_from_server_group', 'replace_lbmetadata', 'resize_k8s_cluster_v2', 'resize_loadbalancer', 'resize_vm', 'resume_vm', 'revert_volume', 'soft_reboot_gpu_baremetal_server', 'soft_reboot_gpu_virtual_cluster', 'soft_reboot_gpu_virtual_server', 'soft_reboot_vm', 'start_gpu_baremetal_server', 'start_gpu_virtual_cluster', 'start_gpu_virtual_server', 'start_vm', 'stop_gpu_baremetal_server', 'stop_gpu_virtual_cluster', 'stop_gpu_virtual_server', 'stop_vm', 'suspend_vm', 'sync_private_flavors', 'update_ddos_profile', 'update_inference_instance', 'update_inference_instance_key', 'update_k8s_cluster_v2', 'update_lbmetadata', 'update_port_allowed_address_pairs', 'update_tags_gpu_virtual_cluster', 'upgrade_k8s_cluster_v2', 'upscale_ai_cluster_gpu', 'upscale_gpu_virtual_cluster']

​
to_timestamp
string | null

ISO formatted datetime string. Filter the tasks by creation date less than or equal to to_timestamp

Response

200 - application/json

OK

The response is of type object.