Dela via


Integration Runtimes - Update

Uppdaterar 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

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

Fabriksnamnet.

integrationRuntimeName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

Namnet på integrationskörningen.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Resursgruppens namn.

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 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örningen sker vid den tidpunkten.

Svar

Name Typ Description
200 OK

IntegrationRuntimeResource

OKEJ.

Other Status Codes

CloudError

Ett felsvar som togs 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 integration runtime.

IntegrationRuntimeComputeProperties

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

IntegrationRuntimeCustomerVirtualNetwork

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

IntegrationRuntimeCustomSetupScriptProperties

Anpassade konfigurationsskriptegenskaper för en hanterad dedikerad integreringskörning.

IntegrationRuntimeDataFlowProperties

Dataflödesegenskaper för hanterad integrationskörning.

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integreringskörning.

IntegrationRuntimeEdition

Utgåvan för SSIS Integration Runtime

IntegrationRuntimeEntityReferenceType

Typen av den här 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

Typ av integrationskörning.

IntegrationRuntimeVNetProperties

VNet-egenskaper för hanterad integrationskörning.

LinkedIntegrationRuntimeKeyAuthorization

Integreringskörning för nyckelauktoriseringstyp.

LinkedIntegrationRuntimeRbacAuthorization

Rollbaserad åtkomstkontroll (RBAC) auktoriseringstyp integrationskörning.

ManagedIntegrationRuntime

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

ManagedVirtualNetworkReference

Referenstyp för hanterat virtuellt nätverk.

ManagedVirtualNetworkReferenceType

Referenstyp för hanterat virtuellt nätverk.

PackageStore

Paketarkiv för SSIS-integreringskörningen.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-egenskaper för hanterad integrationskörning.

SecureString

Säker strängdefinition för Azure Data Factory. Strängvärdet maskeras med asterisker '*' under Get- eller List-API-anrop.

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 (int32)

minimum: 4

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 (int32)

minimum: 5

Inställningen Time to live (in minutes) 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.

Värde Description
CredentialReference

CustomProperties

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

Name Typ Description
name

string

Namnet på den anpassade egenskapen.

value

string

Värdet för den anpassade egenskapen.

DataFlowComputeType

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

Värde Description
ComputeOptimized
General
MemoryOptimized

EntityReference

Entitetsreferensen.

Name Typ Description
referenceName

string

Namnet på den refererade entiteten.

type

IntegrationRuntimeEntityReferenceType

Typen av den här refererade entiteten.

IntegrationRuntimeAutoUpdate

Tillståndet för automatisk uppdatering av integration runtime.

Värde Description
Off
On

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

minimum: 1

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

nodeSize

string

Krav på nodstorlek för hanterad integrationskörning.

numberOfNodes

integer

minimum: 1

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

Name Typ Description
subnetId

string

ID:t för det undernät som Azure-SSIS integrationskörning ska anslutas till.

IntegrationRuntimeCustomSetupScriptProperties

Anpassade konfigurationsskriptegenskaper för en hanterad dedikerad integreringskörning.

Name Typ Description
blobContainerUri

string

URI:n för Azure Blob-containern som innehåller det anpassade installationsskriptet.

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 återanvändas 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 sant.

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

minimum: 0

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

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integreringskö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

Referens för mellanlagring av länkad tjänst.

IntegrationRuntimeEdition

Utgåvan för SSIS Integration Runtime

Värde Description
Enterprise
Standard

IntegrationRuntimeEntityReferenceType

Typen av den här refererade entiteten.

Värde Description
IntegrationRuntimeReference
LinkedServiceReference

IntegrationRuntimeLicenseType

Licenstyp för att ta med ditt eget licensscenario.

Värde Description
BasePrice
LicenseIncluded

IntegrationRuntimeResource

Resurstyp för integrationskörning.

Name Typ Description
etag

string

Etag identifierar ändringar 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

minLength: 1
maxLength: 128

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 standby-parnamnet 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/

Värde Description
Basic
Premium
PremiumRS
Standard

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

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Dataproxyegenskaper för en hanterad dedikerad integreringskö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.

Värde Description
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeType

Typ av integrationskörning.

Värde Description
Managed
SelfHosted

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

subnet

string

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

subnetId

string

ID:t för undernätet som den här Azure-SSIS integrationskörningen ska kopplas till.

vNetId

string

ID:t för det virtuella nätverk som den här integreringskörningen ansluter till.

LinkedIntegrationRuntimeKeyAuthorization

Integreringskörning för nyckelauktoriseringstyp.

Name Typ Description
authorizationType string:

Key

Auktoriseringstypen för integreringskörningsdelning.

key

SecureString

Nyckeln som används för auktorisering.

LinkedIntegrationRuntimeRbacAuthorization

Rollbaserad åtkomstkontroll (RBAC) auktoriseringstyp integrationskörning.

Name Typ Description
authorizationType string:

RBAC

Auktoriseringstypen för integreringskörningsdelning.

credential

CredentialReference

Referensen för autentiseringsuppgifter som innehåller autentiseringsinformation.

resourceId

string

Resursidentifieraren för integrationskörningen som ska delas.

ManagedIntegrationRuntime

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

Name Typ Description
description

string

Beskrivning av integrationskörning.

managedVirtualNetwork

ManagedVirtualNetworkReference

Referens för hanterat virtuellt nätverk.

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 integreringskörning ansluter till

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

SSIS-egenskaper för hanterad integrationskörning.

ManagedVirtualNetworkReference

Referenstyp för hanterat virtuellt nätverk.

Name Typ Description
referenceName

string

Referens till ManagedVirtualNetwork-namn.

type

ManagedVirtualNetworkReferenceType

Referenstyp för hanterat virtuellt nätverk.

ManagedVirtualNetworkReferenceType

Referenstyp för hanterat virtuellt nätverk.

Värde Description
ManagedVirtualNetworkReference

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 (int32)

minimum: 1
maximum: 10

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

numberOfPipelineNodes

integer (int32)

minimum: 1
maximum: 10

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

timeToLive

integer (int32)

minimum: 5

Inställningen Time to live (i minuter) för integreringskörning som kör pipeline och extern aktivitet.

SecureString

Säker strängdefinition för Azure Data Factory. Strängvärdet maskeras med asterisker '*' under Get- eller List-API-anrop.

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 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örningen sker vid den tidpunkten.