Tasks
get/cloud/v1/tasks

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cloud/v1/tasks
  • Auth
    HTTP apikey

Query parameters

from_timestampstring date-time

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

is_acknowledgedboolean

Filter the tasks by their acknowledgement status

limitinteger

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

Example:100
offsetinteger

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

order_by'asc' | 'desc'

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

project_idinteger[]

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

region_idinteger[]

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

sorting'asc' | 'desc'

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

stateTaskState[]

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

task_typestring

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_port_to_fip', 'convert_reserved_fixed_ip_to_fip', 'create_ai_cluster_gpu', 'create_basic_vm', '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_port', 'create_reserved_fixed_ip', 'create_router', 'create_secret', 'create_security_group', 'create_security_group_rule', 'create_servergroup', 'create_sfs', 'create_slurm_cluster', 'create_slurm_node_set', 'create_snapshot', 'create_subnet', 'create_vm', 'create_volume', 'deactivate_ddos_profile', 'delete_ai_cluster_gpu', 'delete_basic_vm', 'delete_bm', '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_port', 'delete_project', 'delete_reserved_fixed_ip', 'delete_router', 'delete_secret', 'delete_security_group_rule', 'delete_servergroup', 'delete_sfs', 'delete_slurm_cluster', 'delete_slurm_node_set', '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_basic_vm', 'update_bm', 'update_ddos_profile', 'update_floating_ip', 'update_inference_application', 'update_inference_instance', 'update_k8s_cluster_v2', 'update_l7policy', 'update_lbmember', 'update_lbmetadata', 'update_lbpool_health_monitor', 'update_loadbalancer', 'update_network', 'update_port', 'update_port_allowed_address_pairs', 'update_router', 'update_security_group', 'update_sfs', 'update_slurm_cluster', 'update_slurm_node_set', 'update_tags_gpu_virtual_cluster', 'update_vm', 'upgrade_k8s_cluster_v2', 'upscale_ai_cluster_gpu', 'upscale_gpu_virtual_cluster']

to_timestampstring date-time

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

Response

OK

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "acknowledged_by": 123,
      "client_id": 123,
      "created_on": "2019-06-25T08:42:42Z",
      "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
      },
      "id": "26986bc0-748a-4448-b836-0a2aa465eb06",
      "project_id": 123,
      "region_id": 123,
      "task_type": "create_vm",
      "user_client_id": 123,
      "user_id": 123
    }
  ]
}

Changes

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      removed subschema #1 subschema #2 from the // response property anyOf list for the response status