Dela via


Integration Runtimes - Update

Uppdateringar en integrationskörning.

PATCH 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ärandetext

Name Typ Description
autoUpdate

IntegrationRuntimeAutoUpdate

Aktiverar eller inaktiverar funktionen för automatisk uppdatering i integrationskörningen med egen värd. Se https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

Tidsförskjutningen (i timmar) på dagen, t.ex. PT03H är 3 timmar. Automatisk uppdatering av Integration Runtime sker vid den tidpunkten.

Svar

Name Typ Description
200 OK

IntegrationRuntimeResource

OK.

Other Status Codes

CloudError

Ett felsvar som tagits emot från Azure Data Factory-tjänsten.

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_Update

Exempelbegäran

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

Exempelsvar

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

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.

IntegrationRuntimeAutoUpdate

Tillståndet för automatisk uppdatering av integrationskörning.

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

Anpassade konfigurationsskriptegenskaper 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 att ta med ditt eget licensscenario.

IntegrationRuntimeResource

Resurstyp för integrationskörning.

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 integrationskörning.

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-integreringskörningen.

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.

UpdateIntegrationRuntimeRequest

Uppdatera integration runtime-begäran.

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 integrationskörning 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.

IntegrationRuntimeAutoUpdate

Tillståndet för automatisk uppdatering av integrationskörning.

Name Typ Description
Off

string

On

string

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

Kravet på nodstorlek 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 det undernät som Azure-SSIS Integration Runtime ska ansluta till.

IntegrationRuntimeCustomSetupScriptProperties

Anpassade konfigurationsskriptegenskaper 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 kommer inte att återvinnas och det kommer att användas i nästa dataflödesaktivitet tills TTL (time to live) har nåtts 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 ska köra dataflödesjobbet.

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integrationskörning.

Name Typ Description
connectVia

EntityReference

Den lokalt installerade integrationskörningsreferensen.

path

string

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

stagingLinkedService

EntityReference

Referensen för mellanlagringslänkad tjänst.

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 att ta med ditt eget licensscenario.

Name Typ Description
BasePrice

string

LicenseIncluded

string

IntegrationRuntimeResource

Resurstyp för integrationskörning.

Name Typ Description
etag

string

Etag identifierar ändring i resursen.

id

string

Resursidentifieraren.

name

string

Resursnamnet.

properties IntegrationRuntime:

Egenskaper för integrationskörning.

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

Det dubbla vänteparnamnet 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

Anpassade konfigurationsskriptegenskaper 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 att ta med ditt eget licensscenario.

packageStores

PackageStore[]

Paketlager för SSIS-Integration Runtime.

IntegrationRuntimeState

Tillståndet för integrationskörning.

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 integrationskörningen använder.

subnet

string

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

subnetId

string

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

vNetId

string

ID:t för det virtuella nätverk som integrationskö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 integrationskörning.

managedVirtualNetwork

ManagedVirtualNetworkReference

Referens för hanterade Virtual Network.

state

IntegrationRuntimeState

Körningstillstånd för integrering, 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

ReferenshanteratVirtualNetwork-namn.

type

ManagedVirtualNetworkReferenceType

Hanterad Virtual Network referenstyp.

ManagedVirtualNetworkReferenceType

Hanterad Virtual Network referenstyp.

Name Typ Description
ManagedVirtualNetworkReference

string

PackageStore

Paketarkiv för SSIS-integreringskörningen.

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 integreringskörning 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 integrationskörning.

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.

UpdateIntegrationRuntimeRequest

Uppdatera integration runtime-begäran.

Name Typ Description
autoUpdate

IntegrationRuntimeAutoUpdate

Aktiverar eller inaktiverar funktionen för automatisk uppdatering i den lokalt installerade integrationskörningen. Se https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

Tidsförskjutningen (i timmar) på dagen, t.ex. PT03H är 3 timmar. Den automatiska uppdateringen av integrationskörning sker vid den tidpunkten.