Delen via


Integration Runtimes - Update

Hiermee wordt een integratieruntime bijgewerkt.

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

URI-parameters

Name In Vereist Type Description
factoryName
path True

string

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

De naam van de fabriek.

integrationRuntimeName
path True

string

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

De naam van de integratieruntime.

resourceGroupName
path True

string

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

De naam van de resourcegroep.

subscriptionId
path True

string

De abonnement-ID.

api-version
query True

string

De API-versie.

Aanvraagbody

Name Type Description
autoUpdate

IntegrationRuntimeAutoUpdate

Hiermee schakelt u de functie voor automatisch bijwerken van de zelf-hostende Integration Runtime in of uit. Zie https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

De tijdsverschil (in uren) op de dag, bijvoorbeeld PT03H is 3 uur. De automatische update van integration runtime vindt op dat moment plaats.

Antwoorden

Name Type Description
200 OK

IntegrationRuntimeResource

OK.

Other Status Codes

CloudError

Er is een foutbericht ontvangen van de Azure Data Factory-service.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

IntegrationRuntimes_Update

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
CloudError

Het object dat de structuur van een Azure Data Factory-foutreactie definieert.

CopyComputeScaleProperties

CopyComputeScale-eigenschappen voor beheerde integratieruntime.

CredentialReference

Referentietype.

CredentialReferenceType

Referentietype.

CustomProperties

Aangepaste eigenschappen worden gebruikt om de runtimeprestaties van de gegevensstroom af te stemmen.

DataFlowComputeType

Het rekentype van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.

EntityReference

De entiteitsreferentie.

IntegrationRuntimeAutoUpdate

De status van automatische update van Integration Runtime.

IntegrationRuntimeComputeProperties

De eigenschappen van rekenresources voor beheerde integratieruntime.

IntegrationRuntimeCustomerVirtualNetwork

De definitie en eigenschappen van het virtuele netwerk waaraan Azure-SSIS integration runtime wordt toegevoegd.

IntegrationRuntimeCustomSetupScriptProperties

Aangepaste eigenschappen van installatiescripts voor een beheerde toegewezen integratieruntime.

IntegrationRuntimeDataFlowProperties

Eigenschappen van gegevensstromen voor beheerde integratieruntime.

IntegrationRuntimeDataProxyProperties

Eigenschappen van gegevensproxy voor een beheerde toegewezen integratieruntime.

IntegrationRuntimeEdition

De editie voor de SSIS Integration Runtime

IntegrationRuntimeEntityReferenceType

Het type van deze entiteit waarnaar wordt verwezen.

IntegrationRuntimeLicenseType

Licentietype voor het meenemen van uw eigen licentiescenario.

IntegrationRuntimeResource

Resourcetype Integration Runtime.

IntegrationRuntimeSsisCatalogInfo

Catalogusinformatie voor beheerde toegewezen integratieruntime.

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden zijn te vinden in https://azure.microsoft.com/en-us/pricing/details/sql-database/

IntegrationRuntimeSsisProperties

SSIS-eigenschappen voor beheerde integration runtime.

IntegrationRuntimeState

De status van integration runtime.

IntegrationRuntimeType

Het type integration runtime.

IntegrationRuntimeVNetProperties

VNet-eigenschappen voor beheerde integration runtime.

LinkedIntegrationRuntimeKeyAuthorization

De integratieruntime van het sleutelautorisatietype.

LinkedIntegrationRuntimeRbacAuthorization

De op rollen gebaseerd toegangsbeheer (RBAC) autorisatietype Integration Runtime.

ManagedIntegrationRuntime

Beheerde integratieruntime, waaronder beheerde elastische en beheerde toegewezen integratieruntimes.

ManagedVirtualNetworkReference

Verwijzingstype beheerd virtueel netwerk.

ManagedVirtualNetworkReferenceType

Verwijzingstype beheerd virtueel netwerk.

PackageStore

Pakketarchief voor de SSIS Integration Runtime.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-eigenschappen voor beheerde integration runtime.

SecureString

Definitie van beveiligde tekenreeks in Azure Data Factory. De tekenreekswaarde wordt gemaskeerd met sterretjes '*' tijdens get- of list-API-aanroepen.

SelfHostedIntegrationRuntime

Zelf-hostende Integration Runtime.

UpdateIntegrationRuntimeRequest

Update Integration Runtime-aanvraag.

CloudError

Het object dat de structuur van een Azure Data Factory-foutreactie definieert.

Name Type Description
error.code

string

Foutcode.

error.details

CloudError[]

Matrix met aanvullende foutdetails.

error.message

string

Foutmelding.

error.target

string

Eigenschapsnaam/pad in aanvraag die is gekoppeld aan een fout.

CopyComputeScaleProperties

CopyComputeScale-eigenschappen voor beheerde integratieruntime.

Name Type Description
dataIntegrationUnit

integer (int32)

minimum: 4

DIU-nummerinstelling gereserveerd voor de uitvoering van kopieeractiviteit. Ondersteunde waarden zijn veelvouden van 4 in bereik 4-256.

timeToLive

integer (int32)

minimum: 5

Time to live (in minuten) instelling van integration runtime waarmee kopieeractiviteit wordt uitgevoerd.

CredentialReference

Referentietype.

Name Type Description
referenceName

string

Referentiereferentienaam.

type

CredentialReferenceType

Referentietype.

CredentialReferenceType

Referentietype.

Waarde Description
CredentialReference

CustomProperties

Aangepaste eigenschappen worden gebruikt om de runtimeprestaties van de gegevensstroom af te stemmen.

Name Type Description
name

string

Naam van aangepaste eigenschap.

value

string

Waarde van aangepaste eigenschap.

DataFlowComputeType

Het rekentype van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.

Waarde Description
ComputeOptimized
General
MemoryOptimized

EntityReference

De entiteitsreferentie.

Name Type Description
referenceName

string

De naam van deze entiteit waarnaar wordt verwezen.

type

IntegrationRuntimeEntityReferenceType

Het type van deze entiteit waarnaar wordt verwezen.

IntegrationRuntimeAutoUpdate

De status van automatische update van Integration Runtime.

Waarde Description
Off
On

IntegrationRuntimeComputeProperties

De eigenschappen van rekenresources voor beheerde integratieruntime.

Name Type Description
copyComputeScaleProperties

CopyComputeScaleProperties

CopyComputeScale-eigenschappen voor beheerde integratieruntime.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

Eigenschappen van gegevensstromen voor beheerde integratieruntime.

location

string

De locatie voor beheerde integration runtime. De ondersteunde regio's zijn te vinden op https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities

maxParallelExecutionsPerNode

integer

minimum: 1

Maximumaantal parallelle uitvoeringen per knooppunt voor beheerde integration runtime.

nodeSize

string

De vereiste voor de grootte van het knooppunt voor beheerde integratieruntime.

numberOfNodes

integer

minimum: 1

Het vereiste aantal knooppunten voor beheerde integratieruntime.

pipelineExternalComputeScaleProperties

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-eigenschappen voor beheerde integration runtime.

vNetProperties

IntegrationRuntimeVNetProperties

VNet-eigenschappen voor beheerde integration runtime.

IntegrationRuntimeCustomerVirtualNetwork

De definitie en eigenschappen van het virtuele netwerk waaraan Azure-SSIS integration runtime wordt toegevoegd.

Name Type Description
subnetId

string

De id van het subnet waaraan Azure-SSIS Integration Runtime wordt gekoppeld.

IntegrationRuntimeCustomSetupScriptProperties

Aangepaste eigenschappen van installatiescripts voor een beheerde toegewezen integratieruntime.

Name Type Description
blobContainerUri

string

De URI van de Azure Blob-container die het aangepaste installatiescript bevat.

sasToken

SecureString

Het SAS-token van de Azure Blob-container.

IntegrationRuntimeDataFlowProperties

Eigenschappen van gegevensstromen voor beheerde integratieruntime.

Name Type Description
cleanup

boolean

Het cluster wordt niet gerecycled en wordt gebruikt in de volgende gegevensstroomactiviteit wordt uitgevoerd totdat TTL (time to live) is bereikt als dit is ingesteld als onwaar. De standaardwaarde is waar.

computeType

DataFlowComputeType

Het rekentype van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.

coreCount

integer

Het aantal kernen van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd. Ondersteunde waarden zijn: 8, 16, 32, 48, 80, 144 en 272.

customProperties

CustomProperties[]

Aangepaste eigenschappen worden gebruikt om de runtimeprestaties van de gegevensstroom af te stemmen.

timeToLive

integer

minimum: 0

De instelling Time to Live (in minuten) van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.

IntegrationRuntimeDataProxyProperties

Eigenschappen van gegevensproxy voor een beheerde toegewezen integratieruntime.

Name Type Description
connectVia

EntityReference

De zelf-hostende naslaginformatie over integration runtime.

path

string

Het pad naar de gefaseerde gegevens in de Blob-opslag.

stagingLinkedService

EntityReference

De referentie voor de gekoppelde faseringsservice.

IntegrationRuntimeEdition

De editie voor de SSIS Integration Runtime

Waarde Description
Enterprise
Standard

IntegrationRuntimeEntityReferenceType

Het type van deze entiteit waarnaar wordt verwezen.

Waarde Description
IntegrationRuntimeReference
LinkedServiceReference

IntegrationRuntimeLicenseType

Licentietype voor het meenemen van uw eigen licentiescenario.

Waarde Description
BasePrice
LicenseIncluded

IntegrationRuntimeResource

Resourcetype Integration Runtime.

Name Type Description
etag

string

Etag identificeert de wijziging in de resource.

id

string

De resource-id.

name

string

De resourcenaam.

properties IntegrationRuntime:

Eigenschappen van Integration Runtime.

type

string

Het resourcetype.

IntegrationRuntimeSsisCatalogInfo

Catalogusinformatie voor beheerde toegewezen integratieruntime.

Name Type Description
catalogAdminPassword

SecureString

Het wachtwoord van het beheerdersgebruikersaccount van de catalogusdatabase.

catalogAdminUserName

string

minLength: 1
maxLength: 128

De gebruikersnaam van de beheerder van de catalogusdatabase.

catalogPricingTier

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden zijn te vinden in https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

De URL van de catalogusdatabaseserver.

dualStandbyPairName

string

De dubbele stand-bypaarnaam van Azure-SSIS Integration Runtimes ter ondersteuning van SSISDB-failover.

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden zijn te vinden in https://azure.microsoft.com/en-us/pricing/details/sql-database/

Waarde Description
Basic
Premium
PremiumRS
Standard

IntegrationRuntimeSsisProperties

SSIS-eigenschappen voor beheerde integration runtime.

Name Type Description
catalogInfo

IntegrationRuntimeSsisCatalogInfo

Catalogusinformatie voor beheerde toegewezen integratieruntime.

credential

CredentialReference

De referentiereferentie met verificatiegegevens.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

Aangepaste eigenschappen van installatiescripts voor een beheerde toegewezen integratieruntime.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Eigenschappen van gegevensproxy voor een beheerde toegewezen integratieruntime.

edition

IntegrationRuntimeEdition

De editie voor de SSIS Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Aangepaste installatie zonder scripteigenschappen voor een SSIS Integration Runtime.

licenseType

IntegrationRuntimeLicenseType

Licentietype voor het meenemen van uw eigen licentiescenario.

packageStores

PackageStore[]

Pakketarchieven voor de SSIS Integration Runtime.

IntegrationRuntimeState

De status van integration runtime.

Waarde Description
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeType

Het type integration runtime.

Waarde Description
Managed
SelfHosted

IntegrationRuntimeVNetProperties

VNet-eigenschappen voor beheerde integration runtime.

Name Type Description
publicIPs

string[]

Resource-id's van de openbare IP-adressen die door deze integratieruntime worden gebruikt.

subnet

string

De naam van het subnet waaraan deze integratieruntime wordt gekoppeld.

subnetId

string

De id van het subnet waaraan deze Azure-SSIS Integration Runtime wordt toegevoegd.

vNetId

string

De id van het VNet waaraan deze integratieruntime wordt gekoppeld.

LinkedIntegrationRuntimeKeyAuthorization

De integratieruntime van het sleutelautorisatietype.

Name Type Description
authorizationType string:

Key

Het autorisatietype voor het delen van integratieruntime.

key

SecureString

De sleutel die wordt gebruikt voor autorisatie.

LinkedIntegrationRuntimeRbacAuthorization

De op rollen gebaseerd toegangsbeheer (RBAC) autorisatietype Integration Runtime.

Name Type Description
authorizationType string:

RBAC

Het autorisatietype voor het delen van integratieruntime.

credential

CredentialReference

De referentiereferentie met verificatiegegevens.

resourceId

string

De resource-id van de integratieruntime die moet worden gedeeld.

ManagedIntegrationRuntime

Beheerde integratieruntime, waaronder beheerde elastische en beheerde toegewezen integratieruntimes.

Name Type Description
description

string

Beschrijving van Integration Runtime.

managedVirtualNetwork

ManagedVirtualNetworkReference

Naslaginformatie over beheerd virtueel netwerk.

state

IntegrationRuntimeState

Integratieruntimestatus, alleen geldig voor beheerde toegewezen integratieruntime.

type string:

Managed

Type integration runtime.

typeProperties.computeProperties

IntegrationRuntimeComputeProperties

De rekenresource voor beheerde integratieruntime.

typeProperties.customerVirtualNetwork

IntegrationRuntimeCustomerVirtualNetwork

De naam van het virtuele netwerk waaraan Azure-SSIS Integration Runtime wordt gekoppeld

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

SSIS-eigenschappen voor beheerde integration runtime.

ManagedVirtualNetworkReference

Verwijzingstype beheerd virtueel netwerk.

Name Type Description
referenceName

string

Verwijzing naar managedVirtualNetwork-naam.

type

ManagedVirtualNetworkReferenceType

Verwijzingstype beheerd virtueel netwerk.

ManagedVirtualNetworkReferenceType

Verwijzingstype beheerd virtueel netwerk.

Waarde Description
ManagedVirtualNetworkReference

PackageStore

Pakketarchief voor de SSIS Integration Runtime.

Name Type Description
name

string

De naam van het pakketarchief

packageStoreLinkedService

EntityReference

De naslaginformatie over de gekoppelde pakketopslagservice.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-eigenschappen voor beheerde integration runtime.

Name Type Description
numberOfExternalNodes

integer (int32)

minimum: 1
maximum: 10

Het aantal externe knooppunten, dat groter moet zijn dan 0 en kleiner dan 11.

numberOfPipelineNodes

integer (int32)

minimum: 1
maximum: 10

Het aantal pijplijnknooppunten, dat groter moet zijn dan 0 en kleiner dan 11.

timeToLive

integer (int32)

minimum: 5

Time to live (in minuten) instelling van integration runtime die pijplijn en externe activiteit uitvoert.

SecureString

Definitie van beveiligde tekenreeks in Azure Data Factory. De tekenreekswaarde wordt gemaskeerd met sterretjes '*' tijdens get- of list-API-aanroepen.

Name Type Description
type string:

SecureString

Type van het geheim.

value

string

Waarde van beveiligde tekenreeks.

SelfHostedIntegrationRuntime

Zelf-hostende Integration Runtime.

Name Type Description
description

string

Beschrijving van Integration Runtime.

type string:

SelfHosted

Type integration runtime.

typeProperties.linkedInfo LinkedIntegrationRuntimeType:

De basisdefinitie van een gekoppelde integration runtime.

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

Een alternatieve optie om ervoor te zorgen dat de interactieve creatiefunctie werkt wanneer uw zelf-hostende Integration Runtime geen verbinding kan maken met Azure Relay.

UpdateIntegrationRuntimeRequest

Update Integration Runtime-aanvraag.

Name Type Description
autoUpdate

IntegrationRuntimeAutoUpdate

Hiermee schakelt u de functie voor automatisch bijwerken van de zelf-hostende Integration Runtime in of uit. Zie https://go.microsoft.com/fwlink/?linkid=854189.

updateDelayOffset

string

De tijdsverschil (in uren) op de dag, bijvoorbeeld PT03H is 3 uur. De automatische update van integration runtime vindt op dat moment plaats.