Skip to main content
Version: 1.7.1

The tedge connect command

tedge connect
Connect to cloud provider

If there is a renewed version of the device certificate, this new certificate is used to connect the cloud and on a successful connection the new certificate is promoted as active.

Usage: tedge connect [OPTIONS] <CLOUD>

Arguments:
<CLOUD>
The cloud or custom mapper to connect to (e.g. c8y, aws, az, or a custom mapper name)

Options:
--config-dir <CONFIG_DIR>
[env: TEDGE_CONFIG_DIR, default: /etc/tedge]

--test
Test an existing connection

--debug
Turn-on the DEBUG log level.

If off only reports ERROR, WARN, and INFO, if on also reports DEBUG

--offline
Ignore connection registration and connection check

--log-level <LOG_LEVEL>
Configures the logging level.

One of error/warn/info/debug/trace. Logs with verbosity lower or equal to the selected level will be printed, i.e. warn prints ERROR and WARN logs and trace prints logs of all levels.

Overrides `--debug`

--profile <PROFILE>
The cloud profile to use

[env: TEDGE_CLOUD_PROFILE]

-h, --help
Print help (see a summary with '-h')

AWS​

tedge connect aws
Connect to cloud provider

If there is a renewed version of the device certificate, this new certificate is used to connect the cloud and on a successful connection the new certificate is promoted as active.

Usage: tedge connect [OPTIONS] <CLOUD>

Arguments:
<CLOUD>
The cloud or custom mapper to connect to (e.g. c8y, aws, az, or a custom mapper name)

Options:
--config-dir <CONFIG_DIR>
[env: TEDGE_CONFIG_DIR, default: /etc/tedge]

--test
Test an existing connection

--debug
Turn-on the DEBUG log level.

If off only reports ERROR, WARN, and INFO, if on also reports DEBUG

--offline
Ignore connection registration and connection check

--log-level <LOG_LEVEL>
Configures the logging level.

One of error/warn/info/debug/trace. Logs with verbosity lower or equal to the selected level will be printed, i.e. warn prints ERROR and WARN logs and trace prints logs of all levels.

Overrides `--debug`

--profile <PROFILE>
The cloud profile to use

[env: TEDGE_CLOUD_PROFILE]

-h, --help
Print help (see a summary with '-h')

Azure​

tedge connect az
Connect to cloud provider

If there is a renewed version of the device certificate, this new certificate is used to connect the cloud and on a successful connection the new certificate is promoted as active.

Usage: tedge connect [OPTIONS] <CLOUD>

Arguments:
<CLOUD>
The cloud or custom mapper to connect to (e.g. c8y, aws, az, or a custom mapper name)

Options:
--config-dir <CONFIG_DIR>
[env: TEDGE_CONFIG_DIR, default: /etc/tedge]

--test
Test an existing connection

--debug
Turn-on the DEBUG log level.

If off only reports ERROR, WARN, and INFO, if on also reports DEBUG

--offline
Ignore connection registration and connection check

--log-level <LOG_LEVEL>
Configures the logging level.

One of error/warn/info/debug/trace. Logs with verbosity lower or equal to the selected level will be printed, i.e. warn prints ERROR and WARN logs and trace prints logs of all levels.

Overrides `--debug`

--profile <PROFILE>
The cloud profile to use

[env: TEDGE_CLOUD_PROFILE]

-h, --help
Print help (see a summary with '-h')

Cumulocity​

tedge connect c8y
Connect to cloud provider

If there is a renewed version of the device certificate, this new certificate is used to connect the cloud and on a successful connection the new certificate is promoted as active.

Usage: tedge connect [OPTIONS] <CLOUD>

Arguments:
<CLOUD>
The cloud or custom mapper to connect to (e.g. c8y, aws, az, or a custom mapper name)

Options:
--config-dir <CONFIG_DIR>
[env: TEDGE_CONFIG_DIR, default: /etc/tedge]

--test
Test an existing connection

--debug
Turn-on the DEBUG log level.

If off only reports ERROR, WARN, and INFO, if on also reports DEBUG

--offline
Ignore connection registration and connection check

--log-level <LOG_LEVEL>
Configures the logging level.

One of error/warn/info/debug/trace. Logs with verbosity lower or equal to the selected level will be printed, i.e. warn prints ERROR and WARN logs and trace prints logs of all levels.

Overrides `--debug`

--profile <PROFILE>
The cloud profile to use

[env: TEDGE_CLOUD_PROFILE]

-h, --help
Print help (see a summary with '-h')