다음을 통해 공유


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 매개 변수

Name In(다음 안에) 필수 형식 Description
factoryName
path True

string

팩터리 이름입니다.

regex 패턴: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

integrationRuntimeName
path True

string

통합 런타임 이름입니다.

regex 패턴: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

리소스 그룹 이름입니다.

regex 패턴: ^[-\w\._\(\)]+$

subscriptionId
path True

string

구독 식별자입니다.

api-version
query True

string

API 버전입니다.

요청 본문

Name 형식 Description
dataFactoryLocation

string

연결된 통합 런타임이 속한 데이터 팩터리의 위치입니다.

dataFactoryName

string

연결된 통합 런타임이 속한 데이터 팩터리의 이름입니다.

name

string

연결된 통합 런타임의 이름입니다.

subscriptionId

string

연결된 통합 런타임이 속한 구독의 ID입니다.

응답

Name 형식 Description
200 OK

IntegrationRuntimeStatusResponse

OK.

Other Status Codes

CloudError

Azure Data Factory 서비스에서 받은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

IntegrationRuntimes_CreateLinkedIntegrationRuntime

Sample request

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"
}

Sample response

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"
    }
  }
}

정의

Name Description
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 오류 응답의 구조를 정의하는 개체입니다.

Name 형식 Description
error.code

string

오류 코드

error.details

CloudError[]

추가 오류 세부 정보가 있는 배열입니다.

error.message

string

오류 메시지입니다.

error.target

string

오류와 관련된 요청의 속성 이름/경로입니다.

CreateLinkedIntegrationRuntimeRequest

연결된 통합 런타임 정보입니다.

Name 형식 Description
dataFactoryLocation

string

연결된 통합 런타임이 속한 데이터 팩터리의 위치입니다.

dataFactoryName

string

연결된 통합 런타임이 속한 데이터 팩터리의 이름입니다.

name

string

연결된 통합 런타임의 이름입니다.

subscriptionId

string

연결된 통합 런타임이 속한 구독의 ID입니다.

IntegrationRuntimeAutoUpdate

통합 런타임 자동 업데이트의 상태입니다.

Name 형식 Description
Off

string

On

string

IntegrationRuntimeInternalChannelEncryptionMode

노드-노드 통신 채널에 대한 암호화 모드를 설정하는 데 사용됩니다(자체 호스팅 통합 런타임 노드가 2개 이상 있는 경우).

Name 형식 Description
NotEncrypted

string

NotSet

string

SslEncrypted

string

IntegrationRuntimeState

통합 런타임의 상태입니다.

Name 형식 Description
AccessDenied

string

Initial

string

Limited

string

NeedRegistration

string

Offline

string

Online

string

Started

string

Starting

string

Stopped

string

Stopping

string

IntegrationRuntimeStatusResponse

통합 런타임 상태 응답입니다.

Name 형식 Description
name

string

통합 런타임 이름입니다.

properties IntegrationRuntimeStatus:

통합 런타임 속성.

IntegrationRuntimeType

통합 런타임의 유형입니다.

Name 형식 Description
Managed

string

SelfHosted

string

IntegrationRuntimeUpdateResult

마지막 통합 런타임 노드 업데이트의 결과입니다.

Name 형식 Description
Fail

string

None

string

Succeed

string

LinkedIntegrationRuntime

연결된 통합 런타임 정보입니다.

Name 형식 Description
createTime

string

연결된 통합 런타임의 생성 시간입니다.

dataFactoryLocation

string

연결된 통합 런타임이 속한 데이터 팩터리의 위치입니다.

dataFactoryName

string

연결된 통합 런타임이 속한 데이터 팩터리의 이름입니다.

name

string

연결된 통합 런타임의 이름입니다.

subscriptionId

string

연결된 통합 런타임이 속한 구독 ID입니다.

ManagedIntegrationRuntimeError

관리되는 통합 런타임에 대한 오류 정의입니다.

Name 형식 Description
code

string

오류 코드

message

string

오류 메시지입니다.

parameters

string[]

관리되는 통합 런타임 오류 매개 변수입니다.

time

string

오류가 발생한 시간입니다.

ManagedIntegrationRuntimeNode

통합 런타임 노드의 속성입니다.

Name 형식 Description
errors

ManagedIntegrationRuntimeError[]

이 통합 런타임 노드에서 발생한 오류입니다.

nodeId

string

관리되는 통합 런타임 노드 ID입니다.

status

ManagedIntegrationRuntimeNodeStatus

관리되는 통합 런타임 노드가 상태.

ManagedIntegrationRuntimeNodeStatus

관리되는 통합 런타임 노드가 상태.

Name 형식 Description
Available

string

Recycling

string

Starting

string

Unavailable

string

ManagedIntegrationRuntimeOperationResult

관리되는 통합 런타임 작업 결과의 속성입니다.

Name 형식 Description
activityId

string

작업 요청에 대한 활동 ID입니다.

errorCode

string

오류 코드입니다.

parameters

string[]

관리되는 통합 런타임 오류 매개 변수입니다.

result

string

작업 결과입니다.

startTime

string

작업의 시작 시간입니다.

type

string

연산 유형입니다. 시작 또는 중지할 수 있습니다.

ManagedIntegrationRuntimeStatus

관리되는 통합 런타임 상태.

Name 형식 Description
dataFactoryName

string

통합 런타임이 속한 데이터 팩터리 이름입니다.

state

IntegrationRuntimeState

통합 런타임의 상태입니다.

type string:

Managed

통합 런타임의 유형입니다.

typeProperties.createTime

string

통합 런타임을 만든 시간(ISO8601 형식)입니다.

typeProperties.lastOperation

ManagedIntegrationRuntimeOperationResult

이 통합 런타임에서 발생한 마지막 작업 결과입니다.

typeProperties.nodes

ManagedIntegrationRuntimeNode[]

관리되는 통합 런타임에 대한 노드 목록입니다.

typeProperties.otherErrors

ManagedIntegrationRuntimeError[]

이 통합 런타임에서 발생한 오류입니다.

SelfHostedIntegrationRuntimeNode

자체 호스팅 통합 런타임 노드의 속성입니다.

Name 형식 Description
capabilities

object

통합 런타임 기능 사전

concurrentJobsLimit

integer

통합 런타임 노드의 최대 동시 작업 수입니다.

expiryTime

string

통합 런타임이 ISO8601 형식으로 만료되는 시간입니다.

hostServiceUri

string

통합 런타임의 호스트 컴퓨터에 대한 URI입니다.

isActiveDispatcher

boolean

이 노드가 통합 런타임 요청에 대한 활성 디스패처인지 여부를 나타냅니다.

lastConnectTime

string

통합 런타임이 ISO8601 형식으로 연결된 가장 최근의 시간입니다.

lastEndUpdateTime

string

통합 런타임 노드 업데이트가 마지막으로 종료된 시간입니다.

lastStartTime

string

노드가 마지막으로 시작된 시간입니다.

lastStartUpdateTime

string

통합 런타임 노드 업데이트가 마지막으로 시작된 시간입니다.

lastStopTime

string

통합 런타임 노드 마지막 중지 시간입니다.

lastUpdateResult

IntegrationRuntimeUpdateResult

마지막 통합 런타임 노드 업데이트의 결과입니다.

machineName

string

통합 런타임 노드의 컴퓨터 이름입니다.

maxConcurrentJobs

integer

이 통합 런타임의 최대 동시 작업입니다.

nodeName

string

통합 런타임 노드의 이름입니다.

registerTime

string

통합 런타임 노드가 ISO8601 형식으로 등록된 시간입니다.

status

SelfHostedIntegrationRuntimeNodeStatus

통합 런타임 노드의 상태입니다.

version

string

통합 런타임 노드의 버전입니다.

versionStatus

string

통합 런타임 노드 버전의 상태입니다.

SelfHostedIntegrationRuntimeNodeStatus

통합 런타임 노드의 상태입니다.

Name 형식 Description
InitializeFailed

string

Initializing

string

Limited

string

NeedRegistration

string

Offline

string

Online

string

Upgrading

string

SelfHostedIntegrationRuntimeStatus

자체 호스팅 통합 런타임 상태.

Name 형식 Description
dataFactoryName

string

통합 런타임이 속한 데이터 팩터리 이름입니다.

state

IntegrationRuntimeState

통합 런타임의 상태입니다.

type string:

SelfHosted

통합 런타임의 유형입니다.

typeProperties.autoUpdate

IntegrationRuntimeAutoUpdate

자체 호스팅 통합 런타임 자동 업데이트가 켜져 있는지 여부입니다.

typeProperties.autoUpdateETA

string

자체 호스팅 통합 런타임이 업데이트될 예상 시간입니다.

typeProperties.capabilities

object

통합 런타임 기능에 대한 추가 정보가 포함된 개체입니다.

typeProperties.createTime

string

통합 런타임을 만든 시간(ISO8601 형식)입니다.

typeProperties.internalChannelEncryption

IntegrationRuntimeInternalChannelEncryptionMode

노드-노드 통신 채널에 대한 암호화 모드를 설정하는 데 사용됩니다(자체 호스팅 통합 런타임 노드가 2개 이상 있는 경우).

typeProperties.latestVersion

string

다운로드 센터의 최신 버전입니다.

typeProperties.links

LinkedIntegrationRuntime[]

이 통합 런타임과 공유하도록 만들어진 연결된 통합 런타임 목록입니다.

typeProperties.localTimeZoneOffset

string

현지 표준 시간대 오프셋(시간)입니다.

typeProperties.nodes

SelfHostedIntegrationRuntimeNode[]

이 통합 런타임에 대한 노드 목록입니다.

typeProperties.pushedVersion

string

통합 런타임이 업데이트할 버전입니다.

typeProperties.scheduledUpdateDate

string

통합 런타임이 업데이트되도록 예약되는 날짜(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

통합 런타임 버전의 상태입니다.