Create a new volume

POST 
/v1/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.

application/json

Bodyrequired

Volume attributes in Create request.

namestringrequired

Unique resource name. This attribute can not be updated.

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

descriptionstring

Resource description

tags object

Tags associated with the resource

property name*string

sizeint32required

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.

Possible values: >= 1 and <= 5000

imagestring

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

Responses

201

Created

Response Headers

X-Job-Href

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

X-Retry-After

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

application/json

Schema

Schema

iduuidrequired

Resource identifier.

hRefurirequired

Hypertext reference of the resource.

Example (auto)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "hRef": "string"
}

OK

{   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",   "hRef": "/projects/{projectId}/zones/{zoneName}/volumes/{volumeId}" }

400

Bad Request

Request is not valid

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

401

Unauthorized

Credentials are missing

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

403

Forbidden

Valid credentials but not enough privileges to perform the operation

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

404

Not Found

Unknown resource or service

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

405

Method Not Allowed

Operation is not valid according to the state of the resource

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

500

Internal Server Error

Unexpected error, please contact support

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

503

Service Unavailable

Service probably in maintenance. Please retry later.

application/json

Schema

Schema

codeint32required

An integer coding the error type. This is given to caller so he can translate them if required.

messagestringrequired

A short localized string that describes the error.

descriptionstring

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (auto)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

• curl
• python
• go
• nodejs
• php
• java

• CURL

curl -L '/v1/projects/:projectId/zones/:zoneName/volumes' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "name": "string",
  "description": "string",
  "tags": {},
  "size": 0,
  "image": "string"
}'

Request Collapse all

Base URL

/v1

Parameters

projectId — pathrequired

zoneName — pathrequired

X-API-KEY — header

Authorization — header

X-Requester-Id — header

Body required

• Example (from schema)
• createVolume

{
  "name": "string",
  "description": "string",
  "tags": {},
  "size": 0,
  "image": "string"
}