Integration Runtimes - Start

Dienst:: Data Factory

API-Version:: 2018-06-01

Startet eine ManagedReserved-Typintegrationslaufzeit.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
factoryName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	Der Werksname.
integrationRuntimeName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	Der Name der Integrationslaufzeit.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Der Ressourcengruppenname.
subscriptionId	path	True	string	Der Abonnementbezeichner.
api-version	query	True	string	Die API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	IntegrationRuntimeStatusResponse	OKAY.
202 Accepted		Angenommen.
Other Status Codes	CloudError	Eine Fehlerantwort, die vom Azure Data Factory-Dienst empfangen wurde.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

IntegrationRuntimes_Start

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataFactory.Models;
using Azure.ResourceManager.DataFactory;

// Generated from example definition: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/IntegrationRuntimes_Start.json
// this example is just showing the usage of "IntegrationRuntimes_Start" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataFactoryIntegrationRuntimeResource created on azure
// for more information of creating DataFactoryIntegrationRuntimeResource, please refer to the document of DataFactoryIntegrationRuntimeResource
string subscriptionId = "12345678-1234-1234-1234-12345678abc";
string resourceGroupName = "exampleResourceGroup";
string factoryName = "exampleFactoryName";
string integrationRuntimeName = "exampleManagedIntegrationRuntime";
ResourceIdentifier dataFactoryIntegrationRuntimeResourceId = DataFactoryIntegrationRuntimeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, factoryName, integrationRuntimeName);
DataFactoryIntegrationRuntimeResource dataFactoryIntegrationRuntime = client.GetDataFactoryIntegrationRuntimeResource(dataFactoryIntegrationRuntimeResourceId);

// invoke the operation
ArmOperation<DataFactoryIntegrationRuntimeStatusResult> lro = await dataFactoryIntegrationRuntime.StartAsync(WaitUntil.Completed);
DataFactoryIntegrationRuntimeStatusResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourcegroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationruntimes/exampleIntegrationRuntime/IntegrationRuntimesStart/operationresults/d711da6461c04b98b03ae734743a3f4e?api-version=2018-06-01
location: https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourcegroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationruntimes/exampleIntegrationRuntime/IntegrationRuntimesStart/operationresults/d711da6461c04b98b03ae734743a3f4e?api-version=2018-06-01

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": "exampleFactoryName",
    "type": "Managed",
    "state": "Started",
    "typeProperties": {
      "nodes": [],
      "otherErrors": [],
      "createTime": "2018-06-13T21:11:01.8695494Z"
    }
  }
}

Definitionen

Name	Beschreibung
CloudError	Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert.
IntegrationRuntimeAutoUpdate	Der Status der automatischen Aktualisierung der Integrationslaufzeit.
IntegrationRuntimeInternalChannelEncryptionMode	Es wird verwendet, um den Verschlüsselungsmodus für den Knotenknotenkommunikationskanal festzulegen (wenn mehr als 2 selbst gehostete Integrations-Runtime-Knoten vorhanden sind).
IntegrationRuntimeState	Der Status der Integrationslaufzeit.
IntegrationRuntimeStatusResponse	Antwort auf den Integrations-Laufzeitstatus.
IntegrationRuntimeType	Der Typ der Integrationslaufzeit.
IntegrationRuntimeUpdateResult	Das Ergebnis des letzten Integrations-Runtime-Knotenupdates.
LinkedIntegrationRuntime	Die Informationen zur verknüpften Integrationslaufzeit.
ManagedIntegrationRuntimeError	Fehlerdefinition für verwaltete Integrationslaufzeit.
ManagedIntegrationRuntimeNode	Eigenschaften des Integrationslaufzeitknotens.
ManagedIntegrationRuntimeNodeStatus	Der Status des Verwalteten Integrations-Laufzeitknotens.
ManagedIntegrationRuntimeOperationResult	Eigenschaften des Ergebnisses des Verwalteten Integrations-Laufzeitvorgangs.
ManagedIntegrationRuntimeStatus	Status der verwalteten Integrationslaufzeit.
SelfHostedIntegrationRuntimeNode	Eigenschaften des Selbst gehosteten Integrations-Laufzeitknotens.
SelfHostedIntegrationRuntimeNodeStatus	Status des Integrationslaufzeitknotens.
SelfHostedIntegrationRuntimeStatus	Selbst gehosteter Integrationslaufzeitstatus.

CloudError

Objekt

Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert.

Name	Typ	Beschreibung
error.code	string	Fehlercode.
error.details	CloudError[]	Array mit zusätzlichen Fehlerdetails.
error.message	string	Fehlermeldung.
error.target	string	Eigenschaftsname/Pfad in Anforderung, die fehler zugeordnet ist.

IntegrationRuntimeAutoUpdate

Enumeration

Der Status der automatischen Aktualisierung der Integrationslaufzeit.

Wert	Beschreibung
On
Off

IntegrationRuntimeInternalChannelEncryptionMode

Enumeration

Es wird verwendet, um den Verschlüsselungsmodus für den Knotenknotenkommunikationskanal festzulegen (wenn mehr als 2 selbst gehostete Integrations-Runtime-Knoten vorhanden sind).

Wert	Beschreibung
NotSet
SslEncrypted
NotEncrypted

IntegrationRuntimeState

Enumeration

Der Status der Integrationslaufzeit.

Wert	Beschreibung
Initial
Stopped
Started
Starting
Stopping
NeedRegistration
Online
Limited
Offline
AccessDenied

IntegrationRuntimeStatusResponse

Objekt

Antwort auf den Integrations-Laufzeitstatus.

Name	Typ	Beschreibung
name	string	Der Name der Integrationslaufzeit.
properties	IntegrationRuntimeStatus: ManagedIntegrationRuntimeStatus SelfHostedIntegrationRuntimeStatus	Integrationslaufzeiteigenschaften.

IntegrationRuntimeType

Enumeration

Der Typ der Integrationslaufzeit.

Wert	Beschreibung
Managed
SelfHosted

IntegrationRuntimeUpdateResult

Enumeration

Das Ergebnis des letzten Integrations-Runtime-Knotenupdates.

Wert	Beschreibung
None
Succeed
Fail

LinkedIntegrationRuntime

Objekt

Die Informationen zur verknüpften Integrationslaufzeit.

Name	Typ	Beschreibung
createTime	string (date-time)	Die Erstellungszeit der verknüpften Integrationslaufzeit.
dataFactoryLocation	string	Der Speicherort der Datenfactory, zu der die verknüpfte Integrationslaufzeit gehört.
dataFactoryName	string	Der Name der Datenfactory, zu der die verknüpfte Integrationslaufzeit gehört.
name	string	Der Name der verknüpften Integrationslaufzeit.
subscriptionId	string	Die Abonnement-ID, zu der die verknüpfte Integrationslaufzeit gehört.

ManagedIntegrationRuntimeError

Objekt

Fehlerdefinition für verwaltete Integrationslaufzeit.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung.
parameters	string[]	Fehlerparameter für verwaltete Integrationslaufzeit.
time	string (date-time)	Die Uhrzeit, zu der der Fehler aufgetreten ist

ManagedIntegrationRuntimeNode

Objekt

Eigenschaften des Integrationslaufzeitknotens.

Name	Typ	Beschreibung
errors	ManagedIntegrationRuntimeError[]	Die Fehler, die auf diesem Integrationslaufzeitknoten aufgetreten sind.
nodeId	string	Die ID des verwalteten Integrations-Laufzeitknotens.
status	ManagedIntegrationRuntimeNodeStatus	Der Status des Verwalteten Integrations-Laufzeitknotens.

ManagedIntegrationRuntimeNodeStatus

Enumeration

Der Status des Verwalteten Integrations-Laufzeitknotens.

Wert	Beschreibung
Starting
Available
Recycling
Unavailable

ManagedIntegrationRuntimeOperationResult

Objekt

Eigenschaften des Ergebnisses des Verwalteten Integrations-Laufzeitvorgangs.

Name	Typ	Beschreibung
activityId	string	Die Aktivitäts-ID für die Vorgangsanforderung.
errorCode	string	Der Fehlercode.
parameters	string[]	Fehlerparameter für verwaltete Integrationslaufzeit.
result	string	Das Vorgangsergebnis.
startTime	string (date-time)	Die Startzeit des Vorgangs.
type	string	Der Vorgangstyp. Kann gestartet oder beendet werden.

ManagedIntegrationRuntimeStatus

Objekt

Status der verwalteten Integrationslaufzeit.

Name	Typ	Beschreibung
dataFactoryName	string	Der Name der Datenfactory, zu dem die Integrationslaufzeit gehört.
state	IntegrationRuntimeState	Der Status der Integrationslaufzeit.
type	string: Managed	Typ der Integrationslaufzeit.
typeProperties.createTime	string (date-time)	Die Zeit, zu der die Integrationslaufzeit erstellt wurde, im ISO8601 Format.
typeProperties.lastOperation	ManagedIntegrationRuntimeOperationResult	Das letzte Vorgangsergebnis, das in dieser Integrationslaufzeit aufgetreten ist.
typeProperties.nodes	ManagedIntegrationRuntimeNode[]	Die Liste der Knoten für die Laufzeit der verwalteten Integration.
typeProperties.otherErrors	ManagedIntegrationRuntimeError[]	Die Fehler, die in dieser Integrationslaufzeit aufgetreten sind.

SelfHostedIntegrationRuntimeNode

Objekt

Eigenschaften des Selbst gehosteten Integrations-Laufzeitknotens.

Name	Typ	Beschreibung
capabilities	object	Das Wörterbuch der Integrationslaufzeitfunktionen
concurrentJobsLimit	integer	Maximale Anzahl gleichzeitiger Aufträge für den Integrationslaufzeitknoten.
expiryTime	string (date-time)	Der Zeitpunkt, zu dem die Integrationslaufzeit im ISO8601 Format abläuft.
hostServiceUri	string	URI für den Hostcomputer der Integrationslaufzeit.
isActiveDispatcher	boolean	Gibt an, ob dieser Knoten der aktive Verteiler für Integrationslaufzeitanforderungen ist.
lastConnectTime	string (date-time)	Die neueste Zeit, zu der die Integrationslaufzeit im ISO8601 Format verbunden wurde.
lastEndUpdateTime	string (date-time)	Das letzte Mal für das Update des Integrations-Runtime-Knotens.
lastStartTime	string (date-time)	Der Zeitpunkt, zu dem der Knoten zuletzt gestartet wurde.
lastStartUpdateTime	string (date-time)	Die letzte Zeit für den Start des Integrations-Runtime-Knoten-Updates.
lastStopTime	string (date-time)	Der Letzte Stoppzeit des Integrationslaufzeitknotens.
lastUpdateResult	IntegrationRuntimeUpdateResult	Das Ergebnis des letzten Integrations-Runtime-Knotenupdates.
machineName	string	Computername des Integrationslaufzeitknotens.
maxConcurrentJobs	integer	Die maximalen gleichzeitigen Aufträge in dieser Integrationslaufzeit.
nodeName	string	Name des Integrationslaufzeitknotens.
registerTime	string (date-time)	Die Uhrzeit, zu der der Integrationslaufzeitknoten im ISO8601 Format registriert wurde.
status	SelfHostedIntegrationRuntimeNodeStatus	Status des Integrationslaufzeitknotens.
version	string	Version des Integrationslaufzeitknotens.
versionStatus	string	Status der Integrations-Laufzeitknotenversion.

SelfHostedIntegrationRuntimeNodeStatus

Enumeration

Status des Integrationslaufzeitknotens.

Wert	Beschreibung
NeedRegistration
Online
Limited
Offline
Upgrading
Initializing
InitializeFailed

SelfHostedIntegrationRuntimeStatus

Objekt

Selbst gehosteter Integrationslaufzeitstatus.

Name	Typ	Beschreibung
dataFactoryName	string	Der Name der Datenfactory, zu dem die Integrationslaufzeit gehört.
state	IntegrationRuntimeState	Der Status der Integrationslaufzeit.
type	string: SelfHosted	Typ der Integrationslaufzeit.
typeProperties.autoUpdate	IntegrationRuntimeAutoUpdate	Gibt an, ob das automatische Update der selbst gehosteten Integrationslaufzeit aktiviert wurde.
typeProperties.autoUpdateETA	string (date-time)	Die geschätzte Zeit, zu der die selbst gehostete Integrationslaufzeit aktualisiert wird.
typeProperties.capabilities	object	Objekt mit zusätzlichen Informationen zu Integrationslaufzeitfunktionen.
typeProperties.createTime	string (date-time)	Die Zeit, zu der die Integrationslaufzeit erstellt wurde, im ISO8601 Format.
typeProperties.internalChannelEncryption	IntegrationRuntimeInternalChannelEncryptionMode	Es wird verwendet, um den Verschlüsselungsmodus für den Knotenknotenkommunikationskanal festzulegen (wenn mehr als 2 selbst gehostete Integrations-Runtime-Knoten vorhanden sind).
typeProperties.latestVersion	string	Die neueste Version im Download Center.
typeProperties.links	LinkedIntegrationRuntime[]	Die Liste der verknüpften Integrationslaufzeiten, die für die Freigabe mit dieser Integrationslaufzeit erstellt werden.
typeProperties.localTimeZoneOffset	string	Der Offset der lokalen Zeitzone in Stunden.
typeProperties.nodes	SelfHostedIntegrationRuntimeNode[]	Die Liste der Knoten für diese Integrationslaufzeit.
typeProperties.pushedVersion	string	Die Version, auf die die Integrationslaufzeit aktualisiert werden soll.
typeProperties.scheduledUpdateDate	string (date-time)	Das Datum, an dem die Integrationslaufzeit im ISO8601 Format aktualisiert werden soll.
typeProperties.selfContainedInteractiveAuthoringEnabled	boolean	Eine alternative Option zum Sicherstellen der interaktiven Erstellungsfunktion, wenn Ihre selbst gehostete Integrationslaufzeit keine Verbindung mit Azure Relay herstellen kann.
typeProperties.serviceUrls	string[]	Die URLs für die Dienste, die im Back-End-Dienst der Integrationslaufzeit verwendet werden.
typeProperties.taskQueueId	string	Die Aufgabenwarteschlangen-ID der Integrationslaufzeit.
typeProperties.updateDelayOffset	string	Die Uhrzeit des vom Dienst geplanten Datums zum Aktualisieren der Integrationslaufzeit, z. B. PT03H, beträgt 3 Stunden.
typeProperties.version	string	Version der Integrationslaufzeit.
typeProperties.versionStatus	string	Status der Integrationslaufzeitversion.

Freigeben über

Integration Runtimes - Start

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

IntegrationRuntimes_Start

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CloudError

IntegrationRuntimeAutoUpdate

IntegrationRuntimeInternalChannelEncryptionMode

IntegrationRuntimeState

IntegrationRuntimeStatusResponse

IntegrationRuntimeType

IntegrationRuntimeUpdateResult

LinkedIntegrationRuntime

ManagedIntegrationRuntimeError

ManagedIntegrationRuntimeNode

ManagedIntegrationRuntimeNodeStatus

ManagedIntegrationRuntimeOperationResult

ManagedIntegrationRuntimeStatus

SelfHostedIntegrationRuntimeNode

SelfHostedIntegrationRuntimeNodeStatus

SelfHostedIntegrationRuntimeStatus