az synapse kusto pool-principal-assignment
This command group is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Manage kusto pool principal assignment with synapse.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az synapse kusto pool-principal-assignment create |
Create a Kusto pool principalAssignment. |
Core | Experimental |
| az synapse kusto pool-principal-assignment delete |
Deletes a Kusto pool principalAssignment. |
Core | Experimental |
| az synapse kusto pool-principal-assignment list |
Lists all Kusto pool principalAssignments. |
Core | Experimental |
| az synapse kusto pool-principal-assignment show |
Gets a Kusto pool principalAssignment. |
Core | Experimental |
| az synapse kusto pool-principal-assignment update |
Update a Kusto pool principalAssignment. |
Core | Experimental |
| az synapse kusto pool-principal-assignment wait |
Place the CLI in a waiting state until a condition of the synapse kusto pool-principal-assignment is met. |
Core | Experimental |
az synapse kusto pool-principal-assignment create
Command group 'synapse kusto pool-principal-assignment' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Create a Kusto pool principalAssignment.
az synapse kusto pool-principal-assignment create --kusto-pool-name
--principal-assignment-name
--resource-group
--workspace-name
[--no-wait]
[--principal-id]
[--principal-type {App, Group, User}]
[--role {AllDatabasesAdmin, AllDatabasesViewer}]
[--tenant-id]
Examples
KustoPoolPrincipalAssignmentsCreateOrUpdate
az synapse kusto pool-principal-assignment create --kusto-pool-name "kustoclusterrptest4" --principal-id "87654321-1234-1234-1234-123456789123" --principal-type "App" --role "AllDatabasesAdmin" --tenant-id "12345678-1234-1234-1234-123456789123" --principal-assignment-name "kustoprincipal1" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName"
Required Parameters
The name of the Kusto pool.
The name of the Kusto principalAssignment.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the workspace.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
The principal ID assigned to the cluster principal. It can be a user email, application ID, or security group name.
Principal type.
| Property | Value |
|---|---|
| Accepted values: | App, Group, User |
Cluster principal role.
| Property | Value |
|---|---|
| Accepted values: | AllDatabasesAdmin, AllDatabasesViewer |
The tenant id of the principal.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az synapse kusto pool-principal-assignment delete
Command group 'synapse kusto pool-principal-assignment' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Deletes a Kusto pool principalAssignment.
az synapse kusto pool-principal-assignment delete [--ids]
[--kusto-pool-name]
[--no-wait]
[--principal-assignment-name]
[--resource-group]
[--subscription]
[--workspace-name]
[--yes]
Examples
KustoPoolPrincipalAssignmentsDelete
az synapse kusto pool-principal-assignment delete --kusto-pool-name "kustoclusterrptest4" --principal-assignment-name "kustoprincipal1" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName"
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
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.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the Kusto pool.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
The name of the Kusto principalAssignment.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the workspace.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Do not prompt for confirmation.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az synapse kusto pool-principal-assignment list
Command group 'synapse kusto pool-principal-assignment' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Lists all Kusto pool principalAssignments.
az synapse kusto pool-principal-assignment list --kusto-pool-name
--resource-group
--workspace-name
Examples
KustoPoolPrincipalAssignmentsList
az synapse kusto pool-principal-assignment list --kusto-pool-name "kustoclusterrptest4" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName"
Required Parameters
The name of the Kusto pool.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the workspace.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az synapse kusto pool-principal-assignment show
Command group 'synapse kusto pool-principal-assignment' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Gets a Kusto pool principalAssignment.
az synapse kusto pool-principal-assignment show [--ids]
[--kusto-pool-name]
[--principal-assignment-name]
[--resource-group]
[--subscription]
[--workspace-name]
Examples
KustoPoolPrincipalAssignmentsGet
az synapse kusto pool-principal-assignment show --kusto-pool-name "kustoclusterrptest4" --principal-assignment-name "kustoprincipal1" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName"
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
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.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the Kusto pool.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the Kusto principalAssignment.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the workspace.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az synapse kusto pool-principal-assignment update
Command group 'synapse kusto pool-principal-assignment' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Update a Kusto pool principalAssignment.
az synapse kusto pool-principal-assignment update [--add]
[--force-string]
[--ids]
[--kusto-pool-name]
[--no-wait]
[--principal-assignment-name]
[--principal-id]
[--principal-type {App, Group, User}]
[--remove]
[--resource-group]
[--role {AllDatabasesAdmin, AllDatabasesViewer}]
[--set]
[--subscription]
[--tenant-id]
[--workspace-name]
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
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>.
| Property | Value |
|---|---|
| Parameter group: | Generic Update Arguments |
| Default value: | [] |
When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
| Property | Value |
|---|---|
| Parameter group: | Generic Update Arguments |
| Default value: | False |
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.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the Kusto pool.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
The name of the Kusto principalAssignment.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The principal ID assigned to the cluster principal. It can be a user email, application ID, or security group name.
Principal type.
| Property | Value |
|---|---|
| Accepted values: | App, Group, User |
Remove a property or an element from a list. Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Property | Value |
|---|---|
| Parameter group: | Generic Update Arguments |
| Default value: | [] |
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Cluster principal role.
| Property | Value |
|---|---|
| Accepted values: | AllDatabasesAdmin, AllDatabasesViewer |
Update an object by specifying a property path and value to set. Example: --set property1.property2=<value>.
| Property | Value |
|---|---|
| Parameter group: | Generic Update Arguments |
| Default value: | [] |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The tenant id of the principal.
The name of the workspace.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az synapse kusto pool-principal-assignment wait
Command group 'synapse kusto pool-principal-assignment' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Place the CLI in a waiting state until a condition of the synapse kusto pool-principal-assignment is met.
az synapse kusto pool-principal-assignment wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--kusto-pool-name]
[--principal-assignment-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
[--workspace-name]
Examples
Pause executing next line of CLI script until the synapse kusto pool-principal-assignment is successfully created.
az synapse kusto pool-principal-assignment wait --kusto-pool-name "kustoclusterrptest4" --principal-assignment-name "kustoprincipal1" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName" --created
Pause executing next line of CLI script until the synapse kusto pool-principal-assignment is successfully updated.
az synapse kusto pool-principal-assignment wait --kusto-pool-name "kustoclusterrptest4" --principal-assignment-name "kustoprincipal1" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName" --updated
Pause executing next line of CLI script until the synapse kusto pool-principal-assignment is successfully deleted.
az synapse kusto pool-principal-assignment wait --kusto-pool-name "kustoclusterrptest4" --principal-assignment-name "kustoprincipal1" --resource-group "kustorptest" --workspace-name "synapseWorkspaceName" --deleted
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Wait until created with 'provisioningState' at 'Succeeded'.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
Wait until deleted.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Wait until the resource exists.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
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.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Polling interval in seconds.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | 30 |
The name of the Kusto pool.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
The name of the Kusto principalAssignment.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Maximum wait in seconds.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | 3600 |
Wait until updated with provisioningState at 'Succeeded'.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
The name of the workspace.
| Property | Value |
|---|---|
| Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |