# Create

Launch stage: GA

`POST /api/2.1/unity-catalog/volumes`

Creates a new volume.

 The user could create either an external volume or a managed volume. An external volume
 will be created in the specified external location, while a managed volume
 will be located in the default location which is specified by the parent schema,
 or the parent catalog, or the Metastore.

 For the volume creation to succeed, the user must satisfy following conditions:
 - The caller must be a metastore admin, or be the owner of the parent catalog and schema,
   or have the **USE_CATALOG** privilege on the parent catalog
   and the **USE_SCHEMA** privilege on the parent schema.
 - The caller must have **CREATE VOLUME** privilege on the parent schema.

 For an external volume, following conditions also need to satisfy
 - The caller must have **CREATE EXTERNAL VOLUME** privilege on the external location.
 - There are no other tables, nor volumes existing in the specified storage location.
 - The specified storage location is not under the location of other tables, nor volumes,
   or catalogs or schemas.

API scopes: unity-catalog

## Request body

- `name` (string, optional)
  The name of the volume
- `catalog_name` (string, optional)
  The name of the catalog where the schema and the volume are
- `schema_name` (string, optional)
  The name of the schema where the volume is
- `volume_type` (string, optional)
  The type of the volume. An external volume is located in the specified external location.
   A managed volume is located in the default location which is specified by the parent schema, or the parent catalog, or the Metastore.
   [Learn more](https://docs.databricks.com/aws/en/volumes/managed-vs-external)
  Possible values: `MANAGED`, `EXTERNAL`
- `storage_location` (string, optional)
  The storage location on the cloud
- `owner` (string, optional)
  The identifier of the user who owns the volume
- `comment` (string, optional)
  The comment attached to the volume
  Constraints: `[ 1 .. 65536 ] characters`
- `full_name` (string, optional)
  The three-level (fully qualified) name of the volume
- `volume_id` (string, optional)
  The unique identifier of the volume
- `metastore_id` (string, optional)
  The unique identifier of the metastore
- `created_at` (int64, optional)
- `created_by` (string, optional)
  The identifier of the user who created the volume
- `updated_at` (int64, optional)
- `updated_by` (string, optional)
  The identifier of the user who updated the volume last time
- `access_point` (string, optional)
  The AWS access point to use when accesing s3 for this external location.
- `browse_only` (boolean, optional)
  Indicates whether the principal is limited to retrieving metadata for the associated object through the BROWSE privilege when include_browse is enabled in the request.

## Returns

Returns the VolumeInfo object.

## Response

```json
{
  "name": "string",
  "catalog_name": "string",
  "schema_name": "string",
  "volume_type": "string",
  "storage_location": "string",
  "owner": "string",
  "comment": "string",
  "full_name": "string",
  "volume_id": "string",
  "metastore_id": "string",
  "created_at": 0,
  "created_by": "string",
  "updated_at": 0,
  "updated_by": "string",
  "access_point": "string",
  "browse_only": true
}
```