Integration Runtimes - Create Or Update
Crée ou met à jour un runtime d’intégration.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}?api-version=2018-06-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
factory
|
path | True |
string |
Nom de la fabrique. Modèle d’expression régulière: |
integration
|
path | True |
string |
Nom du runtime d’intégration. Modèle d’expression régulière: |
resource
|
path | True |
string |
Nom du groupe de ressources. Modèle d’expression régulière: |
subscription
|
path | True |
string |
Identificateur de l’abonnement. |
api-version
|
query | True |
string |
Version de l'API. |
En-tête de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
If-Match |
string |
ETag de l’entité runtime d’intégration. Doit uniquement être spécifié pour la mise à jour, pour laquelle il doit correspondre à l’entité existante ou peut être * pour la mise à jour inconditionnelle. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
properties | True | IntegrationRuntime: |
Propriétés du runtime d’intégration. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK. |
|
Other Status Codes |
Réponse d’erreur reçue de l’opération de runtime d’intégration PUT. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
IntegrationRuntimes_Create
Exemple de requête
PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/integrationRuntimes/exampleIntegrationRuntime?api-version=2018-06-01
{
"properties": {
"type": "SelfHosted",
"description": "A selfhosted integration runtime"
}
}
Exemple de réponse
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.DataFactory/factories/exampleFactoryName/integrationruntimes/exampleIntegrationRuntime",
"name": "exampleIntegrationRuntime",
"type": "Microsoft.DataFactory/factories/integrationruntimes",
"properties": {
"type": "SelfHosted",
"description": "A selfhosted integration runtime"
},
"etag": "000046c4-0000-0000-0000-5b2198bf0000"
}
Définitions
Nom | Description |
---|---|
Cloud |
Objet qui définit la structure d’une réponse d’erreur Azure Data Factory. |
Copy |
Propriétés CopyComputeScale pour le runtime d’intégration managée. |
Credential |
Type de référence d’informations d’identification. |
Credential |
Type de référence d’informations d’identification. |
Custom |
Les propriétés personnalisées sont utilisées pour optimiser les performances du runtime du flux de données. |
Data |
Type de calcul du cluster qui exécutera le travail de flux de données. |
Entity |
Référence d’entité. |
Integration |
Propriétés des ressources de calcul pour le runtime d’intégration managée. |
Integration |
Définition et propriétés du réseau virtuel auquel le runtime d’intégration Azure-SSIS sera joint. |
Integration |
Propriétés de script d’installation personnalisées pour un runtime d’intégration dédié managé. |
Integration |
Propriétés de flux de données pour le runtime d’intégration managée. |
Integration |
Propriétés de proxy de données pour un runtime d’intégration dédié managé. |
Integration |
Édition du Integration Runtime SSIS |
Integration |
Type de cette entité référencée. |
Integration |
Type de licence pour apporter votre propre scénario de licence. |
Integration |
Type de ressource runtime d’intégration. |
Integration |
Informations de catalogue pour le runtime d’intégration dédié managé. |
Integration |
Niveau tarifaire de la base de données de catalogue. Les valeurs valides se trouvent dans https://azure.microsoft.com/en-us/pricing/details/sql-database/ |
Integration |
Propriétés SSIS pour le runtime d’intégration managée. |
Integration |
État du runtime d’intégration. |
Integration |
Type de runtime d’intégration. |
Integration |
Propriétés de réseau virtuel pour le runtime d’intégration managée. |
Linked |
Runtime d’intégration du type d’autorisation de clé. |
Linked |
Runtime d’intégration du type d’autorisation RBAC (Contrôle d’accès en fonction du rôle). |
Managed |
Runtime d’intégration managée, y compris les runtimes d’intégration dédiés managés et élastiques managés. |
Managed |
Type de référence Réseau virtuel managé. |
Managed |
Type de référence Réseau virtuel managé. |
Package |
Magasin de packages pour le runtime d’intégration SSIS. |
Pipeline |
Propriétés PipelineExternalComputeScale pour le runtime d’intégration managée. |
Secure |
Azure Data Factory définition de chaîne sécurisée. La valeur de chaîne est masquée avec des astérisque '*' pendant les appels d’API Get ou List. |
Self |
Runtime d’intégration auto-hébergé. |
CloudError
Objet qui définit la structure d’une réponse d’erreur Azure Data Factory.
Nom | Type | Description |
---|---|---|
error.code |
string |
Code d’erreur. |
error.details |
Tableau avec des détails d’erreur supplémentaires. |
|
error.message |
string |
Message d’erreur. |
error.target |
string |
Nom de propriété/chemin d’accès dans la requête associée à l’erreur. |
CopyComputeScaleProperties
Propriétés CopyComputeScale pour le runtime d’intégration managée.
Nom | Type | Description |
---|---|---|
dataIntegrationUnit |
integer |
Paramètre de numéro DIU réservé à l’exécution de l’activité de copie. Les valeurs prises en charge sont des multiples de 4 dans la plage 4-256. |
timeToLive |
integer |
Paramètre de durée de vie (en minutes) du runtime d’intégration qui exécutera l’activité de copie. |
CredentialReference
Type de référence d’informations d’identification.
Nom | Type | Description |
---|---|---|
referenceName |
string |
Nom des informations d’identification de référence. |
type |
Type de référence d’informations d’identification. |
CredentialReferenceType
Type de référence d’informations d’identification.
Nom | Type | Description |
---|---|---|
CredentialReference |
string |
CustomProperties
Les propriétés personnalisées sont utilisées pour optimiser les performances du runtime du flux de données.
Nom | Type | Description |
---|---|---|
name |
string |
Nom de la propriété personnalisée. |
value |
string |
Valeur de la propriété personnalisée. |
DataFlowComputeType
Type de calcul du cluster qui exécutera le travail de flux de données.
Nom | Type | Description |
---|---|---|
ComputeOptimized |
string |
|
General |
string |
|
MemoryOptimized |
string |
EntityReference
Référence d’entité.
Nom | Type | Description |
---|---|---|
referenceName |
string |
Nom de cette entité référencée. |
type |
Type de cette entité référencée. |
IntegrationRuntimeComputeProperties
Propriétés des ressources de calcul pour le runtime d’intégration managée.
Nom | Type | Description |
---|---|---|
copyComputeScaleProperties |
Propriétés CopyComputeScale pour le runtime d’intégration managée. |
|
dataFlowProperties |
Propriétés de flux de données pour le runtime d’intégration managée. |
|
location |
string |
Emplacement du runtime d’intégration managée. Les régions prises en charge sont disponibles sur https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities |
maxParallelExecutionsPerNode |
integer |
Nombre maximal d’exécutions parallèles par nœud pour le runtime d’intégration managée. |
nodeSize |
string |
Exigence de taille de nœud pour le runtime d’intégration managée. |
numberOfNodes |
integer |
Nombre de nœuds requis pour le runtime d’intégration managée. |
pipelineExternalComputeScaleProperties |
Propriétés PipelineExternalComputeScale pour le runtime d’intégration managée. |
|
vNetProperties |
Propriétés de réseau virtuel pour le runtime d’intégration managée. |
IntegrationRuntimeCustomerVirtualNetwork
Définition et propriétés du réseau virtuel auquel le runtime d’intégration Azure-SSIS sera joint.
Nom | Type | Description |
---|---|---|
subnetId |
string |
ID du sous-réseau auquel le runtime d’intégration Azure-SSIS sera joint. |
IntegrationRuntimeCustomSetupScriptProperties
Propriétés de script d’installation personnalisées pour un runtime d’intégration dédié managé.
Nom | Type | Description |
---|---|---|
blobContainerUri |
string |
URI du conteneur d’objets blob Azure qui contient le script d’installation personnalisé. |
sasToken |
Jeton SAP du conteneur d’objets blob Azure. |
IntegrationRuntimeDataFlowProperties
Propriétés de flux de données pour le runtime d’intégration managée.
Nom | Type | Description |
---|---|---|
cleanup |
boolean |
Le cluster ne sera pas recyclé et il sera utilisé lors de la prochaine exécution de l’activité de flux de données jusqu’à ce que la durée de vie (durée de vie) soit atteinte si celle-ci est définie sur false. La valeur par défaut est true. |
computeType |
Type de calcul du cluster qui exécutera le travail de flux de données. |
|
coreCount |
integer |
Nombre de cœurs du cluster qui exécutera le travail de flux de données. Les valeurs prises en charge sont : 8, 16, 32, 48, 80, 144 et 272. |
customProperties |
Les propriétés personnalisées sont utilisées pour optimiser les performances du runtime du flux de données. |
|
timeToLive |
integer |
Paramètre Durée de vie (en minutes) du cluster qui exécutera le travail de flux de données. |
IntegrationRuntimeDataProxyProperties
Propriétés de proxy de données pour un runtime d’intégration dédié managé.
Nom | Type | Description |
---|---|---|
connectVia |
Référence du runtime d’intégration auto-hébergé. |
|
path |
string |
Chemin d’accès pour contenir les données intermédiaires dans le stockage Blob. |
stagingLinkedService |
Référence du service lié intermédiaire. |
IntegrationRuntimeEdition
Édition du Integration Runtime SSIS
Nom | Type | Description |
---|---|---|
Enterprise |
string |
|
Standard |
string |
IntegrationRuntimeEntityReferenceType
Type de cette entité référencée.
Nom | Type | Description |
---|---|---|
IntegrationRuntimeReference |
string |
|
LinkedServiceReference |
string |
IntegrationRuntimeLicenseType
Type de licence pour apporter votre propre scénario de licence.
Nom | Type | Description |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
IntegrationRuntimeResource
Type de ressource runtime d’intégration.
Nom | Type | Description |
---|---|---|
etag |
string |
Etag identifie les modifications apportées à la ressource. |
id |
string |
Identificateur de ressource. |
name |
string |
Nom de la ressource. |
properties | IntegrationRuntime: |
Propriétés du runtime d’intégration. |
type |
string |
Type de ressource. |
IntegrationRuntimeSsisCatalogInfo
Informations de catalogue pour le runtime d’intégration dédié managé.
Nom | Type | Description |
---|---|---|
catalogAdminPassword |
Mot de passe du compte d’utilisateur administrateur de la base de données du catalogue. |
|
catalogAdminUserName |
string |
Nom d’utilisateur administrateur de la base de données de catalogue. |
catalogPricingTier |
Niveau tarifaire de la base de données de catalogue. Les valeurs valides se trouvent dans https://azure.microsoft.com/en-us/pricing/details/sql-database/ |
|
catalogServerEndpoint |
string |
URL du serveur de base de données de catalogue. |
dualStandbyPairName |
string |
Nom de paire double secours des runtimes d’intégration Azure-SSIS pour prendre en charge le basculement SSISDB. |
IntegrationRuntimeSsisCatalogPricingTier
Niveau tarifaire de la base de données de catalogue. Les valeurs valides se trouvent dans https://azure.microsoft.com/en-us/pricing/details/sql-database/
Nom | Type | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
PremiumRS |
string |
|
Standard |
string |
IntegrationRuntimeSsisProperties
Propriétés SSIS pour le runtime d’intégration managée.
Nom | Type | Description |
---|---|---|
catalogInfo |
Informations de catalogue pour le runtime d’intégration dédié managé. |
|
credential |
Référence des informations d’identification contenant des informations d’authentification. |
|
customSetupScriptProperties |
Propriétés de script d’installation personnalisées pour un runtime d’intégration dédié managé. |
|
dataProxyProperties |
Propriétés de proxy de données pour un runtime d’intégration dédié managé. |
|
edition |
Édition du Integration Runtime SSIS |
|
expressCustomSetupProperties |
Custom |
Installation personnalisée sans propriétés de script pour un runtime d’intégration SSIS. |
licenseType |
Type de licence pour apporter votre propre scénario de licence. |
|
packageStores |
Magasins de packages pour le Integration Runtime SSIS. |
IntegrationRuntimeState
État du runtime d’intégration.
Nom | Type | Description |
---|---|---|
AccessDenied |
string |
|
Initial |
string |
|
Limited |
string |
|
NeedRegistration |
string |
|
Offline |
string |
|
Online |
string |
|
Started |
string |
|
Starting |
string |
|
Stopped |
string |
|
Stopping |
string |
IntegrationRuntimeType
Type de runtime d’intégration.
Nom | Type | Description |
---|---|---|
Managed |
string |
|
SelfHosted |
string |
IntegrationRuntimeVNetProperties
Propriétés de réseau virtuel pour le runtime d’intégration managée.
Nom | Type | Description |
---|---|---|
publicIPs |
string[] |
ID de ressource des adresses IP publiques que ce runtime d’intégration utilisera. |
subnet |
string |
Nom du sous-réseau que ce runtime d’intégration doit rejoindre. |
subnetId |
string |
ID du sous-réseau auquel ce runtime d’intégration Azure-SSIS sera joint. |
vNetId |
string |
ID du réseau virtuel auquel ce runtime d’intégration doit rejoindre. |
LinkedIntegrationRuntimeKeyAuthorization
Runtime d’intégration du type d’autorisation de clé.
Nom | Type | Description |
---|---|---|
authorizationType |
string:
Key |
Type d’autorisation pour le partage du runtime d’intégration. |
key |
Clé utilisée pour l’autorisation. |
LinkedIntegrationRuntimeRbacAuthorization
Runtime d’intégration du type d’autorisation RBAC (Contrôle d’accès en fonction du rôle).
Nom | Type | Description |
---|---|---|
authorizationType |
string:
RBAC |
Type d’autorisation pour le partage du runtime d’intégration. |
credential |
Référence des informations d’identification contenant des informations d’authentification. |
|
resourceId |
string |
Identificateur de ressource du runtime d’intégration à partager. |
ManagedIntegrationRuntime
Runtime d’intégration managée, y compris les runtimes d’intégration dédiés managés et élastiques managés.
Nom | Type | Description |
---|---|---|
description |
string |
Description du runtime d’intégration. |
managedVirtualNetwork |
Référence Réseau virtuel managée. |
|
state |
État du runtime d’intégration, valide uniquement pour le runtime d’intégration dédié managé. |
|
type |
string:
Managed |
Type de runtime d’intégration. |
typeProperties.computeProperties |
Ressource de calcul pour le runtime d’intégration managée. |
|
typeProperties.customerVirtualNetwork |
Nom du réseau virtuel auquel le runtime d’intégration Azure-SSIS sera joint |
|
typeProperties.ssisProperties |
Propriétés SSIS pour le runtime d’intégration managée. |
ManagedVirtualNetworkReference
Type de référence Réseau virtuel managé.
Nom | Type | Description |
---|---|---|
referenceName |
string |
Référencez le nom ManagedVirtualNetwork. |
type |
Type de référence Réseau virtuel managé. |
ManagedVirtualNetworkReferenceType
Type de référence Réseau virtuel managé.
Nom | Type | Description |
---|---|---|
ManagedVirtualNetworkReference |
string |
PackageStore
Magasin de packages pour le runtime d’intégration SSIS.
Nom | Type | Description |
---|---|---|
name |
string |
Nom du magasin de packages |
packageStoreLinkedService |
Référence du service lié du magasin de packages. |
PipelineExternalComputeScaleProperties
Propriétés PipelineExternalComputeScale pour le runtime d’intégration managée.
Nom | Type | Description |
---|---|---|
numberOfExternalNodes |
integer |
Nombre des nœuds externes, qui doit être supérieur à 0 et inférieur à 11. |
numberOfPipelineNodes |
integer |
Nombre de nœuds de pipeline, qui doit être supérieur à 0 et inférieur à 11. |
timeToLive |
integer |
Paramètre de durée de vie (en minutes) du runtime d’intégration qui exécutera le pipeline et l’activité externe. |
SecureString
Azure Data Factory définition de chaîne sécurisée. La valeur de chaîne est masquée avec des astérisque '*' pendant les appels d’API Get ou List.
Nom | Type | Description |
---|---|---|
type | string: |
Type du secret. |
value |
string |
Valeur de la chaîne sécurisée. |
SelfHostedIntegrationRuntime
Runtime d’intégration auto-hébergé.
Nom | Type | Description |
---|---|---|
description |
string |
Description du runtime d’intégration. |
type |
string:
Self |
Type de runtime d’intégration. |
typeProperties.linkedInfo | LinkedIntegrationRuntimeType: |
Définition de base d’un runtime d’intégration lié. |
typeProperties.selfContainedInteractiveAuthoringEnabled |
boolean |
Une autre option pour garantir la fonction de création interactive lorsque votre runtime d’intégration auto-hébergé ne parvient pas à établir une connexion avec Azure Relay. |