Integration Runtimes - Create Or Update
Crea o actualiza un entorno de ejecución de integración.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}?api-version=2018-06-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
factory
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ |
Nombre de fábrica. |
integration
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ |
Nombre del entorno de ejecución de integración. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nombre del grupo de recursos. |
subscription
|
path | True |
string |
Identificador de la suscripción. |
api-version
|
query | True |
string |
La versión de la API. |
Encabezado de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
If-Match |
string |
ETag de la entidad integration Runtime. Solo se debe especificar para la actualización, para la que debe coincidir con la entidad existente o puede ser * para la actualización incondicional. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
properties | True | IntegrationRuntime: |
Propiedades de Integration Runtime. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo. |
|
Other Status Codes |
Respuesta de error recibida de la operación PUT integration Runtime. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantar la cuenta de usuario |
Ejemplos
IntegrationRuntimes_Create
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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"
}
Definiciones
Nombre | Description |
---|---|
Cloud |
Objeto que define la estructura de una respuesta de error de Azure Data Factory. |
Copy |
Propiedades copyComputeScale para el entorno de ejecución de integración administrado. |
Credential |
Tipo de referencia de credencial. |
Credential |
Tipo de referencia de credencial. |
Custom |
Las propiedades personalizadas se usan para ajustar el rendimiento del entorno de ejecución del flujo de datos. |
Data |
Tipo de proceso del clúster que ejecutará el trabajo de flujo de datos. |
Entity |
Referencia de entidad. |
Integration |
Propiedades de recursos de proceso para managed integration Runtime. |
Integration |
Definición y propiedades de la red virtual a la que se unirá Azure-SSIS integration Runtime. |
Integration |
Propiedades del script de instalación personalizada para un entorno de ejecución de integración dedicado administrado. |
Integration |
Propiedades de flujo de datos para el entorno de ejecución de integración administrado. |
Integration |
Propiedades de proxy de datos para un entorno de ejecución de integración dedicado administrado. |
Integration |
Edición de SSIS Integration Runtime |
Integration |
Tipo de esta entidad a la que se hace referencia. |
Integration |
Tipo de licencia para traer su propio escenario de licencia. |
Integration |
Tipo de recurso de Integration Runtime. |
Integration |
Información del catálogo para el entorno de ejecución de integración dedicado administrado. |
Integration |
Plan de tarifa de la base de datos de catálogo. Los valores válidos se pueden encontrar en https://azure.microsoft.com/en-us/pricing/details/sql-database/ |
Integration |
Propiedades de SSIS para el entorno de ejecución de integración administrado. |
Integration |
Estado del entorno de ejecución de integración. |
Integration |
Tipo de entorno de ejecución de integración. |
Integration |
Propiedades de red virtual para el entorno de ejecución de integración administrado. |
Linked |
El tipo de autorización de clave integration Runtime. |
Linked |
El tipo de autorización de control de acceso basado en rol (RBAC) integration Runtime. |
Managed |
Entorno de ejecución de integración administrado, incluidos los entornos de ejecución de integración dedicados administrados y el elásticos administrados. |
Managed |
Tipo de referencia de red virtual administrada. |
Managed |
Tipo de referencia de red virtual administrada. |
Package |
Almacén de paquetes para el entorno de ejecución de integración de SSIS. |
Pipeline |
Propiedades PipelineExternalComputeScale para el entorno de ejecución de integración administrado. |
Secure |
Definición de cadena segura de Azure Data Factory. El valor de cadena se enmascarará con asteriscos '*' durante las llamadas API Get o List. |
Self |
Entorno de ejecución de integración autohospedado. |
CloudError
Objeto que define la estructura de una respuesta de error de Azure Data Factory.
Nombre | Tipo | Description |
---|---|---|
error.code |
string |
Código de error. |
error.details |
Matriz con detalles de error adicionales. |
|
error.message |
string |
Mensaje de error. |
error.target |
string |
Nombre o ruta de acceso de propiedad en la solicitud asociada al error. |
CopyComputeScaleProperties
Propiedades copyComputeScale para el entorno de ejecución de integración administrado.
Nombre | Tipo | Description |
---|---|---|
dataIntegrationUnit |
integer (int32) minimum: 4 |
Configuración de número de DIU reservada para la ejecución de la actividad de copia. Los valores admitidos son múltiplos de 4 en el intervalo 4-256. |
timeToLive |
integer (int32) minimum: 5 |
Configuración de período de vida (en minutos) de Integration Runtime que ejecutará la actividad de copia. |
CredentialReference
Tipo de referencia de credencial.
Nombre | Tipo | Description |
---|---|---|
referenceName |
string |
Nombre de credencial de referencia. |
type |
Tipo de referencia de credencial. |
CredentialReferenceType
Tipo de referencia de credencial.
Valor | Description |
---|---|
CredentialReference |
CustomProperties
Las propiedades personalizadas se usan para ajustar el rendimiento del entorno de ejecución del flujo de datos.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre de la propiedad personalizada. |
value |
string |
Valor de la propiedad personalizada. |
DataFlowComputeType
Tipo de proceso del clúster que ejecutará el trabajo de flujo de datos.
Valor | Description |
---|---|
ComputeOptimized | |
General | |
MemoryOptimized |
EntityReference
Referencia de entidad.
Nombre | Tipo | Description |
---|---|---|
referenceName |
string |
Nombre de esta entidad a la que se hace referencia. |
type |
Tipo de esta entidad a la que se hace referencia. |
IntegrationRuntimeComputeProperties
Propiedades de recursos de proceso para managed integration Runtime.
Nombre | Tipo | Description |
---|---|---|
copyComputeScaleProperties |
Propiedades copyComputeScale para el entorno de ejecución de integración administrado. |
|
dataFlowProperties |
Propiedades de flujo de datos para el entorno de ejecución de integración administrado. |
|
location |
string |
Ubicación del entorno de ejecución de integración administrado. Las regiones admitidas se pueden encontrar en https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities |
maxParallelExecutionsPerNode |
integer minimum: 1 |
Número máximo de ejecuciones paralelas por nodo para el entorno de ejecución de integración administrado. |
nodeSize |
string |
Requisito de tamaño de nodo para el entorno de ejecución de integración administrado. |
numberOfNodes |
integer minimum: 1 |
El número necesario de nodos para el entorno de ejecución de integración administrado. |
pipelineExternalComputeScaleProperties |
Propiedades PipelineExternalComputeScale para el entorno de ejecución de integración administrado. |
|
vNetProperties |
Propiedades de red virtual para el entorno de ejecución de integración administrado. |
IntegrationRuntimeCustomerVirtualNetwork
Definición y propiedades de la red virtual a la que se unirá Azure-SSIS integration Runtime.
Nombre | Tipo | Description |
---|---|---|
subnetId |
string |
Identificador de la subred a la que se unirá Azure-SSIS integration Runtime. |
IntegrationRuntimeCustomSetupScriptProperties
Propiedades del script de instalación personalizada para un entorno de ejecución de integración dedicado administrado.
Nombre | Tipo | Description |
---|---|---|
blobContainerUri |
string |
URI del contenedor de blobs de Azure que contiene el script de instalación personalizado. |
sasToken |
Token de SAS del contenedor de blobs de Azure. |
IntegrationRuntimeDataFlowProperties
Propiedades de flujo de datos para el entorno de ejecución de integración administrado.
Nombre | Tipo | Description |
---|---|---|
cleanup |
boolean |
El clúster no se reciclará y se usará en la siguiente ejecución de actividad de flujo de datos hasta que se alcance TTL (período de vida) si se establece como false. El valor predeterminado es true. |
computeType |
Tipo de proceso del clúster que ejecutará el trabajo de flujo de datos. |
|
coreCount |
integer |
Recuento básico del clúster que ejecutará el trabajo de flujo de datos. Los valores admitidos son: 8, 16, 32, 48, 80, 144 y 272. |
customProperties |
Las propiedades personalizadas se usan para ajustar el rendimiento del entorno de ejecución del flujo de datos. |
|
timeToLive |
integer minimum: 0 |
Configuración de período de vida (en minutos) del clúster que ejecutará el trabajo de flujo de datos. |
IntegrationRuntimeDataProxyProperties
Propiedades de proxy de datos para un entorno de ejecución de integración dedicado administrado.
Nombre | Tipo | Description |
---|---|---|
connectVia |
Referencia del entorno de ejecución de integración autohospedado. |
|
path |
string |
Ruta de acceso que contiene los datos almacenados provisionalmente en Blob Storage. |
stagingLinkedService |
Referencia del servicio vinculado de almacenamiento provisional. |
IntegrationRuntimeEdition
Edición de SSIS Integration Runtime
Valor | Description |
---|---|
Enterprise | |
Standard |
IntegrationRuntimeEntityReferenceType
Tipo de esta entidad a la que se hace referencia.
Valor | Description |
---|---|
IntegrationRuntimeReference | |
LinkedServiceReference |
IntegrationRuntimeLicenseType
Tipo de licencia para traer su propio escenario de licencia.
Valor | Description |
---|---|
BasePrice | |
LicenseIncluded |
IntegrationRuntimeResource
Tipo de recurso de Integration Runtime.
Nombre | Tipo | Description |
---|---|---|
etag |
string |
Etag identifica el cambio en el recurso. |
id |
string |
Identificador de recurso. |
name |
string |
Nombre del recurso. |
properties | IntegrationRuntime: |
Propiedades de Integration Runtime. |
type |
string |
Tipo de recurso. |
IntegrationRuntimeSsisCatalogInfo
Información del catálogo para el entorno de ejecución de integración dedicado administrado.
Nombre | Tipo | Description |
---|---|---|
catalogAdminPassword |
Contraseña de la cuenta de usuario administrador de la base de datos del catálogo. |
|
catalogAdminUserName |
string minLength: 1maxLength: 128 |
Nombre de usuario de administrador de la base de datos de catálogo. |
catalogPricingTier |
Plan de tarifa de la base de datos de catálogo. Los valores válidos se pueden encontrar en https://azure.microsoft.com/en-us/pricing/details/sql-database/ |
|
catalogServerEndpoint |
string |
Dirección URL del servidor de base de datos del catálogo. |
dualStandbyPairName |
string |
El nombre del par de espera dual de Azure-SSIS Integration Runtimes para admitir la conmutación por error de SSISDB. |
IntegrationRuntimeSsisCatalogPricingTier
Plan de tarifa de la base de datos de catálogo. Los valores válidos se pueden encontrar en https://azure.microsoft.com/en-us/pricing/details/sql-database/
Valor | Description |
---|---|
Basic | |
Premium | |
PremiumRS | |
Standard |
IntegrationRuntimeSsisProperties
Propiedades de SSIS para el entorno de ejecución de integración administrado.
Nombre | Tipo | Description |
---|---|---|
catalogInfo |
Información del catálogo para el entorno de ejecución de integración dedicado administrado. |
|
credential |
Referencia de credenciales que contiene información de autenticación. |
|
customSetupScriptProperties |
Propiedades del script de instalación personalizada para un entorno de ejecución de integración dedicado administrado. |
|
dataProxyProperties |
Propiedades de proxy de datos para un entorno de ejecución de integración dedicado administrado. |
|
edition |
Edición de SSIS Integration Runtime |
|
expressCustomSetupProperties |
Custom |
Configuración personalizada sin propiedades de script para un entorno de ejecución de integración de SSIS. |
licenseType |
Tipo de licencia para traer su propio escenario de licencia. |
|
packageStores |
Almacenes de paquetes para SSIS Integration Runtime. |
IntegrationRuntimeState
Estado del entorno de ejecución de integración.
Valor | Description |
---|---|
AccessDenied | |
Initial | |
Limited | |
NeedRegistration | |
Offline | |
Online | |
Started | |
Starting | |
Stopped | |
Stopping |
IntegrationRuntimeType
Tipo de entorno de ejecución de integración.
Valor | Description |
---|---|
Managed | |
SelfHosted |
IntegrationRuntimeVNetProperties
Propiedades de red virtual para el entorno de ejecución de integración administrado.
Nombre | Tipo | Description |
---|---|---|
publicIPs |
string[] |
Identificadores de recursos de las direcciones IP públicas que usará este entorno de ejecución de integración. |
subnet |
string |
Nombre de la subred a la que se unirá este entorno de ejecución de integración. |
subnetId |
string |
El identificador de la subred, al que se unirá este Azure-SSIS integration Runtime. |
vNetId |
string |
Identificador de la red virtual a la que se unirá este entorno de ejecución de integración. |
LinkedIntegrationRuntimeKeyAuthorization
El tipo de autorización de clave integration Runtime.
Nombre | Tipo | Description |
---|---|---|
authorizationType |
string:
Key |
Tipo de autorización para el uso compartido de Integration Runtime. |
key |
Clave que se usa para la autorización. |
LinkedIntegrationRuntimeRbacAuthorization
El tipo de autorización de control de acceso basado en rol (RBAC) integration Runtime.
Nombre | Tipo | Description |
---|---|---|
authorizationType |
string:
RBAC |
Tipo de autorización para el uso compartido de Integration Runtime. |
credential |
Referencia de credenciales que contiene información de autenticación. |
|
resourceId |
string |
Identificador de recurso del entorno de ejecución de integración que se va a compartir. |
ManagedIntegrationRuntime
Entorno de ejecución de integración administrado, incluidos los entornos de ejecución de integración dedicados administrados y el elásticos administrados.
Nombre | Tipo | Description |
---|---|---|
description |
string |
Descripción del entorno de ejecución de integración. |
managedVirtualNetwork |
Referencia de red virtual administrada. |
|
state |
Estado del entorno de ejecución de integración, solo válido para el entorno de ejecución de integración dedicado administrado. |
|
type |
string:
Managed |
Tipo de entorno de ejecución de integración. |
typeProperties.computeProperties |
Recurso de proceso para el entorno de ejecución de integración administrado. |
|
typeProperties.customerVirtualNetwork |
Nombre de la red virtual a la que se unirá Azure-SSIS integration Runtime. |
|
typeProperties.ssisProperties |
Propiedades de SSIS para el entorno de ejecución de integración administrado. |
ManagedVirtualNetworkReference
Tipo de referencia de red virtual administrada.
Nombre | Tipo | Description |
---|---|---|
referenceName |
string |
Haga referencia al nombre managedVirtualNetwork. |
type |
Tipo de referencia de red virtual administrada. |
ManagedVirtualNetworkReferenceType
Tipo de referencia de red virtual administrada.
Valor | Description |
---|---|
ManagedVirtualNetworkReference |
PackageStore
Almacén de paquetes para el entorno de ejecución de integración de SSIS.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre del almacén de paquetes |
packageStoreLinkedService |
Referencia del servicio vinculado del almacén de paquetes. |
PipelineExternalComputeScaleProperties
Propiedades PipelineExternalComputeScale para el entorno de ejecución de integración administrado.
Nombre | Tipo | Description |
---|---|---|
numberOfExternalNodes |
integer (int32) minimum: 1maximum: 10 |
Número de los nodos externos, que deben ser mayores que 0 y menores que 11. |
numberOfPipelineNodes |
integer (int32) minimum: 1maximum: 10 |
Número de nodos de canalización, que deben ser mayores que 0 y menores que 11. |
timeToLive |
integer (int32) minimum: 5 |
Configuración de período de vida (en minutos) de Integration Runtime que ejecutará la canalización y la actividad externa. |
SecureString
Definición de cadena segura de Azure Data Factory. El valor de cadena se enmascarará con asteriscos '*' durante las llamadas API Get o List.
Nombre | Tipo | Description |
---|---|---|
type | string: |
Tipo del secreto. |
value |
string |
Valor de cadena segura. |
SelfHostedIntegrationRuntime
Entorno de ejecución de integración autohospedado.
Nombre | Tipo | Description |
---|---|---|
description |
string |
Descripción del entorno de ejecución de integración. |
type |
string:
Self |
Tipo de entorno de ejecución de integración. |
typeProperties.linkedInfo | LinkedIntegrationRuntimeType: |
Definición base de un entorno de ejecución de integración vinculado. |
typeProperties.selfContainedInteractiveAuthoringEnabled |
boolean |
Una opción alternativa para garantizar la función de creación interactiva cuando el entorno de ejecución de integración autohospedado no puede establecer una conexión con Azure Relay. |