--- title: "List tasks" method: GET path: "/cloud/v1/tasks" tags: ["Tasks"] --- # List tasks `GET /cloud/v1/tasks` ## Query parameters - `from_timestamp` string, date-time — ISO formatted datetime string. Filter the tasks by creation date greater than or equal to `from_timestamp` - `is_acknowledged` boolean — Filter the tasks by their acknowledgement status - `limit` integer — Limit the number of returned tasks. Falls back to default of 10 if not specified. Limited by max limit value of 1000 - `offset` integer — Offset value is used to exclude the first set of records from the result - `order_by` 'asc' | 'desc' - `project_id` integer[] — The project ID to filter the tasks by project. Supports multiple values of kind key=value1&key=value2 - `region_id` integer[] — The region ID to filter the tasks by region. Supports multiple values of kind key=value1&key=value2 - `sorting` 'asc' | 'desc' - `state` TaskState[] — Filter the tasks by state. Supports multiple values of kind key=value1&key=value2 - `task_type` string — 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', 'convert_fip_to_reserved_fixed_ip', 'convert_reserved_fixed_ip_to_fip', '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_application', 'create_inference_instance', '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_security_group', 'create_security_group_rule', '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_application', '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_project', 'delete_reserved_fixed_ip', 'delete_router', 'delete_secret', 'delete_security_group_rule', '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_bm', 'hard_reboot_gpu_baremetal_cluster', '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_l7rule', 'rebuild_bm', 'rebuild_gpu_baremetal_cluster', 'rebuild_gpu_baremetal_node', 'rebuild_gpu_baremetal_server', 'remove_from_server_group', 'replace_gpu_baremetal_server', 'replace_lbmetadata', 'resize_k8s_cluster_v2', 'resize_loadbalancer', 'resize_vm', 'resume_vm', 'revert_volume', 'soft_reboot_bm', 'soft_reboot_gpu_baremetal_cluster', 'soft_reboot_gpu_baremetal_server', 'soft_reboot_gpu_virtual_cluster', 'soft_reboot_gpu_virtual_server', 'soft_reboot_vm', 'start_bm', 'start_gpu_baremetal_cluster', 'start_gpu_baremetal_server', 'start_gpu_virtual_cluster', 'start_gpu_virtual_server', 'start_vm', 'stop_bm', 'stop_gpu_baremetal_cluster', 'stop_gpu_baremetal_server', 'stop_gpu_virtual_cluster', 'stop_gpu_virtual_server', 'stop_vm', 'suspend_vm', 'sync_private_flavors', 'update_ddos_profile', 'update_floating_ip', 'update_inference_application', 'update_inference_instance', 'update_k8s_cluster_v2', 'update_l7policy', 'update_lbmetadata', 'update_loadbalancer', 'update_port_allowed_address_pairs', 'update_router', 'update_security_group', 'update_sfs', 'update_tags_gpu_virtual_cluster', 'upgrade_k8s_cluster_v2', 'upscale_ai_cluster_gpu', 'upscale_gpu_virtual_cluster'] - `to_timestamp` string, date-time — ISO formatted datetime string. Filter the tasks by creation date less than or equal to `to_timestamp` ## Response `200` OK - TaskCollectionSerializer - `count` integer, required — Number of objects - `results` TaskSerializer[], required — Objects - `acknowledged_at` string, nullable — If task was acknowledged, this field stores acknowledge timestamp - `acknowledged_by` integer, nullable — If task was acknowledged, this field stores `user_id` of the person - `client_id` integer, nullable — The client ID - `created_on` string, nullable, required — Created timestamp - `created_resources` CreatedResources - `ai_clusters` string[] — Deprecated, use 'clusters' instead. IDs of created GPU clusters - `api_keys` string[] — IDs of created API keys - `caas_containers` string[] — IDs of created CaaS containers - `clusters` string[] — IDs of created GPU clusters - `ddos_profiles` integer[] — IDs of created ddos protection profiles - `faas_functions` string[] — IDs of created FaaS functions - `faas_namespaces` string[] — IDs of created FaaS namespaces - `file_shares` string[] — IDs of created file shares - `floatingips` string[] — IDs of created floating IPs - `healthmonitors` string[] — IDs of created health monitors - `images` string[] — IDs of created images - `inference_instances` string[] — IDs of created inference instances - `instances` string[] — IDs of created instances - `k8s_clusters` string[] — IDs of created Kubernetes clusters - `k8s_pools` string[] — IDs of created Kubernetes pools - `l7polices` string[] — IDs of created L7 policies - `l7rules` string[] — IDs of created L7 rules - `laas_topic` string[] — IDs of created LaaS topics - `listeners` string[] — IDs of created load balancer listeners - `loadbalancers` string[] — IDs of created load balancers - `members` string[] — IDs of created pool members - `networks` string[] — IDs of created networks - `pools` string[] — IDs of created load balancer pools - `ports` string[] — IDs of created ports - `postgresql_clusters` string[] — IDs of created postgres clusters - `projects` integer[] — IDs of created projects - `registry_registries` string[] — IDs of created registry registries - `registry_users` string[] — IDs of created registry users - `routers` string[] — IDs of created routers - `secrets` string[] — IDs of created secrets - `security_group_rules` string[] — IDs of created security group rules - `security_groups` string[] — IDs of created security groups - `servergroups` string[] — IDs of created server groups - `snapshots` string[] — IDs of created volume snapshots - `subnets` string[] — IDs of created subnets - `volumes` string[] — IDs of created volumes - `data` unknown - `detailed_state` '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, nullable — The error value - `finished_on` string, nullable — Finished timestamp - `id` string, required — The task ID - `job_id` string, nullable — Job ID - `lifecycle_policy_id` integer, nullable — Lifecycle policy ID - `project_id` integer, nullable — The project ID - `region_id` integer, nullable — The region ID - `request_id` string, nullable — The request ID - `schedule_id` string, nullable — Schedule ID - `state` 'ERROR' | 'FINISHED' | 'NEW' | 'RUNNING', required - `task_type` string, required — The task type - `updated_on` string, nullable — Last updated timestamp - `user_client_id` integer, nullable — Client, specified in user's JWT - `user_id` integer, required — The user ID that initiated the task --- [API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)