warehouse

Update Storage Profile

Updates both the storage profile and credentials of a warehouse.

post/management/v1/warehouse/{warehouse_id}/storage

Request

Path parameters

warehouse_idstring uuid required

Request body

Example request

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

Response

Storage profile updated 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.