Skip to content

Latest commit

 

History

History
152 lines (93 loc) · 4.75 KB

VolumesApi.md

File metadata and controls

152 lines (93 loc) · 4.75 KB

VolumesApi

All URIs are relative to http://localhost:8080/api/2.1/unity-catalog

Method HTTP request Description
createVolume POST /volumes Create a Volume
deleteVolume DELETE /volumes/{name} Delete a Volume
getVolume GET /volumes/{name} Get a Volume
listVolumes GET /volumes List Volumes
updateVolume PATCH /volumes/{name} Update a Volume

createVolume

VolumeInfo createVolume(CreateVolumeRequestContent)

Create a Volume

Creates a new volume. 

Parameters

Name Type Description Notes
CreateVolumeRequestContent CreateVolumeRequestContent

Return type

VolumeInfo

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

deleteVolume

oas_any_type_not_mapped deleteVolume(name)

Delete a Volume

Deletes a volume from the specified parent catalog and schema. 

Parameters

Name Type Description Notes
name String The three-level (fully qualified) name of the volume [default to null]

Return type

oas_any_type_not_mapped

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

getVolume

VolumeInfo getVolume(name)

Get a Volume

Gets a volume for a specific catalog and schema. 

Parameters

Name Type Description Notes
name String The three-level (fully qualified) name of the volume [default to null]

Return type

VolumeInfo

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

listVolumes

ListVolumesResponseContent listVolumes(catalog_name, schema_name, max_results, page_token)

List Volumes

Gets an array of available volumes under the parent catalog and schema. There is no guarantee of a specific ordering of the elements in the array. 

Parameters

Name Type Description Notes
catalog_name String The identifier of the catalog [default to null]
schema_name String The identifier of the schema [default to null]
max_results Integer Maximum number of volumes to return (page length). If not set, the page length is set to a server configured value. - 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; Note: this parameter controls only the maximum number of volumes to return. The actual number of volumes returned in a page may be smaller than this value, including 0, even if there are more pages. [optional] [default to null]
page_token String Opaque token returned by a previous request. It must be included in the request to retrieve the next page of results (pagination). [optional] [default to null]

Return type

ListVolumesResponseContent

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

updateVolume

VolumeInfo updateVolume(name, UpdateVolumeRequestContent)

Update a Volume

Updates the specified volume under the specified parent catalog and schema.  Currently only the name or the comment of the volume could be updated. 

Parameters

Name Type Description Notes
name String The three-level (fully qualified) name of the volume [default to null]
UpdateVolumeRequestContent UpdateVolumeRequestContent [optional]

Return type

VolumeInfo

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json