Introduction
A Unity REST Catalog refers to an API-based implementation that acts as a central metadata management service, often associated with distributed data processing and data lake architectures. It provides a unified interface to manage and query metadata for different data assets like databases, tables, schemas, and files stored across multiple storage systems.
The api are in beta state and expected to change.
Authentication
Required Purpose: To work with the API, you must use an IBM Cloud Pak for Data API key (platform API key or instance API key), or IBM Cloud Pak for Data authorization token (platform token or instance token). The API key or token is used to determine the actions that a user or service ID has access to when they use the API.
You can generate an API key or authorization token for an authenticated user by using the Cloud Pak for Data APIs. For more information, see Generating an authorization token or API key.
To use the API, add a valid API key or token to the HTTP Authorization request header. For token, -H 'Authorization: Bearer {TOKEN}'.
For API key, you need to firstly encode username together with API key: echo "<username>:<api_key>" | base64.
Then, you can use the ZenApiKey header to authenticate to an endpoint: -H "Authorization: ZenApiKey <encoded value>".
To retrieve your access token:
For most Cloud Pak for Data endpoints, you can use the generated API key in the authorization header of subsequent API calls.
curl -H "Authorization: ZenApiKey <token>" "https://<cpd_instance_route>/<endpoint>"
If the ZenApiKey token is not supported, use a generated Bearer token in the authorization header of subsequent API calls.
curl -H "Authorization: Bearer <token>" "https://<cpd_instance_route>/<endpoint>"
Error handling
This API uses standard HTTP response codes to indicate whether a method completed successfully. A 200 response indicates success. A 400 type response indicates a failure, and a 500 type response indicates an internal system error.
| HTTP Error Code | Description | Recovery |
|---|---|---|
200 |
Success | The request was successful. |
400 |
Bad Request | The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request. |
401 |
Unauthorized | You are not authorized to make this request. Log in to IBM Cloud and try again. If this error persists, contact the account owner to check your permissions. |
403 |
Forbidden | The supplied authentication is not authorized to access '{namespace}'. |
404 |
Not Found | The requested resource could not be found. |
409 |
Conflict | The entity is already in the requested state. |
500 |
Internal Server Error | Your request could not be processed. Wait a few minutes and try again. |
Methods
Request
Create catalog
Name of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUser-provided free-form text description.
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"name":"string","comment":"string","properties":{"locationUri":"string","storageName":"string","catalogType":"string"}}' "https://{region}/api/2.1/unity-catalog/catalogs"
Response
Catalog Info
Name of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Username of current owner of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of catalog creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9-_]*$
Status Code
The new catalog was successfully created.
Bad Request
Unauthorized
{ "name": "string", "comment": "string", "properties": { "storageName": "string", "catalogType": "string", "additionalProp3": "string" }, "created_at": 0, "updated_at": 0, "id": "10", "owner": "string", "created_by": "string", "updated_by": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
List catalogs
Lists the available catalogs. There is no guarantee of a specific ordering of the elements in the list.
GET /catalogs
Request
Query Parameters
Opaque pagination token to go to next page based on previous query.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Maximum number of catalogs to return.
- when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
- when set to 0, the page length is set to a server configured value;
- when set to a value less than 0, an invalid parameter error is returned;
Possible values: 0 ≤ value ≤ 1000000000000000
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/catalogs"
Response
List of catalogs
An array of catalog information objects.
Possible values: 0 ≤ number of items ≤ 1000000000
Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request (for the next page of results).
Possible values: 1 ≤ length ≤ 2000000, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The catalog list was successfully retrieved.
Bad Request
Unauthorized
{ "catalogs": [ { "name": "string", "comment": "string", "properties": { "catalogType": "string", "storageName": "string" }, "created_at": 0, "updated_at": 0, "id": "0", "owner": "string", "created_by": "string", "updated_by": "string" } ] }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
The name of the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/catalogs/{catalog_name}"
Response
Catalog Info
Name of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Username of current owner of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of catalog creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9-_]*$
Status Code
The catalog was successfully retrieved.
Bad Request
Unauthorized
{ "name": "string", "comment": "string", "properties": { "catalogType": "string", "storageName": "string" }, "created_at": 0, "updated_at": 0, "id": "string", "owner": "string", "created_by": "string", "updated_by": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
The name of the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Query Parameters
Force deletion even if the catalog is not empty.
curl -X DELETE -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/catalogs/{catalog_name}?force=true"
Response
Delete Catalog Response
Status Code
The catalog was successfully deleted.
Bad Request
Unauthorized
catalog: <catalog_name> deleted successfully
{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Create a Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUser-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Example:
string
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"name": "testschema", "catalog_name": "testcatalog","comment": "string","properties": { "locationUri": "s3a://{bucket_name}/{schema_name}.db"}}' "https://{region}/api/2.1/unity-catalog/schemas"
Response
Information about Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringUser-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Example:
string
Full name of schema, in form of catalog_name.schema_name.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_.]*$Example:
stringUsername of current owner of schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringTime at which this schema was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of schema creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this schema was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringNew name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The new schema was successfully created.
Bad Request
Unauthorized
{ "name": "string", "catalog_name": "string", "comment": "string", "properties": { "locationUri": "s3a://bucket_name/schema_name.db" }, "full_name": "string", "created_at": 0, "updated_at": 0, "schema_id": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
List schemas
Gets an array of schemas for a catalog. There is no guarantee of a specific ordering of the elements in the array.
GET /schemas
Request
Query Parameters
Parent catalog for schemas of interest.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Maximum number of schemas to return.
- when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
- when set to 0, the page length is set to a server configured value;
- when set to a value less than 0, an invalid parameter error is returned;
Possible values: 0 ≤ value ≤ 1000000000000000
Opaque pagination token to go to next page based on previous query.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/schemas?catalog_name={catalog_name}"
Response
List Schema Response
An array of schema information objects.
Possible values: 0 ≤ number of items ≤ 250
Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request (for the next page of results).
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The schemas list was successfully retrieved.
Bad Request
Unauthorized
{ "schemas": [ { "name": "string", "catalog_name": "string", "comment": "string", "properties": { "locationUri": "s3a://bucketname/schema_name.db" }, "full_name": "string", "created_at": 0, "updated_at": 0, "schema_id": "0" } ] }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the schema.
Possible values: 1 ≤ length ≤ 256, Value must match regular expression
^[a-zA-Z0-9.-_]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/schemas/{catalog_name.schema_name}"
Response
Information about Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringUser-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Example:
string
Full name of schema, in form of catalog_name.schema_name.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_.]*$Example:
stringUsername of current owner of schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringTime at which this schema was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of schema creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this schema was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringNew name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The schema was successfully retrieved.
Bad Request
Unauthorized
{ "name": "string", "catalog_name": "string", "comment": "string", "properties": { "locationUri": "s3a://bucket_name/schema_name.db" }, "full_name": "string", "created_at": 0, "updated_at": 0, "schema_id": "3" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the schema.
Possible values: 1 ≤ length ≤ 256, Value must match regular expression
^[a-zA-Z0-9.-_]*$
Update Schema
User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Example:
string
New name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
curl -X PATCH -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d "comment": "string", "properties": { "additionalProp1": "string","additionalProp2": "string","additionalProp3": "string"},"new_name": "string" "https://{region}/api/2.1/unity-catalog/schemas/{catalog_name.schema_name}"
Response
Information about Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringUser-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Example:
string
Full name of schema, in form of catalog_name.schema_name.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_.]*$Example:
stringUsername of current owner of schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Example:
stringTime at which this schema was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of schema creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this schema was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringNew name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The schema was successfully updated.
Bad Request
Unauthorized
{ "name": "string", "catalog_name": "string", "comment": "string", "properties": { "locationUri": "s3a://bucketname/schemaname.db" }, "full_name": "catalog_name.schema_name", "created_at": 0, "updated_at": 0, "schema_id": "3" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the schema.
Possible values: 1 ≤ length ≤ 256, Value must match regular expression
^[a-zA-Z0-9.-_]*$
Query Parameters
Force deletion even if the catalog is not empty.
curl -X DELETE -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/schemas/{catalog_name.schema_name}"
Response
Status Code
The schema was successfully deleted.
Bad Request
Unauthorized
true{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Create a table.
Creates a new external table instance. WARNING: This API is experimental and will change in future versions.
POST /tables
Request
Create a table
Name of table, relative to parent schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
testTableName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
testcatalogName of parent schema relative to its parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
testSchemaTable Type
Allowable values: [
MANAGED,EXTERNAL]Example:
MANAGEDData source format
Allowable values: [
DELTA,CSV,JSON,AVRO,PARQUET,ORC,TEXT]Example:
TEXTThe array of ColumnInfo definitions of the table's columns.
Possible values: 0 ≤ number of items ≤ 250
Storage root URL for external table
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUser-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d "{" "name": "testtable", "catalog_name": "testcatalog", "schema_name": "testschema", "table_type": "MANAGED", "data_source_format": "DELTA", "columns": [{ "name": "id", "type_text": "string", "type_json": "string", "type_name": "BOOLEAN", "type_precision": 0, "type_scale": 0, "type_interval_type": "string", "position": 0, "comment": "string", "nullable": true, "partition_index": 0 }], "storage_location": null, "comment": "string", "properties": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } }" "https://{region}/api/2.1/unity-catalog/tables"
Response
Table Info
Name of table, relative to parent schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringName of parent schema relative to its parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringTable Type
Possible values: [
MANAGED,EXTERNAL]Example:
MANAGEDData source format
Possible values: [
DELTA,CSV,JSON,AVRO,PARQUET,ORC,TEXT]Example:
TEXTThe array of ColumnInfo definitions of the table's columns.
Possible values: 0 ≤ number of items ≤ 250
Storage root URL for table (for MANAGED, EXTERNAL tables)
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*://[A-Za-z0-9-]{3,63}(?:.[A-Za-z0-9-]{3,63})*(/[A-Za-z0-9-_/]+)*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Username of current owner of table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of table creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUnique identifier for the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Status Code
The new external table was successfully created.
Bad Request
Unauthorized
{ "name": "string", "catalog_name": "string", "schema_name": "string", "table_type": "EXTERNAL", "data_source_format": "HIVE", "columns": [ { "name": "id", "type_text": "string", "type_json": "string", "type_name": "STRING", "type_precision": 0, "type_scale": 0, "type_interval_type": null, "position": 0, "comment": "string", "nullable": false, "partition_index": 1 } ], "storage_location": "string", "comment": null, "properties": { "external.table.purge": "TRUE", "additionalProp1": "string", "EXTERNAL": "TRUE", "transient_lastDdlTime": "string", "TRANSLATED_TO_EXTERNAL": "TRUE", "additionalProp3": "string", "additionalProp2": "string" }, "created_at": 0, "updated_at": 0, "table_id": "0" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
List tables
Gets the list of all available tables under the parent catalog and schema. There is no guarantee of a specific ordering of the elements in the array.
GET /tables
Request
Query Parameters
Name of parent catalog for tables of interest.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Parent schema of tables.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Maximum number of tables to return.
- when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
- when set to 0, the page length is set to a server configured value;
- when set to a value less than 0, an invalid parameter error is returned;
Possible values: 0 ≤ value ≤ 1000000000000000
Opaque token to send for the next page of results (pagination).
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/tables"
Response
List of Tables
An array of table information objects.
Possible values: 0 ≤ number of items ≤ 10000
Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request (for the next page of results).
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The tables list was successfully retrieved.
Bad Request
Unauthorized
{ "tables": [ { "name": "string", "catalog_name": "string", "schema_name": "string", "table_type": "EXTERNAL", "data_source_format": "DELTA", "columns": [ { "name": "id", "type_text": "string", "type_json": "string", "type_name": "STRING", "type_precision": 0, "type_scale": 0, "type_interval_type": "string", "position": 0, "comment": "string", "nullable": false, "partition_index": 0 } ], "storage_location": "string", "comment": "string", "properties": { "external.table.purge": "TRUE", "additionalProp1": "string", "EXTERNAL": "TRUE", "transient_lastDdlTime": "string", "TRANSLATED_TO_EXTERNAL": "TRUE", "additionalProp3": "string", "additionalProp2": "string" }, "created_at": 0, "updated_at": 0, "table_id": "26" } ] }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the table.
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/tables/{catalog_name.schema_name.table_name}"
Response
Table Info
Name of table, relative to parent schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringName of parent schema relative to its parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringTable Type
Possible values: [
MANAGED,EXTERNAL]Example:
MANAGEDData source format
Possible values: [
DELTA,CSV,JSON,AVRO,PARQUET,ORC,TEXT]Example:
TEXTThe array of ColumnInfo definitions of the table's columns.
Possible values: 0 ≤ number of items ≤ 250
Storage root URL for table (for MANAGED, EXTERNAL tables)
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*://[A-Za-z0-9-]{3,63}(?:.[A-Za-z0-9-]{3,63})*(/[A-Za-z0-9-_/]+)*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Username of current owner of table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of table creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUnique identifier for the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Status Code
The table was successfully retrieved.
Bad Request
Unauthorized
{ "name": "string", "catalog_name": "string", "schema_name": "string", "table_type": "EXTERNAL", "data_source_format": "DELTA", "columns": [ { "name": "id", "type_text": "string", "type_json": "string", "type_name": "string", "type_precision": 0, "type_scale": 0, "type_interval_type": "string", "position": 0, "comment": "string", "nullable": false, "partition_index": 0 } ], "storage_location": "s3a://func-test-bucket/presto-warehouse/ad_hive_schema/my_table_ad", "comment": "string", "properties": { "external.table.purge": "TRUE", "additionalProp1": "string", "EXTERNAL": "TRUE", "transient_lastDdlTime": "string", "TRANSLATED_TO_EXTERNAL": "TRUE", "additionalProp3": "string", "additionalProp2": "string" }, "created_at": 0, "updated_at": 0, "table_id": "0" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Delete a table
Deletes a table from the specified parent catalog and schema.
DELETE /tables/{full_name}Request
Path Parameters
Full name of the table.
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X DELETE -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://{region}/api/2.1/unity-catalog/tables/{catalog_name.schema_name.table_name}"
Response
Status Code
The table was successfully deleted.
Bad Request
Unauthorized
true{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
{
"table_id": "string",
"operation": "UNKNOWN_TABLE_OPERATION"
}Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Allowable values: [
UNKNOWN_TABLE_OPERATION,READ,READ_WRITE]
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"table_id":"10","operation":"UNKNOWN_TABLE_OPERATION"}' "https://{region}/api/2.1/unity-catalog/temporary-table-credentials"
Response
Response for credential APIs
Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 0 ≤ value ≤ 1000000000000000
Status Code
OK
Bad Request
Unauthorized
{ "aws_temp_credentials": "string", "azure_user_delegation_sas": { "sas_token": "string" }, "gcp_oauth_token": "string", "expiration_time": 0 }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Get a temporary Path credential
{
"url": "string",
"operation": "UNKNOWN_PATH_OPERATION"
}url
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Operation
Allowable values: [
UNKNOWN_PATH_OPERATION,PATH_READ,PATH_READ_WRITE,PATH_CREATE_TABLE]
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"url":"string","operation":"UNKNOWN_PATH_OPERATION"}' "https://{region}/api/2.1/unity-catalog/temporary-path-credentials"
Response
Response for credential APIs
Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 0 ≤ value ≤ 1000000000000000
Status Code
OK
Bad Request
Unauthorized
{ "aws_temp_credentials": "string", "azure_user_delegation_sas": { "sas_token": "string" }, "gcp_oauth_token": "string", "expiration_time": 0 }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }