Skip to main content

Create a new volume

POST 
/projects/:projectId/zones/:zoneName/volumes

Create a volume. In case of success, the response body contains the created volume with its identifier.

Request​

Path Parameters

    projectId stringrequired

    Project Identifier

    zoneName stringrequired

    Zone name

Header Parameters

    X-API-Key string

    Your SIU token if you use this API through Orange Developer.

    Authorization string

    Bearer access token authentication if you use this API through Orange Developer or Orange Developer Inside.

    X-Requester-Id string

    Your SIU Id if you use this API through Orange Developer Inside.

Body

required

Volume attributes in Create request.

    name stringrequired

    Possible values: <= 40 characters, Value must match regular expression [A-Za-z0-9-]

    Unique resource name. This attribute can not be updated.

    description string

    Resource description

    tags

    object

    Tags associated with the resource

    property name* string
    size int32required

    Possible values: >= 1 and <= 5000

    Size of the volume in GB (max: 5000). NB: when updating a volume, the size can not be decreased. For a boot volume, the size can be increased only if it is not attached to a VM.

    image string

    Name of the image to create the volume from. To be selected from the result of GET images.

Responses​

Created

Response Headers

  • X-Job-Href

    string

    Href of the asynchronous job that will process the request, in order to track its status.

  • X-Retry-After

    integer

    The number of seconds to wait before checking the status of the job.

Schema

    id uuidrequired

    Resource identifier.

    hRef urirequired

    Hypertext reference of the resource.

Loading...