Commands

Documentation for `scw mnq`

The CLI documentation pages are currently under construction

The content is up to date. We're making improvements to the site over the next few weeks for a better experience.

These APIs allow you to manage your Messaging and Queuing NATS, Queues and Topics and Events services.

MnQ NATS commands

MnQ NATS commands.

Create a NATS account

Create a NATS account associated with a Project.

Usage:

Code
scw mnq nats create-account [arg=value ...]

Arguments:

Name	Description	Argument Specifications
name	NATS account name	Default: `<generated>`
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Create a new context for natscli

This command help you configure your nats cli Contexts should are stored in $HOME/.config/nats/context Credentials and context file are saved in your nats context folder with 0600 permissions

Usage:

Code
scw mnq nats create-context [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-account-id	ID of the NATS account
name	Name of the saved context, defaults to account name
credentials-name	Name of the created credentials
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Examples:

Create a context in your nats server

Code
scw mnq nats create-context <nats-account-id> credentials-name=<credential-name> region=fr-par

Create NATS credentials

Create a set of credentials for a NATS account, specified by its NATS account ID.

Usage:

Code
scw mnq nats create-credentials [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-account-id	NATS account containing the credentials	Required
name	Name of the credentials	Default: `<generated>`
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Delete a NATS account

Delete a NATS account, specified by its NATS account ID. Note that deleting a NATS account is irreversible, and any credentials, streams, consumer and stored messages belonging to this NATS account will also be deleted.

Usage:

Code
scw mnq nats delete-account <nats-account-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-account-id	ID of the NATS account to delete	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Delete NATS credentials

Delete a set of credentials, specified by their credentials ID. Deleting credentials is irreversible and cannot be undone. The credentials can no longer be used to access the NATS account, and active connections using this credentials will be closed.

Usage:

Code
scw mnq nats delete-credentials <nats-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-credentials-id	ID of the credentials to delete	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Get a NATS account

Retrieve information about an existing NATS account identified by its NATS account ID. Its full details, including name and endpoint, are returned in the response.

Usage:

Code
scw mnq nats get-account <nats-account-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-account-id	ID of the NATS account to get	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Get NATS credentials

Retrieve an existing set of credentials, identified by the nats_credentials_id. The credentials themselves are NOT returned, only their metadata (NATS account ID, credentials name, etc), are returned in the response.

Usage:

Code
scw mnq nats get-credentials <nats-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-credentials-id	ID of the credentials to get	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

List NATS accounts

List all NATS accounts in the specified region, for a Scaleway Organization or Project. By default, the NATS accounts returned in the list are ordered by creation date in ascending order, though this can be modified via the order_by field.

Usage:

Code
scw mnq nats list-accounts [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Include only NATS accounts in this Project
order-by	Order in which to return results	One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc`
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`, `all`

List NATS credentials

List existing credentials in the specified NATS account. The response contains only the metadata for the credentials, not the credentials themselves, which are only returned after a Create Credentials call.

Usage:

Code
scw mnq nats list-credentials [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Include only NATS accounts in this Project
nats-account-id	Include only credentials for this NATS account
order-by	Order in which to return results	One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc`
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`, `all`

Update the name of a NATS account

Update the name of a NATS account, specified by its NATS account ID.

Usage:

Code
scw mnq nats update-account <nats-account-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
nats-account-id	ID of the NATS account to update	Required
name	NATS account name
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

MnQ Topics and Events commands

MnQ Topics and Events commands.

Activate Topics and Events

Activate Topics and Events for the specified Project ID. Topics and Events must be activated before any usage. Activating Topics and Events does not trigger any billing, and you can deactivate at any time.

Usage:

Code
scw mnq sns activate [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Create Topics and Events credentials

Create a set of credentials for Topics and Events, specified by a Project ID. Credentials give the bearer access to topics, and the level of permissions can be defined granularly.

Usage:

Code
scw mnq sns create-credentials [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
name	Name of the credentials	Default: `<generated>`
permissions.can-publish	Defines whether the credentials bearer can publish messages to the service (publish to Topics and Events topics)
permissions.can-receive	Defines whether the credentials bearer can receive messages from the service (configure subscriptions)
permissions.can-manage	Defines whether the credentials bearer can manage the associated Topics and Events topics or subscriptions
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Deactivate Topics and Events

Deactivate Topics and Events for the specified Project ID. You must delete all topics and credentials before this call or you need to set the force_delete parameter.

Usage:

Code
scw mnq sns deactivate [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Delete Topics and Events credentials

Delete a set of Topics and Events credentials, specified by their credentials ID. Deleting credentials is irreversible and cannot be undone. The credentials can then no longer be used to access Topics and Events.

Usage:

Code
scw mnq sns delete-credentials <sns-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
sns-credentials-id	ID of the credentials to delete	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Get Topics and Events credentials

Retrieve an existing set of credentials, identified by the credentials_id. The credentials themselves, as well as their metadata (name, project ID etc), are returned in the response.

Usage:

Code
scw mnq sns get-credentials <sns-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
sns-credentials-id	ID of the Topics and Events credentials to get	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Get Topics and Events info

Retrieve the Topics and Events information of the specified Project ID. information include the activation status and the Topics and Events API endpoint URL.

Usage:

Code
scw mnq sns get-info [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

List Topics and Events credentials

List existing Topics and Events credentials in the specified region. The response contains only the metadata for the credentials, not the credentials themselves.

Usage:

Code
scw mnq sns list-credentials [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Include only Topics and Events credentials in this Project
order-by	Order in which to return results	One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc`
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`, `all`

Update Topics and Events credentials

Update a set of Topics and Events credentials. You can update the credentials' name, or their permissions.

Usage:

Code
scw mnq sns update-credentials <sns-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
sns-credentials-id	ID of the Topics and Events credentials to update	Required
name	Name of the credentials
permissions.can-publish	Defines whether the credentials bearer can publish messages to the service (publish to Topics and Events topics)
permissions.can-receive	Defines whether the credentials bearer can receive messages from the service (configure subscriptions)
permissions.can-manage	Defines whether the credentials bearer can manage the associated Topics and Events topics or subscriptions
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

MnQ Queues commands

MnQ Queues commands.

Activate Queues

Activate Queues for the specified Project ID. Queues must be activated before any usage such as creating credentials and queues. Activating Queues does not trigger any billing, and you can deactivate at any time.

Usage:

Code
scw mnq sqs activate [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Create Queues credentials

Create a set of credentials for Queues, specified by a Project ID. Credentials give the bearer access to queues, and the level of permissions can be defined granularly.

Usage:

Code
scw mnq sqs create-credentials [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
name	Name of the credentials	Default: `<generated>`
permissions.can-publish	Defines whether the credentials bearer can publish messages to the service (send messages to Queues queues)
permissions.can-receive	Defines whether the credentials bearer can receive messages from Queues queues
permissions.can-manage	Defines whether the credentials bearer can manage the associated Queues queues
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Deactivate Queues

Deactivate Queues for the specified Project ID. You must delete all queues and credentials before this call or you need to set the force_delete parameter.

Usage:

Code
scw mnq sqs deactivate [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Delete Queues credentials

Delete a set of Queues credentials, specified by their credentials ID. Deleting credentials is irreversible and cannot be undone. The credentials can then no longer be used to access Queues.

Usage:

Code
scw mnq sqs delete-credentials <sqs-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
sqs-credentials-id	ID of the credentials to delete	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Get Queues credentials

Retrieve an existing set of credentials, identified by the credentials_id. The credentials themselves, as well as their metadata (name, project ID etc), are returned in the response.

Usage:

Code
scw mnq sqs get-credentials <sqs-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
sqs-credentials-id	ID of the Queues credentials to get	Required
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

Get Queues info

Retrieve the Queues information of the specified Project ID. information include the activation status and the Queues API endpoint URL.

Usage:

Code
scw mnq sqs get-info [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Project ID to use. If none is passed the default project ID will be used
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`

List Queues credentials

List existing Queues credentials in the specified region. The response contains only the metadata for the credentials, not the credentials themselves.

Usage:

Code
scw mnq sqs list-credentials [arg=value ...]

Arguments:

Name	Description	Argument Specifications
project-id	Include only Queues credentials in this Project
order-by	Order in which to return results	One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc`
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`, `all`

Update Queues credentials

Update a set of Queues credentials. You can update the credentials' name, or their permissions.

Usage:

Code
scw mnq sqs update-credentials <sqs-credentials-id ...> [arg=value ...]

Arguments:

Name	Description	Argument Specifications
sqs-credentials-id	ID of the Queues credentials to update	Required
name	Name of the credentials
permissions.can-publish	Defines whether the credentials bearer can publish messages to the service (send messages to Queues queues)
permissions.can-receive	Defines whether the credentials bearer can receive messages from Queues queues
permissions.can-manage	Defines whether the credentials bearer can manage the associated Queues queues
region	Region to target. If none is passed will use default region from the config	Default: `fr-par` One of: `fr-par`, `nl-ams`