UNunitycatalog
Catalogs

Create a catalog

Changed on

Creates a new catalog instance.

post/catalogs

Request

  • Base URL
    http://localhost:8080/api/2.1/unity-catalog
  • Auth
    none declared

Request body

namestring required

Name of catalog.

commentstring

User-provided free-form text description.

propertiesSecurablePropertiesMap

A map of key-value properties attached to the securable.

storage_rootstring

Storage root URL for managed storage location of catalog. Example: s3://bucket/ucroot

Response

The new catalog was successfully created.

namestring

Name of catalog.

commentstring

User-provided free-form text description.

propertiesSecurablePropertiesMap

A map of key-value properties attached to the securable.

ownerstring

Username of current owner of catalog.

created_atinteger

Time at which this catalog was created, in epoch milliseconds.

created_bystring

Username of catalog creator.

updated_atinteger

Time at which this catalog was last modified, in epoch milliseconds.

updated_bystring

Username of user who last modified catalog.

idstring

Unique identifier for the catalog.

storage_rootstring

Storage root URL for managed storage location of catalog. This can be set when creating a catalog. Example: s3://bucket/ucroot

storage_locationstring

Storage Location URL (full path) for managed storage location of catalog. This is an automatically generated unique path under storage_root. Example: s3://bucket/ucroot/__unitystorage/catalogs/{catalog_id}

Changes

  • 6ed25d35da7aRevision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 2dd9fd4253e0Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status