Dela via


Integration Runtimes - Get

Hämtar en integrationskörning.

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

URI-parametrar

Name I Obligatorisk Typ Description
factoryName
path True

string

Fabriksnamnet.

Reguljärt uttrycksmönster: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

integrationRuntimeName
path True

string

Integration Runtime-namnet.

Reguljärt uttrycksmönster: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

Resursgruppens namn.

Reguljärt uttrycksmönster: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Prenumerationsidentifieraren.

api-version
query True

string

API-versionen.

Begärandehuvud

Name Obligatorisk Typ Description
If-None-Match

string

ETag för integration runtime-entiteten. Bör endast anges för get. Om ETag matchar den befintliga entitetstaggen, eller om * angavs, returneras inget innehåll.

Svar

Name Typ Description
200 OK

IntegrationRuntimeResource

OK.

Other Status Codes

Har inte ändrats.

Other Status Codes

CloudError

Ett felsvar som togs emot från GET Integration Runtime-åtgärden.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

IntegrationRuntimes_Get

Exempelbegäran

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

Exempelsvar

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"
}

Definitioner

Name Description
CloudError

Objektet som definierar strukturen för ett Azure Data Factory felsvar.

CopyComputeScaleProperties

CopyComputeScale-egenskaper för hanterad integrationskörning.

CredentialReference

Referenstyp för autentiseringsuppgifter.

CredentialReferenceType

Referenstyp för autentiseringsuppgifter.

CustomProperties

Anpassade egenskaper används för att justera prestanda för dataflödeskörning.

DataFlowComputeType

Beräkningstyp för klustret som ska köra dataflödesjobbet.

EntityReference

Entitetsreferensen.

IntegrationRuntimeComputeProperties

Egenskaper för beräkningsresurser för hanterad integrationskörning.

IntegrationRuntimeCustomerVirtualNetwork

Definitionen och egenskaperna för det virtuella nätverk som Azure-SSIS Integration Runtime ska ansluta till.

IntegrationRuntimeCustomSetupScriptProperties

Egenskaper för anpassade konfigurationsskript för en hanterad dedikerad integrationskörning.

IntegrationRuntimeDataFlowProperties

Dataflödesegenskaper för hanterad integrationskörning.

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integrationskörning.

IntegrationRuntimeEdition

Utgåvan för SSIS-Integration Runtime

IntegrationRuntimeEntityReferenceType

Typen av den refererade entiteten.

IntegrationRuntimeLicenseType

Licenstyp för ditt eget licensscenario.

IntegrationRuntimeResource

Resurstyp för Integration Runtime.

IntegrationRuntimeSsisCatalogInfo

Kataloginformation för hanterad dedikerad integreringskörning.

IntegrationRuntimeSsisCatalogPricingTier

Prisnivån för katalogdatabasen. Det gick att hitta giltiga värden i https://azure.microsoft.com/en-us/pricing/details/sql-database/

IntegrationRuntimeSsisProperties

SSIS-egenskaper för hanterad integrationskörning.

IntegrationRuntimeState

Tillståndet för Integration Runtime.

IntegrationRuntimeType

Typen av integrationskörning.

IntegrationRuntimeVNetProperties

VNet-egenskaper för hanterad integrationskörning.

LinkedIntegrationRuntimeKeyAuthorization

Integration Runtime för nyckelauktoriseringstyp.

LinkedIntegrationRuntimeRbacAuthorization

Rollbaserad åtkomstkontroll (RBAC) auktoriseringstyp integration runtime.

ManagedIntegrationRuntime

Hanterad integrationskörning, inklusive hanterade elastiska och hanterade dedikerade integrationskörningar.

ManagedVirtualNetworkReference

Hanterad Virtual Network referenstyp.

ManagedVirtualNetworkReferenceType

Hanterad Virtual Network referenstyp.

PackageStore

Paketarkiv för SSIS Integration Runtime.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-egenskaper för hanterad integrationskörning.

SecureString

Azure Data Factory säker strängdefinition. Strängvärdet maskeras med asterisker *under API-anropen Hämta eller Lista.

SelfHostedIntegrationRuntime

Lokalt installerad integrationskörning.

CloudError

Objektet som definierar strukturen för ett Azure Data Factory felsvar.

Name Typ Description
error.code

string

Felkod.

error.details

CloudError[]

Matris med ytterligare felinformation.

error.message

string

Felmeddelande.

error.target

string

Egenskapsnamn/sökväg i begäran som är associerad med fel.

CopyComputeScaleProperties

CopyComputeScale-egenskaper för hanterad integrationskörning.

Name Typ Description
dataIntegrationUnit

integer

DIU-nummerinställning reserverad för körning av kopieringsaktivitet. Värden som stöds är multiplar av 4 i intervallet 4–256.

timeToLive

integer

Inställningen Time to Live (i minuter) för Integration Runtime som kör kopieringsaktiviteten.

CredentialReference

Referenstyp för autentiseringsuppgifter.

Name Typ Description
referenceName

string

Referensnamn för autentiseringsuppgifter.

type

CredentialReferenceType

Referenstyp för autentiseringsuppgifter.

CredentialReferenceType

Referenstyp för autentiseringsuppgifter.

Name Typ Description
CredentialReference

string

CustomProperties

Anpassade egenskaper används för att justera prestanda för dataflödeskörning.

Name Typ Description
name

string

Namn på anpassad egenskap.

value

string

Värdet för den anpassade egenskapen.

DataFlowComputeType

Beräkningstyp för klustret som ska köra dataflödesjobbet.

Name Typ Description
ComputeOptimized

string

General

string

MemoryOptimized

string

EntityReference

Entitetsreferensen.

Name Typ Description
referenceName

string

Namnet på den refererade entiteten.

type

IntegrationRuntimeEntityReferenceType

Typen av den refererade entiteten.

IntegrationRuntimeComputeProperties

Egenskaper för beräkningsresurser för hanterad integrationskörning.

Name Typ Description
copyComputeScaleProperties

CopyComputeScaleProperties

CopyComputeScale-egenskaper för hanterad integrationskörning.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

Dataflödesegenskaper för hanterad integrationskörning.

location

string

Platsen för hanterad integrationskörning. Det gick att hitta de regioner som stöds på https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities

maxParallelExecutionsPerNode

integer

Maximalt antal parallella körningar per nod för hanterad integrationskörning.

nodeSize

string

Nodstorlekskravet för hanterad integrationskörning.

numberOfNodes

integer

Det antal noder som krävs för hanterad integrationskörning.

pipelineExternalComputeScaleProperties

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-egenskaper för hanterad integrationskörning.

vNetProperties

IntegrationRuntimeVNetProperties

VNet-egenskaper för hanterad integrationskörning.

IntegrationRuntimeCustomerVirtualNetwork

Definitionen och egenskaperna för det virtuella nätverk som Azure-SSIS Integration Runtime ska ansluta till.

Name Typ Description
subnetId

string

ID:t för undernätet som Azure-SSIS Integration Runtime ska ansluta till.

IntegrationRuntimeCustomSetupScriptProperties

Egenskaper för anpassade konfigurationsskript för en hanterad dedikerad integrationskörning.

Name Typ Description
blobContainerUri

string

URI:n för azure-blobcontainern som innehåller det anpassade konfigurationsskriptet.

sasToken

SecureString

SAS-token för Azure Blob-containern.

IntegrationRuntimeDataFlowProperties

Dataflödesegenskaper för hanterad integrationskörning.

Name Typ Description
cleanup

boolean

Klustret återanvänds inte och används i nästa dataflödesaktivitet tills TTL (time to live) nås om detta anges som falskt. Standardvärdet är true.

computeType

DataFlowComputeType

Beräkningstyp för klustret som ska köra dataflödesjobbet.

coreCount

integer

Kärnantal för klustret som ska köra dataflödesjobbet. Värden som stöds är: 8, 16, 32, 48, 80, 144 och 272.

customProperties

CustomProperties[]

Anpassade egenskaper används för att justera prestanda för dataflödeskörning.

timeToLive

integer

Inställningen Time to Live (i minuter) för klustret som kör dataflödesjobbet.

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integrationskörning.

Name Typ Description
connectVia

EntityReference

Referens för integrationskörning med egen värd.

path

string

Sökvägen som ska innehålla mellanlagrade data i Blob Storage.

stagingLinkedService

EntityReference

Referens för den länkade mellanlagringstjänsten.

IntegrationRuntimeEdition

Utgåvan för SSIS-Integration Runtime

Name Typ Description
Enterprise

string

Standard

string

IntegrationRuntimeEntityReferenceType

Typen av den refererade entiteten.

Name Typ Description
IntegrationRuntimeReference

string

LinkedServiceReference

string

IntegrationRuntimeLicenseType

Licenstyp för ditt eget licensscenario.

Name Typ Description
BasePrice

string

LicenseIncluded

string

IntegrationRuntimeResource

Resurstyp för Integration Runtime.

Name Typ Description
etag

string

Etag identifierar ändringar i resursen.

id

string

Resursidentifieraren.

name

string

Resursnamnet.

properties IntegrationRuntime:

Egenskaper för Integration Runtime.

type

string

Resurstypen.

IntegrationRuntimeSsisCatalogInfo

Kataloginformation för hanterad dedikerad integreringskörning.

Name Typ Description
catalogAdminPassword

SecureString

Lösenordet för administratörsanvändarkontot för katalogdatabasen.

catalogAdminUserName

string

Administratörsanvändarnamnet för katalogdatabasen.

catalogPricingTier

IntegrationRuntimeSsisCatalogPricingTier

Prisnivån för katalogdatabasen. Det gick att hitta giltiga värden i https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

Url:en för katalogdatabasservern.

dualStandbyPairName

string

Namnet på det dubbla standby-paret för Azure-SSIS Integration Runtimes för att stödja SSISDB-redundans.

IntegrationRuntimeSsisCatalogPricingTier

Prisnivån för katalogdatabasen. Det gick att hitta giltiga värden i https://azure.microsoft.com/en-us/pricing/details/sql-database/

Name Typ Description
Basic

string

Premium

string

PremiumRS

string

Standard

string

IntegrationRuntimeSsisProperties

SSIS-egenskaper för hanterad integrationskörning.

Name Typ Description
catalogInfo

IntegrationRuntimeSsisCatalogInfo

Kataloginformation för hanterad dedikerad integreringskörning.

credential

CredentialReference

Referensen för autentiseringsuppgifter som innehåller autentiseringsinformation.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

Egenskaper för anpassade konfigurationsskript för en hanterad dedikerad integrationskörning.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integrationskörning.

edition

IntegrationRuntimeEdition

Utgåvan för SSIS-Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Anpassad installation utan skriptegenskaper för en SSIS-integreringskörning.

licenseType

IntegrationRuntimeLicenseType

Licenstyp för ditt eget licensscenario.

packageStores

PackageStore[]

Paketlager för SSIS-Integration Runtime.

IntegrationRuntimeState

Tillståndet för Integration Runtime.

Name Typ Description
AccessDenied

string

Initial

string

Limited

string

NeedRegistration

string

Offline

string

Online

string

Started

string

Starting

string

Stopped

string

Stopping

string

IntegrationRuntimeType

Typen av integrationskörning.

Name Typ Description
Managed

string

SelfHosted

string

IntegrationRuntimeVNetProperties

VNet-egenskaper för hanterad integrationskörning.

Name Typ Description
publicIPs

string[]

Resurs-ID:t för de offentliga IP-adresser som den här integreringskörningen ska använda.

subnet

string

Namnet på det undernät som integreringskörningen ansluter till.

subnetId

string

ID:t för undernätet som azure-SSIS-integreringskörningen ska anslutas till.

vNetId

string

ID:t för det virtuella nätverk som integreringskörningen ska ansluta till.

LinkedIntegrationRuntimeKeyAuthorization

Integration Runtime för nyckelauktoriseringstyp.

Name Typ Description
authorizationType string:

Key

Auktoriseringstyp för integreringskörningsdelning.

key

SecureString

Nyckeln som används för auktorisering.

LinkedIntegrationRuntimeRbacAuthorization

Rollbaserad åtkomstkontroll (RBAC) auktoriseringstyp integration runtime.

Name Typ Description
authorizationType string:

RBAC

Auktoriseringstyp för integreringskörningsdelning.

credential

CredentialReference

Referensen för autentiseringsuppgifter som innehåller autentiseringsinformation.

resourceId

string

Resursidentifieraren för integreringskörningen som ska delas.

ManagedIntegrationRuntime

Hanterad integrationskörning, inklusive hanterade elastiska och hanterade dedikerade integrationskörningar.

Name Typ Description
description

string

Beskrivning av Integration Runtime.

managedVirtualNetwork

ManagedVirtualNetworkReference

Referens för hanterade Virtual Network.

state

IntegrationRuntimeState

Integration Runtime-tillstånd, endast giltigt för hanterad dedikerad integrationskörning.

type string:

Managed

Typ av integrationskörning.

typeProperties.computeProperties

IntegrationRuntimeComputeProperties

Beräkningsresursen för hanterad integrationskörning.

typeProperties.customerVirtualNetwork

IntegrationRuntimeCustomerVirtualNetwork

Namnet på det virtuella nätverk som Azure-SSIS Integration Runtime ska ansluta till

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

SSIS-egenskaper för hanterad integrationskörning.

ManagedVirtualNetworkReference

Hanterad Virtual Network referenstyp.

Name Typ Description
referenceName

string

Referensnamn för ManagedVirtualNetwork.

type

ManagedVirtualNetworkReferenceType

Hanterad Virtual Network referenstyp.

ManagedVirtualNetworkReferenceType

Hanterad Virtual Network referenstyp.

Name Typ Description
ManagedVirtualNetworkReference

string

PackageStore

Paketarkiv för SSIS Integration Runtime.

Name Typ Description
name

string

Namnet på paketarkivet

packageStoreLinkedService

EntityReference

Referens för den länkade tjänsten för paketarkivet.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-egenskaper för hanterad integrationskörning.

Name Typ Description
numberOfExternalNodes

integer

Antal externa noder, som ska vara större än 0 och mindre än 11.

numberOfPipelineNodes

integer

Antalet pipelinenoder, som ska vara större än 0 och mindre än 11.

timeToLive

integer

Inställningen Time to Live (i minuter) för Integration Runtime som kör pipeline och extern aktivitet.

SecureString

Azure Data Factory säker strängdefinition. Strängvärdet maskeras med asterisker *under API-anropen Hämta eller Lista.

Name Typ Description
type string:

SecureString

Typ av hemlighet.

value

string

Värdet för säker sträng.

SelfHostedIntegrationRuntime

Lokalt installerad integrationskörning.

Name Typ Description
description

string

Beskrivning av Integration Runtime.

type string:

SelfHosted

Typ av integrationskörning.

typeProperties.linkedInfo LinkedIntegrationRuntimeType:

Basdefinitionen för en länkad integrationskörning.

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

Ett alternativt alternativ för att säkerställa en interaktiv redigeringsfunktion när din lokala integrationskörning inte kan upprätta en anslutning till Azure Relay.