Freigeben über


Integration Runtimes - Update

Updates einer Integration Runtime.

PATCH 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 Werksname.

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.

Anforderungstext

Name Typ Beschreibung
autoUpdate

IntegrationRuntimeAutoUpdate

Aktiviert oder deaktiviert das Feature für automatische Updates der selbstgehosteten Integration Runtime. Siehe https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

Der Zeitoffset (in Stunden) am Tag, z. B. PT03H, beträgt 3 Stunden. Die automatische Aktualisierung der Integration Runtime erfolgt zu diesem Zeitpunkt.

Antworten

Name Typ Beschreibung
200 OK

IntegrationRuntimeResource

OK.

Other Status Codes

CloudError

Eine Vom Azure Data Factory-Dienst empfangene Fehlerantwort.

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_Update

Beispielanforderung

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

{
  "autoUpdate": "Off",
  "updateDelayOffset": "\"PT3H\""
}

Beispiel für eine Antwort

Date: Wed, 13 Jun 2018 21:33:04 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1192
x-ms-request-id: eb1c35f8-4b37-4d08-b5dd-d6a0ad8b182d
x-ms-correlation-request-id: eb1c35f8-4b37-4d08-b5dd-d6a0ad8b182d
{
  "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": "0400f1a1-0000-0000-0000-5b2188640000"
}

Definitionen

Name Beschreibung
CloudError

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

CopyComputeScaleProperties

CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime.

CredentialReference

Referenztyp für Anmeldeinformationen.

CredentialReferenceType

Verweistyp 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.

IntegrationRuntimeAutoUpdate

Der Status der automatischen Integration Runtime-Aktualisierung.

IntegrationRuntimeComputeProperties

Die Computeressourceneigenschaften für die verwaltete Integration Runtime.

IntegrationRuntimeCustomerVirtualNetwork

Die Definition und die Eigenschaften des virtuellen Netzwerks, zu dem die 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 Ausgabe für die SSIS-Integration Runtime

IntegrationRuntimeEntityReferenceType

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

IntegrationRuntimeLicenseType

Lizenztyp zum Mitbringen Ihres eigenen Lizenzszenarios.

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 in 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 der Aufrufe der Get- oder List-API mit Sternchen "*" maskiert.

SelfHostedIntegrationRuntime

Selbstgehostete Integration Runtime.

UpdateIntegrationRuntimeRequest

Aktualisieren Sie die Integration Runtime-Anforderung.

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 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 Vielfaches von 4 im Bereich 4-256.

timeToLive

integer

Laufzeit (in Minuten) Einstellung der Integration Runtime, die die Kopieraktivität ausführt.

CredentialReference

Referenztyp für Anmeldeinformationen.

Name Typ Beschreibung
referenceName

string

Verweisen Sie auf den Namen der Anmeldeinformationen.

type

CredentialReferenceType

Referenztyp für Anmeldeinformationen.

CredentialReferenceType

Verweistyp 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.

IntegrationRuntimeAutoUpdate

Der Status der automatischen Integration Runtime-Aktualisierung.

Name Typ Beschreibung
Off

string

On

string

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ößesanforderung für die verwaltete Integration Runtime.

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, zu dem die Azure-SSIS Integration Runtime verknüpft wird.

Name Typ Beschreibung
subnetId

string

Die ID des Subnetzes, zu dem die Azure-SSIS Integration Runtime verknüpft 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 Datenflussaktivitätsausführung verwendet, bis die TTL (Time to Live) 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 der Laufzeit (in Minuten) des Clusters, der den Datenflussauftrag ausführt.

IntegrationRuntimeDataProxyProperties

Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime.

Name Typ Beschreibung
connectVia

EntityReference

Die selbstgehostete Integration Runtime-Referenz.

path

string

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

stagingLinkedService

EntityReference

Die Stagingverknüpfung des verknüpften Diensts.

IntegrationRuntimeEdition

Die Ausgabe 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 zum Mitbringen Ihres eigenen Lizenzszenarios.

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 unter https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

Die Katalogdatenbankserver-URL.

dualStandbyPairName

string

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

IntegrationRuntimeSsisCatalogPricingTier

Der Tarif für die Katalogdatenbank. Die gültigen Werte finden Sie in 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, die Authentifizierungsinformationen enthält.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime.

edition

IntegrationRuntimeEdition

Die Ausgabe für die SSIS-Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Benutzerdefinierte Einrichtung ohne Skripteigenschaften für eine SSIS Integration Runtime.

licenseType

IntegrationRuntimeLicenseType

Lizenztyp zum Mitbringen Ihres eigenen Lizenzszenarios.

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, das von dieser Integration Runtime verknüpft wird.

subnetId

string

Die ID des Subnetzes, in das diese Azure-SSIS Integration Runtime eingebunden wird.

vNetId

string

Die ID des VNET, in das diese Integration Runtime eingebunden wird.

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 mit Authentifizierungsinformationen.

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

Referenz zu verwalteten Virtual Network.

state

IntegrationRuntimeState

Integration Runtime-Zustand, 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 beitreten soll

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 Namen von ManagedVirtualNetwork.

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

Die Referenz zum verknüpften Paketspeicherdienst.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-Eigenschaften für die verwaltete Integration Runtime.

Name Typ Beschreibung
numberOfExternalNodes

integer

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

numberOfPipelineNodes

integer

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

timeToLive

integer

Laufzeiteinstellung (in Minuten) der Integration Runtime, die Pipeline und externe Aktivitäten ausführt.

SecureString

Azure Data Factory Sichere Zeichenfolgendefinition. Der Zeichenfolgenwert wird während der Aufrufe der Get- oder List-API 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 einer interaktiven Erstellungsfunktion, wenn Ihre selbstgehostete Integration Runtime keine Verbindung mit Azure Relay herstellen kann.

UpdateIntegrationRuntimeRequest

Aktualisieren Sie die Integration Runtime-Anforderung.

Name Typ Beschreibung
autoUpdate

IntegrationRuntimeAutoUpdate

Aktiviert oder deaktiviert das Feature für die automatische Aktualisierung der selbstgehosteten Integration Runtime. Siehe https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

Der Zeitoffset (in Stunden) am Tag, z. B. PT03H, beträgt 3 Stunden. Die automatische Aktualisierung der Integration Runtime erfolgt zu diesem Zeitpunkt.