{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","examples":{"codes":[]},"method":"post","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Create a volume","type":"endpoint","slug":"create-a-volume-v2","excerpt":"","body":"This call creates a new volume. Currently, volumes may be created using three types of cloud storage repository: \n* Amazon Web Services' (AWS) S3 buckets\n* Google Cloud Storage (GCS) buckets\n* Other types of cloud storage, through an S3-compatible API (read-only). This cloud storage type requires an additional API layer that the storage employs, which must use the same \"language\" as the AWS S3 API. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If your are using a cloud storage provider other than Amazon Web Services S3 or Google Cloud Storage, please make sure you have met the following requirements:\\n* There is an additional API layer implemented on your cloud storage, compatible with the AWS S3 API. This means that you need to use an additional service or software on top of your storage, that will emulate the behavior and interaction of AWS S3 storage.\\n* You or your cloud storage administrator can provide S3-compatible storage endpoint and credentials that are required to connect the storage to CAVATICA. These should be available for creation or obtaining when you have met the previous prerequisite.\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://cavatica-api.sbgenomics.com/v2/storage/volumes\",\n      \"language\": \"text\",\n      \"name\": \"API path\"\n    }\n  ]\n}\n[/block]\n##Request\n\n###Example request\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /v2/storage/volumes HTTP/1.1\\nHost: cavatica-api.sbgenomics.com\\nX-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74\\nContent-Type: application/json\",\n      \"language\": \"http\",\n      \"name\": null\n    },\n    {\n      \"code\": \"curl --data ':::at:::create-volume.json' -X POST -H \\\"X-SBG-Auth-Token: ce7ae5ab85e946599298e88a3430fba0\\\" -H \\\"Content-Type: application/json\\\" 'https://cavatica-api.sbgenomics.com/storage/volumes'\",\n      \"language\": \"curl\",\n      \"name\": \"cURL\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n###Header Fields\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Description of value\",\n    \"0-0\": \"`X-SBG-Auth-Token`\\n_required_\",\n    \"0-1\": \"Your CAVATICA [authentication token](doc:get-your-authentication-token).\",\n    \"h-2\": \"\",\n    \"1-0\": \"`Content-type`\\n_required_\",\n    \"1-1\": \"`application/json`\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n###Request body\n\nIn the body, you should enter a list of key-value pairs. The keys and the values they take are described in the following table.\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"`name`\\n_required_\",\n    \"2-0\": \"`description`\",\n    \"h-0\": \"Key\",\n    \"h-1\": \"Data type of value\",\n    \"0-1\": \"String\",\n    \"2-1\": \"String\",\n    \"0-2\": \"The name of the volume. It must be unique from all other volumes for this user.\",\n    \"h-2\": \"Description of value\",\n    \"2-2\": \"An optional description of this volume.\",\n    \"3-0\": \"`service`\\n_required_\",\n    \"3-1\": \"Object\",\n    \"3-2\": \"This object should contain the information about the cloud service that this volume represents.\\n\\nSee the <code><a href=\\\"#section-the-service-object\\\">service</code> object section</a> below for an explanation of its structure.\",\n    \"1-0\": \"<a name=\\\"access-mode\\\"></a>\\n`access_mode`\",\n    \"1-1\": \"String\",\n    \"1-2\": \"Signifies whether this volume should be used for read-write (`\\\"RW\\\"`) or read-only (`\\\"RO\\\"`) operations.\\n\\nThe access mode is consulted independently of the credentials granted to Seven Bridges when the volume was created, so it is possible to use a read-write credentials to register both read-write and read-only volumes using it.\\n\\n_default:_ `\\\"RW\\\"`\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]\n###The `service` object\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Data type of value\",\n    \"h-2\": \"Description of value\",\n    \"0-0\": \"`type`\",\n    \"0-1\": \"string\",\n    \"0-2\": \"The type of cloud service supported. Currently the only valid values are `\\\"s3\\\"` for Amazon Web Services or an S3-compatible endpoint and `\\\"gcs\\\"` for Google Cloud Storage.\",\n    \"1-0\": \"`prefix`\",\n    \"1-1\": \"String\",\n    \"2-0\": \"`bucket`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `s3` and `gcs`_</span>\\n_required_\",\n    \"2-1\": \"String\",\n    \"3-0\": \"`root_url`\\n\\n_default: https://s3.amazonaws.com for `s3`,  https://www.googleapis.com/ for `gcs`, or a custom endpoint if you are connecting cloud storage through an S3-compatible endpoint._\",\n    \"4-0\": \"`credentials`\",\n    \"4-1\": \"Object\",\n    \"5-0\": \"<a name=\\\"access-key-id\\\"></a>`access_key_id`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `s3`_</span>\\n_required_\",\n    \"3-1\": \"String\",\n    \"5-1\": \"String\",\n    \"6-0\": \"<a name=\\\"secret-access-key\\\"></a>`secret_access_key`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `s3`_</span>\\n_required_\",\n    \"6-1\": \"String\",\n    \"7-0\": \"<a name=\\\"client-email\\\"></a>`client_email`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `gcs`_</span>\\n_required_\",\n    \"7-1\": \"String\",\n    \"8-0\": \"<a name=\\\"private-key\\\"></a>`private_key`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `gcs`_</span>\\n_required_\",\n    \"8-1\": \"String\",\n    \"9-0\": \"`properties`\",\n    \"9-1\": \"Object\",\n    \"10-0\": \"`sse_algorithm`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `s3`_</span>\",\n    \"11-0\": \"`sse_aws_kms_key_id`\\n\\n<span style=\\\"color:#871818\\\">_applies to type: `s3`_</span>\",\n    \"10-1\": \"String\",\n    \"11-1\": \"String\",\n    \"2-2\": \"The name of the bucket you wish to register as a volume.\",\n    \"1-2\": \"A service-specific prefix to prepend to all objects created in this volume. If the service supports folders, and this prefix includes them, the API will attempt to create any missing folders when it outputs a file.\\n\\n_default:_ `\\\"\\\"`\",\n    \"3-2\": \"Cloud provider API endpoint to use when accessing this bucket.\\n\\nFor a list of AWS-supported endpoints, see <a href=\\\"http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region\\\" target=\\\"blank\\\">AWS Regions and Endpoints</a>.\",\n    \"4-2\": \"Contains credentials for the underlying cloud provider.\\n\\n* AWS IAM user, or S3-compatible endpoint:\\n    * [`access-key-id`](#access-key-id)\\n    * [`secret_access-key`](#secret-access-key)\\n<span style=\\\"margin:10px;\\\"></span>\\n\\nFor Google Cloud Storage, these credentials are:\\n\\n* [`client_email`](#client-email)\\n* [`private_key`](#private-key)\",\n    \"5-2\": \"AWS access key ID of the IAM user shared with Seven Bridges to access this bucket.\",\n    \"6-2\": \"AWS secret access key of the IAM user shared with Seven Bridges to access this bucket.\",\n    \"7-2\": \"Google Cloud Platform user email.\",\n    \"8-2\": \"Google Cloud Platform private key.\",\n    \"9-2\": \"Contains properties of specific service.\",\n    \"10-2\": \"Use default AES256 server-side encryption or AWS KMS encryption when writing to this bucket.\\n\\nCan be:\\n  * AES256 (default)\\n  * aws:kms\\n\\n_default: AES256_\",\n    \"11-2\": \"If AWS KMS encryption is used, this should be set to the required KMS key. If not set and `aws:kms` is set as `sse_algorithm`, default KMS key is used.\"\n  },\n  \"cols\": 3,\n  \"rows\": 12\n}\n[/block]\n###Example request body\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"name\\\": \\\"my_s3_volume\\\",\\n  \\\"service\\\": {\\n    \\\"type\\\": \\\"s3\\\",\\n    \\\"bucket\\\": \\\"input_files\\\",\\n    \\\"prefix\\\": \\\"\\\",\\n    \\\"credentials\\\": {\\n      \\\"access_key_id\\\": \\\"AKIAIOSFODNN7EXAMPLE\\\",\\n      \\\"secret_access_key\\\": \\\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\\\"\\n    },\\n    \\\"properties\\\": {\\n      \\\"sse_algorithm\\\": \\\"AES256\\\"\\n    }\\n  },\\n  \\\"access_mode\\\": \\\"RO\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Example request body for AWS S3 (IAM user)\"\n    },\n    {\n      \"code\": \"{\\n  \\\"name\\\": \\\"my_gcs_volume\\\",\\n  \\\"description\\\": \\\"New google volume\\\",\\n  \\\"service\\\": {\\n    \\\"type\\\": \\\"gcs\\\",\\n    \\\"bucket\\\": \\\"output_files\\\",\\n    \\\"prefix\\\": \\\"output\\\",\\n    \\\"credentials\\\": {\\n      \\\"client_email\\\": \\\"[email protected]erviceaccount.com\\\",\\n      \\\"private_key\\\": \\\"-----BEGIN RSA PRIVATE KEY-----\\\\nMIIEpQIBAAKCAQEAsXj4E7svaB4szcOrAcraSbsGnNuTU1b/4llyspDa0lltZIKL\\\\nfl5s3QoqbjUWqAZXkJexKus55g49ULD8BGKH2r4EF+XyKcpoon4uIFcbmYcmsUXM\\\\nJ3ujgyL5DbWnQZ6GrqgFNRFVVz/PuvTZOd6KFCrjbbtCxfKoXQrmCwFC/4NlFR3v\\\\n1kavU81w201Mied3e+pxjfiQKAJOoy5I7kfuH20xfzHXWR2YHdQGbzOUZyPgmzZ6\\\\nH6Ry39b7bgLVbyk3++e13KrsTEf58rRzUHLzlcUDcGyf8iTO2vA2qzcbrbovwqJr\\\\n7H4ZfFllDMYQ/ISj4cmi+sz/hR43LUK86emrXwIDAQABAoIBADBr2fvAMbINsZm+\\\\njjTh/ObrAWXgvvSZIx3F2/Z+cUW9Ioyu1ZJ3/uncMTF6iKD1ggSwbqVQIq7zKaWP\\\\ndGNZ4sk62PEQSx8924iiNsGaIqyj5FmvuoD3SeiorR0hd+3+a67RpwIQpaE1ht7y\\\\nmSYh4riX7w9sbU6G44rnQ1azVG1UHvk5ieOD4OPvJopuc6D6ow1oJOnHE0k8v3HY\\\\n1FpLdWCL6nSERqXOI5w+tllG4NMUmTZ2jhaBSEM4PIJVO+24TM3XFCcvhZ7ipPMF\\\\nP5B8hV4hDA4Av1Ei7iuRZlJsH4sRrtHJE3/FZLgqHRRvt/7w4c1xnwirNghtTNMb\\\\nXVoaS/ECgYEA15vL3l22mIoePlcCxIgVCAxhKm6TVQZsAE2EaeVsJKDl0AgCtn/1\\\\nThMIPPGkO8jmjqHGgA+FhjoUQuCCdIuON00mUpmUxZlwI5+uknuK597/zAjd6W8s\\\\n7p9apvBUDfod0hwF9Jfw+aUtZm6EAUNR1Odbb+bpXp1luwfcesHe4QcCgYEA0rg8\\\\nZBBwh2DetU6wWh2JIejBH5SfRUqtEwo5WiEZhrEQLazcpX4w5uvESnT+xd7qx3yC\\\\n/vyzqmy+YwP92Ql0vZApdQoyKGHVntY/o3HYxZD3x+7BKThUs747WjdSo8SwBkSr\\\\nxEzLBgTqqcho6UXvYTTEAg11F5yNYzbvVf4vROkCgYEAh6XtTamIB9Bd1rrHcv5q\\\\nvPWM7DVFXGj96fLbLAS7VRAlhgyEKG2417YBqNYejb6Hz5TYXhll2F0SAkFd0hU7\\\\nFG/lfHJDt04hz0fXfTFc4yTZqnSpqQPZMQfw8LajK2gA+v/Gf2xYn7fcKGW/h0vj\\\\nYB9u16hfirdcGZ+Ih3MR1mECgYEAnq1b1KJIirlYm8FYrVOGe4FxRF2/ngdA05Ck\\\\nZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvALJlQZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvAL+CxZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvAL+MjZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvALSi0sVSXpA=\\\\n-----END RSA PRIVATE KEY-----\\\"\\n    }\\n  },\\n  \\\"access_mode\\\": \\\"RW\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Example request body for Google Cloud Storage Service\"\n    }\n  ]\n}\n[/block]\n##Response\n\n[See a list of CAVATICA-specific response codes that may be contained in the body of the response](doc:api-status-codes).\n\n###Example response body\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"href\\\": \\\"https://cavatica-api.sbgenomics.com/v2/storage/volumes/rfranklin/my_volume\\\",\\n  \\\"id\\\": \\\"rfranklin/my_volume\\\",\\n  \\\"name\\\": \\\"my_volume\\\",\\n  \\\"access_mode\\\": \\\"RW\\\",\\n  \\\"service\\\": {\\n    \\\"type\\\": \\\"S3\\\",\\n    \\\"bucket\\\": \\\"output\\\",\\n    \\\"prefix\\\": \\\"\\\",\\n    \\\"endpoint\\\": \\\"s3.amazonaws.com\\\",\\n    \\\"credentials\\\": {\\n      \\\"access_key_id\\\": \\\"AKIAJRC7TPMRMDKOFXGA\\\"\\n    },\\n    \\\"properties\\\": {\\n      \\\"sse_algorithm\\\": \\\"AES256\\\"\\n    }\\n  },\\n  \\\"created_on\\\": \\\"2016-06-30T08:14:02Z\\\",\\n  \\\"modified_on\\\": \\\"2016-06-30T08:14:02Z\\\",\\n  \\\"active\\\": true\\n}\",\n      \"language\": \"json\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Note that you cannot view volumes that you have created via the visual interface. However, you can see all your volumes by making the call to [list volumes](list-volumes-v2).\"\n}\n[/block]","updates":[],"order":84,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"57909931ff09520e00d98125","user":"575e85ac41c8ba0e00259a44","parentDoc":null,"project":"5773dcfc255e820e00e1cd4d","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5773dcfc255e820e00e1cd51","5773df36904b0c0e00ef05ff","577baf92451b1e0e006075ac","577bb183b7ee4a0e007c4e8d","577ce77a1cf3cb0e0048e5ea","577d11865fd4de0e00cc3dab","578e62792c3c790e00937597","578f4fd98335ca0e006d5c84","578f5e5c3d04570e00976ebb","57bc35f7531e000e0075d118","57f801b3760f3a1700219ebb","5804d55d1642890f00803623","581c8d55c0dc651900aa9350","589dcf8ba8c63b3b00c3704f","594cebadd8a2f7001b0b53b2","59a562f46a5d8c00238e309a","5a2aa096e25025003c582b58","5a2e79566c771d003ca0acd4","5a3a5166142db90026f24007","5a3a52b5bcc254001c4bf152","5a3a574a2be213002675c6d2","5a3a66bb2be213002675cb73","5a3a6e4854faf60030b63159","5c8a68278e883901341de571","5cb9971e57bf020024523c7b","5cbf1683e2a36d01d5012ecd","5dc15666a4f788004c5fd7d7","5eaff69e844d67003642a020","5eb00899b36ba5002d35b0c1","5eb0172be179b70073dc936e","5eb01b42b36ba5002d35ebba","5eb01f202654a20136813093","5eb918ef149186021c9a76c8","5f0839d3f4b24e005ebbbc29","5f893e508c9862002d0614a9","6024033e2b2f6f004dfe994c","60a7a12f9a06c70052b7c4db","60a7ab97266a4700161507c4","60b0c84babba720010a8b0b5"],"_id":"5773dcfc255e820e00e1cd50","__v":39,"createdAt":"2016-06-29T14:36:44.812Z","releaseDate":"2016-06-29T14:36:44.812Z","project":"5773dcfc255e820e00e1cd4d"},"githubsync":"","__v":1,"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"CAVATICA API","slug":"api","order":22,"from_sync":false,"reference":false,"_id":"5773df36904b0c0e00ef05ff","createdAt":"2016-06-29T14:46:14.277Z","version":"5773dcfc255e820e00e1cd50","__v":1,"project":"5773dcfc255e820e00e1cd4d"},"createdAt":"2016-07-21T09:43:13.911Z"}

postCreate a volume


This call creates a new volume. Currently, volumes may be created using three types of cloud storage repository: * Amazon Web Services' (AWS) S3 buckets * Google Cloud Storage (GCS) buckets * Other types of cloud storage, through an S3-compatible API (read-only). This cloud storage type requires an additional API layer that the storage employs, which must use the same "language" as the AWS S3 API. [block:callout] { "type": "info", "body": "If your are using a cloud storage provider other than Amazon Web Services S3 or Google Cloud Storage, please make sure you have met the following requirements:\n* There is an additional API layer implemented on your cloud storage, compatible with the AWS S3 API. This means that you need to use an additional service or software on top of your storage, that will emulate the behavior and interaction of AWS S3 storage.\n* You or your cloud storage administrator can provide S3-compatible storage endpoint and credentials that are required to connect the storage to CAVATICA. These should be available for creation or obtaining when you have met the previous prerequisite." } [/block] [block:code] { "codes": [ { "code": "https://cavatica-api.sbgenomics.com/v2/storage/volumes", "language": "text", "name": "API path" } ] } [/block] ##Request ###Example request [block:code] { "codes": [ { "code": "POST /v2/storage/volumes HTTP/1.1\nHost: cavatica-api.sbgenomics.com\nX-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74\nContent-Type: application/json", "language": "http", "name": null }, { "code": "curl --data '@create-volume.json' -X POST -H \"X-SBG-Auth-Token: ce7ae5ab85e946599298e88a3430fba0\" -H \"Content-Type: application/json\" 'https://cavatica-api.sbgenomics.com/storage/volumes'", "language": "curl", "name": "cURL" } ], "sidebar": true } [/block] ###Header Fields [block:parameters] { "data": { "h-0": "Key", "h-1": "Description of value", "0-0": "`X-SBG-Auth-Token`\n_required_", "0-1": "Your CAVATICA [authentication token](doc:get-your-authentication-token).", "h-2": "", "1-0": "`Content-type`\n_required_", "1-1": "`application/json`" }, "cols": 2, "rows": 2 } [/block] ###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. [block:parameters] { "data": { "0-0": "`name`\n_required_", "2-0": "`description`", "h-0": "Key", "h-1": "Data type of value", "0-1": "String", "2-1": "String", "0-2": "The name of the volume. It must be unique from all other volumes for this user.", "h-2": "Description of value", "2-2": "An optional description of this volume.", "3-0": "`service`\n_required_", "3-1": "Object", "3-2": "This object should contain the information about the cloud service that this volume represents.\n\nSee the <code><a href=\"#section-the-service-object\">service</code> object section</a> below for an explanation of its structure.", "1-0": "<a name=\"access-mode\"></a>\n`access_mode`", "1-1": "String", "1-2": "Signifies whether this volume should be used for read-write (`\"RW\"`) or read-only (`\"RO\"`) operations.\n\nThe access mode is consulted independently of the credentials granted to Seven Bridges when the volume was created, so it is possible to use a read-write credentials to register both read-write and read-only volumes using it.\n\n_default:_ `\"RW\"`" }, "cols": 3, "rows": 4 } [/block] ###The `service` object [block:parameters] { "data": { "h-0": "Key", "h-1": "Data type of value", "h-2": "Description of value", "0-0": "`type`", "0-1": "string", "0-2": "The type of cloud service supported. Currently the only valid values are `\"s3\"` for Amazon Web Services or an S3-compatible endpoint and `\"gcs\"` for Google Cloud Storage.", "1-0": "`prefix`", "1-1": "String", "2-0": "`bucket`\n\n<span style=\"color:#871818\">_applies to type: `s3` and `gcs`_</span>\n_required_", "2-1": "String", "3-0": "`root_url`\n\n_default: https://s3.amazonaws.com for `s3`, https://www.googleapis.com/ for `gcs`, or a custom endpoint if you are connecting cloud storage through an S3-compatible endpoint._", "4-0": "`credentials`", "4-1": "Object", "5-0": "<a name=\"access-key-id\"></a>`access_key_id`\n\n<span style=\"color:#871818\">_applies to type: `s3`_</span>\n_required_", "3-1": "String", "5-1": "String", "6-0": "<a name=\"secret-access-key\"></a>`secret_access_key`\n\n<span style=\"color:#871818\">_applies to type: `s3`_</span>\n_required_", "6-1": "String", "7-0": "<a name=\"client-email\"></a>`client_email`\n\n<span style=\"color:#871818\">_applies to type: `gcs`_</span>\n_required_", "7-1": "String", "8-0": "<a name=\"private-key\"></a>`private_key`\n\n<span style=\"color:#871818\">_applies to type: `gcs`_</span>\n_required_", "8-1": "String", "9-0": "`properties`", "9-1": "Object", "10-0": "`sse_algorithm`\n\n<span style=\"color:#871818\">_applies to type: `s3`_</span>", "11-0": "`sse_aws_kms_key_id`\n\n<span style=\"color:#871818\">_applies to type: `s3`_</span>", "10-1": "String", "11-1": "String", "2-2": "The name of the bucket you wish to register as a volume.", "1-2": "A service-specific prefix to prepend to all objects created in this volume. If the service supports folders, and this prefix includes them, the API will attempt to create any missing folders when it outputs a file.\n\n_default:_ `\"\"`", "3-2": "Cloud provider API endpoint to use when accessing this bucket.\n\nFor a list of AWS-supported endpoints, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region\" target=\"blank\">AWS Regions and Endpoints</a>.", "4-2": "Contains credentials for the underlying cloud provider.\n\n* AWS IAM user, or S3-compatible endpoint:\n * [`access-key-id`](#access-key-id)\n * [`secret_access-key`](#secret-access-key)\n<span style=\"margin:10px;\"></span>\n\nFor Google Cloud Storage, these credentials are:\n\n* [`client_email`](#client-email)\n* [`private_key`](#private-key)", "5-2": "AWS access key ID of the IAM user shared with Seven Bridges to access this bucket.", "6-2": "AWS secret access key of the IAM user shared with Seven Bridges to access this bucket.", "7-2": "Google Cloud Platform user email.", "8-2": "Google Cloud Platform private key.", "9-2": "Contains properties of specific service.", "10-2": "Use default AES256 server-side encryption or AWS KMS encryption when writing to this bucket.\n\nCan be:\n * AES256 (default)\n * aws:kms\n\n_default: AES256_", "11-2": "If AWS KMS encryption is used, this should be set to the required KMS key. If not set and `aws:kms` is set as `sse_algorithm`, default KMS key is used." }, "cols": 3, "rows": 12 } [/block] ###Example request body [block:code] { "codes": [ { "code": "{\n \"name\": \"my_s3_volume\",\n \"service\": {\n \"type\": \"s3\",\n \"bucket\": \"input_files\",\n \"prefix\": \"\",\n \"credentials\": {\n \"access_key_id\": \"AKIAIOSFODNN7EXAMPLE\",\n \"secret_access_key\": \"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\"\n },\n \"properties\": {\n \"sse_algorithm\": \"AES256\"\n }\n },\n \"access_mode\": \"RO\"\n}", "language": "json", "name": "Example request body for AWS S3 (IAM user)" }, { "code": "{\n \"name\": \"my_gcs_volume\",\n \"description\": \"New google volume\",\n \"service\": {\n \"type\": \"gcs\",\n \"bucket\": \"output_files\",\n \"prefix\": \"output\",\n \"credentials\": {\n \"client_email\": \"[email protected]count.com\",\n \"private_key\": \"-----BEGIN RSA PRIVATE KEY-----\\nMIIEpQIBAAKCAQEAsXj4E7svaB4szcOrAcraSbsGnNuTU1b/4llyspDa0lltZIKL\\nfl5s3QoqbjUWqAZXkJexKus55g49ULD8BGKH2r4EF+XyKcpoon4uIFcbmYcmsUXM\\nJ3ujgyL5DbWnQZ6GrqgFNRFVVz/PuvTZOd6KFCrjbbtCxfKoXQrmCwFC/4NlFR3v\\n1kavU81w201Mied3e+pxjfiQKAJOoy5I7kfuH20xfzHXWR2YHdQGbzOUZyPgmzZ6\\nH6Ry39b7bgLVbyk3++e13KrsTEf58rRzUHLzlcUDcGyf8iTO2vA2qzcbrbovwqJr\\n7H4ZfFllDMYQ/ISj4cmi+sz/hR43LUK86emrXwIDAQABAoIBADBr2fvAMbINsZm+\\njjTh/ObrAWXgvvSZIx3F2/Z+cUW9Ioyu1ZJ3/uncMTF6iKD1ggSwbqVQIq7zKaWP\\ndGNZ4sk62PEQSx8924iiNsGaIqyj5FmvuoD3SeiorR0hd+3+a67RpwIQpaE1ht7y\\nmSYh4riX7w9sbU6G44rnQ1azVG1UHvk5ieOD4OPvJopuc6D6ow1oJOnHE0k8v3HY\\n1FpLdWCL6nSERqXOI5w+tllG4NMUmTZ2jhaBSEM4PIJVO+24TM3XFCcvhZ7ipPMF\\nP5B8hV4hDA4Av1Ei7iuRZlJsH4sRrtHJE3/FZLgqHRRvt/7w4c1xnwirNghtTNMb\\nXVoaS/ECgYEA15vL3l22mIoePlcCxIgVCAxhKm6TVQZsAE2EaeVsJKDl0AgCtn/1\\nThMIPPGkO8jmjqHGgA+FhjoUQuCCdIuON00mUpmUxZlwI5+uknuK597/zAjd6W8s\\n7p9apvBUDfod0hwF9Jfw+aUtZm6EAUNR1Odbb+bpXp1luwfcesHe4QcCgYEA0rg8\\nZBBwh2DetU6wWh2JIejBH5SfRUqtEwo5WiEZhrEQLazcpX4w5uvESnT+xd7qx3yC\\n/vyzqmy+YwP92Ql0vZApdQoyKGHVntY/o3HYxZD3x+7BKThUs747WjdSo8SwBkSr\\nxEzLBgTqqcho6UXvYTTEAg11F5yNYzbvVf4vROkCgYEAh6XtTamIB9Bd1rrHcv5q\\nvPWM7DVFXGj96fLbLAS7VRAlhgyEKG2417YBqNYejb6Hz5TYXhll2F0SAkFd0hU7\\nFG/lfHJDt04hz0fXfTFc4yTZqnSpqQPZMQfw8LajK2gA+v/Gf2xYn7fcKGW/h0vj\\nYB9u16hfirdcGZ+Ih3MR1mECgYEAnq1b1KJIirlYm8FYrVOGe4FxRF2/ngdA05Ck\\nZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvALJlQZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvAL+CxZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvAL+MjZYl9Vl8pZqvAL+MZ4hpyYvs9CzX1KClL38XdaZ2ftKJB2tjzDZYl9Vl8pZqvALSi0sVSXpA=\\n-----END RSA PRIVATE KEY-----\"\n }\n },\n \"access_mode\": \"RW\"\n}", "language": "json", "name": "Example request body for Google Cloud Storage Service" } ] } [/block] ##Response [See a list of CAVATICA-specific response codes that may be contained in the body of the response](doc:api-status-codes). ###Example response body [block:code] { "codes": [ { "code": "{\n \"href\": \"https://cavatica-api.sbgenomics.com/v2/storage/volumes/rfranklin/my_volume\",\n \"id\": \"rfranklin/my_volume\",\n \"name\": \"my_volume\",\n \"access_mode\": \"RW\",\n \"service\": {\n \"type\": \"S3\",\n \"bucket\": \"output\",\n \"prefix\": \"\",\n \"endpoint\": \"s3.amazonaws.com\",\n \"credentials\": {\n \"access_key_id\": \"AKIAJRC7TPMRMDKOFXGA\"\n },\n \"properties\": {\n \"sse_algorithm\": \"AES256\"\n }\n },\n \"created_on\": \"2016-06-30T08:14:02Z\",\n \"modified_on\": \"2016-06-30T08:14:02Z\",\n \"active\": true\n}", "language": "json" } ], "sidebar": true } [/block] [block:callout] { "type": "success", "body": "Note that you cannot view volumes that you have created via the visual interface. However, you can see all your volumes by making the call to [list volumes](list-volumes-v2)." } [/block]