Delen via


Integration Runtimes - Update

Updates een Integration Runtime.

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

De fabrieksnaam.

Regex-patroon: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

integrationRuntimeName
path True

string

De naam van de integratieruntime.

Regex-patroon: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

De naam van de resourcegroep.

Regex-patroon: ^[-\w\._\(\)]+$

subscriptionId
path True

string

De abonnements-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

Het tijdverschil (in uren) in 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

Een foutbericht ontvangen van de Azure Data Factory-service.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

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

Referentiereferentietype.

CredentialReferenceType

Referentiereferentietype.

CustomProperties

Aangepaste eigenschappen worden gebruikt om de prestaties van de gegevensstroomruntime af te stemmen.

DataFlowComputeType

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 de rekenresource voor beheerde integratieruntime.

IntegrationRuntimeCustomerVirtualNetwork

De definitie en eigenschappen van het virtuele netwerk waaraan Azure-SSIS Integration Runtime wordt gekoppeld.

IntegrationRuntimeCustomSetupScriptProperties

Aangepaste eigenschappen van installatiescripts voor een beheerde, toegewezen integratieruntime.

IntegrationRuntimeDataFlowProperties

Gegevensstroomeigenschappen voor beheerde integratieruntime.

IntegrationRuntimeDataProxyProperties

Gegevensproxy-eigenschappen 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 Integratieruntime.

IntegrationRuntimeSsisCatalogInfo

Catalogusinformatie voor beheerde, toegewezen integratieruntime.

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden kunnen worden gevonden in https://azure.microsoft.com/en-us/pricing/details/sql-database/

IntegrationRuntimeSsisProperties

SSIS-eigenschappen voor beheerde integratieruntime.

IntegrationRuntimeState

De status van integration runtime.

IntegrationRuntimeType

Het type integration runtime.

IntegrationRuntimeVNetProperties

VNet-eigenschappen voor beheerde integratieruntime.

LinkedIntegrationRuntimeKeyAuthorization

Het sleutelautorisatietype Integration Runtime.

LinkedIntegrationRuntimeRbacAuthorization

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

ManagedIntegrationRuntime

Beheerde integratieruntime, inclusief beheerde elastische en beheerde toegewezen integratieruntimes.

ManagedVirtualNetworkReference

Verwijzingstype beheerde Virtual Network.

ManagedVirtualNetworkReferenceType

Verwijzingstype beheerde Virtual Network.

PackageStore

Pakketopslag voor de SSIS Integration Runtime.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-eigenschappen voor beheerde integratieruntime.

SecureString

Azure Data Factory definitie van een beveiligde tekenreeks. De tekenreekswaarde wordt gemaskeerd met sterretjes '*' tijdens GET- of List-API-aanroepen.

SelfHostedIntegrationRuntime

Zelf-hostende Integration Runtime.

UpdateIntegrationRuntimeRequest

Integratieruntimeaanvraag bijwerken.

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

Foutbericht.

error.target

string

De naam/het pad van de eigenschap in de aanvraag die is gekoppeld aan een fout.

CopyComputeScaleProperties

CopyComputeScale-eigenschappen voor beheerde integratieruntime.

Name Type Description
dataIntegrationUnit

integer

INSTELLING VAN HET DIU-nummer gereserveerd voor het uitvoeren van kopieeractiviteiten. Ondersteunde waarden zijn veelvouden van 4 in het bereik 4-256.

timeToLive

integer

Time to live (in minuten) instelling van Integration Runtime waarmee kopieeractiviteit wordt uitgevoerd.

CredentialReference

Referentiereferentietype.

Name Type Description
referenceName

string

Referentienaam.

type

CredentialReferenceType

Referentiereferentietype.

CredentialReferenceType

Referentiereferentietype.

Name Type Description
CredentialReference

string

CustomProperties

Aangepaste eigenschappen worden gebruikt om de prestaties van de gegevensstroomruntime af te stemmen.

Name Type Description
name

string

Naam van aangepaste eigenschap.

value

string

Waarde van aangepaste eigenschap.

DataFlowComputeType

Rekentype van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.

Name Type Description
ComputeOptimized

string

General

string

MemoryOptimized

string

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.

Name Type Description
Off

string

On

string

IntegrationRuntimeComputeProperties

De eigenschappen van de rekenresource voor beheerde integratieruntime.

Name Type Description
copyComputeScaleProperties

CopyComputeScaleProperties

CopyComputeScale-eigenschappen voor beheerde integratieruntime.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

Gegevensstroomeigenschappen voor beheerde integratieruntime.

location

string

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

maxParallelExecutionsPerNode

integer

Het maximale aantal parallelle uitvoeringen per knooppunt voor beheerde integratieruntime.

nodeSize

string

De vereiste knooppuntgrootte voor beheerde integratieruntime.

numberOfNodes

integer

Het vereiste aantal knooppunten voor beheerde integratieruntime.

pipelineExternalComputeScaleProperties

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-eigenschappen voor beheerde integratieruntime.

vNetProperties

IntegrationRuntimeVNetProperties

VNet-eigenschappen voor beheerde integratieruntime.

IntegrationRuntimeCustomerVirtualNetwork

De definitie en eigenschappen van het virtuele netwerk waaraan Azure-SSIS Integration Runtime wordt gekoppeld.

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-blobcontainer die het aangepaste installatiescript bevat.

sasToken

SecureString

Het SAS-token van de Azure Blob-container.

IntegrationRuntimeDataFlowProperties

Gegevensstroomeigenschappen voor beheerde integratieruntime.

Name Type Description
cleanup

boolean

Het cluster wordt niet gerecycled en wordt gebruikt in de volgende uitvoering van de gegevensstroomactiviteit totdat TTL (time to live) is bereikt als dit is ingesteld als false. De standaardwaarde is true.

computeType

DataFlowComputeType

Rekentype van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.

coreCount

integer

Kernaantal 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 prestaties van de gegevensstroomruntime af te stemmen.

timeToLive

integer

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

IntegrationRuntimeDataProxyProperties

Gegevensproxy-eigenschappen voor een beheerde, toegewezen integratieruntime.

Name Type Description
connectVia

EntityReference

De naslaginformatie over zelf-hostende Integration Runtime.

path

string

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

stagingLinkedService

EntityReference

De naslaginformatie over de gekoppelde faseringsservice.

IntegrationRuntimeEdition

De editie voor de SSIS-Integration Runtime

Name Type Description
Enterprise

string

Standard

string

IntegrationRuntimeEntityReferenceType

Het type van deze entiteit waarnaar wordt verwezen.

Name Type Description
IntegrationRuntimeReference

string

LinkedServiceReference

string

IntegrationRuntimeLicenseType

Licentietype voor het meenemen van uw eigen licentiescenario.

Name Type Description
BasePrice

string

LicenseIncluded

string

IntegrationRuntimeResource

Resourcetype Integratieruntime.

Name Type Description
etag

string

Etag identificeert wijzigingen in de resource.

id

string

De resource-id.

name

string

De resourcenaam.

properties IntegrationRuntime:

Eigenschappen van Integratieruntime.

type

string

Het resourcetype.

IntegrationRuntimeSsisCatalogInfo

Catalogusinformatie voor beheerde, toegewezen integratieruntime.

Name Type Description
catalogAdminPassword

SecureString

Het wachtwoord van het beheerdersaccount van de catalogusdatabase.

catalogAdminUserName

string

De gebruikersnaam van de beheerder van de catalogusdatabase.

catalogPricingTier

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden kunnen worden gevonden in https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

De URL van de catalogusdatabaseserver.

dualStandbyPairName

string

De naam van het dubbele stand-bypaar van Azure-SSIS Integration Runtimes ter ondersteuning van SSISDB-failover.

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden kunnen worden gevonden in https://azure.microsoft.com/en-us/pricing/details/sql-database/

Name Type Description
Basic

string

Premium

string

PremiumRS

string

Standard

string

IntegrationRuntimeSsisProperties

SSIS-eigenschappen voor beheerde integratieruntime.

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

Gegevensproxy-eigenschappen voor een beheerde, toegewezen integratieruntime.

edition

IntegrationRuntimeEdition

De editie voor de SSIS-Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Aangepaste installatie zonder scripteigenschappen voor een SSIS-integratieruntime.

licenseType

IntegrationRuntimeLicenseType

Licentietype voor het meenemen van uw eigen licentiescenario.

packageStores

PackageStore[]

Pakketarchieven voor de SSIS-Integration Runtime.

IntegrationRuntimeState

De status van integration runtime.

Name Type Description
AccessDenied

string

Initial

string

Limited

string

NeedRegistration

string

Offline

string

Online

string

Started

string

Starting

string

Stopped

string

Stopping

string

IntegrationRuntimeType

Het type integration runtime.

Name Type Description
Managed

string

SelfHosted

string

IntegrationRuntimeVNetProperties

VNet-eigenschappen voor beheerde integratieruntime.

Name Type Description
publicIPs

string[]

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

subnet

string

De naam van het subnet waaraan deze Integration Runtime wordt gekoppeld.

subnetId

string

De id van het subnet, waaraan deze Azure-SSIS-integratieruntime wordt toegevoegd.

vNetId

string

De id van het VNet waaraan deze integratieruntime wordt gekoppeld.

LinkedIntegrationRuntimeKeyAuthorization

Het sleutelautorisatietype Integration Runtime.

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, inclusief beheerde elastische en beheerde toegewezen integratieruntimes.

Name Type Description
description

string

Beschrijving van integratieruntime.

managedVirtualNetwork

ManagedVirtualNetworkReference

Naslaginformatie over beheerde Virtual Network.

state

IntegrationRuntimeState

Status van integratieruntime, 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 integratieruntime.

ManagedVirtualNetworkReference

Verwijzingstype beheerde Virtual Network.

Name Type Description
referenceName

string

Verwijzing naar ManagedVirtualNetwork-naam.

type

ManagedVirtualNetworkReferenceType

Verwijzingstype beheerde Virtual Network.

ManagedVirtualNetworkReferenceType

Verwijzingstype beheerde Virtual Network.

Name Type Description
ManagedVirtualNetworkReference

string

PackageStore

Pakketopslag voor de SSIS Integration Runtime.

Name Type Description
name

string

De naam van het pakketarchief

packageStoreLinkedService

EntityReference

De verwijzing naar de gekoppelde service voor het pakketarchief.

PipelineExternalComputeScaleProperties

PipelineExternalComputeScale-eigenschappen voor beheerde integratieruntime.

Name Type Description
numberOfExternalNodes

integer

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

numberOfPipelineNodes

integer

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

timeToLive

integer

Time to Live (in minuten) instelling van Integration Runtime waarmee pijplijn- en externe activiteiten worden uitgevoerd.

SecureString

Azure Data Factory definitie van een beveiligde tekenreeks. 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 integratieruntime.

type string:

SelfHosted

Type Integration Runtime.

typeProperties.linkedInfo LinkedIntegrationRuntimeType:

De basisdefinitie van een gekoppelde Integration Runtime.

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

Een alternatieve optie om een interactieve ontwerpfunctie te garanderen wanneer uw zelf-hostende Integration Runtime geen verbinding kan maken met Azure Relay.

UpdateIntegrationRuntimeRequest

Integratieruntimeaanvraag bijwerken.

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

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