Scaleway logo
IoT Hub API

google.protobuf.StringValue

string | null

google.protobuf.UInt32Value

integer | null · uint32

scaleway.iot.v1.Certificate

crt
​string
key
​string

scaleway.iot.v1.CreateDeviceResponse

Information related to the created device.

​scaleway.iot.v1.Certificate

Device certificate.

scaleway.iot.v1.CreateNetworkResponse

Information related to the created network.

secret
​string

Endpoint Key to keep secret. This cannot be retrieved later.

scaleway.iot.v1.CreateRouteRequest.DatabaseConfig

host
​string
port
​integer · uint32
dbname
​string
username
​string
password
​string
query
​string
engine
​scaleway.iot.v1.Route.DatabaseConfig.Engine · enum
Enum values:
unknown
postgresql
mysql
Default: unknown

scaleway.iot.v1.CreateRouteRequest.RestConfig

verb
​scaleway.iot.v1.Route.RestConfig.HttpVerb · enum
Enum values:
unknown
get
post
put
patch
delete
Default: unknown
uri
​string
​object

scaleway.iot.v1.CreateRouteRequest.S3Config

bucket_region
​string
bucket_name
​string
object_prefix
​string
strategy
​scaleway.iot.v1.Route.S3Config.S3Strategy · enum
Enum values:
unknown
per_topic
per_message
Default: unknown

scaleway.iot.v1.Device

id
​string

Device ID, also used as MQTT Client ID or username.

name
​string

Device name.

description
​string

Device description.

status
​scaleway.iot.v1.Device.Status · enum

Device status.

Enum values:
unknown
error
enabled
disabled
Default: unknown
hub_id
​string

Hub ID.

last_activity_at
​string | null · date-time

Last connection/activity date of a device. (RFC 3339 format)

is_connected
​boolean

Defines whether the device is connected to the Hub.

allow_insecure
​boolean

Defines whether to allow the device to connect to the Hub without TLS mutual authentication.

allow_multiple_connections
​boolean

Defines whether to allow multiple physical devices to connect to the Hub with this device's credentials.

Filter-sets to restrict the topics the device can publish/subscribe to.

has_custom_certificate
​boolean

Defines whether the device was assigned a custom certificate. Assigning a custom certificate allows a device to authenticate using that specific certificate without checking the Hub's CA certificate.

created_at
​string | null · date-time

Date at which the device was added. (RFC 3339 format)

updated_at
​string | null · date-time

Date at which the device was last modified. (RFC 3339 format)

region
​string

Region of the device.

scaleway.iot.v1.Device.MessageFilters

Filtering rule to restrict topics the device can publish to.

Filtering rule to restrict topics the device can subscribe to.

scaleway.iot.v1.Device.MessageFilters.Rule

How to use the topic list. If set to accept, all topics in the topics list will be allowed, with all other topics being denied. If set to reject, all topics in the topics list will be denied, with all other topics being allowed.

Enum values:
unknown
accept
reject
Default: unknown
topics
​array | null

List of topics to accept or reject. It must be valid MQTT topics and up to 65535 characters.

scaleway.iot.v1.Device.MessageFilters.Rule.Policy

string · enum
Enum values:
unknown
accept
reject
Default: unknown

scaleway.iot.v1.Device.Status

string · enum
Enum values:
unknown
error
enabled
disabled
Default: unknown

scaleway.iot.v1.GetDeviceCertificateResponse

Information related to the created device.

certificate_pem
​string

Device certificate.

scaleway.iot.v1.GetDeviceMetricsResponse

Metrics for a device over the requested period.

scaleway.iot.v1.GetHubCAResponse

ca_cert_pem
​string

scaleway.iot.v1.GetHubMetricsResponse

Metrics for a Hub over the requested period.

scaleway.iot.v1.Hub

id
​string

Hub ID.

name
​string

Hub name.

status
​scaleway.iot.v1.Hub.Status · enum

Current status of the Hub.

Enum values:
unknown
error
enabling
ready
disabling
disabled
Default: unknown
product_plan
​scaleway.iot.v1.Hub.ProductPlan · enum

Hub feature set.

Enum values:
plan_unknown
plan_shared
plan_dedicated
plan_ha
Default: plan_unknown
enabled
​boolean

Defines whether the hub has been enabled.

device_count
​integer · uint64

Number of registered devices.

connected_device_count
​integer · uint64

Number of currently connected devices.

endpoint
​string

Host to connect your devices to. Devices should be connected to this host. Port may be 1883 (MQTT), 8883 (MQTT over TLS), 80 (MQTT over Websocket) or 443 (MQTT over Websocket over TLS).

disable_events
​boolean

Defines whether to disable Hub events.

events_topic_prefix
​string

Hub events topic prefix.

region
​string

Region of the Hub.

created_at
​string | null · date-time

Hub creation date. (RFC 3339 format)

updated_at
​string | null · date-time

Hub last modification date. (RFC 3339 format)

project_id
​string

Project owning the resource.

organization_id
​string

Organization owning the resource.

enable_device_auto_provisioning
​boolean

Defines whether to enable device auto provisioning. When an unknown device connects to your hub using a valid certificate chain, it will be automatically provisioned inside your Hub. The Hub uses the common name of the device certificate to find out if a device with the same name already exists. This setting can only be enabled on a hub with a custom certificate authority.

has_custom_ca
​boolean

Defines whether the hub is using a custom certificate authority. Flag is automatically set to false after Hub creation, as Hub certificates are managed by Scaleway. Once a custom certificate authority is set, the flag will be set to true.

​

BETA - not implemented yet.

scaleway.iot.v1.Hub.ProductPlan

string · enum
Enum values:
plan_unknown
plan_shared
plan_dedicated
plan_ha
Default: plan_unknown

scaleway.iot.v1.Hub.Status

string · enum
Enum values:
unknown
error
enabling
ready
disabling
disabled
Default: unknown

scaleway.iot.v1.Hub.TwinsGraphiteConfig

push_uri
​string

scaleway.iot.v1.ListDevicesRequest.OrderBy

string · enum
Enum values:
name_asc
name_desc
status_asc
status_desc
hub_id_asc
hub_id_desc
created_at_asc
created_at_desc
Default: name_asc

scaleway.iot.v1.ListDevicesResponse

total_count
​integer · uint32

Total number of devices.

Page of devices.

scaleway.iot.v1.ListHubsRequest.OrderBy

string · enum
Enum values:
name_asc
name_desc
status_asc
status_desc
product_plan_asc
product_plan_desc
created_at_asc
created_at_desc
Default: name_asc

scaleway.iot.v1.ListHubsResponse

total_count
​integer · uint32

Total number of Hubs.

A page of hubs.

scaleway.iot.v1.ListNetworksRequest.OrderBy

string · enum
Enum values:
name_asc
name_desc
type_asc
type_desc
created_at_asc
created_at_desc
Default: name_asc

scaleway.iot.v1.ListNetworksResponse

total_count
​integer · uint32

Total number of Networks.

Page of networks.

scaleway.iot.v1.ListRoutesRequest.OrderBy

string · enum
Enum values:
name_asc
name_desc
hub_id_asc
hub_id_desc
type_asc
type_desc
created_at_asc
created_at_desc
Default: name_asc

scaleway.iot.v1.ListRoutesResponse

total_count
​integer · uint32

Total number of routes.

Page of routes.

scaleway.iot.v1.ListTwinDocumentsResponse

List of the twin document.

scaleway.iot.v1.ListTwinDocumentsResponse.DocumentSummary

document_name
​string

Name of the document.

scaleway.iot.v1.Network

id
​string

Network ID.

name
​string

Network name.

type
​scaleway.iot.v1.Network.NetworkType · enum

Type of network to connect with.

Enum values:
unknown
sigfox
rest
Default: unknown
endpoint
​string

Endpoint to use for interacting with the network.

hub_id
​string

Hub ID to connect the Network to.

created_at
​string | null · date-time

Date at which the network was created. (RFC 3339 format)

topic_prefix
​string

Topic prefix for the Network. This prefix will be prepended to all topics for this Network.

region
​string

Region of the network.

scaleway.iot.v1.Network.NetworkType

string · enum
Enum values:
unknown
sigfox
rest
Default: unknown

scaleway.iot.v1.RenewDeviceCertificateResponse

Information related to the created device.

​scaleway.iot.v1.Certificate

Device certificate.

scaleway.iot.v1.Route

id
​string

Route ID.

name
​string

Route name.

hub_id
​string

Hub ID of the route.

topic
​string

Topic the route subscribes to. It must be a valid MQTT topic and up to 65535 characters.

type
​scaleway.iot.v1.Route.RouteType · enum

Route type.

Enum values:
unknown
s3
database
rest
Default: unknown
created_at
​string | null · date-time

Date at which the route was created. (RFC 3339 format)

​

When using Amazon S3 Routes, Amazon S3-specific configuration fields.

​

When using Database Route, DB-specific configuration fields.

​

When using Rest Route, Rest-specific configuration fields.

updated_at
​string | null · date-time

Date at which the route was last updated. (RFC 3339 format)

region
​string

Region of the route.

scaleway.iot.v1.Route.DatabaseConfig

host
​string · required

Database host.

port
​integer · uint32 · required

Database port.

dbname
​string · required

Database name.

username
​string · required

Database username. Make sure this account can execute the provided query.

password
​string · required

Database password.

engine
​scaleway.iot.v1.Route.DatabaseConfig.Engine · enum

Database engine the route will connect to. If not specified, the default database will be 'PostgreSQL'.

Enum values:
unknown
postgresql
mysql
Default: unknown
query
​string

SQL query to be executed ($TOPIC and $PAYLOAD variables are available, see documentation).

scaleway.iot.v1.Route.DatabaseConfig.Engine

string · enum
Enum values:
unknown
postgresql
mysql
Default: unknown

scaleway.iot.v1.Route.RestConfig

verb
​scaleway.iot.v1.Route.RestConfig.HttpVerb · enum

HTTP verb used to call REST URI.

Enum values:
unknown
get
post
put
patch
delete
Default: unknown
uri
​string

URI of the REST endpoint.

​object

HTTP call extra headers.

scaleway.iot.v1.Route.RestConfig.HttpVerb

string · enum
Enum values:
unknown
get
post
put
patch
delete
Default: unknown

scaleway.iot.v1.Route.RouteType

string · enum
Enum values:
unknown
s3
database
rest
Default: unknown

scaleway.iot.v1.Route.S3Config

bucket_region
​string

Region of the Amazon S3 route's destination bucket (e.g., 'fr-par').

bucket_name
​string

Destination bucket name of the Amazon S3 route.

object_prefix
​string

Optional string to prefix object names with.

strategy
​scaleway.iot.v1.Route.S3Config.S3Strategy · enum

How the Amazon S3 route's objects will be created: one per topic or one per message.

Enum values:
unknown
per_topic
per_message
Default: unknown

scaleway.iot.v1.Route.S3Config.S3Strategy

string · enum
Enum values:
unknown
per_topic
per_message
Default: unknown

scaleway.iot.v1.RouteSummary

id
​string

Route ID.

name
​string

Route name.

hub_id
​string

Hub ID of the route.

topic
​string

Topic the route subscribes to. It must be a valid MQTT topic and up to 65535 characters.

type
​scaleway.iot.v1.Route.RouteType · enum

Route type.

Enum values:
unknown
s3
database
rest
Default: unknown
created_at
​string | null · date-time

Date at which the route was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date at which the route was last updated. (RFC 3339 format)

region
​string

Region of the route.

scaleway.iot.v1.SetDeviceCertificateResponse

certificate_pem
​string

scaleway.iot.v1.TwinDocument

twin_id
​string

Parent twin ID of the document.

document_name
​string

Name of the document.

version
​integer · uint32

New version of the document.

​object

New data related to the document.

scaleway.iot.v1.UpdateRouteRequest.DatabaseConfig

port
​google.protobuf.UInt32Value · uint32
engine
​scaleway.iot.v1.Route.DatabaseConfig.Engine · enum
Enum values:
unknown
postgresql
mysql
Default: unknown

scaleway.iot.v1.UpdateRouteRequest.RestConfig

verb
​scaleway.iot.v1.Route.RestConfig.HttpVerb · enum
Enum values:
unknown
get
post
put
patch
delete
Default: unknown

scaleway.iot.v1.UpdateRouteRequest.S3Config

bucket_region
​google.protobuf.StringValue
bucket_name
​google.protobuf.StringValue
object_prefix
​google.protobuf.StringValue
strategy
​scaleway.iot.v1.Route.S3Config.S3Strategy · enum
Enum values:
unknown
per_topic
per_message
Default: unknown

scaleway.std.MapStringStringValue

<key>
​string

scaleway.std.TimeSeries

name
​string
​object

scaleway.std.TimeSeries.Point

​array
oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = string
type = number
Properties for Variant 1:
string · date-time