search
Contact support

Datavolumes

hashtag
List datavolumes in permitted scopes

get

Get requested datavolumes.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
requestTypestring · enumRequired

Which datavolumes to return in the GET datavolumes response. Originated - datavolumes that are originated in the permitted scopes of the caller. UsableInProject - datavolumes that can be used in a specific project; if you use this value, you must also provide the project ID in the "usableInProjectId" query param.

Example: OriginatedPossible values:
usableInProjectIdstringOptional

Only when using "UsableInProject" requestType; Filter results for only datavolumes that are shared with - or originated in - the project.

Example: 5
offsetinteger · int32Optional

The offset of the first item returned in the collection.

Example: 100
limitinteger · int32 · min: 1 · max: 500Optional

The maximum number of entries to return.

Default: 50
sortBystring · enumOptional

Sort results by a parameters.

Possible values:
sortOrderstring · enumOptional

Sort results in descending or ascending order.

Default: ascPossible values:
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contains, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-datavolume-name"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
get
/api/v1/datavolumes

hashtag
Create a datavolume

post
Authorizations
AuthorizationstringRequired

Bearer authentication

Body
namestring · max: 63Required

The name of the new data volume.

Example: datavolume-aPattern: ^[a-z][-a-z0-9]{0,62}$
descriptionstring · max: 127Optional

A brief description of the data volume and its purpose.

Example: Results of experiment X
originPvcNamestringRequired

The name of the existing PVC that the new data volume is based on.

Example: pvc-a
projectIdstringRequired

The ID of the project whose namespace contains the origin PVC.

Example: 5
shouldDeleteOriginalVolumebooleanOptional

True is not supported. This parameter will be removed in a future release.

Default: falseExample: false
useOriginalVolumeboolean · nullableOptional

If true, the original storage volume will be used together with the data volume. Default true as long as "shouldDeleteOriginalVolume" is false.

Default: trueExample: true
Responses
chevron-right
201

Created

application/json
post
/api/v1/datavolumes

hashtag
Get datavolume

get
Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210
Responses
get
/api/v1/datavolumes/{datavolumeId}

hashtag
Delete datavolume

delete
Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210
Responses
delete
/api/v1/datavolumes/{datavolumeId}

hashtag
Patch datavolume

patch
Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210
Body
descriptionstring · max: 127OptionalExample: Results of experiment X
Responses
patch
/api/v1/datavolumes/{datavolumeId}

hashtag
Data volumes name availability.

get

Check if a given data volume name creates naming conflicts under the given scope. Returns conflict (409) in case the name is not available, or 204 (no content) if it is ok.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
dataNamestring · min: 1Required

the name of the datavolume

clusterIdstring · uuidRequired

The id of the cluster

Example: d73a738f-fab3-430a-8fa3-5241493d7128
Responses
get
/api/v1/datavolumes/name-availability
No content

hashtag
Count data volumes.

get

Retrieve the number of data volumes.

Authorizations
AuthorizationstringRequired

Bearer authentication

Query parameters
requestTypestring · enumRequired

Which datavolumes to return in the GET datavolumes response. Originated - datavolumes that are originated in the permitted scopes of the caller. UsableInProject - datavolumes that can be used in a specific project; if you use this value, you must also provide the project ID in the "usableInProjectId" query param.

Example: OriginatedPossible values:
usableInProjectIdstringOptional

Only when using "UsableInProject" requestType; Filter results for only datavolumes that are shared with - or originated in - the project.

Example: 5
filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contains, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-datavolume-name"]
searchstringOptional

Filter results by a free text search.

Example: test project
Responses
get
/api/v1/datavolumes/count

hashtag
Get the datavolume's shared scopes

get
Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210
Responses
get
/api/v1/datavolumes/{datavolumeId}/sharedScopes

hashtag
Patch the datavolume's shared scopes

patch
Authorizations
AuthorizationstringRequired

Bearer authentication

Path parameters
datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210
Body
Responses
patch
/api/v1/datavolumes/{datavolumeId}/sharedScopes
PreviousAuditLogsNextEvents

Last updated