Freigeben über


Integration Runtimes - Create Linked Integration Runtime

Erstellen Sie einen Eintrag zur verknüpften Integrationslaufzeit in einer freigegebenen Integrationslaufzeit.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}/linkedIntegrationRuntime?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

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string (uuid)

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Typ Beschreibung
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 ID des Abonnements, zu dem die verknüpfte Integrationslaufzeit gehört.

Antworten

Name Typ Beschreibung
200 OK

IntegrationRuntimeStatusResponse

Azure-Operation erfolgreich abgeschlossen.

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

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_CreateLinkedIntegrationRuntime

Beispielanforderung

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

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
CloudError

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

CreateLinkedIntegrationRuntimeRequest

Die Informationen zur verknüpften Integrationslaufzeit.

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

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.

CreateLinkedIntegrationRuntimeRequest

Die Informationen zur verknüpften Integrationslaufzeit.

Name Typ Beschreibung
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 ID des Abonnements, zu dem die verknüpfte Integrationslaufzeit gehört.

IntegrationRuntimeAutoUpdate

Der Status der automatischen Aktualisierung der Integrationslaufzeit.

Wert Beschreibung
On

Ein

Off

Deaktiviert

IntegrationRuntimeInternalChannelEncryptionMode

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

Nicht festgelegt

SslEncrypted

SslEncrypted

NotEncrypted

NotEncrypted

IntegrationRuntimeState

Der Status der Integrationslaufzeit.

Wert Beschreibung
Initial

Initial

Stopped

Angehalten

Started

Gestartet

Starting

Wird gestartet

Stopping

Anhalten

NeedRegistration

BedarfRegistrierung

Online

Online

Limited

Begrenzt

Offline

Offline

AccessDenied

AccessDenied

IntegrationRuntimeStatusResponse

Antwort auf den Integrations-Laufzeitstatus.

Name Typ Beschreibung
name

string

Der Name der Integrationslaufzeit.

properties IntegrationRuntimeStatus:

Integrationslaufzeiteigenschaften.

IntegrationRuntimeType

Der Typ der Integrationslaufzeit.

Wert Beschreibung
Managed

Verwaltet

SelfHosted

SelfHosted

IntegrationRuntimeUpdateResult

Das Ergebnis des letzten Integrations-Runtime-Knotenupdates.

Wert Beschreibung
None

Nichts

Succeed

Erfolg

Fail

Fehler

LinkedIntegrationRuntime

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

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

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

Der Status des Verwalteten Integrations-Laufzeitknotens.

Wert Beschreibung
Starting

Wird gestartet

Available

Verfügbar

Recycling

Recycling

Unavailable

Nicht verfügbar

ManagedIntegrationRuntimeOperationResult

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

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

Eigenschaften des Selbst gehosteten Integrations-Laufzeitknotens.

Name Typ Beschreibung
capabilities

object

Das Wörterbuch der Integrationslaufzeitfunktionen

concurrentJobsLimit

integer (int32)

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 (int32)

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

Status des Integrationslaufzeitknotens.

Wert Beschreibung
NeedRegistration

BedarfRegistrierung

Online

Online

Limited

Begrenzt

Offline

Offline

Upgrading

Aktualisierung

Initializing

Initialisierung

InitializeFailed

InitialisierenFehlgeschlagen

SelfHostedIntegrationRuntimeStatus

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.