Saltar al contenido principal
POST
Crear una clave

Autorizaciones

Authorization
string
header
requerido

Usa el ID de la clave y el secreto de la clave obtenidos en la consola de ClickHouse Cloud: https://clickhouse.com/docs/cloud/manage/openapi

Parámetros de ruta

organizationId
string<uuid>
requerido

ID de la organización que será propietaria de la clave.

Cuerpo

application/json
expireAt
string<date-time> | null

Marca de tiempo en la que expira la clave. Si no está presente, es null o está vacío, la clave no expira nunca. ISO-8601.

hashData
object
ipAccessList
object[]

Lista de direcciones IP autorizadas para acceder a la API usando esta clave

name
string

Nombre de la clave.

roles
enum<string>[]

Lista de roles asignados a la clave. Contiene al menos 1 elemento.

Opciones disponibles:
admin,
developer,
query_endpoints
state
enum<string>

Estado inicial de la clave: 'enabled', 'disabled'. Si no se proporciona, la nueva clave será 'enabled'.

Opciones disponibles:
enabled,
disabled

Respuesta

Respuesta satisfactoria

requestId
string<uuid>

ID único asignado a cada solicitud. UUIDv4

result
object
status
number

Código de estado HTTP.

Ejemplo:

200

Última modificación el 2 de julio de 2026