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 | SUPPORTED | 20260701 |
1 - CLIs
1.1 - CheckClusterResourceSizeForQuickQuery
1.1.1 - 1.1
scp-cli 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 |
|---|
| min_spec_node_pool | min_spec_node_pool | [] |
| result | result | |
1.1.2 - 1.0
scp-cli 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 (SUPPORTED)
| 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 |
|---|
| min_spec_node_pool | min_spec_node_pool | [] |
| result | result | |
1.2 - CheckDuplicationQuickQueryName
1.2.1 - 1.1
scp-cli 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
scp-cli 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 (SUPPORTED)
| 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
scp-cli 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>
[--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>]
[--tags <value>]
[--kubernetes_engine_create_request_tags <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": ""}' |
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 | - |
tags optional | array | tags | '{"key": "Key", "value": "Value"}' |
kubernetes_engine_create_request_tags optional | array | tags | '{"key": "Key", "value": "Value"}' |
Responses
| Name | Description | Example |
|---|
| project_id | Project ID | 10a599e031e749b7b260868f441e862b |
| request_id | Request ID | 10a599e031e749b7b260868f441e862b |
| resource_id | Resource ID | 10a599e031e749b7b260868f441e862b |
1.3.2 - 1.0
scp-cli 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>
[--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>]
[--tags <value>]
[--kubernetes_engine_create_request_tags <value>]
Description
Create Quick Query.
State
ACTIVE (SUPPORTED)
| 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": ""}' |
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 | - |
tags optional | array | tags | '{"key": "Key", "value": "Value"}' |
kubernetes_engine_create_request_tags optional | array | tags | '{"key": "Key", "value": "Value"}' |
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
scp-cli 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
scp-cli quick-query delete quick query
--quick_query_id <value>
Description
delete quick query
State
ACTIVE (SUPPORTED)
| 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
scp-cli 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
scp-cli 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 (SUPPORTED)
| 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
scp-cli 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
scp-cli quick-query list quick query images
Description
get quick query image versions
State
ACTIVE (SUPPORTED)
| 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
scp-cli 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 |
|---|
| cluster_id | cluster_id | |
| cluster_name | cluster_name | |
| cluster_permission | cluster_permission | {} |
| cluster_request_failed | cluster_request_failed | |
| created_dt | created_dt | |
| description | description | |
| domain | domain | |
| dsc_console_domain | dsc_console_domain | |
| dsc_domain | dsc_domain | |
| dsc_oidc_domain | dsc_oidc_domain | |
| host_alias_list | domain | [] |
| hosts_file | hosts_file | |
| is_active_image | is_active_image | |
| is_engine_type_private | is_engine_type_private | |
| max_query | max_query | |
| modified_dt | modified_dt | |
| namespace_name | namespace_name | |
| node_information | node_information | [] |
| provisioning_state | provisioning_state | |
| query_engine_spec | query_engine_spec | {} |
| 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.7.2 - 1.0
scp-cli quick-query show quick query
--quick_query_id <value>
Description
Get Quick Query details.
State
ACTIVE (SUPPORTED)
| Version | Not Before |
|---|
| 1.0 | 20260701 |
Parameters
| Name | Type | Description | Example |
|---|
quick_query_id required | string | quick_query_id | - |
Responses
| Name | Description | Example |
|---|
| cluster_id | cluster_id | |
| cluster_name | cluster_name | |
| cluster_permission | cluster_permission | {} |
| cluster_request_failed | cluster_request_failed | |
| created_dt | created_dt | |
| description | description | |
| domain | domain | |
| dsc_console_domain | dsc_console_domain | |
| dsc_domain | dsc_domain | |
| dsc_oidc_domain | dsc_oidc_domain | |
| host_alias_list | domain | [] |
| hosts_file | hosts_file | |
| is_active_image | is_active_image | |
| is_engine_type_private | is_engine_type_private | |
| max_query | max_query | |
| modified_dt | modified_dt | |
| namespace_name | namespace_name | |
| node_information | node_information | [] |
| provisioning_state | provisioning_state | |
| query_engine_spec | query_engine_spec | {} |
| 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.8 - UpdateQuickQueryDescription
1.8.1 - 1.1
scp-cli 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
scp-cli quick-query update quick query description
--quick_query_id <value>
--description <value>
Description
update quick query description
State
ACTIVE (SUPPORTED)
| 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
scp-cli 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
scp-cli quick-query update quick query domain
--quick_query_id <value>
--domain <value>
Description
update quick query domain
State
ACTIVE (SUPPORTED)
| 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
scp-cli 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
scp-cli quick-query update quick query dsc domain
--quick_query_id <value>
--dsc_domain <value>
Description
update quick query dsc domain
State
ACTIVE (SUPPORTED)
| 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
scp-cli 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
scp-cli 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 (SUPPORTED)
| 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
scp-cli 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
scp-cli quick-query update quick query host alias
--quick_query_id <value>
[--host_alias_list <value>]
Description
update quick query host alias
State
ACTIVE (SUPPORTED)
| 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": ""}' |