Scaleway Elements IoT Station Gateways

Gateway Overview

Hub Gateways bring Scaleway’s ecosystem to IoT Station !

Currently you can store messages in an «Object Storage» bucket.

«Object Storage» Gateway

Overview

«Object storage» is an Object Storage service provided by Scaleway and based on the S3 protocol.

«Object Storage» Gateway purpose is to store specific messages (published on a given topic) in a bucket. You need to create your «Object Storage» bucket before creating the Gateway.

Messages store strategies

There are two distinct strategies for storing messages

Per Topic

Messages published on the same topic are stored in the same object (the last message overwriting the previous ones). The object name is composed of the prefix you choosed and the topic name.

eg publishing to ‘hello/world’ will create ‘s3://my-bucket/my-prefix/hello/world’ object.

Per Message

Each published message is stored in a distinct object. The object name is composed of the prefix you chose, the topic name and the timestamp the message is received on the gateway.

eg publishing to ‘hello/world’ will create a ‘s3://my-bucket/my-prefix/hello/world/2006-01-02T15:04:05.999999999Z’ object.

Permissions

When you create an «Object Storage» Gateway through the Scaleway console, selected bucket’s write permission is automatically granted to the IoT platform. But if you create the gateway using Scaleway’s API (or Scaleway’s CLI), you will have to grant us write access:

> s3cmd setacl s3://<my-bucket> --acl-grant=write:555c69c3-87d0-4bf8-80f1-99a2f757d031:555c69c3-87d0-4bf8-80f1-99a2f757d031

How to create a «Object Storage» Gateway

Once you have created a Hub, you can add «Object Storage» Gateways to it.

1 . Click Create a Gateway in the Gateways tab of your Hub.

2 . Enter a name for your Gateway.

3 . Enter the topic filter you want your gateway to subscribe to. This topic filter can contains wildcards (+ and #).

4 . Choose Object Storage as Gateway type.

5 . Select the region of your Object Storage bucket.

6 . Choose the bucket you want to store messages in (you cannot directly create a bucket from the «Object Storage» Gateway screen).

7 . Enter the prefix that will be prepended to object names.

8 . Select how your messages will be stored in the bucket (per topic or per message).

How to delete an «Object Storage» Gateway

In the Gateways tab of your Hub, use the “…” button in the gateway list or use multi select.

Discover a New Cloud Experience

Deploy SSD Cloud Servers in seconds.