{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Attach a volume through an S3-compatible endpoint","type":"basic","slug":"attach-a-volume-from-another-cloud-provider-through-an-s3-compatible-api","excerpt":"","body":"## Overview\n\nFollow the procedure below if you want to connect your storage as a volume to CAVATICA using an S3-compatible endpoint:\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. You will then use the AWS option in the connection wizard on CAVATICA to attach your 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[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You can use an S3-compatible endpoint only when it has been whitelisted on CAVATICA.\"\n}\n[/block]\nOr, learn more if the storage bucket that you want to attach is actually hosted on [Amazon Web Services](doc:attach-an-amazon-web-services-s3-volume) or [Google Cloud Storage (GCS)](doc:attach-a-google-cloud-storage-volume).\n\n## Step 1: Access the Volumes Dashboard\n1. Click on the **Data** tab of the top navigation bar.\n2. Select **Volumes** from the drop-down menu.\n\n## Step 2: Choose a cloud storage provider\n1. On the Volumes Dashboard, click **+Attach volume**.\n2. Select **Amazon Web Services** as your cloud storage provider.\n3. Click **Next**.\n\n## Step 3: Provide S3 bucket details\n1. Enter your cloud storage bucket name.\n2. (Optional) Define a new name for the volume created on CAVATICA.\n3. (Optional) Enter a description for your volume.\n4. Keep **Read only (RO)** selected as this is the only connection mode available for this type of cloud storage at the moment. Trying to connect the volume in read-write mode will result in an error.\n5. (Optional) enter a prefix.\n6. Click **Next**.\n\n## Step 4: Policy\n\nThis step is not needed when connecting storage other than AWS S3 or GCS. Click **Next** to continue.\n\n## Step 5: Enter user credentials\n\n1. Enter **Access Key ID** and **Secret Access Key**. If you are not sure about these credentials, ask your cloud storage administrator.\n2. Click **Next**.\n\n## Step 6: Configure additional options\n\n1. Enter the storage *S3-compatible endpoint*. If you are not sure about the endpoint, ask your cloud storage administrator.\n2. Unless you have specific instructions about **Server-side encryption** type and **Canned ACL**, keep the default values.\n3. Click **Next**.\n\n## Step 7: Review volume details\n\nOn this tab, review the details for your volume and click **Connect**.\n\n## Next step\n\nCongratulations! You've attached your volume to CAVATICA. You can make individual data objects within it available as \"aliases\" on CAVATICA. Aliases point to files stored on your cloud storage bucket and can be copied, executed, and organized like normal files on CAVATICA.","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"60423dde94f0aa0011f9bb12","createdAt":"2021-03-05T14:19:10.427Z","user":"5767bc73bb15f40e00a28777","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Connect cloud storage","slug":"connect-cloud-storage","order":23,"from_sync":false,"reference":false,"_id":"5f0839d3f4b24e005ebbbc29","createdAt":"2020-07-10T09:50:11.713Z","version":"5773dcfc255e820e00e1cd50","project":"5773dcfc255e820e00e1cd4d","__v":0},"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"},"project":"5773dcfc255e820e00e1cd4d","__v":0,"parentDoc":null}

Attach a volume through an S3-compatible endpoint


## Overview Follow the procedure below if you want to connect your storage as a volume to CAVATICA using an S3-compatible endpoint: * 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. You will then use the AWS option in the connection wizard on CAVATICA to attach your storage. * 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:callout] { "type": "info", "body": "You can use an S3-compatible endpoint only when it has been whitelisted on CAVATICA." } [/block] Or, learn more if the storage bucket that you want to attach is actually hosted on [Amazon Web Services](doc:attach-an-amazon-web-services-s3-volume) or [Google Cloud Storage (GCS)](doc:attach-a-google-cloud-storage-volume). ## Step 1: Access the Volumes Dashboard 1. Click on the **Data** tab of the top navigation bar. 2. Select **Volumes** from the drop-down menu. ## Step 2: Choose a cloud storage provider 1. On the Volumes Dashboard, click **+Attach volume**. 2. Select **Amazon Web Services** as your cloud storage provider. 3. Click **Next**. ## Step 3: Provide S3 bucket details 1. Enter your cloud storage bucket name. 2. (Optional) Define a new name for the volume created on CAVATICA. 3. (Optional) Enter a description for your volume. 4. Keep **Read only (RO)** selected as this is the only connection mode available for this type of cloud storage at the moment. Trying to connect the volume in read-write mode will result in an error. 5. (Optional) enter a prefix. 6. Click **Next**. ## Step 4: Policy This step is not needed when connecting storage other than AWS S3 or GCS. Click **Next** to continue. ## Step 5: Enter user credentials 1. Enter **Access Key ID** and **Secret Access Key**. If you are not sure about these credentials, ask your cloud storage administrator. 2. Click **Next**. ## Step 6: Configure additional options 1. Enter the storage *S3-compatible endpoint*. If you are not sure about the endpoint, ask your cloud storage administrator. 2. Unless you have specific instructions about **Server-side encryption** type and **Canned ACL**, keep the default values. 3. Click **Next**. ## Step 7: Review volume details On this tab, review the details for your volume and click **Connect**. ## Next step Congratulations! You've attached your volume to CAVATICA. You can make individual data objects within it available as "aliases" on CAVATICA. Aliases point to files stored on your cloud storage bucket and can be copied, executed, and organized like normal files on CAVATICA.