Features add bucket controller and signed urls to file:getUrl

config/kuzzlerc

@@ -4,7 +4,8 @@
       "bucketName": "your-s3-bucket",
       "endpoint": "https://s3.eu-west-3.amazonaws.com",
       "s3ClientOptions": {
-        "s3ForcePathStyle": false
+        "s3ForcePathStyle": false,
+        "region" : "eu-west-3"
       },
       "signedUrlTTL": "20min",
       "redisPrefix": "s3Plugin/uploads",

doc/2/controllers/bucket/create/index.md

@@ -0,0 +1,91 @@
+---
+code: true
+type: page
+title: create
+---
+
+# create
+
+Creates a S3 bucket
+
+## Query Syntax
+
+### HTTP
+
+```http
+URL: http://kuzzle:7512/_plugin/s3/bucket/create
+Method: POST
+Body:
+```
+
+```js
+      {
+        "bucketName":"<bucketname>",
+        "bucketRegion":"<bucketregion>",
+        "bucketOptions":{ <OptionsList> },
+        "bucketPolicy":{ <PolicyList> },
+        "bucketCORS":{ <CORS> }
+        "disableDotsInName":"false"
+      }
+```
+
+### Other protocols 
+
+```js
+{
+  "controller": "s3",
+  "action": "create",
+
+  "body": {
+      "bucketName": "<expression>",
+      "bucketRegion": "<number_of_result_max>",
+      "bucketOptions": { <OptionsList> },
+      "bucketPolicy":{ <PolicyList> },
+      "bucketCORS":{ <CORS> }
+      "disableDotsInName":"false"
+  }
+}
+```
+
+## Arguments
+
+- `bucketName`: the name of the bucket, bucket will need to follow the [AWS Bucket Name Guidelines](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).
+- `bucketRegion` (optional): the region where you want to create the bucket, see [AWS Documentation](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) for available regions. Otherwise it will default to the region configured globally.
+- `bucketOptions` (optional): Specify options like a custom ACL, otherwise it will default to :
+
+```js
+      {
+        ACL: 'public-read'
+      }
+```
+
+- `bucketPolicy` (optional): Specify a custom policy for your bucket.
+- `bucketCORS` (optional): Specify a custom CORS policy to add to your bucket, otherwise it will default to :
+
+```js
+      {
+        AllowedHeaders: ['*'],
+        AllowedMethods: ['GET', 'POST', 'PUT'],
+        AllowedOrigins: ['*'],
+      }
+```
+
+- `disableDotsInName` (optional): changes the name checks on the `bucketName` variable to check for dots, which would prevent [S3 Transfer Acceleration](https://aws.amazon.com/fr/s3/transfer-acceleration/) from working.
+
+## Response
+
+Returns an object with the following properties:
+
+```js
+{
+      "status": 200,
+      "error": null,
+      "action": "create",
+      "controller": "s3/bucket",
+      "bucketName: "<bucketname>",
+      "bucketRegion":"<bucketregion>",
+      "bucketOptions": { <OptionsList> },
+      "bucketPolicy":{ <PolicyList> },
+      "bucketCORS": { <CORS> }
+}
+```

doc/2/controllers/bucket/delete/index.md

@@ -0,0 +1,49 @@
+---
+code: true
+type: page
+title: create
+---
+
+# delete
+
+Deletes an existing empty S3 bucket
+
+## Query Syntax
+
+### HTTP
+
+```http
+URL: http://kuzzle:7512/_plugin/s3/bucket/delete/<bucketName>
+Method: DELETE
+```
+
+### Other protocols 
+
+```js
+{
+  "controller": "s3",
+  "action": "delete",
+  "bucketName": "mybucket"
+
+}
+```
+
+## Arguments
+
+- `bucketName`: the name of the bucket to delete
+
+## Response
+
+Returns an object with the following properties:
+
+```js
+{
+  "status": 200,
+  "error": null,
+  "action": "delete",
+  "controller": "s3/bucket",
+  "result": {
+    "result": "ok"
+  }
+}
+```

doc/2/controllers/bucket/exists/index.md

@@ -0,0 +1,50 @@
+---
+code: true
+type: page
+title: exists
+---
+
+# exists
+
+Check if a S3 bucket exists.
+
+## Query Syntax
+
+### HTTP
+
+```http
+URL: http://kuzzle:7512/_plugin/s3/bucket/exists/<bucketName>
+Method: GET
+```
+
+### Other protocols 
+
+```js
+{
+  "controller": "s3",
+  "action": "exists",
+  "bucketName": "mybucket",
+  "bucketRegion": "eu-east-1"
+}
+```
+
+## Arguments
+
+- `bucketName`: the name of the bucket to delete
+- `bucketRegion`: the AWS region where the bucket is located
+
+## Response
+
+Returns an object with the following properties:
+
+```js
+{
+  "status": 200,
+  "error": null,
+  "action": "exists",
+  "controller": "s3/bucket",
+  "result": {
+    "result": "true"
+  }
+}
+```

doc/2/controllers/bucket/index.md

@@ -0,0 +1,5 @@
+---
+code: true
+type: branch
+title: file
+---

doc/2/controllers/file/get-url/index.md

@@ -25,7 +25,9 @@ Method: GET
 {
   "controller": "s3/file",
   "action": "getUrl",
-
+  "bucketName":"<bucketname>",
+  "bucketRegion":"<bucketregion>",
+  "signedUrl":"true"
   "fileKey": "xen/<uuid>-headcrab.png"
 }
 ```
@@ -35,7 +37,10 @@ Method: GET
 ## Arguments
 
 - `fileKey`: [file key](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys) in S3 bucket
-
+- `bucketName` (optional): the name of the bucket
+- `bucketRegion` (optional): the region where the specified bucket is located,
+- `signedUrl` (optional): flag to use a signed url,
+
 ---
 
 ## Response