gcloud_iot_registries_create (1)
NAME
- gcloud iot registries create - create a new device registry
SYNOPSIS
-
gcloud iot registries create (REGISTRY : --region=REGION) [--no-enable-http-config] [--no-enable-mqtt-config] [--event-notification-config=[subfolder=SUBFOLDER],[topic=TOPIC]] [--log-level=LOG_LEVEL] [--public-key-path=PUBLIC_KEY_PATH] [--state-pubsub-topic=STATE_PUBSUB_TOPIC] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
POSITIONAL ARGUMENTS
-
-
Registry resource - The registry you want to create. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
To set the [project] attribute: provide the argument [registry] on the command
line with a fully specified name; provide the argument [--project] on the
command line; set the property [core/project]. This must be specified.
-
- REGISTRY
-
ID of the registry or fully qualified identifier for the registry. This
positional must be specified if any of the other arguments in this group are
specified.
- --region=REGION
-
The name of the Cloud IoT region.
-
-
Registry resource - The registry you want to create. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
To set the [project] attribute: provide the argument [registry] on the command
line with a fully specified name; provide the argument [--project] on the
command line; set the property [core/project]. This must be specified.
FLAGS
-
- --enable-http-config
-
Whether to allow device connections to the HTTP bridge. Enabled by default, use
--no-enable-http-config to disable.
- --enable-mqtt-config
-
Whether to allow MQTT connections to this device registry. Enabled by default,
use --no-enable-mqtt-config to disable.
- --event-notification-config=[subfolder=SUBFOLDER],[topic=TOPIC]
-
The configuration for notification of telemetry events received from the device.
This flag can be specified multiple times to add multiple configs to the device
registry. Configs are added to the registry in the order the flags are
specified. Only one config with an empty subfolder field is allowed and must be
specified last.
-
- topic
-
A Google Cloud Pub/Sub topic name for event notifications
-
- subfolder
-
If the subfolder name matches this string exactly, this configuration will be
used to publish telemetry events. If empty all strings are matched.
-
-
- --log-level=LOG_LEVEL
-
The default logging verbosity for activity from devices in this registry. The
verbosity level can be overridden by setting a specific device's log level.
LOG_LEVEL must be one of:
-
- debug
- All events will be logged.
- error
- Error events will be logged.
- info
- Informational events will be logged, such as connections and disconnections. Also includes error events.
- none
- Disables logging.
-
- --public-key-path=PUBLIC_KEY_PATH
-
Path to a file containing an X.509v3 certificate (RFC5280
(www.ietf.org/rfc/rfc5280.txt encoded in base64, and wrapped by
-----BEGIN CERTIFICATE----- and -----END
CERTIFICATE-----.
- --state-pubsub-topic=STATE_PUBSUB_TOPIC
-
A Google Cloud Pub/Sub topic name for state notifications.
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
API REFERENCE
This command uses the cloudiot/v1 API. The full documentation for this API can be found at: cloud.google.com/iot
NOTES
These variants are also available:
- $ gcloud alpha iot registries create $ gcloud beta iot registries create