Freigeben über


Integration Runtimes - Create Or Update

Erstellt oder aktualisiert eine Integration Runtime.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
factoryName
path True

string

Der Factoryname.

RegEx-Muster: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

integrationRuntimeName
path True

string

Der Name der Integration Runtime.

RegEx-Muster: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

RegEx-Muster: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Die Abonnement-ID.

api-version
query True

string

Die API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung
If-Match

string

ETag der Integration Runtime-Entität. Sollte nur für das Update angegeben werden, für das es mit einer vorhandenen Entität übereinstimmen sollte, oder kann * für bedingungslose Aktualisierung sein.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties True IntegrationRuntime:

Integration Runtime-Eigenschaften.

Antworten

Name Typ Beschreibung
200 OK

IntegrationRuntimeResource

OK.

Other Status Codes

CloudError

Eine Fehlerantwort, die vom PUT Integration Runtime-Vorgang empfangen wurde.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

IntegrationRuntimes_Create

Beispielanforderung

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

{
  "properties": {
    "type": "SelfHosted",
    "description": "A selfhosted integration runtime"
  }
}

Beispiel für eine Antwort

Date: Wed, 13 Jun 2018 22:20:47 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1197
x-ms-request-id: 125c07fa-e39a-4541-885f-5019631a5ecd
x-ms-correlation-request-id: 125c07fa-e39a-4541-885f-5019631a5ecd
{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationruntimes/exampleIntegrationRuntime",
  "name": "exampleIntegrationRuntime",
  "type": "Microsoft.DataFactory/factories/integrationruntimes",
  "properties": {
    "type": "SelfHosted",
    "description": "A selfhosted integration runtime"
  },
  "etag": "000046c4-0000-0000-0000-5b2198bf0000"
}

Definitionen

Name Beschreibung
CloudError

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

CopyComputeScaleProperties

CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime.

CredentialReference

Verweistyp für Anmeldeinformationen.

CredentialReferenceType

Referenztyp für Anmeldeinformationen.

CustomProperties

Benutzerdefinierte Eigenschaften werden verwendet, um die Leistung der Datenflusslaufzeit zu optimieren.

DataFlowComputeType

Computetyp des Clusters, der den Datenflussauftrag ausführt.

EntityReference

Der Entitätsverweis.

IntegrationRuntimeComputeProperties

Die Computeressourceneigenschaften für die verwaltete Integration Runtime.

IntegrationRuntimeCustomerVirtualNetwork

Die Definition und die Eigenschaften des virtuellen Netzwerks, mit dem azure-SSIS Integration Runtime verknüpft wird.

IntegrationRuntimeCustomSetupScriptProperties

Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime.

IntegrationRuntimeDataFlowProperties

Datenflusseigenschaften für die verwaltete Integration Runtime.

IntegrationRuntimeDataProxyProperties

Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime.

IntegrationRuntimeEdition

Die Edition für die SSIS-Integration Runtime

IntegrationRuntimeEntityReferenceType

Der Typ dieser Entität, auf die verwiesen wird.

IntegrationRuntimeLicenseType

Lizenztyp für das Szenario "Bring Your Own License".

IntegrationRuntimeResource

Ressourcentyp der Integration Runtime.

IntegrationRuntimeSsisCatalogInfo

Kataloginformationen für verwaltete dedizierte Integration Runtime.

IntegrationRuntimeSsisCatalogPricingTier

Der Tarif für die Katalogdatenbank. Die gültigen Werte finden Sie unter https://azure.microsoft.com/en-us/pricing/details/sql-database/

IntegrationRuntimeSsisProperties

SSIS-Eigenschaften für die verwaltete Integration Runtime.

IntegrationRuntimeState

Der Status der Integration Runtime.

IntegrationRuntimeType

Der Typ der Integration Runtime.

IntegrationRuntimeVNetProperties

VNET-Eigenschaften für die verwaltete Integration Runtime.

LinkedIntegrationRuntimeKeyAuthorization

Die Integration Runtime des Schlüsselautorisierungstyps.

LinkedIntegrationRuntimeRbacAuthorization

Die Integration Runtime des Autorisierungstyps der rollenbasierten Zugriffssteuerung (Role Based Access Control, RBAC).

ManagedIntegrationRuntime

Verwaltete Integration Runtime, einschließlich verwalteter elastischer und verwalteter dedizierter Integration Runtimes.

ManagedVirtualNetworkReference

Verwalteter Virtual Network Verweistyp.

ManagedVirtualNetworkReferenceType

Verwalteter Virtual Network Verweistyp.

PackageStore

Paketspeicher für die SSIS Integration Runtime.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-Eigenschaften für die verwaltete Integration Runtime.

SecureString

Azure Data Factory Sichere Zeichenfolgendefinition. Der Zeichenfolgenwert wird während Get- oder Listen-API-Aufrufen mit Sternchen "*" maskiert.

SelfHostedIntegrationRuntime

Selbstgehostete Integration Runtime.

CloudError

Das -Objekt, das die Struktur eines 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 der Anforderung, die einem Fehler zugeordnet ist.

CopyComputeScaleProperties

CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
dataIntegrationUnit

integer

DIU-Nummerneinstellung für die Ausführung der Kopieraktivität reserviert. Unterstützte Werte sind Vielfache von 4 im Bereich 4 bis 256.

timeToLive

integer

Einstellung für die Gültigkeitsdauer (in Minuten) der Integration Runtime, die die Kopieraktivität ausführt.

CredentialReference

Verweistyp für Anmeldeinformationen.

Name Typ Beschreibung
referenceName

string

Verweisen Sie auf den Namen der Anmeldeinformationen.

type

CredentialReferenceType

Verweistyp für Anmeldeinformationen.

CredentialReferenceType

Referenztyp für Anmeldeinformationen.

Name Typ Beschreibung
CredentialReference

string

CustomProperties

Benutzerdefinierte Eigenschaften werden verwendet, um die Leistung der Datenflusslaufzeit zu optimieren.

Name Typ Beschreibung
name

string

Name der benutzerdefinierten Eigenschaft.

value

string

Wert der benutzerdefinierten Eigenschaft.

DataFlowComputeType

Computetyp des Clusters, der den Datenflussauftrag ausführt.

Name Typ Beschreibung
ComputeOptimized

string

General

string

MemoryOptimized

string

EntityReference

Der Entitätsverweis.

Name Typ Beschreibung
referenceName

string

Der Name dieser Entität, auf die verwiesen wird.

type

IntegrationRuntimeEntityReferenceType

Der Typ dieser Entität, auf die verwiesen wird.

IntegrationRuntimeComputeProperties

Die Computeressourceneigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
copyComputeScaleProperties

CopyComputeScaleProperties

CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

Datenflusseigenschaften für die verwaltete Integration Runtime.

location

string

Der Speicherort für die verwaltete Integration Runtime. Die unterstützten Regionen finden Sie unter https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities

maxParallelExecutionsPerNode

integer

Maximale Anzahl paralleler Ausführungen pro Knoten für die verwaltete Integration Runtime.

nodeSize

string

Die Knotengröße, die für die verwaltete Integration Runtime erforderlich ist.

numberOfNodes

integer

Die erforderliche Anzahl von Knoten für die verwaltete Integration Runtime.

pipelineExternalComputeScaleProperties

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-Eigenschaften für die verwaltete Integration Runtime.

vNetProperties

IntegrationRuntimeVNetProperties

VNET-Eigenschaften für die verwaltete Integration Runtime.

IntegrationRuntimeCustomerVirtualNetwork

Die Definition und die Eigenschaften des virtuellen Netzwerks, mit dem azure-SSIS Integration Runtime verknüpft wird.

Name Typ Beschreibung
subnetId

string

Die ID des Subnetzes, dem azure-SSIS Integration Runtime hinzugefügt wird.

IntegrationRuntimeCustomSetupScriptProperties

Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime.

Name Typ Beschreibung
blobContainerUri

string

Der URI des Azure-Blobcontainers, der das benutzerdefinierte Setupskript enthält.

sasToken

SecureString

Das SAS-Token des Azure-Blobcontainers.

IntegrationRuntimeDataFlowProperties

Datenflusseigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
cleanup

boolean

Der Cluster wird nicht wiederverwendet, und er wird in der nächsten Ausführung der Datenflussaktivität verwendet, bis die Gültigkeitsdauer (Gültigkeitsdauer) erreicht ist, wenn dies auf false festgelegt ist. Der Standardwert ist "true".

computeType

DataFlowComputeType

Computetyp des Clusters, der den Datenflussauftrag ausführt.

coreCount

integer

Kernanzahl des Clusters, der den Datenflussauftrag ausführt. Unterstützte Werte sind: 8, 16, 32, 48, 80, 144 und 272.

customProperties

CustomProperties[]

Benutzerdefinierte Eigenschaften werden verwendet, um die Leistung der Datenflusslaufzeit zu optimieren.

timeToLive

integer

Einstellung für die Gültigkeitsdauer (in Minuten) des Clusters, der den Datenflussauftrag ausführt.

IntegrationRuntimeDataProxyProperties

Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime.

Name Typ Beschreibung
connectVia

EntityReference

Die Referenz zur selbstgehosteten Integration Runtime.

path

string

Der Pfad, der die mehrstufigen Daten im Blobspeicher enthalten soll.

stagingLinkedService

EntityReference

Der Verknüpfte Stagingdienstverweis.

IntegrationRuntimeEdition

Die Edition für die SSIS-Integration Runtime

Name Typ Beschreibung
Enterprise

string

Standard

string

IntegrationRuntimeEntityReferenceType

Der Typ dieser Entität, auf die verwiesen wird.

Name Typ Beschreibung
IntegrationRuntimeReference

string

LinkedServiceReference

string

IntegrationRuntimeLicenseType

Lizenztyp für das Szenario "Bring Your Own License".

Name Typ Beschreibung
BasePrice

string

LicenseIncluded

string

IntegrationRuntimeResource

Ressourcentyp der Integration Runtime.

Name Typ Beschreibung
etag

string

Etag identifiziert Änderungen in der Ressource.

id

string

Der Ressourcenbezeichner.

name

string

Der Name der Ressource.

properties IntegrationRuntime:

Integration Runtime-Eigenschaften.

type

string

Der Ressourcentyp.

IntegrationRuntimeSsisCatalogInfo

Kataloginformationen für verwaltete dedizierte Integration Runtime.

Name Typ Beschreibung
catalogAdminPassword

SecureString

Das Kennwort des Administratorbenutzerkontos der Katalogdatenbank.

catalogAdminUserName

string

Der Administratorbenutzername der Katalogdatenbank.

catalogPricingTier

IntegrationRuntimeSsisCatalogPricingTier

Der Tarif für die Katalogdatenbank. Die gültigen Werte finden Sie in https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

Die URL des Katalogdatenbankservers.

dualStandbyPairName

string

Der Name des Dual Standby-Paars von Azure-SSIS Integration Runtimes zur Unterstützung des SSISDB-Failovers.

IntegrationRuntimeSsisCatalogPricingTier

Der Tarif für die Katalogdatenbank. Die gültigen Werte finden Sie unter https://azure.microsoft.com/en-us/pricing/details/sql-database/

Name Typ Beschreibung
Basic

string

Premium

string

PremiumRS

string

Standard

string

IntegrationRuntimeSsisProperties

SSIS-Eigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
catalogInfo

IntegrationRuntimeSsisCatalogInfo

Kataloginformationen für verwaltete dedizierte Integration Runtime.

credential

CredentialReference

Der Verweis auf Anmeldeinformationen mit Authentifizierungsinformationen.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime.

edition

IntegrationRuntimeEdition

Die Edition für die SSIS-Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Benutzerdefiniertes Setup ohne Skripteigenschaften für eine SSIS Integration Runtime.

licenseType

IntegrationRuntimeLicenseType

Lizenztyp für das Szenario "Bring Your Own License".

packageStores

PackageStore[]

Paketspeicher für die SSIS-Integration Runtime.

IntegrationRuntimeState

Der Status der Integration Runtime.

Name Typ Beschreibung
AccessDenied

string

Initial

string

Limited

string

NeedRegistration

string

Offline

string

Online

string

Started

string

Starting

string

Stopped

string

Stopping

string

IntegrationRuntimeType

Der Typ der Integration Runtime.

Name Typ Beschreibung
Managed

string

SelfHosted

string

IntegrationRuntimeVNetProperties

VNET-Eigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
publicIPs

string[]

Ressourcen-IDs der öffentlichen IP-Adressen, die von dieser Integration Runtime verwendet werden.

subnet

string

Der Name des Subnetzes, dem diese Integration Runtime hinzugefügt wird.

subnetId

string

Die ID des Subnetzes, mit dem diese Azure-SSIS Integration Runtime verknüpft wird.

vNetId

string

Die ID des VNET, dem diese Integration Runtime beitritt.

LinkedIntegrationRuntimeKeyAuthorization

Die Integration Runtime des Schlüsselautorisierungstyps.

Name Typ Beschreibung
authorizationType string:

Key

Der Autorisierungstyp für die Integration Runtime-Freigabe.

key

SecureString

Der schlüssel, der für die Autorisierung verwendet wird.

LinkedIntegrationRuntimeRbacAuthorization

Die Integration Runtime des Autorisierungstyps der rollenbasierten Zugriffssteuerung (Role Based Access Control, RBAC).

Name Typ Beschreibung
authorizationType string:

RBAC

Der Autorisierungstyp für die Integration Runtime-Freigabe.

credential

CredentialReference

Der Verweis auf Anmeldeinformationen, die Authentifizierungsinformationen enthält.

resourceId

string

Der Ressourcenbezeichner der Integration Runtime, die freigegeben werden soll.

ManagedIntegrationRuntime

Verwaltete Integration Runtime, einschließlich verwalteter elastischer und verwalteter dedizierter Integration Runtimes.

Name Typ Beschreibung
description

string

Beschreibung der Integration Runtime.

managedVirtualNetwork

ManagedVirtualNetworkReference

Verwaltete Virtual Network Referenz.

state

IntegrationRuntimeState

Status der Integration Runtime, nur gültig für verwaltete dedizierte Integration Runtime.

type string:

Managed

Typ der Integration Runtime.

typeProperties.computeProperties

IntegrationRuntimeComputeProperties

Die Computeressource für die verwaltete Integration Runtime.

typeProperties.customerVirtualNetwork

IntegrationRuntimeCustomerVirtualNetwork

Der Name des virtuellen Netzwerks, dem die Azure-SSIS Integration Runtime hinzugefügt wird.

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

SSIS-Eigenschaften für die verwaltete Integration Runtime.

ManagedVirtualNetworkReference

Verwalteter Virtual Network Verweistyp.

Name Typ Beschreibung
referenceName

string

Verweisen Sie auf den ManagedVirtualNetwork-Namen.

type

ManagedVirtualNetworkReferenceType

Verwalteter Virtual Network Verweistyp.

ManagedVirtualNetworkReferenceType

Verwalteter Virtual Network Verweistyp.

Name Typ Beschreibung
ManagedVirtualNetworkReference

string

PackageStore

Paketspeicher für die SSIS Integration Runtime.

Name Typ Beschreibung
name

string

Der Name des Paketspeichers

packageStoreLinkedService

EntityReference

Der Verweis auf den verknüpften Paketspeicherdienst.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-Eigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
numberOfExternalNodes

integer

Die Anzahl der externen Knoten, die größer als 0 und kleiner als 11 sein sollte.

numberOfPipelineNodes

integer

Anzahl der Pipelineknoten, die größer als 0 und kleiner als 11 sein sollte.

timeToLive

integer

Einstellung für die Gültigkeitsdauer (in Minuten) der Integration Runtime, die Pipeline und externe Aktivitäten ausführt.

SecureString

Azure Data Factory Sichere Zeichenfolgendefinition. Der Zeichenfolgenwert wird während Get- oder Listen-API-Aufrufen mit Sternchen "*" maskiert.

Name Typ Beschreibung
type string:

SecureString

Typ des Geheimnisses.

value

string

Wert der sicheren Zeichenfolge.

SelfHostedIntegrationRuntime

Selbstgehostete Integration Runtime.

Name Typ Beschreibung
description

string

Beschreibung der Integration Runtime.

type string:

SelfHosted

Typ der Integration Runtime.

typeProperties.linkedInfo LinkedIntegrationRuntimeType:

Die Basisdefinition einer verknüpften Integration Runtime.

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

Eine alternative Option zum Sicherstellen der interaktiven Erstellungsfunktion, wenn Ihre selbstgehostete Integration Runtime keine Verbindung mit Azure Relay herstellen kann.