This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

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.

VersionStatusNot Before
1.1CURRENT-
1.0SUPPORTED20260701

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
node_pool_validation_request
required
arraynode_pool_validation_request'{"auto_scale": "", "desired_node_count": "", "max_node_count": "", "min_node_count": "", "scale_name": ""}'
cluster_id
optional
stringcluster_id-
auto_scale
optional
booleanauto_scale-
cluster_size
optional
stringcluster_size-
cpu
optional
stringcpu-
is_engine_type_private
optional
booleanis_engine_type_private-
memory
optional
stringmemory-
replica
optional
stringreplica-

Responses

NameDescriptionExample
min_spec_node_poolmin_spec_node_pool[]
resultresult

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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
node_pool_validation_request
required
arraynode_pool_validation_request'{"auto_scale": "", "desired_node_count": "", "max_node_count": "", "min_node_count": "", "scale_name": ""}'
cluster_id
optional
stringcluster_id-
auto_scale
optional
booleanauto_scale-
cluster_size
optional
stringcluster_size-
cpu
optional
stringcpu-
is_engine_type_private
optional
booleanis_engine_type_private-
memory
optional
stringmemory-
replica
optional
stringreplica-

Responses

NameDescriptionExample
min_spec_node_poolmin_spec_node_pool[]
resultresult

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_name
required
stringquick query name-

Responses

NameDescriptionExample
resultresult

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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_name
required
stringquick query name-

Responses

NameDescriptionExample
resultresult

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quickquery_version
required
stringversion-
quick_query_name
required
stringquick_query_name-
max_query
required
stringmax_query-
is_engine_type_private
required
booleanis_engine_type_private-
image_id
required
stringimage_id-
dsc_domain
required
stringdsc_domain-
domain
required
stringdomain-
vpc_id
required
stringvpc_id-
volume_id
required
stringvolume_id-
subnet_id
required
stringsubnet_id-
security_group_id_list
required
arraysecurity_group_id_list-
kubernetes_engine_name
required
stringkubernetes_engine_name-
k8s_version
required
stringk8s_version-
cloud_logging_enabled
required
booleancloud_logging_enabled-
node_pool_create_requests
required
arraynode_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
stringcifs_volume_id-
lb_id
optional
stringlb_id-
public_acl_ip_address
optional
stringpublic_acl_ip_address-
description
optional
stringdescription-
dsc_console_ip
optional
stringdsc_console_ip-
host_alias_list
optional
arrayhost_alias_list'{"hostnames": "", "ip": ""}'
instance_id
optional
stringinstance_id-
product_group_id
optional
stringproduct_group_id-
auto_scale
optional
booleanauto_scale-
cluster_size
optional
stringcluster_size-
cpu
optional
stringcpu-
memory
optional
stringmemory-
replica
optional
stringreplica-
tags
optional
arraytags'{"key": "Key", "value": "Value"}'
kubernetes_engine_create_request_tags
optional
arraytags'{"key": "Key", "value": "Value"}'

Responses

NameDescriptionExample
project_idProject ID10a599e031e749b7b260868f441e862b
request_idRequest ID10a599e031e749b7b260868f441e862b
resource_idResource ID10a599e031e749b7b260868f441e862b

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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quickquery_version
required
stringversion-
quick_query_name
required
stringquick_query_name-
max_query
required
stringmax_query-
is_engine_type_private
required
booleanis_engine_type_private-
image_id
required
stringimage_id-
dsc_domain
required
stringdsc_domain-
domain
required
stringdomain-
vpc_id
required
stringvpc_id-
volume_id
required
stringvolume_id-
subnet_id
required
stringsubnet_id-
security_group_id_list
required
arraysecurity_group_id_list-
kubernetes_engine_name
required
stringkubernetes_engine_name-
k8s_version
required
stringk8s_version-
cloud_logging_enabled
required
booleancloud_logging_enabled-
node_pool_create_requests
required
arraynode_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
stringcifs_volume_id-
lb_id
optional
stringlb_id-
public_acl_ip_address
optional
stringpublic_acl_ip_address-
description
optional
stringdescription-
dsc_console_ip
optional
stringdsc_console_ip-
host_alias_list
optional
arrayhost_alias_list'{"hostnames": "", "ip": ""}'
instance_id
optional
stringinstance_id-
product_group_id
optional
stringproduct_group_id-
auto_scale
optional
booleanauto_scale-
cluster_size
optional
stringcluster_size-
cpu
optional
stringcpu-
memory
optional
stringmemory-
replica
optional
stringreplica-
tags
optional
arraytags'{"key": "Key", "value": "Value"}'
kubernetes_engine_create_request_tags
optional
arraytags'{"key": "Key", "value": "Value"}'

Responses

NameDescriptionExample
project_idProject ID10a599e031e749b7b260868f441e862b
request_idRequest ID10a599e031e749b7b260868f441e862b
resource_idResource ID10a599e031e749b7b260868f441e862b

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
page
required
integerpage0
size
required
integersize20
sort
optional
stringsortcreated_at:desc
cluster_name
optional
stringcluster_name-
created_by
optional
stringcreated_by-
quick_query_state
optional
****state-
quickquery_version
optional
stringversion-
quick_query_name
optional
stringquick_query_name-

Responses

NameDescriptionExample
cluster_idcluster_id
cluster_namecluster_name
cluster_permissioncluster_permission
cluster_request_failedcluster_request_failed
created_bycreated_by
created_dtcreated_at
modified_bymodified_by
modified_dtmodified_at
quick_query_idquick_query_id
quick_query_namequick_query_name
quick_query_statequick_query_state
quick_query_versionquick_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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
page
required
integerpage0
size
required
integersize20
sort
optional
stringsortcreated_at:desc
cluster_name
optional
stringcluster_name-
created_by
optional
stringcreated_by-
quick_query_state
optional
****state-
quickquery_version
optional
stringversion-
quick_query_name
optional
stringquick_query_name-

Responses

NameDescriptionExample
cluster_idcluster_id
cluster_namecluster_name
cluster_permissioncluster_permission
cluster_request_failedcluster_request_failed
created_bycreated_by
created_dtcreated_at
modified_bymodified_by
modified_dtmodified_at
quick_query_idquick_query_id
quick_query_namequick_query_name
quick_query_statequick_query_state
quick_query_versionquick_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)

VersionNot Before
1.1-

Responses

NameDescriptionExample
image_attrimage_attr
image_idimage_id
image_nameimage_name
versionversion

1.6.2 - 1.0

scp-cli quick-query list quick query images

Description

get quick query image versions

State ACTIVE (SUPPORTED)

VersionNot Before
1.020260701

Responses

NameDescriptionExample
image_attrimage_attr
image_idimage_id
image_nameimage_name
versionversion

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-

Responses

NameDescriptionExample
cluster_idcluster_id
cluster_namecluster_name
cluster_permissioncluster_permission{}
cluster_request_failedcluster_request_failed
created_dtcreated_dt
descriptiondescription
domaindomain
dsc_console_domaindsc_console_domain
dsc_domaindsc_domain
dsc_oidc_domaindsc_oidc_domain
host_alias_listdomain[]
hosts_filehosts_file
is_active_imageis_active_image
is_engine_type_privateis_engine_type_private
max_querymax_query
modified_dtmodified_dt
namespace_namenamespace_name
node_informationnode_information[]
provisioning_stateprovisioning_state
query_engine_specquery_engine_spec{}
quick_query_idquick_query_id
quick_query_namequick_query_name
quick_query_statequick_query_state
quick_query_versionquick_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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-

Responses

NameDescriptionExample
cluster_idcluster_id
cluster_namecluster_name
cluster_permissioncluster_permission{}
cluster_request_failedcluster_request_failed
created_dtcreated_dt
descriptiondescription
domaindomain
dsc_console_domaindsc_console_domain
dsc_domaindsc_domain
dsc_oidc_domaindsc_oidc_domain
host_alias_listdomain[]
hosts_filehosts_file
is_active_imageis_active_image
is_engine_type_privateis_engine_type_private
max_querymax_query
modified_dtmodified_dt
namespace_namenamespace_name
node_informationnode_information[]
provisioning_stateprovisioning_state
query_engine_specquery_engine_spec{}
quick_query_idquick_query_id
quick_query_namequick_query_name
quick_query_statequick_query_state
quick_query_versionquick_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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
description
required
stringdescription-

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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
description
required
stringdescription-

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
domain
required
stringdomain-

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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
domain
required
stringdomain-

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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
dsc_domain
required
stringdsc_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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
dsc_domain
required
stringdsc_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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
replica
required
stringreplica-
memory
required
stringmemory-
cpu
required
stringcpu-
cluster_size
optional
stringcluster_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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
replica
required
stringreplica-
memory
required
stringmemory-
cpu
required
stringcpu-
cluster_size
optional
stringcluster_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)

VersionNot Before
1.1-

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
host_alias_list
optional
arrayhost_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)

VersionNot Before
1.020260701

Parameters

NameTypeDescriptionExample
quick_query_id
required
stringquick_query_id-
host_alias_list
optional
arrayhost_alias_list'{"hostnames": "", "ip": ""}'