Quick Query
Overview
Provides a Command-line Interface (CLI) that supports programmatic use of IaaS/PaaS products provided by SCP.
This guide provides a brief description of Quick Query service and how to call CLI.
Version
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Status | Not Before |
|---|
| 1.1 | CURRENT | - |
| 1.0 | DEPRECATED | 20260701 |
1 - CLIs
1.1 - CheckClusterResourceSizeForQuickQuery
1.1.1 - 1.1
scpcli quick-query check resource validation
--node_pool_validation_request <value>
[--cluster_id <value>]
[--auto_scale <value>]
[--cluster_size <value>]
[--cpu <value>]
[--is_engine_type_private <value>]
[--memory <value>]
[--replica <value>]
Description
Check if resource is verified to be modified/created
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
node_pool_validation_request required | array | node_pool_validation_request | '{"auto_scale": "", "desired_node_count": "", "max_node_count": "", "min_node_count": "", "scale_name": ""}' |
cluster_id optional | string | cluster_id | - |
auto_scale optional | boolean | auto_scale | - |
cluster_size optional | string | cluster_size | - |
cpu optional | string | cpu | - |
is_engine_type_private optional | boolean | is_engine_type_private | - |
memory optional | string | memory | - |
replica optional | string | replica | - |
Responses
| Name | Description | Example |
|---|
| cpu | cpu | |
| is_node_pool_auto_scalable | is_node_pool_auto_scalable | |
| memory | memory | |
| replica | replica | |
1.1.2 - 1.0
scpcli quick-query check resource validation
--node_pool_validation_request <value>
[--cluster_id <value>]
[--auto_scale <value>]
[--cluster_size <value>]
[--cpu <value>]
[--is_engine_type_private <value>]
[--memory <value>]
[--replica <value>]
Description
Check if resource is verified to be modified/created
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
node_pool_validation_request required | array | node_pool_validation_request | '{"auto_scale": "", "desired_node_count": "", "max_node_count": "", "min_node_count": "", "scale_name": ""}' |
cluster_id optional | string | cluster_id | - |
auto_scale optional | boolean | auto_scale | - |
cluster_size optional | string | cluster_size | - |
cpu optional | string | cpu | - |
is_engine_type_private optional | boolean | is_engine_type_private | - |
memory optional | string | memory | - |
replica optional | string | replica | - |
Responses
| Name | Description | Example |
|---|
| cpu | cpu | |
| is_node_pool_auto_scalable | is_node_pool_auto_scalable | |
| memory | memory | |
| replica | replica | |
1.2 - CheckDuplicationQuickQueryName
1.2.1 - 1.1
scpcli quick-query check quick query duplication
--quick_query_name <value>
Description
Check Duplication Quick Query Name. (false: no duplicate value, true: duplicate value)
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_name required | string | quick query name | - |
Responses
| Name | Description | Example |
|---|
| result | result | |
1.2.2 - 1.0
scpcli quick-query check quick query duplication
--quick_query_name <value>
Description
Check Duplication Quick Query Name. (false: no duplicate value, true: duplicate value)
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_name required | string | quick query name | - |
Responses
| Name | Description | Example |
|---|
| result | result | |
1.3 - CreateQuickQuery
1.3.1 - 1.1
scpcli quick-query create quick query
--quickquery_version <value>
--quick_query_name <value>
--max_query <value>
--is_engine_type_private <value>
--image_id <value>
--dsc_domain <value>
--domain <value>
--vpc_id <value>
--volume_id <value>
--subnet_id <value>
--security_group_id_list <value>
--kubernetes_engine_name <value>
--k8s_version <value>
--cloud_logging_enabled <value>
--node_pool_create_requests <value>
[--tags <value>]
[--cifs_volume_id <value>]
[--lb_id <value>]
[--public_acl_ip_address <value>]
[--description <value>]
[--dsc_console_ip <value>]
[--host_alias_list <value>]
[--instance_id <value>]
[--product_group_id <value>]
[--auto_scale <value>]
[--cluster_size <value>]
[--cpu <value>]
[--memory <value>]
[--replica <value>]
Description
Create Quick Query.
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quickquery_version required | string | version | - |
quick_query_name required | string | quick_query_name | - |
max_query required | string | max_query | - |
is_engine_type_private required | boolean | is_engine_type_private | - |
image_id required | string | image_id | - |
dsc_domain required | string | dsc_domain | - |
domain required | string | domain | - |
vpc_id required | string | vpc_id | - |
volume_id required | string | volume_id | - |
subnet_id required | string | subnet_id | - |
security_group_id_list required | array | security_group_id_list | - |
kubernetes_engine_name required | string | kubernetes_engine_name | - |
k8s_version required | string | k8s_version | - |
cloud_logging_enabled required | boolean | cloud_logging_enabled | - |
node_pool_create_requests required | array | node_pool_create_requests | '{"auto_recovery": false, "auto_scale": false, "desired_node_count": "", "image_os": "", "image_os_version": "", "k8s_version": "", "keypair_name": "", "max_node_count": "", "min_node_count": "", "name": "", "scale_name": "", "volume_size": "", "volume_type_name": ""}' |
tags optional | array | tags | '{"key": "Key", "value": "Value"}' |
cifs_volume_id optional | string | cifs_volume_id | - |
lb_id optional | string | lb_id | - |
public_acl_ip_address optional | string | public_acl_ip_address | - |
description optional | string | description | - |
dsc_console_ip optional | string | dsc_console_ip | - |
host_alias_list optional | array | host_alias_list | '{"hostnames": "", "ip": ""}' |
instance_id optional | string | instance_id | - |
product_group_id optional | string | product_group_id | - |
auto_scale optional | boolean | auto_scale | - |
cluster_size optional | string | cluster_size | - |
cpu optional | string | cpu | - |
memory optional | string | memory | - |
replica optional | string | replica | - |
Responses
| Name | Description | Example |
|---|
| project_id | Project ID | 10a599e031e749b7b260868f441e862b |
| request_id | Request ID | 10a599e031e749b7b260868f441e862b |
| resource_id | Resource ID | 10a599e031e749b7b260868f441e862b |
1.3.2 - 1.0
scpcli quick-query create quick query
--quickquery_version <value>
--quick_query_name <value>
--max_query <value>
--is_engine_type_private <value>
--image_id <value>
--dsc_domain <value>
--domain <value>
--vpc_id <value>
--volume_id <value>
--subnet_id <value>
--security_group_id_list <value>
--kubernetes_engine_name <value>
--k8s_version <value>
--cloud_logging_enabled <value>
--node_pool_create_requests <value>
[--tags <value>]
[--cifs_volume_id <value>]
[--lb_id <value>]
[--public_acl_ip_address <value>]
[--description <value>]
[--dsc_console_ip <value>]
[--host_alias_list <value>]
[--instance_id <value>]
[--product_group_id <value>]
[--auto_scale <value>]
[--cluster_size <value>]
[--cpu <value>]
[--memory <value>]
[--replica <value>]
Description
Create Quick Query.
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quickquery_version required | string | version | - |
quick_query_name required | string | quick_query_name | - |
max_query required | string | max_query | - |
is_engine_type_private required | boolean | is_engine_type_private | - |
image_id required | string | image_id | - |
dsc_domain required | string | dsc_domain | - |
domain required | string | domain | - |
vpc_id required | string | vpc_id | - |
volume_id required | string | volume_id | - |
subnet_id required | string | subnet_id | - |
security_group_id_list required | array | security_group_id_list | - |
kubernetes_engine_name required | string | kubernetes_engine_name | - |
k8s_version required | string | k8s_version | - |
cloud_logging_enabled required | boolean | cloud_logging_enabled | - |
node_pool_create_requests required | array | node_pool_create_requests | '{"auto_recovery": false, "auto_scale": false, "desired_node_count": "", "image_os": "", "image_os_version": "", "k8s_version": "", "keypair_name": "", "max_node_count": "", "min_node_count": "", "name": "", "scale_name": "", "volume_size": "", "volume_type_name": ""}' |
tags optional | array | tags | '{"key": "Key", "value": "Value"}' |
cifs_volume_id optional | string | cifs_volume_id | - |
lb_id optional | string | lb_id | - |
public_acl_ip_address optional | string | public_acl_ip_address | - |
description optional | string | description | - |
dsc_console_ip optional | string | dsc_console_ip | - |
host_alias_list optional | array | host_alias_list | '{"hostnames": "", "ip": ""}' |
instance_id optional | string | instance_id | - |
product_group_id optional | string | product_group_id | - |
auto_scale optional | boolean | auto_scale | - |
cluster_size optional | string | cluster_size | - |
cpu optional | string | cpu | - |
memory optional | string | memory | - |
replica optional | string | replica | - |
Responses
| Name | Description | Example |
|---|
| project_id | Project ID | 10a599e031e749b7b260868f441e862b |
| request_id | Request ID | 10a599e031e749b7b260868f441e862b |
| resource_id | Resource ID | 10a599e031e749b7b260868f441e862b |
1.4 - DeleteQuickQuery
1.4.1 - 1.1
scpcli quick-query delete quick query
--quick_query_id <value>
Description
delete quick query
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
1.4.2 - 1.0
scpcli quick-query delete quick query
--quick_query_id <value>
Description
delete quick query
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
1.5 - ListQuickQuery
1.5.1 - 1.1
scpcli quick-query list quick query
--page <value>
--size <value>
[--sort <value>]
[--cluster_name <value>]
[--created_by <value>]
[--quick_query_state <value>]
[--quickquery_version <value>]
[--quick_query_name <value>]
Description
get quick query list console
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
page required | integer | page | 0 |
size required | integer | size | 20 |
sort optional | string | sort | created_at:desc |
cluster_name optional | string | cluster_name | - |
created_by optional | string | created_by | - |
quick_query_state optional | **** | state | - |
quickquery_version optional | string | version | - |
quick_query_name optional | string | quick_query_name | - |
Responses
| Name | Description | Example |
|---|
| cluster_id | cluster_id | |
| cluster_name | cluster_name | |
| cluster_permission | cluster_permission | |
| cluster_request_failed | cluster_request_failed | |
| created_by | created_by | |
| created_dt | created_at | |
| modified_by | modified_by | |
| modified_dt | modified_at | |
| quick_query_id | quick_query_id | |
| quick_query_name | quick_query_name | |
| quick_query_state | quick_query_state | |
| quick_query_version | quick_query_version | |
1.5.2 - 1.0
scpcli quick-query list quick query
--page <value>
--size <value>
[--sort <value>]
[--cluster_name <value>]
[--created_by <value>]
[--quick_query_state <value>]
[--quickquery_version <value>]
[--quick_query_name <value>]
Description
get quick query list console
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
page required | integer | page | 0 |
size required | integer | size | 20 |
sort optional | string | sort | created_at:desc |
cluster_name optional | string | cluster_name | - |
created_by optional | string | created_by | - |
quick_query_state optional | **** | state | - |
quickquery_version optional | string | version | - |
quick_query_name optional | string | quick_query_name | - |
Responses
| Name | Description | Example |
|---|
| cluster_id | cluster_id | |
| cluster_name | cluster_name | |
| cluster_permission | cluster_permission | |
| cluster_request_failed | cluster_request_failed | |
| created_by | created_by | |
| created_dt | created_at | |
| modified_by | modified_by | |
| modified_dt | modified_at | |
| quick_query_id | quick_query_id | |
| quick_query_name | quick_query_name | |
| quick_query_state | quick_query_state | |
| quick_query_version | quick_query_version | |
1.6 - ListQuickQueryImages
1.6.1 - 1.1
scpcli quick-query list quick query images
Description
get quick query image versions
State
ACTIVE (CURRENT)
Responses
| Name | Description | Example |
|---|
| image_attr | image_attr | |
| image_id | image_id | |
| image_name | image_name | |
| version | version | |
1.6.2 - 1.0
scpcli quick-query list quick query images
Description
get quick query image versions
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Responses
| Name | Description | Example |
|---|
| image_attr | image_attr | |
| image_id | image_id | |
| image_name | image_name | |
| version | version | |
1.7 - ShowQuickQuery
1.7.1 - 1.1
scpcli quick-query show quick query
--quick_query_id <value>
Description
Get Quick Query details.
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
Responses
| Name | Description | Example |
|---|
| age | age | |
| cluster_id | cluster id | |
| container_version | Container Version | |
| created_at | created at | |
| external_ip_address | External IP Address | |
| gpu_name | GPU Name | |
| ip | IP | |
| kernel_version | Kernel Version | |
| kubernetes_version | Kubernetes Version | |
| name | name | |
| node_capacities | Node Capacities | |
| node_status | node status | |
| number_of_allocated_pods | Number of allocated pods | |
| number_of_gpu | Number of GPU | |
| os_image | OS Image | |
| uid | uid | |
1.7.2 - 1.0
scpcli quick-query show quick query
--quick_query_id <value>
Description
Get Quick Query details.
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
Responses
| Name | Description | Example |
|---|
| age | age | |
| cluster_id | cluster id | |
| container_version | Container Version | |
| created_at | created at | |
| external_ip_address | External IP Address | |
| gpu_name | GPU Name | |
| ip | IP | |
| kernel_version | Kernel Version | |
| kubernetes_version | Kubernetes Version | |
| name | name | |
| node_capacities | Node Capacities | |
| node_status | node status | |
| number_of_allocated_pods | Number of allocated pods | |
| number_of_gpu | Number of GPU | |
| os_image | OS Image | |
| uid | uid | |
1.8 - UpdateQuickQueryDescription
1.8.1 - 1.1
scpcli quick-query update quick query description
--quick_query_id <value>
--description <value>
Description
update quick query description
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
description required | string | description | - |
1.8.2 - 1.0
scpcli quick-query update quick query description
--quick_query_id <value>
--description <value>
Description
update quick query description
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
description required | string | description | - |
1.9 - UpdateQuickQueryDomain
1.9.1 - 1.1
scpcli quick-query update quick query domain
--quick_query_id <value>
--domain <value>
Description
update quick query domain
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
domain required | string | domain | - |
1.9.2 - 1.0
scpcli quick-query update quick query domain
--quick_query_id <value>
--domain <value>
Description
update quick query domain
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
domain required | string | domain | - |
1.10 - UpdateQuickQueryDscDomain
1.10.1 - 1.1
scpcli quick-query update quick query dsc domain
--quick_query_id <value>
--dsc_domain <value>
Description
update quick query dsc domain
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
dsc_domain required | string | dsc_domain | - |
1.10.2 - 1.0
scpcli quick-query update quick query dsc domain
--quick_query_id <value>
--dsc_domain <value>
Description
update quick query dsc domain
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
dsc_domain required | string | dsc_domain | - |
1.11 - UpdateQuickQueryEngine
1.11.1 - 1.1
scpcli quick-query update quick query engine
--quick_query_id <value>
--replica <value>
--memory <value>
--cpu <value>
[--cluster_size <value>]
Description
update quick query engine
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
replica required | string | replica | - |
memory required | string | memory | - |
cpu required | string | cpu | - |
cluster_size optional | string | cluster_size | - |
1.11.2 - 1.0
scpcli quick-query update quick query engine
--quick_query_id <value>
--replica <value>
--memory <value>
--cpu <value>
[--cluster_size <value>]
Description
update quick query engine
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
replica required | string | replica | - |
memory required | string | memory | - |
cpu required | string | cpu | - |
cluster_size optional | string | cluster_size | - |
1.12 - UpdateQuickQueryHostAlias
1.12.1 - 1.1
scpcli quick-query update quick query host alias
--quick_query_id <value>
[--host_alias_list <value>]
Description
update quick query host alias
State
ACTIVE (CURRENT)
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
host_alias_list optional | array | host_alias_list | '{"hostnames": "", "ip": ""}' |
1.12.2 - 1.0
scpcli quick-query update quick query host alias
--quick_query_id <value>
[--host_alias_list <value>]
Description
update quick query host alias
State
ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
host_alias_list optional | array | host_alias_list | '{"hostnames": "", "ip": ""}' |