az datafactory integration-runtime

Reference

Note

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

Manage integration runtime with datafactory.

Commands

az datafactory integration-runtime delete	Deletes an integration runtime.
az datafactory integration-runtime get-connection-info	Gets the on-premises integration runtime connection information for encrypting the on-premises data source credentials.
az datafactory integration-runtime get-monitoring-data	Get the integration runtime monitoring data, which includes the monitor data for all the nodes under this integration runtime.
az datafactory integration-runtime get-status	Gets detailed status information for an integration runtime.
az datafactory integration-runtime linked-integration-runtime	Manage integration runtime with datafactory sub group linked-integration-runtime.
az datafactory integration-runtime linked-integration-runtime create	Create a linked integration runtime entry in a shared integration runtime.
az datafactory integration-runtime list	Lists integration runtimes.
az datafactory integration-runtime list-auth-key	Retrieves the authentication keys for an integration runtime.
az datafactory integration-runtime managed	Manage integration runtime with datafactory sub group managed.
az datafactory integration-runtime managed create	Create an integration runtime.
az datafactory integration-runtime regenerate-auth-key	Regenerates the authentication key for an integration runtime.
az datafactory integration-runtime remove-link	Remove all linked integration runtimes under specific data factory in a self-hosted integration runtime.
az datafactory integration-runtime self-hosted	Manage integration runtime with datafactory sub group self-hosted.
az datafactory integration-runtime self-hosted create	Create an integration runtime.
az datafactory integration-runtime show	Gets an integration runtime.
az datafactory integration-runtime start	Starts a ManagedReserved type integration runtime.
az datafactory integration-runtime stop	Stops a ManagedReserved type integration runtime.
az datafactory integration-runtime sync-credentials	Force the integration runtime to synchronize credentials across integration runtime nodes, and this will override the credentials across all worker nodes with those available on the dispatcher node. If you already have the latest credential backup file, you should manually import it (preferred) on any self-hosted integration runtime node than using this API directly.
az datafactory integration-runtime update	Updates an integration runtime.
az datafactory integration-runtime upgrade	Upgrade self-hosted integration runtime to latest version if availability.
az datafactory integration-runtime wait	Place the CLI in a waiting state until a condition of the datafactory integration-runtime is met.

az datafactory integration-runtime delete

Deletes an integration runtime.

az datafactory integration-runtime delete --factory-name
                                          --integration-runtime-name
                                          --resource-group
                                          [--yes]

Examples

IntegrationRuntimes_Delete

az datafactory integration-runtime delete --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--yes -y

Do not prompt for confirmation.

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 datafactory integration-runtime get-connection-info

Gets the on-premises integration runtime connection information for encrypting the on-premises data source credentials.

az datafactory integration-runtime get-connection-info --factory-name
                                                       --integration-runtime-name
                                                       --resource-group

Examples

IntegrationRuntimes_GetConnectionInfo

az datafactory integration-runtime get-connection-info --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--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 datafactory integration-runtime get-monitoring-data

Get the integration runtime monitoring data, which includes the monitor data for all the nodes under this integration runtime.

az datafactory integration-runtime get-monitoring-data --factory-name
                                                       --integration-runtime-name
                                                       --resource-group

Examples

IntegrationRuntimes_GetMonitoringData

az datafactory integration-runtime get-monitoring-data --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--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 datafactory integration-runtime get-status

Gets detailed status information for an integration runtime.

az datafactory integration-runtime get-status --factory-name
                                              --integration-runtime-name
                                              --resource-group

Examples

IntegrationRuntimes_GetStatus

az datafactory integration-runtime get-status --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--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 datafactory integration-runtime list

Lists integration runtimes.

az datafactory integration-runtime list --factory-name
                                        --resource-group

Examples

IntegrationRuntimes_ListByFactory

az datafactory integration-runtime list --factory-name "exampleFactoryName" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--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 datafactory integration-runtime list-auth-key

Retrieves the authentication keys for an integration runtime.

az datafactory integration-runtime list-auth-key --factory-name
                                                 --integration-runtime-name
                                                 --resource-group

Examples

IntegrationRuntimes_ListAuthKeys

az datafactory integration-runtime list-auth-key --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--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 datafactory integration-runtime regenerate-auth-key

Regenerates the authentication key for an integration runtime.

az datafactory integration-runtime regenerate-auth-key --factory-name
                                                       --integration-runtime-name
                                                       --resource-group
                                                       [--key-name {authKey1, authKey2}]

Examples

IntegrationRuntimes_RegenerateAuthKey

az datafactory integration-runtime regenerate-auth-key --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --key-name "authKey2" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--key-name

The name of the authentication key to regenerate.

accepted values: authKey1, authKey2

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 datafactory integration-runtime remove-link

Remove all linked integration runtimes under specific data factory in a self-hosted integration runtime.

az datafactory integration-runtime remove-link --factory-name
                                               --integration-runtime-name
                                               --linked-factory-name
                                               --resource-group

Examples

IntegrationRuntimes_Upgrade

az datafactory integration-runtime remove-link --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --linked-factory-name "exampleFactoryName-linked" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--linked-factory-name

The data factory name for linked integration runtime.

--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 datafactory integration-runtime show

Gets an integration runtime.

az datafactory integration-runtime show --factory-name
                                        --integration-runtime-name
                                        --resource-group
                                        [--if-none-match]

Examples

IntegrationRuntimes_Get

az datafactory integration-runtime show --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--if-none-match

ETag of the integration runtime entity. Should only be specified for get. If the ETag matches the existing entity tag, or if * was provided, then no content will be returned.

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 datafactory integration-runtime start

Starts a ManagedReserved type integration runtime.

az datafactory integration-runtime start --factory-name
                                         --integration-runtime-name
                                         --resource-group
                                         [--no-wait]

Examples

IntegrationRuntimes_Start

az datafactory integration-runtime start --factory-name "exampleFactoryName" --name "exampleManagedIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

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 datafactory integration-runtime stop

Stops a ManagedReserved type integration runtime.

az datafactory integration-runtime stop --factory-name
                                        --integration-runtime-name
                                        --resource-group
                                        [--no-wait]

Examples

IntegrationRuntimes_Stop

az datafactory integration-runtime stop --factory-name "exampleFactoryName" --name "exampleManagedIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

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 datafactory integration-runtime sync-credentials

Force the integration runtime to synchronize credentials across integration runtime nodes, and this will override the credentials across all worker nodes with those available on the dispatcher node. If you already have the latest credential backup file, you should manually import it (preferred) on any self-hosted integration runtime node than using this API directly.

az datafactory integration-runtime sync-credentials --factory-name
                                                    --integration-runtime-name
                                                    --resource-group

Examples

IntegrationRuntimes_SyncCredentials

az datafactory integration-runtime sync-credentials --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--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 datafactory integration-runtime update

Updates an integration runtime.

az datafactory integration-runtime update --factory-name
                                          --integration-runtime-name
                                          --resource-group
                                          [--auto-update {Off, On}]
                                          [--update-delay-offset]

Examples

IntegrationRuntimes_Update

az datafactory integration-runtime update --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup" --auto-update "Off" --update-delay-offset "\"PT3H\""

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--auto-update

Enables or disables the auto-update feature of the self-hosted integration runtime. See https://go.microsoft.com/fwlink/?linkid=854189.

accepted values: Off, On

--update-delay-offset

The time offset (in hours) in the day, e.g., PT03H is 3 hours. The integration runtime auto update will happen on that time.

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 datafactory integration-runtime upgrade

Upgrade self-hosted integration runtime to latest version if availability.

az datafactory integration-runtime upgrade --factory-name
                                           --integration-runtime-name
                                           --resource-group

Examples

IntegrationRuntimes_Upgrade

az datafactory integration-runtime upgrade --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup"

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--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 datafactory integration-runtime wait

Place the CLI in a waiting state until a condition of the datafactory integration-runtime is met.

az datafactory integration-runtime wait --factory-name
                                        --integration-runtime-name
                                        --resource-group
                                        [--created]
                                        [--custom]
                                        [--deleted]
                                        [--exists]
                                        [--if-none-match]
                                        [--interval]
                                        [--timeout]
                                        [--updated]

Examples

Pause executing next line of CLI script until the datafactory integration-runtime is successfully created.

az datafactory integration-runtime wait --factory-name "exampleFactoryName" --name "exampleIntegrationRuntime" --resource-group "exampleResourceGroup" --created

Required Parameters

--factory-name

The factory name.

--integration-runtime-name --name -n

The integration runtime name.

--resource-group -g

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

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

--exists

Wait until the resource exists.

--if-none-match

ETag of the integration runtime entity. Should only be specified for get. If the ETag matches the existing entity tag, or if * was provided, then no content will be returned.

--interval

Polling interval in seconds.

default value: 30

--timeout

Maximum wait in seconds.

default value: 3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

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 datafactory integration-runtime

Commands

az datafactory integration-runtime delete

Examples

Required Parameters

Optional Parameters

az datafactory integration-runtime get-connection-info

Examples

Required Parameters

az datafactory integration-runtime get-monitoring-data

Examples

Required Parameters

az datafactory integration-runtime get-status

Examples

Required Parameters

az datafactory integration-runtime list

Examples

Required Parameters

az datafactory integration-runtime list-auth-key

Examples

Required Parameters

az datafactory integration-runtime regenerate-auth-key

Examples

Required Parameters

Optional Parameters

az datafactory integration-runtime remove-link

Examples

Required Parameters

az datafactory integration-runtime show

Examples

Required Parameters

Optional Parameters

az datafactory integration-runtime start

Examples

Required Parameters

Optional Parameters

az datafactory integration-runtime stop

Examples

Required Parameters

Optional Parameters

az datafactory integration-runtime sync-credentials

Examples

Required Parameters

az datafactory integration-runtime update

Examples

Required Parameters

Optional Parameters

az datafactory integration-runtime upgrade

Examples

Required Parameters

az datafactory integration-runtime wait

Examples

Required Parameters

Optional Parameters

Feedback