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 |
---|---|---|---|---|
factory
|
path | True |
string |
Der Factoryname. RegEx-Muster: |
integration
|
path | True |
string |
Der Name der Integration Runtime. RegEx-Muster: |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. RegEx-Muster: |
subscription
|
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 |
OK. |
|
Other Status Codes |
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 |
---|---|
Cloud |
Das -Objekt, das die Struktur eines Azure Data Factory Fehlerantwort definiert. |
Copy |
CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime. |
Credential |
Verweistyp für Anmeldeinformationen. |
Credential |
Referenztyp für Anmeldeinformationen. |
Custom |
Benutzerdefinierte Eigenschaften werden verwendet, um die Leistung der Datenflusslaufzeit zu optimieren. |
Data |
Computetyp des Clusters, der den Datenflussauftrag ausführt. |
Entity |
Der Entitätsverweis. |
Integration |
Die Computeressourceneigenschaften für die verwaltete Integration Runtime. |
Integration |
Die Definition und die Eigenschaften des virtuellen Netzwerks, mit dem azure-SSIS Integration Runtime verknüpft wird. |
Integration |
Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime. |
Integration |
Datenflusseigenschaften für die verwaltete Integration Runtime. |
Integration |
Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime. |
Integration |
Die Edition für die SSIS-Integration Runtime |
Integration |
Der Typ dieser Entität, auf die verwiesen wird. |
Integration |
Lizenztyp für das Szenario "Bring Your Own License". |
Integration |
Ressourcentyp der Integration Runtime. |
Integration |
Kataloginformationen für verwaltete dedizierte Integration Runtime. |
Integration |
Der Tarif für die Katalogdatenbank. Die gültigen Werte finden Sie unter https://azure.microsoft.com/en-us/pricing/details/sql-database/ |
Integration |
SSIS-Eigenschaften für die verwaltete Integration Runtime. |
Integration |
Der Status der Integration Runtime. |
Integration |
Der Typ der Integration Runtime. |
Integration |
VNET-Eigenschaften für die verwaltete Integration Runtime. |
Linked |
Die Integration Runtime des Schlüsselautorisierungstyps. |
Linked |
Die Integration Runtime des Autorisierungstyps der rollenbasierten Zugriffssteuerung (Role Based Access Control, RBAC). |
Managed |
Verwaltete Integration Runtime, einschließlich verwalteter elastischer und verwalteter dedizierter Integration Runtimes. |
Managed |
Verwalteter Virtual Network Verweistyp. |
Managed |
Verwalteter Virtual Network Verweistyp. |
Package |
Paketspeicher für die SSIS Integration Runtime. |
Pipeline |
PipelineExternalComputeScale-Eigenschaften für die verwaltete Integration Runtime. |
Secure |
Azure Data Factory Sichere Zeichenfolgendefinition. Der Zeichenfolgenwert wird während Get- oder Listen-API-Aufrufen mit Sternchen "*" maskiert. |
Self |
Selbstgehostete Integration Runtime. |
CloudError
Das -Objekt, das die Struktur eines Azure Data Factory Fehlerantwort definiert.
Name | Typ | Beschreibung |
---|---|---|
error.code |
string |
Fehlercode |
error.details |
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 |
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 |
Der Typ dieser Entität, auf die verwiesen wird. |
IntegrationRuntimeComputeProperties
Die Computeressourceneigenschaften für die verwaltete Integration Runtime.
Name | Typ | Beschreibung |
---|---|---|
copyComputeScaleProperties |
CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime. |
|
dataFlowProperties |
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 |
PipelineExternalComputeScale-Eigenschaften für die verwaltete Integration Runtime. |
|
vNetProperties |
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 |
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 |
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 |
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 |
Die Referenz zur selbstgehosteten Integration Runtime. |
|
path |
string |
Der Pfad, der die mehrstufigen Daten im Blobspeicher enthalten soll. |
stagingLinkedService |
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 |
Das Kennwort des Administratorbenutzerkontos der Katalogdatenbank. |
|
catalogAdminUserName |
string |
Der Administratorbenutzername der Katalogdatenbank. |
catalogPricingTier |
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 |
Kataloginformationen für verwaltete dedizierte Integration Runtime. |
|
credential |
Der Verweis auf Anmeldeinformationen mit Authentifizierungsinformationen. |
|
customSetupScriptProperties |
Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime. |
|
dataProxyProperties |
Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime. |
|
edition |
Die Edition für die SSIS-Integration Runtime |
|
expressCustomSetupProperties |
Custom |
Benutzerdefiniertes Setup ohne Skripteigenschaften für eine SSIS Integration Runtime. |
licenseType |
Lizenztyp für das Szenario "Bring Your Own License". |
|
packageStores |
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 |
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 |
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 |
Verwaltete Virtual Network Referenz. |
|
state |
Status der Integration Runtime, nur gültig für verwaltete dedizierte Integration Runtime. |
|
type |
string:
Managed |
Typ der Integration Runtime. |
typeProperties.computeProperties |
Die Computeressource für die verwaltete Integration Runtime. |
|
typeProperties.customerVirtualNetwork |
Der Name des virtuellen Netzwerks, dem die Azure-SSIS Integration Runtime hinzugefügt wird. |
|
typeProperties.ssisProperties |
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 |
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 |
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: |
Typ des Geheimnisses. |
value |
string |
Wert der sicheren Zeichenfolge. |
SelfHostedIntegrationRuntime
Selbstgehostete Integration Runtime.
Name | Typ | Beschreibung |
---|---|---|
description |
string |
Beschreibung der Integration Runtime. |
type |
string:
Self |
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. |