madrob commented on a change in pull request #652: URL: https://github.com/apache/solr/pull/652#discussion_r810226694
########## File path: solr/solr-ref-guide/modules/deployment-guide/pages/backup-restore.adoc ########## @@ -671,9 +671,27 @@ This plugin uses the https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide [NOTE] ==== -When using the Backup & Restore Collections API Calls, you can provide a **location** that either starts with `s3://` or not. -Either way, if your **location** (or s3 object prefix) starts with a `/`, it will be removed automatically. -The repository does not allow backup locations that begin with a `/`. +There are a few nuances to using the **`location`** option with the S3 Repository. +The `location` option specifies the sub-directory to store backup information in. + +Location Format:: +When using the Backup & Restore Collections API Calls, the **`location`** option can be presented in a number of ways: ++ +* `dir/in/bucket` +* `/dir/in/bucket` +* `s3:/dir/in/bucket` +* `s3://dir/in/bucket` ++ +All the above options will resolve to the same directory in your S3 Bucket: `dir/in/bucket`. + +Pre-Creation:: +The directory within your S3 bucket must already exist before you preform any backup operations with that location. Review comment: Does this mean that `dir/in` must exist or that `dir/in/bucket` must exist? -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For additional commands, e-mail: issues-h...@solr.apache.org
