az synapse integration-runtime

Commands

Name	Description	Type	Status
az synapse integration-runtime create	Create an integration runtime.	Core	Deprecated
az synapse integration-runtime delete	Delete an integration runtime.	Core	GA
az synapse integration-runtime get-connection-info	Get the integration runtime connection infomation.	Core	GA
az synapse integration-runtime get-monitoring-data	Get metric data for a self-hosted integration runtime.	Core	GA
az synapse integration-runtime get-status	Gets detailed status information for an integration runtime.	Core	GA
az synapse integration-runtime list	List integration runtimes.	Core	GA
az synapse integration-runtime list-auth-key	Get keys for a self-hosted integration runtime.	Core	GA
az synapse integration-runtime managed	Manage integration runtime with synapse sub group managed.	Core	GA
az synapse integration-runtime managed create	Create an managed integration runtime.	Core	GA
az synapse integration-runtime regenerate-auth-key	Regenerate self-hosted integration runtime key.	Core	GA
az synapse integration-runtime self-hosted	Manage integration runtime with synapse sub group self-hosted.	Core	GA
az synapse integration-runtime self-hosted create	Create an self-hosted integration runtime.	Core	GA
az synapse integration-runtime show	Get an integration runtime.	Core	GA
az synapse integration-runtime start	Start an SSIS integration runtime.	Core	GA
az synapse integration-runtime stop	Stop an SSIS integration runtime.	Core	GA
az synapse integration-runtime sync-credentials	Synchronize credentials among integration runtime nodes.	Core	GA
az synapse integration-runtime update	Update an integration runtime.	Core	GA
az synapse integration-runtime upgrade	Upgrade self-hosted integration runtime.	Core	GA
az synapse integration-runtime wait	Place the CLI in a waiting state until a condition of a integration runtime is met.	Core	GA

az synapse integration-runtime create --name
                                      --resource-group
                                      --type {Managed, SelfHosted}
                                      --workspace-name
                                      [--compute-type {ComputeOptimized, General, MemoryOptimized}]
                                      [--core-count]
                                      [--description]
                                      [--if-match]
                                      [--location]
                                      [--no-wait]
                                      [--time-to-live]

Examples

Create an integration runtime.

az synapse integration-runtime create --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime --type Managed

Required Parameters

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime delete [--ids]
                                      [--name]
                                      [--no-wait]
                                      [--resource-group]
                                      [--subscription]
                                      [--workspace-name]
                                      [--yes]

Examples

Delete an integration runtime.

az synapse integration-runtime delete --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime get-connection-info [--ids]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--workspace-name]

Examples

Get the integration runtime connection infomation.

az synapse integration-runtime get-connection-info --workspace-name testsynapseworkspace --resource-group rg \
  --name selfhostedintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime get-monitoring-data [--ids]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--workspace-name]

Examples

Get metric data for a self-hosted integration runtime.

az synapse integration-runtime get-monitoring-data --workspace-name testsynapseworkspace --resource-group rg \
  --name selfhostedintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime get-status [--ids]
                                          [--name]
                                          [--resource-group]
                                          [--subscription]
                                          [--workspace-name]

Examples

Gets detailed status information for an integration runtime.

az synapse integration-runtime get-status --workspace-name testsynapseworkspace --resource-group rg \
  --name selfhostedintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime list --resource-group
                                    --workspace-name

Examples

List integration runtimes.

az synapse integration-runtime list --workspace-name testsynapseworkspace --resource-group rg

Required Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime list-auth-key --name
                                             --resource-group
                                             --workspace-name

Examples

Get keys for a self-hosted integration runtime.

az synapse integration-runtime list-auth-key --workspace-name testsynapseworkspace --resource-group rg \
  --name selfhostedintegrationruntime

Required Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime regenerate-auth-key [--ids]
                                                   [--key-name {authKey1, authKey2}]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--workspace-name]

Examples

Regenerate self-hosted integration runtime key.

az synapse integration-runtime regenerate-auth-key --workspace-name testsynapseworkspace --resource-group rg \
  --name selfhostedintegrationruntime --key-name authKey1

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime show [--ids]
                                    [--if-none-match]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]
                                    [--workspace-name]

Examples

Get an integration runtime.

az synapse integration-runtime show --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime start [--ids]
                                     [--name]
                                     [--no-wait]
                                     [--resource-group]
                                     [--subscription]
                                     [--workspace-name]

Examples

start an SSIS integration runtime.

az synapse integration-runtime start --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime stop [--ids]
                                    [--name]
                                    [--no-wait]
                                    [--resource-group]
                                    [--subscription]
                                    [--workspace-name]
                                    [--yes]

Examples

stop an SSIS integration runtime.

az synapse integration-runtime stop --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime sync-credentials [--ids]
                                                [--name]
                                                [--resource-group]
                                                [--subscription]
                                                [--workspace-name]

Examples

Synchronize credentials among integration runtime nodes.

az synapse integration-runtime sync-credentials --workspace-name testsynapseworkspace --resource-group rg \
  --name selfhostedintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime update --auto-update {Off, On}
                                      --update-delay-offset
                                      [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]
                                      [--workspace-name]

Examples

Update an integration runtime.

az synapse integration-runtime update --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime --auto-update On --update-delay-offset '"PT03H"'

Required Parameters

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime upgrade [--ids]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]
                                       [--workspace-name]

Examples

Upgrade self-hosted integration runtime.

az synapse integration-runtime upgrade --workspace-name testsynapseworkspace --resource-group rg \
  --name testintegrationruntime

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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 synapse integration-runtime wait --name
                                    --resource-group
                                    --workspace-name
                                    [--created]
                                    [--custom]
                                    [--deleted]
                                    [--exists]
                                    [--if-none-match]
                                    [--interval]
                                    [--timeout]
                                    [--updated]

Required Parameters

Optional Parameters

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--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.