Integration Runtimes - Create

Referencia

Szolgáltatás:: Synapse

API-verzió:: 2021-06-01

Integrációs modul létrehozása
Integrációs modul létrehozása

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
integrationRuntimeName	path	True	string	Integrációs modul neve
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
workspaceName	path	True	string	A munkaterület neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match		string	Az integrációs futtatókörnyezeti entitás ETagje. Csak olyan frissítéshez kell megadni, amelynek meg kell egyeznie a meglévő entitással, vagy * lehet a feltétel nélküli frissítéshez.

Kérelem törzse

Name	Kötelező	Típus	Description
properties	True	IntegrationRuntime: ManagedIntegrationRuntime SelfHostedIntegrationRuntime	Integrációs modul tulajdonságai.

Válaszok

Name	Típus	Description
200 OK	IntegrationRuntimeResource	OKÉ.
202 Accepted		Elfogadott.
Other Status Codes	ErrorResponse	A PUT integrációs modul művelettől kapott hibaválasz.

Példák

Create integration runtime

Mintakérelem

HTTP

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

{
  "properties": {
    "type": "SelfHosted",
    "description": "A selfhosted integration runtime"
  }
}

Mintaválasz

Állapotkód:: 200

Date: Wed, 13 Jun 2018 22:20:47 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1197
x-ms-request-id: 125c07fa-e39a-4541-885f-5019631a5ecd
x-ms-correlation-request-id: 125c07fa-e39a-4541-885f-5019631a5ecd

{
  "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": "000046c4-0000-0000-0000-5b2198bf0000"
}

Állapotkód:: 202

Definíciók

Name	Description
DataFlowComputeType	Az adatfolyam-feladatot végrehajtó fürt számítási típusa.
EntityReference	Az entitáshivatkozás.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
IntegrationRuntimeComputeProperties	A felügyelt integrációs futtatókörnyezet számítási erőforrás-tulajdonságai.
IntegrationRuntimeCustomerVirtualNetwork	Annak a virtuális hálózatnak a definíciója és tulajdonságai, amelyhez Azure-SSIS integrációs modul csatlakozik.
IntegrationRuntimeCustomSetupScriptProperties	Egyéni beállítási szkripttulajdonságok felügyelt dedikált integrációs futtatókörnyezethez.
IntegrationRuntimeDataFlowProperties	A felügyelt integrációs futtatókörnyezet adatfolyam-tulajdonságai.
IntegrationRuntimeDataProxyProperties	Felügyelt dedikált integrációs futtatókörnyezet adatproxy-tulajdonságai.
IntegrationRuntimeEdition	Az SSIS integrációs modul kiadása
IntegrationRuntimeEntityReferenceType	A hivatkozott entitás típusa.
IntegrationRuntimeLicenseType	Licenctípus a saját licencforgatókönyv használatához.
IntegrationRuntimeResource	Integrációs modul erőforrástípusa.
IntegrationRuntimeSsisCatalogInfo	Katalógusinformációk a felügyelt dedikált integrációs modulhoz.
IntegrationRuntimeSsisCatalogPricingTier	A katalógusadatbázis tarifacsomagja. Az érvényes értékek https://azure.microsoft.com/en-us/pricing/details/sql-database/
IntegrationRuntimeSsisProperties	SSIS-tulajdonságok felügyelt integrációs futtatókörnyezethez.
IntegrationRuntimeState	Az integrációs modul állapota.
IntegrationRuntimeType	Az integrációs modul típusa.
IntegrationRuntimeVNetProperties	A felügyelt integrációs futtatókörnyezet VNet-tulajdonságai.
LinkedIntegrationRuntimeKeyAuthorization	A kulcsengedélyezési típus integrációs modulja.
LinkedIntegrationRuntimeRbacAuthorization	A szerepköralapú hozzáférés-vezérlési (RBAC) engedélyezési típusú integrációs modul.
ManagedIntegrationRuntime	Felügyelt integrációs modul, beleértve a felügyelt rugalmas és felügyelt dedikált integrációs modulokat.
SecureString	Azure Synapse biztonságos sztringdefiníció. A sztringérték "*" csillagokkal lesz elfedve a Get or List API-hívások során.
SelfHostedIntegrationRuntime	Saját üzemeltetésű integrációs modul.

DataFlowComputeType

Enumerálás

Az adatfolyam-feladatot végrehajtó fürt számítási típusa.

Érték	Description
ComputeOptimized
General
MemoryOptimized

EntityReference

Objektum

Az entitáshivatkozás.

Name	Típus	Description
referenceName	string	A hivatkozott entitás neve.
type	IntegrationRuntimeEntityReferenceType	A hivatkozott entitás típusa.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

IntegrationRuntimeComputeProperties

Objektum

A felügyelt integrációs futtatókörnyezet számítási erőforrás-tulajdonságai.

Name	Típus	Description
dataFlowProperties	IntegrationRuntimeDataFlowProperties	A felügyelt integrációs futtatókörnyezet adatfolyam-tulajdonságai.
location	string	A felügyelt integrációs modul helye. A támogatott régiók a https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities
maxParallelExecutionsPerNode	integer (int32) minimum: 1	A felügyelt integrációs futtatókörnyezetben csomópontonkénti párhuzamos végrehajtások maximális száma.
nodeSize	string	A felügyelt integrációs futtatókörnyezet csomópontméretére vonatkozó követelmény.
numberOfNodes	integer (int32) minimum: 1	A felügyelt integrációs futtatókörnyezethez szükséges csomópontok száma.
vNetProperties	IntegrationRuntimeVNetProperties	A felügyelt integrációs futtatókörnyezet VNet-tulajdonságai.

IntegrationRuntimeCustomerVirtualNetwork

Objektum

Annak a virtuális hálózatnak a definíciója és tulajdonságai, amelyhez Azure-SSIS integrációs modul csatlakozik.

Name	Típus	Description
subnetId	string	Annak az alhálózatnak az azonosítója, amelyhez Azure-SSIS integrációs modul csatlakozik.

IntegrationRuntimeCustomSetupScriptProperties

Objektum

Egyéni beállítási szkripttulajdonságok felügyelt dedikált integrációs futtatókörnyezethez.

Name	Típus	Description
blobContainerUri	string	Az egyéni beállítási szkriptet tartalmazó Azure Blob-tároló URI-ja.
sasToken	SecureString	Az Azure Blob-tároló SAS-jogkivonata.

IntegrationRuntimeDataFlowProperties

Objektum

A felügyelt integrációs futtatókörnyezet adatfolyam-tulajdonságai.

Name	Típus	Description
computeType	DataFlowComputeType	Az adatfolyam-feladatot végrehajtó fürt számítási típusa.
coreCount	integer (int32)	Az adatfolyam-feladatot végrehajtó fürt alapszáma. Támogatott értékek: 8, 16, 32, 48, 80, 144 és 272.
timeToLive	integer (int32) minimum: 0	Az adatfolyam-feladatot végrehajtó fürt élettartam-beállítása (percekben).

IntegrationRuntimeDataProxyProperties

Objektum

Felügyelt dedikált integrációs futtatókörnyezet adatproxy-tulajdonságai.

Name	Típus	Description
connectVia	EntityReference	A saját üzemeltetésű integrációs modul referenciája.
path	string	A blobtárolóban lévő szakaszos adatok tárolásának elérési útja.
stagingLinkedService	EntityReference	Az átmeneti társított szolgáltatás referenciája.

IntegrationRuntimeEdition

Enumerálás

Az SSIS integrációs modul kiadása

Érték	Description
Enterprise
Standard

IntegrationRuntimeEntityReferenceType

Enumerálás

A hivatkozott entitás típusa.

Érték	Description
IntegrationRuntimeReference
LinkedServiceReference

IntegrationRuntimeLicenseType

Enumerálás

Licenctípus a saját licencforgatókönyv használatához.

Érték	Description
BasePrice
LicenseIncluded

IntegrationRuntimeResource

Objektum

Integrációs modul erőforrástípusa.

Name	Típus	Description
etag	string	Erőforráscímke.
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties	IntegrationRuntime: ManagedIntegrationRuntime SelfHostedIntegrationRuntime	Integrációs modul tulajdonságai.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

IntegrationRuntimeSsisCatalogInfo

Objektum

Katalógusinformációk a felügyelt dedikált integrációs modulhoz.

Name	Típus	Description
catalogAdminPassword	SecureString	A katalógusadatbázis rendszergazdai felhasználói fiókjának jelszava.
catalogAdminUserName	string minLength: 1 maxLength: 128	A katalógusadatbázis rendszergazdai felhasználóneve.
catalogPricingTier	IntegrationRuntimeSsisCatalogPricingTier	A katalógusadatbázis tarifacsomagja. Az érvényes értékek https://azure.microsoft.com/en-us/pricing/details/sql-database/
catalogServerEndpoint	string	A katalógusadatbázis-kiszolgáló URL-címe.

IntegrationRuntimeSsisCatalogPricingTier

Enumerálás

A katalógusadatbázis tarifacsomagja. Az érvényes értékek https://azure.microsoft.com/en-us/pricing/details/sql-database/

Érték	Description
Basic
Premium
PremiumRS
Standard

IntegrationRuntimeSsisProperties

Objektum

SSIS-tulajdonságok felügyelt integrációs futtatókörnyezethez.

Name	Típus	Description
catalogInfo	IntegrationRuntimeSsisCatalogInfo	Katalógusinformációk a felügyelt dedikált integrációs modulhoz.
customSetupScriptProperties	IntegrationRuntimeCustomSetupScriptProperties	Egyéni beállítási szkripttulajdonságok felügyelt dedikált integrációs futtatókörnyezethez.
dataProxyProperties	IntegrationRuntimeDataProxyProperties	Felügyelt dedikált integrációs futtatókörnyezet adatproxy-tulajdonságai.
edition	IntegrationRuntimeEdition	Az SSIS integrációs modul kiadása
expressCustomSetupProperties	CustomSetupBase[]	Egyéni beállítás szkripttulajdonságok nélkül az SSIS integrációs modulhoz.
licenseType	IntegrationRuntimeLicenseType	Licenctípus a saját licencforgatókönyv használatához.

IntegrationRuntimeState

Enumerálás

Az integrációs modul állapota.

Érték	Description
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeType

Enumerálás

Az integrációs modul típusa.

Érték	Description
Managed
SelfHosted

IntegrationRuntimeVNetProperties

Objektum

A felügyelt integrációs futtatókörnyezet VNet-tulajdonságai.

Name	Típus	Description
publicIPs	string[]	Az integrációs modul által használt nyilvános IP-címek erőforrás-azonosítói.
subnet	string	Annak az alhálózatnak a neve, amelyhez az integrációs modul csatlakozik.
subnetId	string	Annak az alhálózatnak az azonosítója, amelyhez ez a Azure-SSIS integrációs modul csatlakozik.
vNetId	string	Annak a virtuális hálózatnak az azonosítója, amelyhez ez az integrációs modul csatlakozni fog.

LinkedIntegrationRuntimeKeyAuthorization

Objektum

A kulcsengedélyezési típus integrációs modulja.

Name	Típus	Description
authorizationType	string: Key	Az integrációs modul megosztásának engedélyezési típusa.
key	SecureString	Az engedélyezéshez használt kulcs.

LinkedIntegrationRuntimeRbacAuthorization

Objektum

A szerepköralapú hozzáférés-vezérlési (RBAC) engedélyezési típusú integrációs modul.

Name	Típus	Description
authorizationType	string: RBAC	Az integrációs modul megosztásának engedélyezési típusa.
resourceId	string	A megosztani kívánt integrációs modul erőforrás-azonosítója.

ManagedIntegrationRuntime

Objektum

Felügyelt integrációs modul, beleértve a felügyelt rugalmas és felügyelt dedikált integrációs modulokat.

Name	Típus	Description
description	string	Integrációs modul leírása.
managedVirtualNetwork.id	string	A felügyelt virtuális hálózat azonosítója.
managedVirtualNetwork.referenceName	string	A felügyelt virtuális hálózat referencianeve
managedVirtualNetwork.type	string	A felügyelt virtuális hálózat típusa.
provisioningState	IntegrationRuntimeState	Integrációs modul állapota, csak felügyelt dedikált integrációs futtatókörnyezetre érvényes.
type	string: Managed	Az integrációs modul típusa.
typeProperties.computeProperties	IntegrationRuntimeComputeProperties	A felügyelt integrációs futtatókörnyezet számítási erőforrása.
typeProperties.customerVirtualNetwork	IntegrationRuntimeCustomerVirtualNetwork	Annak a virtuális hálózatnak a neve, amelyhez Azure-SSIS integrációs modul csatlakozik
typeProperties.ssisProperties	IntegrationRuntimeSsisProperties	SSIS-tulajdonságok felügyelt integrációs futtatókörnyezethez.

SecureString

Objektum

Azure Synapse biztonságos sztringdefiníció. A sztringérték "*" csillagokkal lesz elfedve a Get or List API-hívások során.

Name	Típus	Description
type	string: SecureString	A titkos kód típusa.
value	string	A biztonságos sztring értéke.

SelfHostedIntegrationRuntime

Objektum

Saját üzemeltetésű integrációs modul.

Name	Típus	Description
description	string	Integrációs modul leírása.
type	string: SelfHosted	Az integrációs modul típusa.
typeProperties.linkedInfo	LinkedIntegrationRuntimeType: LinkedIntegrationRuntimeKeyAuthorization LinkedIntegrationRuntimeRbacAuthorization	Csatolt integrációs modul típusa a Data Factoryből

Megosztás a következőn keresztül:

Integration Runtimes - Create

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Példák

Create integration runtime

Mintakérelem

Mintaválasz

Definíciók

DataFlowComputeType

EntityReference

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IntegrationRuntimeComputeProperties

IntegrationRuntimeCustomerVirtualNetwork

IntegrationRuntimeCustomSetupScriptProperties

IntegrationRuntimeDataFlowProperties

IntegrationRuntimeDataProxyProperties

IntegrationRuntimeEdition

IntegrationRuntimeEntityReferenceType

IntegrationRuntimeLicenseType

IntegrationRuntimeResource

IntegrationRuntimeSsisCatalogInfo

IntegrationRuntimeSsisCatalogPricingTier

IntegrationRuntimeSsisProperties

IntegrationRuntimeState

IntegrationRuntimeType

IntegrationRuntimeVNetProperties

LinkedIntegrationRuntimeKeyAuthorization

LinkedIntegrationRuntimeRbacAuthorization

ManagedIntegrationRuntime

SecureString

SelfHostedIntegrationRuntime