Skip to main content

Get a volume by its identifier

GET 

/v1/projects/:projectId/zones/:zoneName/volumes/:volumeId

Return the volume with its identifier in the path.

Request

Path Parameters

    projectId stringrequired

    Project Identifier

    zoneName stringrequired

    Zone name

    volumeId stringrequired

    Volume Identifier

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.

Responses

Ok

Schema
    namestringrequired

    Unique resource name. This attribute can not be updated.

    Possible values: Value must match regular expression [A-Za-z0-9-]

    descriptionstring

    Resource description

    tags object

    Tags associated with the resource

    property name*string
    iduuidrequired

    Resource identifier.

    hRefurirequired

    Hypertext reference of the resource.

    createdDatedate-timerequired

    Creation date of the resource.

    lastModifiedDatedate-timerequired

    Date of the last modification of the resource.

    lastRequesterIdstringrequired

    Identifier of the user of the last create/update/delete operation requested on the resource.

    provisioningStateBasicStateEnum (string)required

    Provisioning state of the resource. Possible state:

    • creating: resource creation in progress
    • updating: resource update in progress
    • deleting: resource deletion in progress
    • active: resource created/updated successfully
    • error: resource in error because the last creation/update/deletion failed

    Possible values: [creating, updating, deleting, active, error]

    sizeint32required

    Size of the volume in GB (max: 5000). NB: when updating a volume, the size can not be decreased.

    Possible values: >= 1 and <= 5000

    imagestring

    Name of the image to create the volume from. To be selected from the result of GET images. For a boot volume, the size can be increased only if it is not attached to a VM.

curl -L '/v1/projects/:projectId/zones/:zoneName/volumes/:volumeId' \
-H 'Accept: application/json'
Request Collapse all
Base URL
/v1
Parameters
— pathrequired
— pathrequired
— pathrequired
— header
— header
— header