.. role:: green

Create Volume
=============

**Type:** :guilabel:`POST`

.. py:function:: https://cloud.syminet.com/api/v1/volumes/create/{SLICE_ID}

    Create a new volume and attach it to ``SLICE_ID``.

**Required URL Parameters:**

SLICE_ID
  Slice ID to attach new volume.

**Required JSON Properties:**

volume_name
  Volume name.

volume_size
  Volume size.  Integer, in GB.  Max 4000 (4TB).

.. code-block:: shell
   :caption: Curl

    curl --request POST \
         --url https://cloud.syminet.com/api/v1/volumes/create/SLICE_ID \
         --header "content-type: application/json" \
         --header "authorization:bearer $API_TOKEN" \
         --data '
         {
            "volume_name": "myvolume",
            "volume_size": "100"
         }
         '

**Response:** :green:`202 OK`