Integration Runtimes - Start

Service:

Synapse

API-versie:

2021-06-01

Integration Runtime starten
Een integratieruntime starten

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

URI-parameters

Name	In	Vereist	Type	Description
integrationRuntimeName	path	True	string	Naam van integratieruntime
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string	De id van het doelabonnement.
workspaceName	path	True	string	De naam van de werkruimte.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	IntegrationRuntimeStatusResponse	OK.
202 Accepted		Geaccepteerd.
Other Status Codes	ErrorResponse	Er is een foutbericht ontvangen van de Azure Synapse-service.

Voorbeelden

Start integration runtime

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Statuscode:

202

Definities

Name	Description
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IntegrationRuntimeAutoUpdate	De status van automatische update van Integration Runtime.
IntegrationRuntimeInternalChannelEncryptionMode	Deze wordt gebruikt om de versleutelingsmodus in te stellen voor communicatiekanaal tussen knooppunten (wanneer er meer dan 2 zelf-hostende Integration Runtime-knooppunten bestaan).
IntegrationRuntimeState	De status van integration runtime.
IntegrationRuntimeStatusResponse	Antwoord van de integratieruntimestatus.
IntegrationRuntimeType	Het type integration runtime.
IntegrationRuntimeUpdateResult	Het resultaat van de laatste update van het integration runtime-knooppunt.
LinkedIntegrationRuntime	De informatie over de gekoppelde Integration Runtime.
ManagedIntegrationRuntimeError	Foutdefinitie voor beheerde integratieruntime.
ManagedIntegrationRuntimeNode	Eigenschappen van integration runtime-knooppunt.
ManagedIntegrationRuntimeNodeStatus	De status van het beheerde Integration Runtime-knooppunt.
ManagedIntegrationRuntimeOperationResult	Eigenschappen van het resultaat van de beheerde integration runtime-bewerking.
ManagedIntegrationRuntimeStatus	Status van beheerde integratieruntime.
SelfHostedIntegrationRuntimeNode	Eigenschappen van zelf-hostend integration runtime-knooppunt.
SelfHostedIntegrationRuntimeNodeStatus	Status van het integration runtime-knooppunt.
SelfHostedIntegrationRuntimeStatus	Zelf-hostende integration runtime-status.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IntegrationRuntimeAutoUpdate

Enumeration

De status van automatische update van Integration Runtime.

Waarde	Description
Off
On

IntegrationRuntimeInternalChannelEncryptionMode

Enumeration

Deze wordt gebruikt om de versleutelingsmodus in te stellen voor communicatiekanaal tussen knooppunten (wanneer er meer dan 2 zelf-hostende Integration Runtime-knooppunten bestaan).

Waarde	Description
NotEncrypted
NotSet
SslEncrypted

IntegrationRuntimeState

Enumeration

De status van integration runtime.

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

IntegrationRuntimeStatusResponse

Object

Antwoord van de integratieruntimestatus.

Name	Type	Description
name	string	De naam van de integratieruntime.
properties	IntegrationRuntimeStatus: ManagedIntegrationRuntimeStatus SelfHostedIntegrationRuntimeStatus	Eigenschappen van Integration Runtime.

IntegrationRuntimeType

Enumeration

Het type integration runtime.

Waarde	Description
Managed
SelfHosted

IntegrationRuntimeUpdateResult

Enumeration

Het resultaat van de laatste update van het integration runtime-knooppunt.

Waarde	Description
Fail
None
Succeed

LinkedIntegrationRuntime

Object

De informatie over de gekoppelde Integration Runtime.

Name	Type	Description
createTime	string	De tijd voor het maken van de gekoppelde integratieruntime.
dataFactoryLocation	string	De locatie van de werkruimte waartoe de gekoppelde integratieruntime behoort.
dataFactoryName	string	De naam van de werkruimte waartoe de gekoppelde integratieruntime behoort.
name	string	De naam van de gekoppelde integration runtime.
subscriptionId	string	De abonnements-id waartoe de gekoppelde integratieruntime behoort.

ManagedIntegrationRuntimeError

Object

Foutdefinitie voor beheerde integratieruntime.

Name	Type	Description
code	string	Foutcode.
message	string	Foutmelding.
parameters	string[]	Runtime-foutparameters voor beheerde integratie.
time	string	Het tijdstip waarop de fout is opgetreden.

ManagedIntegrationRuntimeNode

Object

Eigenschappen van integration runtime-knooppunt.

Name	Type	Description
errors	ManagedIntegrationRuntimeError[]	De fouten die zijn opgetreden op dit integration runtime-knooppunt.
nodeId	string	De id van het beheerde Integration Runtime-knooppunt.
status	ManagedIntegrationRuntimeNodeStatus	De status van het beheerde Integration Runtime-knooppunt.

ManagedIntegrationRuntimeNodeStatus

Enumeration

De status van het beheerde Integration Runtime-knooppunt.

Waarde	Description
Available
Recycling
Starting
Unavailable

ManagedIntegrationRuntimeOperationResult

Object

Eigenschappen van het resultaat van de beheerde integration runtime-bewerking.

Name	Type	Description
activityId	string	De activiteits-id voor de bewerkingsaanvraag.
errorCode	string	De foutcode.
parameters	string[]	Runtime-foutparameters voor beheerde integratie.
result	string	Het resultaat van de bewerking.
startTime	string	De begintijd van de bewerking.
type	string	Het bewerkingstype. Kan worden gestart of gestopt.

ManagedIntegrationRuntimeStatus

Object

Status van beheerde integratieruntime.

Name	Type	Description
dataFactoryName	string	De naam van de werkruimte waartoe de integratieruntime behoort.
state	IntegrationRuntimeState	De status van integration runtime.
type	string: Managed	Type integration runtime.
typeProperties.createTime	string	Het tijdstip waarop de integratieruntime is gemaakt, in ISO8601 indeling.
typeProperties.lastOperation	ManagedIntegrationRuntimeOperationResult	Het laatste bewerkingsresultaat dat is opgetreden in deze integration runtime.
typeProperties.nodes	ManagedIntegrationRuntimeNode[]	De lijst met knooppunten voor beheerde integratieruntime.
typeProperties.otherErrors	ManagedIntegrationRuntimeError[]	De fouten die zijn opgetreden in deze integratieruntime.

SelfHostedIntegrationRuntimeNode

Object

Eigenschappen van zelf-hostend integration runtime-knooppunt.

Name	Type	Description
capabilities	object	De woordenlijst met mogelijkheden van Integration Runtime
concurrentJobsLimit	integer	Maximum aantal gelijktijdige taken op het integration runtime-knooppunt.
expiryTime	string	Het tijdstip waarop de integratieruntime verloopt in ISO8601 indeling.
hostServiceUri	string	URI voor de hostcomputer van de Integration Runtime.
isActiveDispatcher	boolean	Geeft aan of dit knooppunt de actieve dispatcher is voor integration runtime-aanvragen.
lastConnectTime	string	Het meest recente tijdstip waarop de integration runtime is verbonden in ISO8601-indeling.
lastEndUpdateTime	string	De laatste keer dat de update van het integratieruntime-knooppunt is beëindigd.
lastStartTime	string	Het tijdstip waarop het knooppunt voor het laatst is opgestart.
lastStartUpdateTime	string	De laatste keer dat de update van het integratieruntime-knooppunt wordt gestart.
lastStopTime	string	De laatste stoptijd van het integration runtime-knooppunt.
lastUpdateResult	IntegrationRuntimeUpdateResult	Het resultaat van de laatste update van het integration runtime-knooppunt.
machineName	string	Computernaam van het integration runtime-knooppunt.
maxConcurrentJobs	integer	De maximale gelijktijdige taken in deze integration runtime.
nodeName	string	Naam van het integration runtime-knooppunt.
registerTime	string	Het tijdstip waarop het integration runtime-knooppunt is geregistreerd in ISO8601 indeling.
status	SelfHostedIntegrationRuntimeNodeStatus	Status van het integration runtime-knooppunt.
version	string	Versie van het integration runtime-knooppunt.
versionStatus	string	Status van de knooppuntversie van integration runtime.

SelfHostedIntegrationRuntimeNodeStatus

Enumeration

Status van het integration runtime-knooppunt.

Waarde	Description
InitializeFailed
Initializing
Limited
NeedRegistration
Offline
Online
Upgrading

SelfHostedIntegrationRuntimeStatus

Object

Zelf-hostende integration runtime-status.

Name	Type	Description
dataFactoryName	string	De naam van de werkruimte waartoe de integratieruntime behoort.
state	IntegrationRuntimeState	De status van integration runtime.
type	string: SelfHosted	Type integration runtime.
typeProperties.autoUpdate	IntegrationRuntimeAutoUpdate	Of automatische update van zelf-hostende Integration Runtime is ingeschakeld.
typeProperties.autoUpdateETA	string	De geschatte tijd waarop de zelf-hostende Integration Runtime wordt bijgewerkt.
typeProperties.capabilities	object	Object met aanvullende informatie over de mogelijkheden van integration runtime.
typeProperties.createTime	string	Het tijdstip waarop de integratieruntime is gemaakt, in ISO8601 indeling.
typeProperties.internalChannelEncryption	IntegrationRuntimeInternalChannelEncryptionMode	Deze wordt gebruikt om de versleutelingsmodus in te stellen voor communicatiekanaal tussen knooppunten (wanneer er meer dan 2 zelf-hostende Integration Runtime-knooppunten bestaan).
typeProperties.latestVersion	string	De nieuwste versie in het downloadcentrum.
typeProperties.links	LinkedIntegrationRuntime[]	De lijst met gekoppelde integratieruntimes die zijn gemaakt om te delen met deze integration runtime.
typeProperties.localTimeZoneOffset	string	De verschuiving van de lokale tijdzone in uren.
typeProperties.nodeCommunicationChannelEncryptionMode	string	De versleutelingsmodus van het knooppuntcommunicatiekanaal
typeProperties.nodes	SelfHostedIntegrationRuntimeNode[]	De lijst met knooppunten voor deze integratieruntime.
typeProperties.pushedVersion	string	De versie waarnaar de Integration Runtime wordt bijgewerkt.
typeProperties.scheduledUpdateDate	string	De datum waarop de integration runtime wordt gepland om bij te werken, in ISO8601 indeling.
typeProperties.serviceUrls	string[]	De URL's voor de services die worden gebruikt in de back-endservice van Integration Runtime.
typeProperties.taskQueueId	string	De id van de taakwachtrij van de integratieruntime.
typeProperties.updateDelayOffset	string	De tijd in de datum gepland door de service voor het bijwerken van de Integration Runtime, bijvoorbeeld PT03H is 3 uur
typeProperties.version	string	Versie van de Integration Runtime.
typeProperties.versionStatus	string	Status van de integration runtime-versie.