Integration Runtimes - Start

참조

서비스:: Synapse

API 버전:: 2021-06-01

통합 런타임 시작
통합 런타임 시작

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}/start?api-version=2021-06-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
integrationRuntimeName	path	True	string	통합 런타임 이름
resourceGroupName	path	True	string	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
subscriptionId	path	True	string	대상 구독의 ID입니다.
workspaceName	path	True	string	작업 영역의 이름입니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	IntegrationRuntimeStatusResponse	그래.
202 Accepted		허용.
Other Status Codes	ErrorResponse	Azure Synapse 서비스에서 받은 오류 응답입니다.

예제

Start integration runtime

샘플 요청

HTTP

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspace/integrationRuntimes/exampleManagedIntegrationRuntime/start?api-version=2021-06-01

샘플 응답

상태 코드:: 200

Date: Wed, 13 Jun 2018 21:33:00 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 14912
x-ms-request-id: 2af47f9f-5625-4b01-a3a5-bccb576a4677
x-ms-correlation-request-id: 2af47f9f-5625-4b01-a3a5-bccb576a4677

{
  "name": "exampleManagedIntegrationRuntime",
  "properties": {
    "dataFactoryName": "exampleWorkspaceName",
    "type": "Managed",
    "state": "Started",
    "typeProperties": {
      "nodes": [],
      "otherErrors": [],
      "createTime": "2018-06-13T21:11:01.8695494Z"
    }
  }
}

상태 코드:: 202

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
IntegrationRuntimeAutoUpdate	통합 런타임 자동 업데이트의 상태입니다.
IntegrationRuntimeInternalChannelEncryptionMode	노드-노드 통신 채널에 대한 암호화 모드를 설정하는 데 사용됩니다(자체 호스팅 통합 런타임 노드가 2개 이상 있는 경우).
IntegrationRuntimeState	통합 런타임의 상태입니다.
IntegrationRuntimeStatusResponse	통합 런타임 상태 응답입니다.
IntegrationRuntimeType	통합 런타임의 유형입니다.
IntegrationRuntimeUpdateResult	마지막 통합 런타임 노드 업데이트의 결과입니다.
LinkedIntegrationRuntime	연결된 통합 런타임 정보입니다.
ManagedIntegrationRuntimeError	관리되는 통합 런타임에 대한 오류 정의입니다.
ManagedIntegrationRuntimeNode	통합 런타임 노드의 속성입니다.
ManagedIntegrationRuntimeNodeStatus	관리되는 통합 런타임 노드 상태입니다.
ManagedIntegrationRuntimeOperationResult	관리되는 통합 런타임 작업 결과의 속성입니다.
ManagedIntegrationRuntimeStatus	관리되는 통합 런타임 상태입니다.
SelfHostedIntegrationRuntimeNode	자체 호스팅 통합 런타임 노드의 속성입니다.
SelfHostedIntegrationRuntimeNodeStatus	통합 런타임 노드의 상태입니다.
SelfHostedIntegrationRuntimeStatus	자체 호스팅 통합 런타임 상태입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

IntegrationRuntimeAutoUpdate

Enumeration

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

값	Description
Off
On

IntegrationRuntimeInternalChannelEncryptionMode

Enumeration

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

값	Description
NotEncrypted
NotSet
SslEncrypted

IntegrationRuntimeState

Enumeration

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

값	Description
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeStatusResponse

Object

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

Name	형식	Description
name	string	통합 런타임 이름입니다.
properties	IntegrationRuntimeStatus: ManagedIntegrationRuntimeStatus SelfHostedIntegrationRuntimeStatus	통합 런타임 속성입니다.

IntegrationRuntimeType

Enumeration

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

값	Description
Managed
SelfHosted

IntegrationRuntimeUpdateResult

Enumeration

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

값	Description
Fail
None
Succeed

LinkedIntegrationRuntime

Object

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

Name	형식	Description
createTime	string	연결된 통합 런타임의 생성 시간입니다.
dataFactoryLocation	string	연결된 통합 런타임이 속한 작업 영역의 위치입니다.
dataFactoryName	string	연결된 통합 런타임이 속한 작업 영역의 이름입니다.
name	string	연결된 통합 런타임의 이름입니다.
subscriptionId	string	연결된 통합 런타임이 속한 구독 ID입니다.

ManagedIntegrationRuntimeError

Object

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

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.
parameters	string[]	관리되는 통합 런타임 오류 매개 변수입니다.
time	string	오류가 발생한 시간입니다.

ManagedIntegrationRuntimeNode

Object

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

Name	형식	Description
errors	ManagedIntegrationRuntimeError[]	이 통합 런타임 노드에서 발생한 오류입니다.
nodeId	string	관리되는 통합 런타임 노드 ID입니다.
status	ManagedIntegrationRuntimeNodeStatus	관리되는 통합 런타임 노드 상태입니다.

ManagedIntegrationRuntimeNodeStatus

Enumeration

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

값	Description
Available
Recycling
Starting
Unavailable

ManagedIntegrationRuntimeOperationResult

Object

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

Name	형식	Description
activityId	string	작업 요청에 대한 활동 ID입니다.
errorCode	string	오류 코드입니다.
parameters	string[]	관리되는 통합 런타임 오류 매개 변수입니다.
result	string	작업 결과입니다.
startTime	string	작업의 시작 시간입니다.
type	string	작업 유형입니다. 시작 또는 중지할 수 있습니다.

ManagedIntegrationRuntimeStatus

Object

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

Name	형식	Description
dataFactoryName	string	통합 런타임이 속한 작업 영역 이름입니다.
state	IntegrationRuntimeState	통합 런타임의 상태입니다.
type	string: Managed	통합 런타임의 유형입니다.
typeProperties.createTime	string	통합 런타임이 만들어진 시간(ISO8601 형식)입니다.
typeProperties.lastOperation	ManagedIntegrationRuntimeOperationResult	이 통합 런타임에서 발생한 마지막 작업 결과입니다.
typeProperties.nodes	ManagedIntegrationRuntimeNode[]	관리되는 통합 런타임에 대한 노드 목록입니다.
typeProperties.otherErrors	ManagedIntegrationRuntimeError[]	이 통합 런타임에서 발생한 오류입니다.

SelfHostedIntegrationRuntimeNode

Object

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

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

Enumeration

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

값	Description
InitializeFailed
Initializing
Limited
NeedRegistration
Offline
Online
Upgrading

SelfHostedIntegrationRuntimeStatus

Object

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

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.nodeCommunicationChannelEncryptionMode	string	노드 통신 채널 암호화 모드
typeProperties.nodes	SelfHostedIntegrationRuntimeNode[]	이 통합 런타임에 대한 노드 목록입니다.
typeProperties.pushedVersion	string	통합 런타임이 업데이트할 버전입니다.
typeProperties.scheduledUpdateDate	string	통합 런타임이 업데이트되도록 예약되는 날짜(ISO8601 형식)입니다.
typeProperties.serviceUrls	string[]	통합 런타임 백 엔드 서비스에 사용되는 서비스에 대한 URL입니다.
typeProperties.taskQueueId	string	통합 런타임의 작업 큐 ID입니다.
typeProperties.updateDelayOffset	string	통합 런타임을 업데이트하기 위해 서비스에서 예약한 날짜의 시간(예: PT03H)은 3시간입니다.
typeProperties.version	string	통합 런타임의 버전입니다.
typeProperties.versionStatus	string	통합 런타임 버전의 상태입니다.

다음을 통해 공유

Integration Runtimes - Start

URI 매개 변수

응답

예제

Start integration runtime

샘플 요청

샘플 응답

정의

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IntegrationRuntimeAutoUpdate

IntegrationRuntimeInternalChannelEncryptionMode

IntegrationRuntimeState

IntegrationRuntimeStatusResponse

IntegrationRuntimeType

IntegrationRuntimeUpdateResult

LinkedIntegrationRuntime

ManagedIntegrationRuntimeError

ManagedIntegrationRuntimeNode

ManagedIntegrationRuntimeNodeStatus

ManagedIntegrationRuntimeOperationResult

ManagedIntegrationRuntimeStatus

SelfHostedIntegrationRuntimeNode

SelfHostedIntegrationRuntimeNodeStatus

SelfHostedIntegrationRuntimeStatus

추가 리소스