---
title: "Create a volume"
method: POST
path: "/volumes/create"
tags: ["Volume"]
---

# Create a volume

`POST /volumes/create`

## Request body

- VolumeCreateConfig — config used to create a volume
  - `Name` string — The new volume's name. If not specified, Pouch generates a name.
  - `Driver` string — Name of the volume driver to use.
  - `DriverOpts` object — A mapping of driver options and values. These options are passed directly to the driver and are driver specific.
  - `Labels` object — User-defined key/value metadata.

## Response `201`

The volume was created successfully

- VolumeInfo — Volume represents the configuration of a volume for the container.
  - `Name` string — Name is the name of the volume.
  - `Driver` string — Driver is the Driver name used to create the volume.
  - `Mountpoint` string — Mountpoint is the location on disk of the volume.
  - `CreatedAt` string, dateTime — Date/Time the volume was created.
  - `Status` object — Status provides low-level status information about the volume.
  - `Labels` object — Labels is metadata specific to the volume.
  - `Scope` string — Scope describes the level at which the volume exists (e.g. `global` for cluster-wide or `local` for machine level)

## Other responses

- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.dev/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/revisions/36d75b2825fc/schema)