Azure Data Factory · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DataFactoryManagementClient Integration Runtime Nodes API

5 actions 5 updates phrasing extends openapi/microsoft-azure-data-factory-integrationruntimenodes-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Azure Data Factory's API. It is a proposal applied on top of the contract, not a document Azure Data Factory publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}/ipAddress'].post

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataFactoryManagementClient Integration Runtime Nodes API
  version: 1.0.0
extends: openapi/microsoft-azure-data-factory-integrationruntimenodes-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a self-hosted runtime node
      effect: read
      questions:
      - How do I check the details of one node in my self-hosted integration runtime?
      - What state is a specific self-hosted runtime machine in?
      instructions:
      - text: Get node {node} of integration runtime {ir} in factory {factory}.
        slots:
          factory: path.factoryName
          ir: path.integrationRuntimeName
          node: path.nodeName
      - text: Show me the details of self-hosted node {node} on runtime {ir}.
        slots:
          node: path.nodeName
          ir: path.integrationRuntimeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a node from a self-hosted runtime
      effect: destructive
      questions:
      - Can I remove a decommissioned machine from my self-hosted integration runtime?
      - What deletes a single node from a self-hosted runtime?
      instructions:
      - text: Delete node {node} from integration runtime {ir} in factory {factory}.
        slots:
          factory: path.factoryName
          ir: path.integrationRuntimeName
          node: path.nodeName
      - text: Remove self-hosted node {node} from runtime {ir}.
        slots:
          node: path.nodeName
          ir: path.integrationRuntimeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set concurrent job limit on a runtime node
      effect: write
      questions:
      - Can I change how many concurrent jobs a self-hosted runtime node will run?
      - How do I raise the job limit on one self-hosted node?
      instructions:
      - text: Set the concurrent jobs limit on node {node} of runtime {ir} in {factory} to {limit}.
        slots:
          factory: path.factoryName
          ir: path.integrationRuntimeName
          node: path.nodeName
          limit: requestBody.concurrentJobsLimit
      - text: Update self-hosted node {node} on runtime {ir}.
        slots:
          node: path.nodeName
          ir: path.integrationRuntimeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/nodes/{nodeName}/ipAddress'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the IP address of a runtime node
      effect: read
      questions:
      - What IP address does a self-hosted integration runtime node use?
      - Can I look up a node's IP so I can allow it through a firewall?
      instructions:
      - text: Get the IP address of node {node} on integration runtime {ir} in factory {factory}.
        slots:
          factory: path.factoryName
          ir: path.integrationRuntimeName
          node: path.nodeName
      - text: Find the IP for self-hosted node {node} of runtime {ir}.
        slots:
          node: path.nodeName
          ir: path.integrationRuntimeName
      method: generated
      generated: '2026-09-26'