次の方法で共有


Integration Runtimes - Create Linked Integration Runtime

共有統合ランタイムにリンクされた統合ランタイム エントリを作成します。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/linkedIntegrationRuntime?api-version=2018-06-01

URI パラメーター

名前 / 必須 説明
factoryName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

ファクトリ名。

integrationRuntimeName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

統合ランタイム名。

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

リソース グループ名。

subscriptionId
path True

string

サブスクリプション識別子。

api-version
query True

string

API のバージョン。

要求本文

名前 説明
dataFactoryLocation

string

リンクされた統合ランタイムが属するデータ ファクトリの場所。

dataFactoryName

string

リンクされた統合ランタイムが属するデータ ファクトリの名前。

name

string

リンクされた統合ランタイムの名前。

subscriptionId

string

リンクされた統合ランタイムが属しているサブスクリプションの ID。

応答

名前 説明
200 OK

IntegrationRuntimeStatusResponse

わかりました。

Other Status Codes

CloudError

Azure Data Factory サービスから受信したエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

IntegrationRuntimes_CreateLinkedIntegrationRuntime

要求のサンプル

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationRuntimes/exampleIntegrationRuntime/linkedIntegrationRuntime?api-version=2018-06-01

{
  "name": "bfa92911-9fb6-4fbe-8f23-beae87bc1c83",
  "subscriptionId": "061774c7-4b5a-4159-a55b-365581830283",
  "dataFactoryName": "e9955d6d-56ea-4be3-841c-52a12c1a9981",
  "dataFactoryLocation": "West US"
}

応答のサンプル

Date: Fri, 17 Aug 2018 06:31:03 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-request-id: f9a67067-62f3-43ce-b891-2ccb3de4a15f
x-ms-correlation-request-id: f9a67067-62f3-43ce-b891-2ccb3de4a15f
{
  "name": "exampleIntegrationRuntime",
  "properties": {
    "dataFactoryName": "exampleFactoryName",
    "state": "Online",
    "type": "SelfHosted",
    "typeProperties": {
      "autoUpdate": "On",
      "taskQueueId": "823da112-f2d9-426b-a0d8-5f361b94f72a",
      "version": "3.8.6743.6",
      "nodes": [
        {
          "nodeName": "Node_1",
          "machineName": "YANZHANG-DT",
          "hostServiceUri": "https://yanzhang-dt.fareast.corp.microsoft.com:8050/HostServiceRemote.svc/",
          "status": "Online",
          "capabilities": {
            "serviceBusConnected": "True",
            "httpsPortEnabled": "True",
            "credentialInSync": "True",
            "connectedToResourceManager": "True",
            "nodeEnabled": "True"
          },
          "versionStatus": "UpToDate",
          "version": "3.8.6743.6",
          "registerTime": "2018-08-17T03:44:55.8012825Z",
          "lastConnectTime": "2018-08-17T06:30:46.6262976Z",
          "lastStartTime": "2018-08-17T03:45:30.8499851Z",
          "lastUpdateResult": "None",
          "isActiveDispatcher": true,
          "maxConcurrentJobs": 20
        }
      ],
      "scheduledUpdateDate": "2018-08-20T00:00:00Z",
      "updateDelayOffset": "PT19H",
      "localTimeZoneOffset": "PT8H",
      "serviceUrls": [
        "wu.frontend.int.clouddatahub-int.net",
        "*.servicebus.windows.net"
      ],
      "links": [
        {
          "name": "bfa92911-9fb6-4fbe-8f23-beae87bc1c83",
          "subscriptionId": "061774c7-4b5a-4159-a55b-365581830283",
          "dataFactoryName": "e9955d6d-56ea-4be3-841c-52a12c1a9981",
          "dataFactoryLocation": "West US",
          "createTime": "2018-08-17T06:31:04.0617928Z"
        }
      ],
      "versionStatus": "UpdateAvailable",
      "capabilities": {
        "serviceBusConnected": "True",
        "httpsPortEnabled": "True",
        "credentialInSync": "True",
        "connectedToResourceManager": "True",
        "nodeEnabled": "True"
      },
      "pushedVersion": "3.9.6774.1",
      "latestVersion": "3.9.6774.1",
      "autoUpdateETA": "2018-08-20T19:00:00Z",
      "createTime": "2018-08-17T03:43:25.7055573Z"
    }
  }
}

定義

名前 説明
CloudError

Azure Data Factory エラー応答の構造を定義するオブジェクト。

CreateLinkedIntegrationRuntimeRequest

リンクされた統合ランタイム情報。

IntegrationRuntimeAutoUpdate

統合ランタイムの自動更新の状態。

IntegrationRuntimeInternalChannelEncryptionMode

ノードノード通信チャネルの暗号化モードを設定するために使用されます (2 つ以上のセルフホステッド統合ランタイム ノードが存在する場合)。

IntegrationRuntimeState

統合ランタイムの状態。

IntegrationRuntimeStatusResponse

統合ランタイムの状態の応答。

IntegrationRuntimeType

統合ランタイムの種類。

IntegrationRuntimeUpdateResult

最後の統合ランタイム ノード更新の結果。

LinkedIntegrationRuntime

リンクされた統合ランタイム情報。

ManagedIntegrationRuntimeError

マネージド統合ランタイムのエラー定義。

ManagedIntegrationRuntimeNode

統合ランタイム ノードのプロパティ。

ManagedIntegrationRuntimeNodeStatus

マネージド統合ランタイム ノードの状態。

ManagedIntegrationRuntimeOperationResult

マネージド統合ランタイム操作の結果のプロパティ。

ManagedIntegrationRuntimeStatus

マネージド統合ランタイムの状態。

SelfHostedIntegrationRuntimeNode

セルフホステッド統合ランタイム ノードのプロパティ。

SelfHostedIntegrationRuntimeNodeStatus

統合ランタイム ノードの状態。

SelfHostedIntegrationRuntimeStatus

セルフホステッド統合ランタイムの状態。

CloudError

Azure Data Factory エラー応答の構造を定義するオブジェクト。

名前 説明
error.code

string

エラー コード。

error.details

CloudError[]

追加のエラーの詳細を含む配列。

error.message

string

エラーメッセージ。

error.target

string

エラーに関連付けられている要求のプロパティ名/パス。

CreateLinkedIntegrationRuntimeRequest

リンクされた統合ランタイム情報。

名前 説明
dataFactoryLocation

string

リンクされた統合ランタイムが属するデータ ファクトリの場所。

dataFactoryName

string

リンクされた統合ランタイムが属するデータ ファクトリの名前。

name

string

リンクされた統合ランタイムの名前。

subscriptionId

string

リンクされた統合ランタイムが属しているサブスクリプションの ID。

IntegrationRuntimeAutoUpdate

統合ランタイムの自動更新の状態。

説明
Off
On

IntegrationRuntimeInternalChannelEncryptionMode

ノードノード通信チャネルの暗号化モードを設定するために使用されます (2 つ以上のセルフホステッド統合ランタイム ノードが存在する場合)。

説明
NotEncrypted
NotSet
SslEncrypted

IntegrationRuntimeState

統合ランタイムの状態。

説明
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeStatusResponse

統合ランタイムの状態の応答。

名前 説明
name

string

統合ランタイム名。

properties IntegrationRuntimeStatus:

統合ランタイムのプロパティ。

IntegrationRuntimeType

統合ランタイムの種類。

説明
Managed
SelfHosted

IntegrationRuntimeUpdateResult

最後の統合ランタイム ノード更新の結果。

説明
Fail
None
Succeed

LinkedIntegrationRuntime

リンクされた統合ランタイム情報。

名前 説明
createTime

string (date-time)

リンクされた統合ランタイムの作成時刻。

dataFactoryLocation

string

リンクされた統合ランタイムが属するデータ ファクトリの場所。

dataFactoryName

string

リンクされた統合ランタイムが属するデータ ファクトリの名前。

name

string

リンクされた統合ランタイムの名前。

subscriptionId

string

リンクされた統合ランタイムが属するサブスクリプション ID。

ManagedIntegrationRuntimeError

マネージド統合ランタイムのエラー定義。

名前 説明
code

string

エラー コード。

message

string

エラーメッセージ。

parameters

string[]

マネージド統合ランタイムのエラー パラメーター。

time

string (date-time)

エラーが発生した時刻。

ManagedIntegrationRuntimeNode

統合ランタイム ノードのプロパティ。

名前 説明
errors

ManagedIntegrationRuntimeError[]

この統合ランタイム ノードで発生したエラー。

nodeId

string

マネージド統合ランタイム ノード ID。

status

ManagedIntegrationRuntimeNodeStatus

マネージド統合ランタイム ノードの状態。

ManagedIntegrationRuntimeNodeStatus

マネージド統合ランタイム ノードの状態。

説明
Available
Recycling
Starting
Unavailable

ManagedIntegrationRuntimeOperationResult

マネージド統合ランタイム操作の結果のプロパティ。

名前 説明
activityId

string

操作要求のアクティビティ ID。

errorCode

string

エラー コード。

parameters

string[]

マネージド統合ランタイムのエラー パラメーター。

result

string

操作の結果。

startTime

string (date-time)

操作の開始時刻。

type

string

操作の種類。 開始または停止できます。

ManagedIntegrationRuntimeStatus

マネージド統合ランタイムの状態。

名前 説明
dataFactoryName

string

統合ランタイムが属するデータ ファクトリ名。

state

IntegrationRuntimeState

統合ランタイムの状態。

type string:

Managed

統合ランタイムの種類。

typeProperties.createTime

string (date-time)

統合ランタイムが作成された時刻 (ISO8601形式)。

typeProperties.lastOperation

ManagedIntegrationRuntimeOperationResult

この統合ランタイムで発生した最後の操作の結果。

typeProperties.nodes

ManagedIntegrationRuntimeNode[]

マネージド統合ランタイムのノードの一覧。

typeProperties.otherErrors

ManagedIntegrationRuntimeError[]

この統合ランタイムで発生したエラー。

SelfHostedIntegrationRuntimeNode

セルフホステッド統合ランタイム ノードのプロパティ。

名前 説明
capabilities

object

統合ランタイム機能ディクショナリ

concurrentJobsLimit

integer

統合ランタイム ノードでの最大同時実行ジョブ数。

expiryTime

string (date-time)

統合ランタイムがISO8601形式で期限切れになる時刻。

hostServiceUri

string

統合ランタイムのホスト マシンの URI。

isActiveDispatcher

boolean

このノードが統合ランタイム要求のアクティブディスパッチャーであるかどうかを示します。

lastConnectTime

string (date-time)

統合ランタイムがISO8601形式で接続された最新の時刻。

lastEndUpdateTime

string (date-time)

統合ランタイム ノードの更新が最後に終了した時刻。

lastStartTime

string (date-time)

ノードが最後に起動した時刻。

lastStartUpdateTime

string (date-time)

統合ランタイム ノードの更新が最後に開始された時刻。

lastStopTime

string (date-time)

統合ランタイム ノードの最終停止時刻。

lastUpdateResult

IntegrationRuntimeUpdateResult

最後の統合ランタイム ノード更新の結果。

machineName

string

統合ランタイム ノードのマシン名。

maxConcurrentJobs

integer

この統合ランタイムの最大同時実行ジョブ数。

nodeName

string

統合ランタイム ノードの名前。

registerTime

string (date-time)

統合ランタイム ノードがISO8601形式で登録された時刻。

status

SelfHostedIntegrationRuntimeNodeStatus

統合ランタイム ノードの状態。

version

string

統合ランタイム ノードのバージョン。

versionStatus

string

統合ランタイム ノードのバージョンの状態。

SelfHostedIntegrationRuntimeNodeStatus

統合ランタイム ノードの状態。

説明
InitializeFailed
Initializing
Limited
NeedRegistration
Offline
Online
Upgrading

SelfHostedIntegrationRuntimeStatus

セルフホステッド統合ランタイムの状態。

名前 説明
dataFactoryName

string

統合ランタイムが属するデータ ファクトリ名。

state

IntegrationRuntimeState

統合ランタイムの状態。

type string:

SelfHosted

統合ランタイムの種類。

typeProperties.autoUpdate

IntegrationRuntimeAutoUpdate

セルフホステッド統合ランタイムの自動更新が有効になっているかどうか。

typeProperties.autoUpdateETA

string (date-time)

セルフホステッド統合ランタイムが更新される推定時間。

typeProperties.capabilities

object

統合ランタイム機能に関する追加情報を含むオブジェクト。

typeProperties.createTime

string (date-time)

統合ランタイムが作成された時刻 (ISO8601形式)。

typeProperties.internalChannelEncryption

IntegrationRuntimeInternalChannelEncryptionMode

ノードノード通信チャネルの暗号化モードを設定するために使用されます (2 つ以上のセルフホステッド統合ランタイム ノードが存在する場合)。

typeProperties.latestVersion

string

ダウンロード センターの最新バージョン。

typeProperties.links

LinkedIntegrationRuntime[]

この統合ランタイムと共有するために作成されたリンクされた統合ランタイムの一覧。

typeProperties.localTimeZoneOffset

string

ローカル タイム ゾーンオフセット (時間単位)。

typeProperties.nodes

SelfHostedIntegrationRuntimeNode[]

この統合ランタイムのノードの一覧。

typeProperties.pushedVersion

string

統合ランタイムが更新されるバージョン。

typeProperties.scheduledUpdateDate

string (date-time)

統合ランタイムの更新がスケジュールされる日付 (ISO8601形式)。

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

セルフホステッド統合ランタイムが Azure Relay との接続を確立できない場合に、対話型の作成機能を確保する別のオプション。

typeProperties.serviceUrls

string[]

統合ランタイム バックエンド サービスで使用されるサービスの URL。

typeProperties.taskQueueId

string

統合ランタイムのタスク キュー ID。

typeProperties.updateDelayOffset

string

統合ランタイムを更新するようにサービスによってスケジュールされた日付の時刻 (PT03H など) は 3 時間です

typeProperties.version

string

統合ランタイムのバージョン。

typeProperties.versionStatus

string

統合ランタイム バージョンの状態。