Skip to main content

integration_runtime_nodes

Creates, updates, deletes, gets or lists an integration_runtime_nodes resource.

Overview

Nameintegration_runtime_nodes
TypeResource
Idazure.data_factory.integration_runtime_nodes

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
capabilitiesobjectThe integration runtime capabilities dictionary.
concurrentJobsLimitintegerMaximum concurrent jobs on the integration runtime node.
expiryTimestring (date-time)The time at which the integration runtime will expire in ISO8601 format.
hostServiceUristringURI for the host machine of the integration runtime.
isActiveDispatcherbooleanIndicates whether this node is the active dispatcher for integration runtime requests.
lastConnectTimestring (date-time)The most recent time at which the integration runtime was connected in ISO8601 format.
lastEndUpdateTimestring (date-time)The last time for the integration runtime node update end.
lastStartTimestring (date-time)The time the node last started up.
lastStartUpdateTimestring (date-time)The last time for the integration runtime node update start.
lastStopTimestring (date-time)The integration runtime node last stop time.
lastUpdateResultstringThe result of the last integration runtime node update. Known values are: "None", "Succeed", and "Fail". (None, Succeed, Fail)
machineNamestringMachine name of the integration runtime node.
maxConcurrentJobsintegerThe maximum concurrent jobs in this integration runtime.
nodeNamestringName of the integration runtime node.
registerTimestring (date-time)The time at which the integration runtime node was registered in ISO8601 format.
statusstringStatus of the integration runtime node. Known values are: "NeedRegistration", "Online", "Limited", "Offline", "Upgrading", "Initializing", and "InitializeFailed". (NeedRegistration, Online, Limited, Offline, Upgrading, Initializing, InitializeFailed)
versionstringVersion of the integration runtime node.
versionStatusstringStatus of the integration runtime node version.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresource_group_name, factory_name, integration_runtime_name, node_name, subscription_idGets a self-hosted integration runtime node.
updateupdateresource_group_name, factory_name, integration_runtime_name, node_name, subscription_idUpdates a self-hosted integration runtime node.
deletedeleteresource_group_name, factory_name, integration_runtime_name, node_name, subscription_idDeletes a self-hosted integration runtime node.
get_ip_addressexecresource_group_name, factory_name, integration_runtime_name, node_name, subscription_idGet the IP address of self-hosted integration runtime node.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
factory_namestringRequired.
integration_runtime_namestringRequired.
node_namestringThe integration runtime node name. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring

SELECT examples

Gets a self-hosted integration runtime node.

SELECT
capabilities,
concurrentJobsLimit,
expiryTime,
hostServiceUri,
isActiveDispatcher,
lastConnectTime,
lastEndUpdateTime,
lastStartTime,
lastStartUpdateTime,
lastStopTime,
lastUpdateResult,
machineName,
maxConcurrentJobs,
nodeName,
registerTime,
status,
version,
versionStatus
FROM azure.data_factory.integration_runtime_nodes
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND factory_name = '{{ factory_name }}' -- required
AND integration_runtime_name = '{{ integration_runtime_name }}' -- required
AND node_name = '{{ node_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

UPDATE examples

Updates a self-hosted integration runtime node.

UPDATE azure.data_factory.integration_runtime_nodes
SET
concurrentJobsLimit = {{ concurrentJobsLimit }}
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND factory_name = '{{ factory_name }}' --required
AND integration_runtime_name = '{{ integration_runtime_name }}' --required
AND node_name = '{{ node_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
capabilities,
concurrentJobsLimit,
expiryTime,
hostServiceUri,
isActiveDispatcher,
lastConnectTime,
lastEndUpdateTime,
lastStartTime,
lastStartUpdateTime,
lastStopTime,
lastUpdateResult,
machineName,
maxConcurrentJobs,
nodeName,
registerTime,
status,
version,
versionStatus;

DELETE examples

Deletes a self-hosted integration runtime node.

DELETE FROM azure.data_factory.integration_runtime_nodes
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND factory_name = '{{ factory_name }}' --required
AND integration_runtime_name = '{{ integration_runtime_name }}' --required
AND node_name = '{{ node_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;

Lifecycle Methods

Get the IP address of self-hosted integration runtime node.

EXEC azure.data_factory.integration_runtime_nodes.get_ip_address 
@resource_group_name='{{ resource_group_name }}' --required,
@factory_name='{{ factory_name }}' --required,
@integration_runtime_name='{{ integration_runtime_name }}' --required,
@node_name='{{ node_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
;