LAlakekeeper
warehouse

Create Warehouse

Creates a new warehouse in the specified project with the provided configuration. The project of a warehouse cannot be changed after creation. This operation validates the storage configuration.

post/management/v1/warehouse

Request

Request body

allowed-format-versionsinteger[] nullable

Iceberg table format versions that may be created in, or upgraded to, within this warehouse. Must be a non-empty subset of [1, 2, 3]. Defaults to all supported versions when omitted.

default-format-versioninteger nullable

Default Iceberg table format version applied when a create-table request does not specify one. Must be a member of allowed-format-versions. When omitted, resolves to v2 if allowed, otherwise the highest allowed version.

managed-by'self-managed' | 'instance-admin'

Which control plane, if any, exclusively manages a warehouse's spec.

self-managed (the default) leaves the spec mutable by the warehouse's own owners through the usual grants. When set to instance-admin, spec changes — storage profile, credentials, delete profile, rename, status, protection, format-version policy, and deletion — are accepted only from instance administrators; other callers are rejected even when their grants would otherwise allow it. Child resources (namespaces, tables, grants), task-queue configuration, and data access are unaffected.

project-idstring nullable

Project ID in which to create the warehouse. Deprecated: Please use the x-project-id header instead.

warehouse-namestring required

Name of the warehouse to create. Must be unique within a project and may not contain "/"

Example request

{
  "storage-profile": {
    "storage-layout": {
      "tabular": "{name}-{uuid}"
    }
  }
}

Response

Warehouse created successfully

allowed-format-versionsinteger[] required

Iceberg table format versions that may be created in, or upgraded to, within this warehouse.

default-format-versioninteger nullable

Default Iceberg table format version applied when a create-table request does not specify one. When absent, resolves to v2 if allowed, otherwise the highest allowed version.

idstring uuid required

ID of the warehouse.

managed-by'self-managed' | 'instance-admin'

Which control plane, if any, exclusively manages a warehouse's spec.

self-managed (the default) leaves the spec mutable by the warehouse's own owners through the usual grants. When set to instance-admin, spec changes — storage profile, credentials, delete profile, rename, status, protection, format-version policy, and deletion — are accepted only from instance administrators; other callers are rejected even when their grants would otherwise allow it. Child resources (namespaces, tables, grants), task-queue configuration, and data access are unaffected.

namestring required

Name of the warehouse.

project-idstring required

Project ID in which the warehouse was created.

protectedboolean required

Whether the warehouse is protected from being deleted.

status'active' | 'inactive' required

Status of a warehouse

updated-atstring date-time nullable

Last updated timestamp.

warehouse-idstring uuid required

ID of the warehouse.

Example response

{
  "storage-profile": {
    "storage-layout": {
      "tabular": "{name}-{uuid}"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.