.png)
Storages can be organized in zero or more storage groups. Use storage groups to:
-
Allow users to group storages in your applications.
-
Apply storage rules to these groups.
Storage group metadata
Storages groups support key value metadata.
Managing storage groups
List all storage groups
GET /storage/storage-group/ Retrieves all storage groups known by the system. Produces: application/xml, application/json – StorageGroupListDocument Role: _storage_group_read
Create a storage group
PUT /storage/storage-group/(group-name) Creates a new storage group with the specified name. If the group already exists this operation does nothing. Status Codes: 200 OK – Group created successfully. Role: _storage_group_write
Delete a storage group
DELETE /storage/storage-group/(group-name) Removes the storage group with the given name. Note that this operation does not remove the actual storages contained in the group. Status Codes: 200 OK – Group removed successfully. 404 Not found – No group with that name exists. Role: _storage_group_write
Storage group content
List all storages within a group
GET /storage/storage-group/(group-name) Lists all storages belonging to a certain group. Status Codes: 404 Not found – No group with that name exists. Produces: application/xml, application/json – StorageGroupDocument Role: _storage_group_read
Add a storage to a group
PUT /storage/storage-group/(group-name)/(storage-id) Adds a storage to a group. If that group already contains the specified storage this operation does nothing. Status Codes: 200 OK – Group added successfully. 404 Not found – No group with that name or no storage with that id exists. Role: _storage_group_write
Remove a storage from a group
DELETE /storage/storage-group/(group-name)/(storage-id) Removes a storage from a group. Status Codes: 200 OK – Group removed successfully. 404 Not found – No group with that name exists, or the group does not contain that storage. Role: _storage_group_write