Event Streams
Overview
SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.
본 가이드는 Event Streams 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다.
API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.
Version
| Version | Status | Supported Until |
|---|
| 1.0 | CURRENT | - |
OpenAPI URL
https://eventstreams.{region}.{environment}.samsungsdscloud.com
Environment and Region List
| environment | region |
|---|
| s | kr-west1 |
| s | kr-east1 |
| g | kr-south1 |
| g | kr-south2 |
| g | kr-south3 |
| e | kr-west1 |
| e | kr-east1 |
1 - APIs
1.1 - Add Instances
1.1.1 - 1.0
post /v1/clusters/{cluster_id}/add-instances
Description
Add Instances.
상태
ACTIVE (CURRENT)
Parameters
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/add-instances
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
{
"instance_count": "",
"public_ip_ids": [
""
],
"service_ip_addresses": [
""
]
}
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.2 - Create Cluster
1.2.1 - 1.0
post /v1/clusters
Description
Create Cluster.
상태
ACTIVE (CURRENT)
Parameters
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
{
"akhq_enabled": false,
"allowable_ip_addresses": [],
"dbaas_engine_version_id": "",
"init_config_option": {
"akhq_id": "",
"akhq_password": "",
"broker_port": 9091,
"broker_sasl_id": "",
"broker_sasl_password": "",
"zookeeper_port": 2180,
"zookeeper_sasl_id": "",
"zookeeper_sasl_password": ""
},
"instance_groups": [
{
"block_storage_groups": [
{
"role_type": "",
"size_gb": 104,
"volume_type": "SSD"
}
],
"instances": [
{
"public_ip_id": "",
"role_type": "ACTIVE",
"service_ip_address": ""
}
],
"role_type": "ACTIVE",
"server_type_name": ""
}
],
"instance_name_prefix": "",
"is_combined": false,
"maintenance_option": {
"period_hour": "",
"starting_day_of_week": "MON",
"starting_time": ""
},
"name": "",
"nat_enabled": false,
"subnet_id": "",
"tags": [],
"timezone": ""
}
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.3 - List Clusters
1.3.1 - 1.0
get /v1/clusters
Description
List Clusters.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| query | size optional | size Example : 20
| any of [integer, null] | 20 |
| query | page optional | page Example : 0
| any of [integer, null] | 0 |
| query | sort optional | sort Example : created_at:desc
| any of [string, null] | name:asc |
| query | name optional | Cluster name Example :
| any of [string, null] | None |
| query | service_state optional | Service state Example :
| any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 200 | OK | ClusterPageResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"account_id": "",
"created_at": "2024-05-17T00:23:17Z",
"created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
"ha_enabled": false,
"id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
"instance_count": 0,
"modified_at": "2024-05-17T00:23:17Z",
"modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
"name": "",
"role_type": "ORIGIN",
"service_state": "RUNNING"
}
],
"count": 20,
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
1.4 - List Engine Version Properties
1.4.1 - 1.0
get /v1/engine-versions/{dbaas_engine_version_id}/properties
Description
List Engine Version Properties.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | dbaas_engine_version_id required | DBaaS engine version ID Example :
| string | None |
Responses
Example HTTP request
Request path
/v1/engine-versions/{dbaas_engine_version_id}/properties
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"name": "",
"value": ""
}
]
}
1.5 - List Engine Versions
1.5.1 - 1.0
get /v1/engine-versions
Description
List Engine Versions.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| query | id optional | DBaaS engine version ID Example :
| any of [string, null] | None |
| query | product_image_type optional | Product image type Example :
| any of [enum (PostgreSQL Community, MariaDB Community, MySQL Community, EPAS, Microsoft SQL Server Enterprise, Microsoft SQL Server Standard, Redis OSS Sentinel, Valkey Sentinel, Kafka, Elasticsearch Enterprise, OpenSearch, Vertica Enterprise, Vertica Community, Scalable DB MariaDB Community), null] | None |
| query | eos_included optional | EoS included Example : False
| boolean | False |
Responses
| HTTP Code | Description | Schema |
|---|
| 200 | OK | EngineListResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/engine-versions
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"end_of_service": false,
"id": "",
"major_version": "",
"name": "",
"os_type": "",
"os_version": "",
"product_image_type": "",
"software_version": ""
}
]
}
1.6 - List Parameter Groups
1.6.1 - 1.0
get /v1/parameter-groups
Description
List Parameter Groups.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| query | major_version optional | Software major version Example :
| any of [string, null] | None |
| query | product_image_type optional | Product image type Example :
| any of [string, null] | None |
| query | sort optional | sort Example : created_at:desc
| any of [string, null] | name:asc |
Responses
Example HTTP request
Request path
/v1/parameter-groups
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"id": "",
"major_version": "",
"name": "",
"product_image_type": "",
"product_type": ""
}
],
"sort": [
""
]
}
1.7 - List Parameter Values
1.7.1 - 1.0
get /v1/clusters/{cluster_id}/parameters
Description
List Parameter Values.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
Example HTTP request
Request path
/v1/clusters/{cluster_id}/parameters
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"allows_value": "",
"applied_value": "",
"apply_type": "",
"data_type": "",
"default_value": "",
"description": "",
"id": "",
"is_modifiable": "",
"name": "",
"software_type": ""
}
],
"count": "",
"modified_at": ""
}
1.8 - List Parameters
1.8.1 - 1.0
get /v1/parameters
Description
List Parameters.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| query | size optional | size Example : 20
| any of [integer, null] | 20 |
| query | page optional | page Example : 0
| any of [integer, null] | 0 |
| query | sort optional | sort Example : created_at:desc
| any of [string, null] | name:asc |
| query | dbaas_parameter_group_id required | Parameter group ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 200 | OK | ParameterPageResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/parameters?dbaas_parameter_group_id={dbaas_parameter_group_id}
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"dbaas_parameter_group_id": "",
"default_value": "",
"description": "",
"id": "",
"name": "",
"software_type": ""
}
],
"count": 20,
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
1.9 - List Server Types
1.9.1 - 1.0
get /v1/server-types
Description
List Server Types.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| query | name optional | Server type name Example :
| any of [string, null] | None |
| query | product_image_type optional | Product image type Example :
| any of [string, null] | None |
Responses
Example HTTP request
Request path
/v1/server-types
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"contents": [
{
"cpu_core": "",
"description": "",
"memory_gb": "",
"name": "",
"product_image_type": "",
"product_type": "",
"purpose": "",
"type": ""
}
]
}
1.10 - Restart Cluster
1.10.1 - 1.0
post /v1/clusters/{cluster_id}/restart
Description
Restart Cluster.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/restart
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.11 - Set Block Storage Size
1.11.1 - 1.0
post /v1/block-storage-groups/{block_storage_group_id}/resize
Description
Set Block Storage Size.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | block_storage_group_id required | Block storage group ID Example : afc33891202643ba8ba1a5298a1affff
| string | None |
| body | body required |
| ResizeBlockStorageGroupRequest | |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 500 | Internal Server Error | None |
Example HTTP request
Request path
/v1/block-storage-groups/{block_storage_group_id}/resize
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.12 - Set Maintenance
1.12.1 - 1.0
post /v1/clusters/{cluster_id}/maintenance
Description
Set Maintenance.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
| body | body required |
| MaintenanceRequest | |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/maintenance
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
{
"start_day_of_week": "MON",
"start_minute": "",
"start_time": "",
"term_hour": ""
}
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.13 - Set Parameter Values
1.13.1 - 1.0
put /v1/clusters/{cluster_id}/parameters
Description
Set Parameter Values.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
| body | body required |
| ParametersRequest | |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/parameters
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
{
"parameters": [
{
"id": "",
"new_value": "",
"old_value": ""
}
]
}
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.14 - Set Security Group Rules
1.14.1 - 1.0
post /v1/clusters/{cluster_id}/security-group-rules
Description
Set Security Group Rules.
상태
ACTIVE (CURRENT)
Parameters
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 500 | Internal Server Error | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/security-group-rules
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
{
"add_ip_addresses": [],
"del_ip_addresses": []
}
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.15 - Set Server Type
1.15.1 - 1.0
post /v1/instance-groups/{instance_group_id}/resize
Description
Set Server Type.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | instance_group_id required | Instance group ID Example :
| string | None |
| body | body required |
| InstanceGroupResizeRequest | |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 500 | Internal Server Error | None |
Example HTTP request
Request path
/v1/instance-groups/{instance_group_id}/resize
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Request body
{
"server_type_name": ""
}
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.16 - Show Cluster
1.16.1 - 1.0
get /v1/clusters/{cluster_id}
Description
Show Cluster.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
Example HTTP request
Request path
/v1/clusters/{cluster_id}
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"account_id": "",
"allowable_ip_addresses": [],
"created_at": "2024-05-17T00:23:17Z",
"created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
"dbaas_engine": "",
"dbaas_engine_version_name": "",
"id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
"init_config_option": {
"broker_port": 9091,
"zookeeper_port": 2180
},
"instance_count": 0,
"instance_groups": [
{
"block_storage_groups": [
{
"id": "",
"name": "",
"role_type": "OS",
"size_gb": "",
"volume_type": "SSD"
}
],
"id": "",
"instances": [
{
"name": "",
"public_ip_address": "",
"public_ip_id": "",
"role_type": "",
"service_ip_address": "",
"service_state": "RUNNING"
}
],
"role_type": "",
"server_type_name": ""
}
],
"is_combined": "",
"maintenance_option": {
"period_hour": "",
"starting_day_of_week": "MON",
"starting_time": "",
"use_maintenance_option": false
},
"modified_at": "2024-05-17T00:23:17Z",
"modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
"name": "",
"nat_enabled": "",
"product_image_type": "",
"product_type": "Event Streams",
"role_type": "ORIGIN",
"service_state": "RUNNING",
"software_version": "",
"subnet_id": "",
"timezone": ""
}
1.17 - Show Request
1.17.1 - 1.0
get /v1/requests/{request_id}
Description
Show Request.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | request_id required | Request ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 200 | OK | RequestStateResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/requests/{request_id}
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 200
{
"request_id": "",
"state": ""
}
1.18 - Start Cluster
1.18.1 - 1.0
post /v1/clusters/{cluster_id}/start
Description
Start Cluster.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/start
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.19 - Stop Cluster
1.19.1 - 1.0
post /v1/clusters/{cluster_id}/stop
Description
Stop Cluster.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/stop
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.20 - Synchronize Cluster State
1.20.1 - 1.0
post /v1/clusters/{cluster_id}/sync-state
Description
Synchronize Cluster State.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 500 | Internal Server Error | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/sync-state
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.21 - Synchronize Parameter Values
1.21.1 - 1.0
post /v1/clusters/{cluster_id}/parameters/sync
Description
Synchronize Parameter Values.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/parameters/sync
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.22 - Terminate Cluster
1.22.1 - 1.0
delete /v1/clusters/{cluster_id}
Description
Terminate Cluster.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
1.23 - Unset Maintenance
1.23.1 - 1.0
delete /v1/clusters/{cluster_id}/maintenance
Description
Unset Maintenance.
상태
ACTIVE (CURRENT)
Parameters
| Type | Name | Description | Schema | Default |
|---|
| path | cluster_id required | Cluster ID Example :
| string | None |
Responses
| HTTP Code | Description | Schema |
|---|
| 202 | Accepted | AsyncResponse |
| 400 | Bad Request | None |
| 401 | Unauthorized | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/clusters/{cluster_id}/maintenance
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = eventstreams 1.0"
Example HTTP response
Response 202
{
"request_id": "req-4f668846-8a3d-49f1-8111-451ebccf445c",
"resource": {
"id": "109a585ae67b4e8482fdafc8a4a5be74"
}
}
2 - Models
2.1 - AsyncResponse
| Name | Description | Schema | Default |
|---|
request_id required | Request ID Example : req-4f668846-8a3d-49f1-8111-451ebccf445c
| string | |
resource required | Resource
| ResourceInfo | |
2.2 - BlockStorageGroupRequest
| Name | Description | Schema | Default |
|---|
role_type required | Role type Example : OS
| enum (OS, DATA, ARCHIVE, TEMP, BACKUP) | |
size_gb required | Size in GB Example : 104 Minimum : 16 Maximum : 5120
| integer | |
volume_type optional | Volume type Example : SSD
| enum (SSD, SSD_KMS, HDD, HDD_KMS) | SSD |
2.3 - BlockStorageGroupResponse
| Name | Description | Schema | Default |
|---|
id required | ID Example :
| string | |
name required | Name Example :
| string | |
role_type required | Role type Example : OS
| enum (OS, DATA, ARCHIVE, TEMP, BACKUP) | |
size_gb required | Size in GB Example :
| integer | |
volume_type required | Volume type Example : SSD
| enum (SSD, SSD_KMS, HDD, HDD_KMS) | |
2.4 - ClusterPageResponse
| Name | Description | Schema | Default |
|---|
contents required | Clusters list
| any of [array[ClusterResponse], null] | |
count required | count Example : 20
| integer | |
page required | page Example : 0
| integer | |
size required | size Example : 20
| integer | |
sort optional | sort Example : ['created_at:asc']
| any of [array[string], null] | |
2.5 - ClusterResponse
| Name | Description | Schema | Default |
|---|
account_id required | Account ID Example :
| string | |
created_at required | 생성 시간 Example : 2024-05-17T00:23:17Z
| string (date-time) | |
created_by required | 생성자 Example : 90dddfc2b1e04edba54ba2b41539a9ac
| string | |
ha_enabled optional | HA availability Example : False
| boolean | |
id required | ID Example : 0fdd87aab8cb46f59b7c1f81ed03fb3e
| string | |
instance_count optional | Instance Count Example : 0
| integer | |
modified_at required | 수정 시간 Example : 2024-05-17T00:23:17Z
| string (date-time) | |
modified_by required | 수정자 Example : 90dddfc2b1e04edba54ba2b41539a9ac
| string | |
name required | Cluster name Example :
| string | |
role_type required | Role type Example : ORIGIN
| any of [enum (ORIGIN, REPLICA, RECOVERY, SECONDARY, MIGRATION), null] | |
service_state required | Service state Example : RUNNING
| enum (RUNNING, STOPPED, UNKNOWN, ERROR, FAILED, TERMINATED, CREATING, STOPPING, STARTING, RESTARTING, EDITING, SYNCHRONIZING, UPGRADING, TERMINATING, MIGRATING) | |
2.6 - Engine
| Name | Description | Schema | Default |
|---|
end_of_service optional | End of Service Example : False
| boolean | |
id required | ID Example :
| string | |
major_version required | Software major version Example :
| string | |
name required | DBaaS engine version name Example :
| string | |
os_type required | OS type Example :
| string | |
os_version required | OS version Example :
| string | |
product_image_type optional | Product type Example :
| any of [string, null] | |
software_version required | Software version Example :
| string | |
2.7 - EngineListResponse
| Name | Description | Schema | Default |
|---|
contents required | DBaaS engine list
| array[Engine] | |
2.8 - EngineProperty
| Name | Description | Schema | Default |
|---|
name required | DBaas engine property name Example :
| string | |
value required | DBaas engine property value Example :
| string | |
2.9 - EnginePropertyListResponse
| Name | Description | Schema | Default |
|---|
contents required | DBaas engine property list
| array[EngineProperty] | |
2.10 - EventStreamsClusterAddInstancesRequest
| Name | Description | Schema | Default |
|---|
instance_count required | Instance Count Example :
| integer | |
public_ip_ids optional | Public IP ID List Example :
| any of [array[string], null] | |
service_ip_addresses required | User subnet IP address
| array[string] | |
2.11 - EventStreamsClusterCreateRequest
| Name | Description | Schema | Default |
|---|
akhq_enabled optional | AKHQ availability Example : False
| boolean | |
allowable_ip_addresses optional | Allowed IP addresses list
| array[string] | |
dbaas_engine_version_id required | DBaaS engine version ID Example :
| string | |
init_config_option required | DB initial configuration option
| EventStreamsInitConfigOptionRequest | |
instance_groups required | Instance groups list
| array[InstanceGroupRequest] | |
instance_name_prefix required | Instance name prefix Example : Pattern : ^[a-z][a-zA-Z0-9\-]*$ Minimum length : 3 Maximum length : 13
| string | |
is_combined optional | HA availability Example : False
| boolean | |
maintenance_option optional | Maintenance option
| any of [MaintenanceOption, null] | |
name required | Cluster name Example : Pattern : ^[a-zA-Z]*$ Minimum length : 3 Maximum length : 20
| string | |
nat_enabled optional | NAT availability Example : False
| boolean | |
subnet_id required | Subnet ID Example :
| string | |
tags optional | tag
| any of [array[Tag], null] | |
timezone required | Timezone Example :
| string | |
2.12 - EventStreamsClusterDetailResponse
| Name | Description | Schema | Default |
|---|
account_id required | Account ID Example :
| string | |
allowable_ip_addresses optional | Allowed IP addresses list
| array[string] | |
created_at required | 생성 시간 Example : 2024-05-17T00:23:17Z
| string (date-time) | |
created_by required | 생성자 Example : 90dddfc2b1e04edba54ba2b41539a9ac
| string | |
dbaas_engine required | DBaaS engine Example :
| string | |
dbaas_engine_version_name required | DBaaS engine version name Example :
| string | |
id required | ID Example : 0fdd87aab8cb46f59b7c1f81ed03fb3e
| string | |
init_config_option required | DB initial configuration option
| EventStreamsInitConfigOptionDetail | |
instance_count optional | Instance Count Example : 0
| integer | |
instance_groups required | Instance groups list
| array[InstanceGroupResponse] | |
is_combined optional | Master Data server separation state Example :
| any of [boolean, null] | |
maintenance_option optional | Maintenance option
| any of [MaintenanceResponseOption, null] | |
modified_at required | 수정 시간 Example : 2024-05-17T00:23:17Z
| string (date-time) | |
modified_by required | 수정자 Example : 90dddfc2b1e04edba54ba2b41539a9ac
| string | |
name required | Cluster name Example :
| string | |
nat_enabled optional | NAT availability Example :
| any of [boolean, null] | |
product_image_type required | Product image type Example :
| string | |
product_type required | Product type Example : Event Streams
| enum (QOS, PostgreSQL Community, EPAS, MariaDB, MySQL, Redis, Microsoft SQL Server, Search Engine, Event Streams, Vertica, Scalable DB) | |
role_type required | Role type Example : ORIGIN
| any of [enum (ORIGIN, REPLICA, RECOVERY, SECONDARY, MIGRATION), null] | |
service_state required | Service state Example : RUNNING
| enum (RUNNING, STOPPED, UNKNOWN, ERROR, FAILED, TERMINATED, CREATING, STOPPING, STARTING, RESTARTING, EDITING, SYNCHRONIZING, UPGRADING, TERMINATING, MIGRATING) | |
software_version required | Software version Example :
| string | |
subnet_id required | Subnet ID Example :
| string | |
timezone required | Timezone Example :
| string | |
2.13 - EventStreamsInitConfigOptionDetail
| Name | Description | Schema | Default |
|---|
broker_port optional | broker port Example : 9091 Minimum : 1024 Maximum : 65535
| integer | 9091 |
zookeeper_port optional | zookeeper port Example : 2180 Minimum : 1024 Maximum : 65535
| integer | 2180 |
2.14 - EventStreamsInitConfigOptionRequest
| Name | Description | Schema | Default |
|---|
akhq_id optional | akhq id Example : Pattern : ^[a-z]+$
| any of [string, null] | |
akhq_password optional | akhq password Example :
| any of [string, null] | |
broker_port optional | broker port Example : 9091 Minimum : 1024 Maximum : 65535
| integer | 9091 |
broker_sasl_id required | broker sasl id Example : Pattern : ^[a-z]+$ Minimum length : 2 Maximum length : 20
| string | |
broker_sasl_password required | broker sasl password Example : Maximum length : 30
| string | |
zookeeper_port optional | zookeeper port Example : 2180 Minimum : 1024 Maximum : 65535
| integer | 2180 |
zookeeper_sasl_id required | zookeeper sasl id Example : Pattern : ^[a-z]+$ Minimum length : 2 Maximum length : 20
| string | |
zookeeper_sasl_password required | zookeeper sasl password Example : Maximum length : 30
| string | |
2.15 - InstanceGroupRequest
| Name | Description | Schema | Default |
|---|
block_storage_groups required | Block storage groups list
| array[BlockStorageGroupRequest] | |
instances optional | Instances list
| any of [array[InstanceRequest], null] | |
role_type required | Role type Example : ACTIVE
| enum (ACTIVE, ACTIVE_STANDBY, PRIMARY_SECONDARY, MASTER, MASTER_REPLICA, REPLICA, SENTINEL, MASTER_DATA, DATA, KIBANA, DASHBOARDS, ZOOKEEPER_BROKER, BROKER, ZOOKEEPER, AKHQ, CONSOLE, PRIMARY, PRIMARY_NODE, READ_NODE) | |
server_type_name required | Server type name Example :
| string | |
2.16 - InstanceGroupResizeRequest
| Name | Description | Schema | Default |
|---|
server_type_name required | Server type name Example :
| string | |
2.17 - InstanceGroupResponse
| Name | Description | Schema | Default |
|---|
block_storage_groups required | Block storage groups list
| array[BlockStorageGroupResponse] | |
id required | ID Example :
| string | |
instances required | Instances list
| array[InstanceResponse] | |
role_type required | Role type Example : ACTIVE
| enum (ACTIVE, ACTIVE_STANDBY, PRIMARY_SECONDARY, MASTER, MASTER_REPLICA, REPLICA, SENTINEL, MASTER_DATA, DATA, KIBANA, DASHBOARDS, ZOOKEEPER_BROKER, BROKER, ZOOKEEPER, AKHQ, CONSOLE, PRIMARY, PRIMARY_NODE, READ_NODE) | |
server_type_name required | Server type name Example :
| string | |
2.18 - InstanceRequest
| Name | Description | Schema | Default |
|---|
public_ip_id optional | Public IP ID Example :
| any of [string, null] | |
role_type required | Role type Example : ACTIVE
| enum (ACTIVE, STANDBY, PRIMARY, SECONDARY, MASTER, REPLICA, SENTINEL, MASTER_DATA, DATA, KIBANA, DASHBOARDS, ZOOKEEPER_BROKER, BROKER, ZOOKEEPER, AKHQ, CONSOLE, READ_REPLICA) | |
service_ip_address optional | User subnet IP address Example :
| any of [string, null] | |
2.19 - InstanceResponse
| Name | Description | Schema | Default |
|---|
name required | Name Example :
| string | |
public_ip_address optional | Public IP Address Example :
| any of [string, null] | |
public_ip_id optional | Public IP ID Example :
| any of [string, null] | |
role_type required | Role type Example : ACTIVE
| enum (ACTIVE, STANDBY, PRIMARY, SECONDARY, MASTER, REPLICA, SENTINEL, MASTER_DATA, DATA, KIBANA, DASHBOARDS, ZOOKEEPER_BROKER, BROKER, ZOOKEEPER, AKHQ, CONSOLE, READ_REPLICA) | |
service_ip_address optional | User subnet IP address Example :
| any of [string, null] | |
service_state required | Service state Example : RUNNING
| enum (RUNNING, STOPPED, UNKNOWN, ERROR, FAILED, TERMINATED, CREATING, STOPPING, STARTING, RESTARTING, EDITING, SYNCHRONIZING, UPGRADING, TERMINATING, MIGRATING) | |
2.20 - MaintenanceOption
| Name | Description | Schema | Default |
|---|
period_hour optional | Period in hours Example : Pattern : ^(0\.5|[1-5]\.5|[1-9]|1[0-9]|2[0-4])$
| string | |
starting_day_of_week optional | Starting day of week Example : MON
| enum (MON, TUE, WED, THU, FRI, SAT, SUN) | |
starting_time optional | Starting time Example :
| string | |
2.21 - MaintenanceRequest
| Name | Description | Schema | Default |
|---|
start_day_of_week required | start_day_of_week Example : MON
| enum (MON, TUE, WED, THU, FRI, SAT, SUN) | |
start_minute required | start_minute Example :
| string | |
start_time required | start_time Example :
| string | |
term_hour required | term_hour Example : Pattern : ^(0\.5|[1-5]\.5|[1-9]|1[0-9]|2[0-4])$
| string | |
2.22 - MaintenanceResponseOption
| Name | Description | Schema | Default |
|---|
period_hour optional | Period in hours Example :
| any of [string, null] | |
starting_day_of_week optional | Starting day of week Example : MON
| any of [enum (MON, TUE, WED, THU, FRI, SAT, SUN), null] | |
starting_time optional | Starting time Example :
| any of [string, null] | |
use_maintenance_option optional | Maintenance period usage state Example : False
| boolean | |
2.23 - ParameterDTO
| Name | Description | Schema | Default |
|---|
allows_value required | Parameter allows value Example :
| string | |
applied_value required | Parameter applied value Example :
| string | |
apply_type required | Parameter apply type Example :
| string | |
data_type required | Parameter data type Example :
| string | |
default_value required | Parameter default value Example :
| string | |
description required | Parameter description Example :
| any of [string, null] | |
id required | Parameter id Example :
| string | |
is_modifiable required | Parameter is_modifiable Example :
| boolean | |
name required | Parameter name Example :
| string | |
software_type required | Parameter software type Example :
| any of [string, null] | |
2.24 - ParameterGroup
| Name | Description | Schema | Default |
|---|
id required | Parameter group ID Example :
| string | |
major_version required | Software major version Example :
| string | |
name required | Parameter group name Example :
| string | |
product_image_type required | Product image type Example :
| string | |
product_type required | Product type Example :
| string | |
2.25 - ParameterGroupListResponse
| Name | Description | Schema | Default |
|---|
contents required | Parameter group list
| array[ParameterGroup] | |
sort optional | sort Example :
| any of [array[string], null] | |
2.26 - ParameterPageResponse
| Name | Description | Schema | Default |
|---|
contents required | Parameter list
| array[Parameters] | |
count required | count Example : 20
| integer | |
page required | page Example : 0
| integer | |
size required | size Example : 20
| integer | |
sort optional | sort Example : ['created_at:asc']
| any of [array[string], null] | |
2.27 - ParameterRequest
| Name | Description | Schema | Default |
|---|
id required | Parameter id Example :
| string | |
new_value required | Parameter new value Example :
| string | |
old_value required | Parameter old value Example :
| string | |
2.28 - Parameters
| Name | Description | Schema | Default |
|---|
dbaas_parameter_group_id required | Parameter id Example :
| string | |
default_value required | Parameter default value Example :
| string | |
description required | Parameter description Example :
| string | |
id required | Parameter id Example :
| string | |
name required | Parameter name Example :
| string | |
software_type required | Parameter software type Example :
| any of [string, null] | |
2.29 - ParametersRequest
| Name | Description | Schema | Default |
|---|
parameters required | Parameter request list
| array[ParameterRequest] | |
2.30 - ParametersResponse
| Name | Description | Schema | Default |
|---|
contents required | Parameter contents
| array[ParameterDTO] | |
count required | Parameter count Example :
| integer | |
modified_at required | Modification time Example :
| string | |
2.31 - RequestStateResponse
| Name | Description | Schema | Default |
|---|
request_id required | Request ID Example :
| string | |
state required | Request state Example :
| string | |
2.32 - ResizeBlockStorageGroupRequest
| Name | Description | Schema | Default |
|---|
size_gb required | Size in GB Example : 16 Minimum : 16 Maximum : 5120
| integer | |
2.33 - ResourceInfo
| Name | Description | Schema | Default |
|---|
id required | request resource id Example : 109a585ae67b4e8482fdafc8a4a5be74
| string | |
2.34 - ServerType
| Name | Description | Schema | Default |
|---|
cpu_core required | Server type cpu core Example :
| integer | |
description required | Server type description Example :
| string | |
memory_gb required | Server type memory Example :
| integer | |
name required | Server type name Example :
| string | |
product_image_type required | Product image type Example :
| string | |
product_type required | Product type Example :
| string | |
purpose required | Server type purpose Example :
| string | |
type required | Server type class Example :
| string | |
2.35 - ServerTypeListResponse
| Name | Description | Schema | Default |
|---|
contents required | Server type list
| array[ServerType] | |
2.36 - Tag
| Name | Description | Schema | Default |
|---|
key optional | Example :
| string | |
value optional | Example :
| any of [string, null] | |
2.37 - UpdateSecurityGroupRulesRequest
| Name | Description | Schema | Default |
|---|
add_ip_addresses optional | Allowed IP addresses list
| array[string] | |
del_ip_addresses optional | Allowed IP addresses list
| array[string] | |