Skip to main content
POST
Create a Query API endpoint
Creates a Query API endpoint.

Permission

The API key must have the control-plane:service:manage-query-api-endpoints permission.

인증

Authorization
string
header
필수

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

경로 매개변수

organizationId
string<uuid>
필수

ID of the requested organization.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
serviceId
string<uuid>
필수

ID of the requested service.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$

본문

application/json
name
string
필수

Name of the Query API endpoint.

Minimum string length: 1
Pattern: \S
sql
string
필수

SQL executed by the endpoint.

Maximum string length: 4194304
Pattern: \S
database
string
필수

Database used by the Query API endpoint.

Pattern: \S
apiKeyIds
string<uuid>[]
필수

API key IDs allowed to call the endpoint.

Minimum array length: 1
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
roles
string[]
필수

Database roles used by the endpoint.

Minimum array length: 1
Minimum string length: 1
parameters
object

Default query parameters.

allowedOrigins
string[]

Origins allowed by the endpoint CORS policy.

응답

The Query API endpoint was created.

status
integer
필수

HTTP status code.

예시:

201

requestId
string<uuid>
필수

Unique id assigned to every request. UUIDv4

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
result
object
필수
마지막 수정일 2026년 10월 3일