Update a volume (Microsoft Azure)
Navigation
- Microsoft Azure volumes
- Attach a Microsoft Azure volume:
- Via the visual interface
- Via the API:
- Create a volume (Microsoft Azure)
- Get details of a volume (Microsoft Azure)
- Update a volume (Microsoft Azure)
This call updates the details of a specific volume.
Request
https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/storage/volumes/{volume_id}
Example request
PATCH /v2/storage/volumes/rfranklin/output HTTP/1.1
Host: api.sb.biodatacatalyst.nhlbi.nih.gov
X-SBG-Auth-Token: 3210a98c1db9304ea9d9273156740f74
curl --data '@patch-volume.json' -s -H "X-SBG-Auth-Token: 3210a98c1db9304ea9d9273156740f74" -H "Content-Type: application/json" -X PATCH "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/storage/volumes/rfranklin/output"
Header Fields
| Name | Description |
|---|---|
| X-SBG-Auth-Token required | Your Platform authentication token. |
| Content-Type required | application/json |
Path parameters
| Name | Description |
|---|---|
volume_idrequired | The volume that you want to update. |
Request body
In the body, you should enter a list of key-value pairs. The keys and the values they take are described in the following table.
| Key | Data type | Description |
|---|---|---|
access_mode | String | Specifies the access mode for the volume. Azure volumes are available only in read-only (RO) mode. |
description | String | An optional description of this volume. |
service | Object | This object should contain the information about the cloud service that this volume represents. See the service object section below for an explanation of its structure. |
The service object
service object| Key | Data type | Description |
|---|---|---|
endpoint | String | Specify a Microsoft Azure endpoint, only if you are using an endpoint that is different from the default one https://(serviceaccount).blob.core.windows.net. To make a non-default endpoint work with the Platform, please first make sure it is supported by Seven Bridges. |
credentials | Object | Contains the Microsoft Azure credentials that are necessary in order to attach your storage container. When updating a volume, you can only use a new client_secret. |
client_secret | String | Value of the client secret you created on the Azure Portal. |
Example request body
{
"description": "Volume containing raw samples collected in April"
}
Response
See a list of Platform-specific response codes that may be contained in the body of the response.
Response body
The response object contains information about the specified volume. The information is structured using the following key-value pairs:
| Key | Data type of value | Description of value |
|---|---|---|
active | Boolean | If a volume is deactivated, this field will be set to false |
id | String | ID of this volume, containing owner/name |
name | String | Name of the volume. |
description | String | The description of this volume. |
service | Object | This object more closely describes the mapping of the volume to the cloud service where the data is stored. See the service object section above for an explanation of its structure. |
created_on | String | The date and time this volume was created. |
modified_on | String | The date and time this volume was last modified. |
Example response body
{
"href": "https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/storage/volumes/rfranklin/myvolume",
"id": "rfranklin/myvolume",
"name": "myvolume",
"description": "Volume containing raw samples collected in April",
"access_mode": "RO",
"service": {
"type": "AZURE",
"bucket": "rfranklinazure.raw-samples",
"prefix": "",
"endpoint": "https://rfranklinazure.blob.core.windows.net/",
"storage_account": "rfranklinazure",
"container": "raw-samples",
"credentials": {
"tenant_id": "a32789b5-123e-45d6-78c9-b8faeb12de9cc",
"client_id": "f3e3f987-276d-5c2c-b87e-e3fe12d782fe"
},
"properties": {
"resource_id": "/subscriptions/e1bfa7ce-123a-575d-789c-5bc70e98f986/resourceGroups/azurepoc/providers/Microsoft.Storage/storageAccounts/rfranklinazure"
}
},
"created_on": "2021-04-28T11:45:48Z",
"modified_on": "2021-05-19T10:03:32Z",
"active": true
}