Create new service | ClickHouse Docs

POST/v1/organizations/{organizationId}/services

Creates a new service in the organization, and returns the current service state and a password to access the service. The service is started asynchronously.

Permission

The API key must have the control-plane:organization:create-service permission.

Authorizations

Authorizationstringheaderrequired
Use key ID and key secret obtained in ClickHouse Cloud console: https://clickhouse.com/docs/cloud/manage/openapi

Path parameters

organizationIdstringrequired
ID of the organization that will own the service.

format: uuid

Request bodyJSON

nameoptionalstring
Name of the service. Alphanumerical string with whitespaces up to 50 characters.

maxLength: 50, minLength: 1
provideroptionalawsorgcporazure
Cloud provider
regionoptionalap-northeast-1orap-northeast-2orap-south-1orap-southeast-1orap-southeast-2orca-central-1+18 more
Service region.
tierdeprecateddevelopmentorproductionordedicated_high_memordedicated_high_cpuordedicated_standardordedicated_standard_n2d_standard_4+5 more
DEPRECATED for BASIC, SCALE and ENTERPRISE organization tiers. Use minReplicaMemoryGb, maxReplicaMemoryGb, and numReplicas instead. Tier of the service: 'development', 'production', 'dedicated_high_mem', 'dedicated_high_cpu', 'dedicated_standard', 'dedicated_standard_n2d_standard_4', 'dedicated_standard_n2d_standard_8', 'dedicated_standard_n2d_standard_32', 'dedicated_standard_n2d_standard_128', 'dedicated_standard_n2d_standard_32_16SSD', 'dedicated_standard_n2d_standard_64_24SSD'. Production services scale, Development are fixed size. Azure services don't support Development tier
ipAccessListoptionalarray ofobject
List of IP addresses allowed to access the service
2 properties
- sourceoptionalstring
  IP or CIDR
- descriptionoptionalstring
  Optional description of IPv4 address or IPv4 CIDR to allow access from
minTotalMemoryGbdeprecatednumber
DEPRECATED - inaccurate for services with non-default numbers of replicas. Use minReplicaMemoryGb instead. Minimum memory of three workers during auto-scaling in Gb. Available only for 'production' services. Must be a multiple of 12 and greater than or equal to 24. Always absent for horizontal-autoscaling services (replica count is variable).

maximum: 1068, minimum: 24
Example: 48
maxTotalMemoryGbdeprecatednumber
DEPRECATED - inaccurate for services with non-default numbers of replicas. Use maxReplicaMemoryGb instead. Maximum memory of three workers during auto-scaling in Gb. Available only for 'production' services. Must be a multiple of 12 and lower than or equal to 360 for non paid services or 1068 for paid services. Always absent for horizontal-autoscaling services (replica count is variable).

maximum: 1068, minimum: 24
Example: 360
autoscalingModeoptionalverticalorhorizontal
Autoscaling mode. "vertical" (the default when omitted) runs a fixed replica count while memory scales between minReplicaMemoryGb and maxReplicaMemoryGb; "horizontal" scales the replica count between minReplicas and maxReplicas at a fixed per-replica memory (minReplicaMemoryGb equal to maxReplicaMemoryGb). Horizontal requires the feature to be enabled for the organization.

Example: "vertical"
minReplicaMemoryGboptionalnumber
Minimum total memory of each replica during auto-scaling in Gb. A range in vertical autoscaling; equal to maxReplicaMemoryGb in horizontal (memory is fixed while the replica count scales). Must be a multiple of 4 and greater than or equal to 8.

maximum: 356, minimum: 8
Example: 16
maxReplicaMemoryGboptionalnumber
Maximum total memory of each replica during auto-scaling in Gb. A range in vertical autoscaling; equal to minReplicaMemoryGb in horizontal (memory is fixed while the replica count scales). Must be a multiple of 4 and lower than or equal to 120* for non paid services or 356* for paid services.* - maximum replica size subject to cloud provider hardware availability in your selected region.

maximum: 356, minimum: 8
Example: 120
numReplicasoptionalinteger
Fixed replica count for vertical autoscaling (autoscalingMode "vertical" or omitted). Mutually exclusive with minReplicas/maxReplicas.

maximum: 50, minimum: 1
Example: 3
minReplicasoptionalinteger
Minimum number of replicas. A minReplicas/maxReplicas band scales the replica count in horizontal autoscaling (autoscalingMode "horizontal"). Must be provided together with maxReplicas. Mutually exclusive with numReplicas. Requires horizontal autoscaling to be enabled for the organization, unless autoscalingMode is omitted or "vertical" and minReplicas equals maxReplicas (an equal band is then an accepted vertical fixed count and needs no horizontal entitlement).

maximum: 50, minimum: 1
Example: 1
maxReplicasoptionalinteger
Maximum number of replicas. A minReplicas/maxReplicas band scales the replica count in horizontal autoscaling (autoscalingMode "horizontal"). Must be provided together with minReplicas. Mutually exclusive with numReplicas. Requires horizontal autoscaling to be enabled for the organization, unless autoscalingMode is omitted or "vertical" and minReplicas equals maxReplicas (an equal band is then an accepted vertical fixed count and needs no horizontal entitlement).

maximum: 50, minimum: 1
Example: 5
idleScalingoptionalboolean
When set to true the service is allowed to scale down to zero when idle. True by default.
idleTimeoutMinutesoptionalnumber
Set minimum idling timeout (in minutes). Must be >= 5 minutes.
isReadonlyoptionalboolean
True if this service is read-only. It can only be read-only if a dataWarehouseId is provided.
dataWarehouseIdoptionalstring
Data warehouse containing this service
backupIdoptionalstring
Optional backup ID used as an initial state for the new service. When used the region and the tier of the new instance must be the same as the values of the original instance. If the backup is stored in your organization's own bucket, backupEncryptionConfig is required; it must be omitted otherwise.

format: uuid
backupEncryptionConfigoptionalobject
The encryption_config.json stored alongside this backup in your bucket, passed through unchanged. Supply the file contents verbatim rather than constructing this object — its shape is versioned and depends on your cloud provider. See Export backups to your own cloud account for what it contains.

Accepted only for organizations enrolled in the private preview, and only when the backup is of a service that has transparent data encryption enabled. Such a restore always produces a service with transparent data encryption enabled, inherited from the source service.

Example: {"schema_version":1,"restore_key_pairs":[{"customer_managed_encryption_key":{"aws_kms_key_arn":"arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"},"encrypted_dek":"<base64 wrapped data encryption key>"}]}
encryptionKeyoptionalstring
Optional customer provided disk encryption key
encryptionAssumedRoleIdentifieroptionalstring
Optional role to use for disk encryption
privateEndpointIdsdeprecatedarray ofstring
DEPRECATED. To associate the service with private endpoints, first create the service, then use the Update Service Basic Details endpoint with the privateEndpointIds field to modify private endpoints.
privatePreviewTermsCheckedoptionalboolean
Accept the private preview terms and conditions. It is only needed when creating the first service in the organization in case of a private preview
releaseChanneloptionalslowordefaultorfast
Select fast if you want to get new ClickHouse releases as soon as they are available. You'll get new features faster, but with a higher risk of bugs. Select slow if you would like to defer releases to give yourself more time to test. This feature is only available for production services. default is the regular release channel.
byocIdoptionalstring
This is the ID returned after setting up a region for Bring Your Own Cloud (BYOC). When the byocId parameter is specified, the minReplicaMemoryGb and the maxReplicaGb parameters are required too, with values included among the following sizes: 48, 116, 172, 232.
hasTransparentDataEncryptionoptionalboolean
True if the service should have the Transparent Data Encryption (TDE) enabled. TDE is only available for ENTERPRISE organizations tiers and can only be enabled at service creation.
endpointsoptionalarray ofobject
List of service endpoints to enable or disable
2 properties
- protocoloptionalmysql
  Endpoint protocol
  
  Example: "mysql"
- enabledoptionalboolean
  Enable or disable the endpoint
profileoptionalstring
Custom instance profile. Only available for ENTERPRISE and BYOC organization tiers. Standard values: 'v1-default', 'v1-highmem-xs', 'v1-highmem-s', 'v1-highmem-m', 'v1-highmem-l', 'v1-highmem-xl'. BYOC services may instead use a dynamic BYOC profile configured for their infrastructure (e.g. 'v1-standard-byoc-4'); it requires byocId, and minReplicaMemoryGb and maxReplicaMemoryGb must both equal the profile's memory size. Use the serviceProfiles endpoint to list the profiles available to the organization.
complianceTypeoptionalhipaaorpci
Type of regulatory compliance for service.
tagsoptionalarray ofobject
Tags associated with the service.
2 properties
- keystringrequired
  Tag key. Must be alphanumeric with dashes, underscores and dots.
  
  maxLength: 128, minLength: 1, pattern: ^[a-zA-Z0-9._-]+$
- valueoptionalstring
  Tag value. Must be alphanumeric with dashes, underscores and dots.
  
  maxLength: 256, pattern: ^[a-zA-Z0-9._-]+$
enableCoreDumpsoptionalboolean
Enables the underlying infra for collecting core dumps. Default is enabled.

Response

JSON

200

Successful response

JSON

statusoptionalnumber
HTTP status code.

Example: 200
requestIdoptionalstring
Unique id assigned to every request. UUIDv4

format: uuid
resultoptionalobject
2 properties
- serviceoptionalobject
  40 properties
  autoscalingModeverticalorhorizontalrequired
  Configured autoscaling mode. "vertical" runs a fixed replica count while memory scales between minReplicaMemoryGb and maxReplicaMemoryGb; "horizontal" scales the replica count between minReplicas and maxReplicas at a fixed per-replica memory. This is the baseline configuration; the mode currently applied (which may differ while a schedule entry is active) is currentScaling.effectiveAutoscalingMode.
  
  Example: "vertical"
  currentScalingobjectrequired
  8 properties
  effectiveAutoscalingModeoptionalverticalorhorizontal
  Autoscaling mode currently in effect on the running service. May diverge from the configured baseline mode while a schedule entry is active.
  
  effectiveMinReplicaMemoryGboptionalnumber
  Minimum memory per replica (Gb) currently applied to the running service. May diverge from the top-level minReplicaMemoryGb baseline while a schedule entry is active.
  
  effectiveMaxReplicaMemoryGboptionalnumber
  Maximum memory per replica (Gb) currently applied to the running service. May diverge from the top-level maxReplicaMemoryGb baseline while a schedule entry is active. Reflects the stored value: normally equal to effectiveMinReplicaMemoryGb in horizontal mode, but a legacy service stored with an unequal memory range reports the stored bounds as-is.
  
  effectiveMinReplicasoptionalinteger
  Minimum number of replicas currently applied to the running service. May diverge from the baseline while a schedule entry is active. Reflects the stored value: normally equal to effectiveMaxReplicas in vertical mode (a fixed replica count), but a legacy service stored with an unequal replica range reports the stored bounds as-is.
  
  effectiveMaxReplicasoptionalinteger
  Maximum number of replicas currently applied to the running service. May diverge from the baseline while a schedule entry is active.
  
  effectiveIdleScalingoptionalboolean
  Whether idle scaling is currently in effect on the service. May diverge from the top-level idleScaling baseline while a schedule entry is active.
  
  effectiveIdleTimeoutMinutesoptionalinteger
  Idle timeout in minutes currently in effect on the service. May diverge from the top-level idleTimeoutMinutes baseline while a schedule entry is active.
  
  activeEntryIdoptionalstring
  ID of the schedule entry whose values are currently applied to the service. Absent when no entry is active.
  
  format: uuid
  idoptionalstring
  Unique service ID.
  
  format: uuid
  nameoptionalstring
  Name of the service. Alphanumerical string with whitespaces up to 50 characters.
  
  maxLength: 50, minLength: 1
  provideroptionalawsorgcporazure
  Cloud provider
  
  regionoptionalap-northeast-1orap-northeast-2orap-south-1orap-southeast-1orap-southeast-2orca-central-1+18 more
  Service region.
  
  stateoptionalstartingorstoppingorterminatingorsoftdeletingorawakingorpartially_running+8 more
  Current state of the service.
  
  clickhouseVersionoptionalstring
  ClickHouse version of the service.
  
  endpointsoptionalarray ofobject
  List of all service endpoints.
  
  4 properties
  protocoloptionalhttpsornativesecureormysql
  Endpoint protocol: 'https', 'nativesecure', 'mysql'.
  
  Example: "mysql"
  hostoptionalstring
  Service host name
  
  portoptionalnumber
  Numeric port
  
  usernameoptionalstring | null
  Optional username for the endpoint
  
  tierdeprecateddevelopmentorproductionordedicated_high_memordedicated_high_cpuordedicated_standardordedicated_standard_n2d_standard_4+5 more
  DEPRECATED for BASIC, SCALE and ENTERPRISE organization tiers. Use minReplicaMemoryGb, maxReplicaMemoryGb, and numReplicas instead. Tier of the service: 'development', 'production', 'dedicated_high_mem', 'dedicated_high_cpu', 'dedicated_standard', 'dedicated_standard_n2d_standard_4', 'dedicated_standard_n2d_standard_8', 'dedicated_standard_n2d_standard_32', 'dedicated_standard_n2d_standard_128', 'dedicated_standard_n2d_standard_32_16SSD', 'dedicated_standard_n2d_standard_64_24SSD'. Production services scale, Development are fixed size. Azure services don't support Development tier
  
  minTotalMemoryGbdeprecatednumber
  DEPRECATED - inaccurate for services with non-default numbers of replicas. Use minReplicaMemoryGb instead. Minimum memory of three workers during auto-scaling in Gb. Available only for 'production' services. Must be a multiple of 12 and greater than or equal to 24. Always absent for horizontal-autoscaling services (replica count is variable).
  
  maximum: 1068, minimum: 24
  Example: 48
  maxTotalMemoryGbdeprecatednumber
  DEPRECATED - inaccurate for services with non-default numbers of replicas. Use maxReplicaMemoryGb instead. Maximum memory of three workers during auto-scaling in Gb. Available only for 'production' services. Must be a multiple of 12 and lower than or equal to 360 for non paid services or 1068 for paid services. Always absent for horizontal-autoscaling services (replica count is variable).
  
  maximum: 1068, minimum: 24
  Example: 360
  minReplicaMemoryGboptionalnumber
  Minimum total memory of each replica during auto-scaling in Gb. A range in vertical autoscaling; equal to maxReplicaMemoryGb in horizontal (memory is fixed while the replica count scales). Must be a multiple of 4 and greater than or equal to 8.
  
  maximum: 356, minimum: 8
  Example: 16
  maxReplicaMemoryGboptionalnumber
  Maximum total memory of each replica during auto-scaling in Gb. A range in vertical autoscaling; equal to minReplicaMemoryGb in horizontal (memory is fixed while the replica count scales). Must be a multiple of 4 and lower than or equal to 120* for non paid services or 356* for paid services.* - maximum replica size subject to cloud provider hardware availability in your selected region.
  
  maximum: 356, minimum: 8
  Example: 120
  numReplicasoptionalinteger
  Number of replicas for the service. The number of replicas must be between 2 and 50 for the first service in a warehouse. Services that are created in an existing warehouse can have a number of replicas as low as 1. Further restrictions may apply based on your organization's tier and its per-warehouse replica limit. It defaults to 1 for the BASIC tier and 3 for the SCALE and ENTERPRISE tiers. Present only when the service uses vertical autoscaling. For horizontal autoscaling, use minReplicas and maxReplicas instead.
  
  maximum: 50, minimum: 1
  Example: 3
  minReplicasoptionalinteger
  Minimum number of replicas for horizontal autoscaling. Present only when the service uses horizontal autoscaling.
  
  maximum: 50, minimum: 1
  Example: 1
  maxReplicasoptionalinteger
  Maximum number of replicas for horizontal autoscaling. Present only when the service uses horizontal autoscaling.
  
  maximum: 50, minimum: 1
  Example: 5
  replicaMemoryGboptionalnumber
  Fixed memory per replica in Gb for horizontal autoscaling. Present only when the service uses horizontal autoscaling. Must be a multiple of 4, at least 8 Gb, and at most 120 Gb for non paid services or 356 Gb for paid services.
  
  maximum: 356, minimum: 8
  Example: 32
  idleScalingoptionalboolean
  When set to true the service is allowed to scale down to zero when idle. True by default.
  
  idleTimeoutMinutesoptionalnumber
  Set minimum idling timeout (in minutes). Must be >= 5 minutes.
  
  ipAccessListoptionalarray ofobject
  List of IP addresses allowed to access the service
  
  2 properties
  sourceoptionalstring
  IP or CIDR
  
  descriptionoptionalstring
  Optional description of IPv4 address or IPv4 CIDR to allow access from
  
  createdAtoptionalstring
  Service creation timestamp. ISO-8601.
  
  format: date-time
  encryptionKeyoptionalstring
  Optional customer provided disk encryption key
  
  encryptionAssumedRoleIdentifieroptionalstring
  Optional role to use for disk encryption
  
  iamRoleoptionalstring
  IAM role used for accessing objects in s3
  
  privateEndpointIdsoptionalarray ofstring
  List of private endpoints
  
  availablePrivateEndpointIdsoptionalarray ofstring
  List of available private endpoints ids that can be attached to the service
  
  dataWarehouseIdoptionalstring
  Data warehouse containing this service
  
  isPrimaryoptionalboolean
  True if this service is the primary service in the data warehouse
  
  isReadonlyoptionalboolean
  True if this service is read-only. It can only be read-only if a dataWarehouseId is provided.
  
  releaseChanneloptionalslowordefaultorfast
  Select fast if you want to get new ClickHouse releases as soon as they are available. You'll get new features faster, but with a higher risk of bugs. Select slow if you would like to defer releases to give yourself more time to test. This feature is only available for production services. default is the regular release channel.
  
  byocIdoptionalstring
  This is the ID returned after setting up a region for Bring Your Own Cloud (BYOC). When the byocId parameter is specified, the minReplicaMemoryGb and the maxReplicaGb parameters are required too, with values included among the following sizes: 48, 116, 172, 232.
  
  hasTransparentDataEncryptionoptionalboolean
  True if the service should have the Transparent Data Encryption (TDE) enabled. TDE is only available for ENTERPRISE organizations tiers and can only be enabled at service creation.
  
  profileoptionalstring
  Custom instance profile. Only available for ENTERPRISE and BYOC organization tiers. Standard values: 'v1-default', 'v1-highmem-xs', 'v1-highmem-s', 'v1-highmem-m', 'v1-highmem-l', 'v1-highmem-xl'. BYOC services may instead use a dynamic BYOC profile configured for their infrastructure (e.g. 'v1-standard-byoc-4'); it requires byocId, and minReplicaMemoryGb and maxReplicaMemoryGb must both equal the profile's memory size. Use the serviceProfiles endpoint to list the profiles available to the organization.
  
  transparentDataEncryptionKeyIdoptionalstring
  The ID of the Transparent Data Encryption key used for the service. This is only available if hasTransparentDataEncryption is true.
  
  encryptionRoleIdoptionalstring
  The ID of the IAM role used for encryption. This is only available if hasTransparentDataEncryption is true.
  
  complianceTypeoptionalhipaaorpci
  Type of regulatory compliance for service.
  
  tagsoptionalarray ofobject
  Tags associated with the service.
  
  2 properties
  keystringrequired
  Tag key. Must be alphanumeric with dashes, underscores and dots.
  
  maxLength: 128, minLength: 1, pattern: ^[a-zA-Z0-9._-]+$
  valueoptionalstring
  Tag value. Must be alphanumeric with dashes, underscores and dots.
  
  maxLength: 256, pattern: ^[a-zA-Z0-9._-]+$
  enableCoreDumpsoptionalboolean
  True if the service's underline infra is enabled for collecting core dumps. This is an experimental feature
  
  scalingScheduleoptionalobject
  3 properties
  entriesarray ofobjectrequired
  List of schedule entries.
  
  13 properties
  idstringrequired
  Unique identifier for this schedule entry.
  
  format: uuid
  namestringrequired
  Human-readable label for this schedule entry.
  
  weekdaysarray ofintegerrequired
  Days of the week this entry applies to. 0 = Sunday, 1 = Monday, …, 6 = Saturday.
  
  startHourUtcintegerrequired
  UTC hour (0–23) when this entry becomes active (inclusive).
  
  maximum: 23, minimum: 0
  endHourUtcintegerrequired
  UTC hour (1–24) when this entry deactivates (exclusive). Must differ from startHourUtc. Set to 24 to end at midnight. Values less than startHourUtc create an overnight window spanning midnight.
  
  maximum: 24, minimum: 1
  autoscalingModeverticalorhorizontalrequired
  Autoscaling mode for this entry. "vertical" runs a fixed replica count while memory scales; "horizontal" scales the replica count at a fixed per-replica memory. Defaults to "vertical" for entries persisted before the mode was exposed.
  
  isActiveNowbooleanrequired
  Whether this entry is currently active. Scheduled times are indicative — actions are applied on a best-effort basis and may be delayed by a few minutes.
  
  minReplicaMemoryGboptionalnumber
  Minimum memory per replica (Gb) during this window. A range in vertical; in horizontal it equals maxReplicaMemoryGb (memory is fixed while the replica count scales).
  
  maxReplicaMemoryGboptionalnumber
  Maximum memory per replica (Gb) during this window. A range in vertical; in horizontal it equals minReplicaMemoryGb (memory is fixed while the replica count scales).
  
  minReplicasoptionalinteger
  Minimum number of replicas during this window. For a horizontal entry the replica count scales between minReplicas and maxReplicas; for a vertical entry minReplicas and maxReplicas are equal and report the fixed replica count (both omitted when the entry stored no count).
  
  maxReplicasoptionalinteger
  Maximum number of replicas during this window. For a horizontal entry the replica count scales between minReplicas and maxReplicas; for a vertical entry minReplicas and maxReplicas are equal and report the fixed replica count (both omitted when the entry stored no count).
  
  idleScalingoptionalboolean
  Whether idle scaling is enabled during this window.
  
  idleTimeoutMinutesoptionalinteger
  Idle timeout in minutes during this window.
  
  baseConfigobjectrequired
  7 properties
  autoscalingModeoptionalverticalorhorizontal
  Autoscaling mode applied when no schedule entry is active. "vertical" runs a fixed replica count while memory scales; "horizontal" scales the replica count at a fixed per-replica memory.
  
  minReplicaMemoryGboptionalnumber
  Minimum memory per replica (Gb) when no schedule entry is active. Absent for services that do not autoscale memory.
  
  maxReplicaMemoryGboptionalnumber
  Maximum memory per replica (Gb) when no schedule entry is active. Absent for services that do not autoscale memory.
  
  minReplicasoptionalinteger
  Minimum number of replicas when no schedule entry is active.
  
  maxReplicasoptionalinteger
  Maximum number of replicas when no schedule entry is active.
  
  idleScalingoptionalboolean
  Whether idle scaling is enabled when no schedule entry is active.
  
  idleTimeoutMinutesoptionalinteger
  Idle timeout in minutes when no schedule entry is active.
  
  activeEntryIdoptionalstring
  ID of the currently-active schedule entry. Absent when no entry is active and the base config is in effect.
  
  format: uuid
- passwordoptionalstring
  Password for the newly created service.

Create new service

curl --request POST \
  --url https://api.clickhouse.cloud/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/services \
  --header 'Authorization: Basic <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "string",
  "provider": "aws",
  "region": "ap-northeast-1",
  "tier": "development",
  "ipAccessList": [
    {
      "source": "string",
      "description": "string"
    }
  ],
  "minTotalMemoryGb": 48,
  "maxTotalMemoryGb": 360,
  "autoscalingMode": "vertical",
  "minReplicaMemoryGb": 16,
  "maxReplicaMemoryGb": 120,
  "numReplicas": 3,
  "minReplicas": 1,
  "maxReplicas": 5,
  "idleScaling": true,
  "idleTimeoutMinutes": 0,
  "isReadonly": true,
  "dataWarehouseId": "string",
  "backupId": "eb7cea43-10b2-42dd-8819-ab9aed37565f",
  "backupEncryptionConfig": {
    "schema_version": 1,
    "restore_key_pairs": [
      {
        "customer_managed_encryption_key": {
          "aws_kms_key_arn": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
        },
        "encrypted_dek": "<base64 wrapped data encryption key>"
      }
    ]
  },
  "encryptionKey": "string",
  "encryptionAssumedRoleIdentifier": "string",
  "privateEndpointIds": [
    "string"
  ],
  "privatePreviewTermsChecked": true,
  "releaseChannel": "slow",
  "byocId": "string",
  "hasTransparentDataEncryption": true,
  "endpoints": [
    {
      "protocol": "mysql",
      "enabled": true
    }
  ],
  "profile": "string",
  "complianceType": "hipaa",
  "tags": [
    {
      "key": "Environment",
      "value": "staging"
    }
  ],
  "enableCoreDumps": true
}
'

const url = 'https://api.clickhouse.cloud/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/services';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Basic <token>'},
  body: JSON.stringify({
    name: 'string',
    provider: 'aws',
    region: 'ap-northeast-1',
    tier: 'development',
    ipAccessList: [{source: 'string', description: 'string'}],
    minTotalMemoryGb: 48,
    maxTotalMemoryGb: 360,
    autoscalingMode: 'vertical',
    minReplicaMemoryGb: 16,
    maxReplicaMemoryGb: 120,
    numReplicas: 3,
    minReplicas: 1,
    maxReplicas: 5,
    idleScaling: true,
    idleTimeoutMinutes: 0,
    isReadonly: true,
    dataWarehouseId: 'string',
    backupId: 'eb7cea43-10b2-42dd-8819-ab9aed37565f',
    backupEncryptionConfig: {
      schema_version: 1,
      restore_key_pairs: [
        {
          customer_managed_encryption_key: {
            aws_kms_key_arn: 'arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab'
          },
          encrypted_dek: '<base64 wrapped data encryption key>'
        }
      ]
    },
    encryptionKey: 'string',
    encryptionAssumedRoleIdentifier: 'string',
    privateEndpointIds: ['string'],
    privatePreviewTermsChecked: true,
    releaseChannel: 'slow',
    byocId: 'string',
    hasTransparentDataEncryption: true,
    endpoints: [{protocol: 'mysql', enabled: true}],
    profile: 'string',
    complianceType: 'hipaa',
    tags: [{key: 'Environment', value: 'staging'}],
    enableCoreDumps: true
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.clickhouse.cloud/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/services"

payload = {
    "name": "string",
    "provider": "aws",
    "region": "ap-northeast-1",
    "tier": "development",
    "ipAccessList": [
        {
            "source": "string",
            "description": "string"
        }
    ],
    "minTotalMemoryGb": 48,
    "maxTotalMemoryGb": 360,
    "autoscalingMode": "vertical",
    "minReplicaMemoryGb": 16,
    "maxReplicaMemoryGb": 120,
    "numReplicas": 3,
    "minReplicas": 1,
    "maxReplicas": 5,
    "idleScaling": True,
    "idleTimeoutMinutes": 0,
    "isReadonly": True,
    "dataWarehouseId": "string",
    "backupId": "eb7cea43-10b2-42dd-8819-ab9aed37565f",
    "backupEncryptionConfig": {
        "schema_version": 1,
        "restore_key_pairs": [
            {
                "customer_managed_encryption_key": { "aws_kms_key_arn": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" },
                "encrypted_dek": "<base64 wrapped data encryption key>"
            }
        ]
    },
    "encryptionKey": "string",
    "encryptionAssumedRoleIdentifier": "string",
    "privateEndpointIds": ["string"],
    "privatePreviewTermsChecked": True,
    "releaseChannel": "slow",
    "byocId": "string",
    "hasTransparentDataEncryption": True,
    "endpoints": [
        {
            "protocol": "mysql",
            "enabled": True
        }
    ],
    "profile": "string",
    "complianceType": "hipaa",
    "tags": [
        {
            "key": "Environment",
            "value": "staging"
        }
    ],
    "enableCoreDumps": True
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Basic <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "status": 200,
  "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",
  "result": {
    "service": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "provider": "aws",
      "region": "ap-northeast-1",
      "state": "starting",
      "clickhouseVersion": "string",
      "endpoints": [
        {
          "protocol": "mysql",
          "host": "string",
          "port": 0,
          "username": "string"
        }
      ],
      "tier": "development",
      "minTotalMemoryGb": 48,
      "maxTotalMemoryGb": 360,
      "minReplicaMemoryGb": 16,
      "maxReplicaMemoryGb": 120,
      "numReplicas": 3,
      "minReplicas": 1,
      "maxReplicas": 5,
      "autoscalingMode": "vertical",
      "replicaMemoryGb": 32,
      "idleScaling": true,
      "idleTimeoutMinutes": 0,
      "ipAccessList": [
        {
          "source": "string",
          "description": "string"
        }
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "encryptionKey": "string",
      "encryptionAssumedRoleIdentifier": "string",
      "iamRole": "string",
      "privateEndpointIds": [
        "string"
      ],
      "availablePrivateEndpointIds": [
        "string"
      ],
      "dataWarehouseId": "string",
      "isPrimary": true,
      "isReadonly": true,
      "releaseChannel": "slow",
      "byocId": "string",
      "hasTransparentDataEncryption": true,
      "profile": "string",
      "transparentDataEncryptionKeyId": "string",
      "encryptionRoleId": "string",
      "complianceType": "hipaa",
      "tags": [
        {
          "key": "Environment",
          "value": "staging"
        }
      ],
      "enableCoreDumps": true,
      "scalingSchedule": {
        "entries": [
          {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "weekdays": [
              0
            ],
            "startHourUtc": 23,
            "endHourUtc": 1,
            "autoscalingMode": "vertical",
            "minReplicaMemoryGb": 0,
            "maxReplicaMemoryGb": 0,
            "minReplicas": 0,
            "maxReplicas": 0,
            "idleScaling": true,
            "idleTimeoutMinutes": 0,
            "isActiveNow": true
          }
        ],
        "baseConfig": {
          "autoscalingMode": "vertical",
          "minReplicaMemoryGb": 0,
          "maxReplicaMemoryGb": 0,
          "minReplicas": 0,
          "maxReplicas": 0,
          "idleScaling": true,
          "idleTimeoutMinutes": 0
        },
        "activeEntryId": "7fea8504-c822-495c-b273-d4283b184c89"
      },
      "currentScaling": {
        "effectiveAutoscalingMode": "vertical",
        "effectiveMinReplicaMemoryGb": 0,
        "effectiveMaxReplicaMemoryGb": 0,
        "effectiveMinReplicas": 0,
        "effectiveMaxReplicas": 0,
        "effectiveIdleScaling": true,
        "effectiveIdleTimeoutMinutes": 0,
        "activeEntryId": "7fea8504-c822-495c-b273-d4283b184c89"
      }
    },
    "password": "string"
  }
}

{
  "status": 400,
  "error": "string",
  "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
}

{
  "status": 500,
  "error": "string",
  "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
}