# Update

Launch stage: GA

`PATCH /api/2.1/unity-catalog/volumes/{full_name_arg}`

Updates the specified volume under the specified parent catalog and schema.

 The caller must be a metastore admin or an owner of the volume.
 For the latter case, the caller must also be the owner or have the **USE_CATALOG**
 privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema.

 Currently only the name, the owner or the comment of the volume could be updated.

API scopes: unity-catalog

## Path parameters

- `full_name_arg` (string, optional)
  The three-level (fully qualified) name of the volume

## Request body

- `new_name` (string, optional)
  New name for the volume.
- `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
}
```