Integration Runtimes - Get
Ruft eine Integration Runtime ab.
GET 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 Werksname. 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-None-Match |
string |
ETag der Integration Runtime-Entität. Sollte nur für get angegeben werden. Wenn das ETag mit dem vorhandenen Entitätstag übereinstimmt oder wenn * angegeben wurde, wird kein Inhalt zurückgegeben. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK. |
|
Other Status Codes |
Nicht geändert. |
|
Other Status Codes |
Eine Fehlerantwort, die vom GET 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_Get
Beispielanforderung
Beispiel für eine Antwort
Date: Mon, 22 Apr 2019 18:33:47 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 11997
x-ms-request-id: ad824326-e577-4a47-a092-2e621c4d59d9
x-ms-correlation-request-id: ad824326-e577-4a47-a092-2e621c4d59d9
{
"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": "15003c4f-0000-0200-0000-5cbe090b0000"
}
Definitionen
Name | Beschreibung |
---|---|
Cloud |
Das -Objekt, das die Struktur einer Azure Data Factory Fehlerantwort definiert. |
Copy |
CopyComputeScale-Eigenschaften für die verwaltete Integration Runtime. |
Credential |
Referenztyp für Anmeldeinformationen. |
Credential |
Verweistyp 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, zu dem die 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 Ausgabe für die SSIS-Integration Runtime |
Integration |
Der Typ dieser Entität, auf die verwiesen wird. |
Integration |
Lizenztyp zum Mitbringen Ihres eigenen Lizenzszenarios. |
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 in 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 RBAC-Autorisierungstyp-Integration Runtime (Role Based Access Control). |
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 der Aufrufe der Get- oder List-API mit Sternchen "*" maskiert. |
Self |
Selbstgehostete Integration Runtime. |
CloudError
Das -Objekt, das die Struktur einer 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 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 |
Referenzname der Anmeldeinformationen. |
type |
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 |
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ößesanforderung für die verwaltete Integration Runtime. |
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, 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 |
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 |
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 der Laufzeit (in Minuten) des Clusters, der den Datenflussauftrag ausführt. |
IntegrationRuntimeDataProxyProperties
Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime.
Name | Typ | Beschreibung |
---|---|---|
connectVia |
Die selbstgehostete Integration Runtime-Referenz. |
|
path |
string |
Der Pfad, der die mehrstufigen Daten im Blobspeicher enthalten soll. |
stagingLinkedService |
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 |
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 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 |
Kataloginformationen für verwaltete dedizierte Integration Runtime. |
|
credential |
Der Verweis auf Anmeldeinformationen, die Authentifizierungsinformationen enthält. |
|
customSetupScriptProperties |
Benutzerdefinierte Setupskripteigenschaften für eine verwaltete dedizierte Integration Runtime. |
|
dataProxyProperties |
Datenproxyeigenschaften für eine verwaltete dedizierte Integration Runtime. |
|
edition |
Die Ausgabe für die SSIS-Integration Runtime |
|
expressCustomSetupProperties |
Custom |
Benutzerdefinierte Einrichtung ohne Skripteigenschaften für eine SSIS Integration Runtime. |
licenseType |
Lizenztyp zum Mitbringen Ihres eigenen Lizenzszenarios. |
|
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, 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 |
Der für die Autorisierung verwendete Schlüssel. |
LinkedIntegrationRuntimeRbacAuthorization
Die RBAC-Autorisierungstyp-Integration Runtime (Role Based Access Control).
Name | Typ | Beschreibung |
---|---|---|
authorizationType |
string:
RBAC |
Der Autorisierungstyp für die Integration Runtime-Freigabe. |
credential |
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 |
Referenz zu verwalteten Virtual Network. |
|
state |
Integration Runtime-Zustand, 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 beitreten soll |
|
typeProperties.ssisProperties |
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 |
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 |
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: |
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 einer interaktiven Erstellungsfunktion, wenn Ihre selbstgehostete Integration Runtime keine Verbindung mit Azure Relay herstellen kann. |