Integration Runtimes - Get

Referentie

Service:: Synapse

API-versie:: 2021-06-01

Integratieruntime ophalen
Een integratieruntime ophalen

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}?api-version=2021-06-01

URI-parameters

Name	In	Vereist	Type	Description
integrationRuntimeName	path	True	string	Naam van integratieruntime
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string	De id van het doelabonnement.
workspaceName	path	True	string	De naam van de werkruimte.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Name	Vereist	Type	Description
If-None-Match		string	ETag van de integration runtime-entiteit. Mag alleen worden opgegeven voor get. Als de ETag overeenkomt met de bestaande entiteitstag of als * is opgegeven, wordt er geen inhoud geretourneerd.

Antwoorden

Name	Type	Description
200 OK	IntegrationRuntimeResource	OK.
Other Status Codes		Niet gewijzigd.
Other Status Codes	ErrorResponse	Er is een foutbericht ontvangen van de GET Integration Runtime-bewerking.

Voorbeelden

Get integration runtime

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspace/integrationRuntimes/exampleIntegrationRuntime?api-version=2021-06-01

Voorbeeldrespons

Statuscode:: 200

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.Synapse/workspaces/exampleWorkspaceName/integrationruntimes/exampleIntegrationRuntime",
  "name": "exampleIntegrationRuntime",
  "type": "Microsoft.Synapse/workspaces/integrationruntimes",
  "properties": {
    "type": "SelfHosted",
    "description": "A selfhosted integration runtime"
  },
  "etag": "15003c4f-0000-0200-0000-5cbe090b0000"
}

Statuscode:: 304

Statuscode:: default

{
  "error": {
    "code": "Error code",
    "message": "Error message"
  }
}

Definities

Name	Description
DataFlowComputeType	Het rekentype van het cluster waarmee de gegevensstroomtaak wordt uitgevoerd.
EntityReference	De entiteitsreferentie.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
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.
SecureString	Definitie van beveiligde tekenreeks in Azure Synapse. De tekenreekswaarde wordt gemaskeerd met sterretjes '*' tijdens get- of list-API-aanroepen.
SelfHostedIntegrationRuntime	Zelf-hostende Integration Runtime.

DataFlowComputeType

Het 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.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IntegrationRuntimeComputeProperties

De eigenschappen van rekenresources voor beheerde integratieruntime.

Name	Type	Description
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	Maximumaantal parallelle uitvoeringen per knooppunt voor beheerde integration runtime.
nodeSize	string	De vereiste voor de grootte van het knooppunt voor beheerde integratieruntime.
numberOfNodes	integer	Het vereiste aantal knooppunten voor beheerde integratieruntime.
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
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.
timeToLive	integer	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

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 Integration Runtime.

Name	Type	Description
etag	string	Resource-Etag.
id	string	Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	De naam van de resource
properties	IntegrationRuntime: ManagedIntegrationRuntime SelfHostedIntegrationRuntime	Eigenschappen van Integration Runtime.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

IntegrationRuntimeSsisCatalogInfo

Catalogusinformatie voor beheerde toegewezen integratieruntime.

Name	Type	Description
catalogAdminPassword	SecureString	Het wachtwoord van het beheerdersgebruikersaccount van de catalogusdatabase.
catalogAdminUserName	string	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.

IntegrationRuntimeSsisCatalogPricingTier

De prijscategorie voor de catalogusdatabase. De geldige waarden zijn te vinden 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 integration runtime.

Name	Type	Description
catalogInfo	IntegrationRuntimeSsisCatalogInfo	Catalogusinformatie voor beheerde toegewezen integratieruntime.
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.

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 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.
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.id	string	De id van het beheerde virtuele netwerk.
managedVirtualNetwork.referenceName	string	De referentienaam van het beheerde virtuele netwerk
managedVirtualNetwork.type	string	Het type van het beheerde virtuele netwerk.
provisioningState	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.

SecureString

Definitie van beveiligde tekenreeks in Azure Synapse. 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: LinkedIntegrationRuntimeKeyAuthorization LinkedIntegrationRuntimeRbacAuthorization	Type gekoppelde integratieruntime van data factory

Delen via