az webpubsub

Note

This reference is part of the webpubsub extension for the Azure CLI (version 2.39.0 or higher). The extension will automatically install the first time you run an az webpubsub command. Learn more about extensions.

Commands to manage Webpubsub.

Commands

az webpubsub client	Commands to manage client connections.
az webpubsub client start	Start a interactive client connection.
az webpubsub create	Create a Webpubsub.
az webpubsub delete	Delete a Webpubsub.
az webpubsub hub	Commands to manage Webpubsub hub settings.
az webpubsub hub create	Create hub settings for WebPubSub Service.
az webpubsub hub delete	Delete hub settings for WebPubSub Service.
az webpubsub hub list	List all hub settings for WebPubSub Service.
az webpubsub hub show	Show hub settings for WebPubSub Service.
az webpubsub hub update	Update hub settings for WebPubSub Service.
az webpubsub key	Commands to manage Webpubsub keys.
az webpubsub key regenerate	Regenerate keys for a WebPubSub Service.
az webpubsub key show	Show connetion strings and keys for a WebPubSub Service.
az webpubsub list	List Webpubsub.
az webpubsub list-skus	List all available skus of the resource.
az webpubsub list-usage	List resource usage quotas by location.
az webpubsub network-rule	Commands to manage Webpubsub network rules.
az webpubsub network-rule show	Get the Network access control of WebPubSub Service.
az webpubsub network-rule update	Update the Network access control of WebPubSub Service.
az webpubsub restart	Restart a Webpubsub.
az webpubsub service	Commands to manage Webpubsub service.
az webpubsub service broadcast	Broadcast messages to hub. Error throws if operation fails.
az webpubsub service connection	Commands to manage Webpubsub service connections.
az webpubsub service connection close	Close a specific client connection. Error throws if operation fails.
az webpubsub service connection exist	Check whether client connection exists.
az webpubsub service connection send	Send a message to connection. Error throws if operation fails.
az webpubsub service group	Commands to manage Webpubsub service groups.
az webpubsub service group add-connection	Add a connection to group. Error throws if operation fails.
az webpubsub service group add-user	Add a user to group. Error throws if operation fails.
az webpubsub service group remove-connection	Remove a connection from group. Error throws if operation fails.
az webpubsub service group remove-user	Remove a user from group. Error throws if operation fails.
az webpubsub service group send	Send a message to group. Error throws if operation fails.
az webpubsub service permission	Commands to manage Webpubsub service permissions.
az webpubsub service permission check	Check if a connection has permission to the specified group.
az webpubsub service permission grant	Grant a group permission to the connection. Error throws if operation fails.
az webpubsub service permission revoke	Revoke a group permission from the connection. Error throws if operation fails.
az webpubsub service user	Commands to manage Webpubsub service users.
az webpubsub service user exist	Check if there are any client connections connected for the given user.
az webpubsub service user send	Send a message to user. Error throws if operation fails.
az webpubsub show	Show details of a Webpubsub.
az webpubsub update	Update a Webpubsub.

az webpubsub create

Create a Webpubsub.

az webpubsub create --name
                    --resource-group
                    --sku
                    [--location]
                    [--tags]
                    [--unit-count]

Examples

Create a WebPubSub Service with Standard SKU and unit 2.

az webpubsub create -n MyWebPubSub -g MyResourceGroup --sku Standard_S1 --unit-count 2

Required Parameters

--name -n

Name of the Webpubsub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--sku

The sku name of the webpubsub service. Allowed values: Free_F1, Standard_S1, Premium_P1.

Optional Parameters

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--unit-count

The number of webpubsub service unit count.

default value: 1

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub delete

Delete a Webpubsub.

az webpubsub delete [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the Webpubsub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub list

List Webpubsub.

az webpubsub list [--resource-group]

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub list-skus

List all available skus of the resource.

az webpubsub list-skus [--ids]
                       [--name]
                       [--resource-group]
                       [--subscription]

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the Webpubsub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub list-usage

List resource usage quotas by location.

az webpubsub list-usage --location

Required Parameters

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub restart

Restart a Webpubsub.

az webpubsub restart [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the Webpubsub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub show

Show details of a Webpubsub.

az webpubsub show [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the Webpubsub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az webpubsub update

Update a Webpubsub.

az webpubsub update [--add]
                    [--force-string]
                    [--ids]
                    [--name]
                    [--remove]
                    [--resource-group]
                    [--set]
                    [--sku]
                    [--subscription]
                    [--tags]
                    [--unit-count]

Examples

Update a WebPubSub Service to unit 10.

az webpubsub update -n MyWebPubSub -g MyResourceGroup --sku Standard_S1 --unit-count 10

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

default value: []

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

default value: False

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the Webpubsub.

--remove

Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.

default value: []

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=.

default value: []

--sku

The sku name of the webpubsub service. Allowed values: Free_F1, Standard_S1, Premium_P1.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--unit-count

The number of webpubsub service unit count.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.