Compartir a través de


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
factoryName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

Nombre de fábrica.

integrationRuntimeName
path True

string

minLength: 3
maxLength: 63
pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

Nombre del entorno de ejecución de integración.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Nombre del grupo de recursos.

subscriptionId
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

IntegrationRuntimeResource

De acuerdo.

Other Status Codes

CloudError

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
CloudError

Objeto que define la estructura de una respuesta de error de Azure Data Factory.

CopyComputeScaleProperties

Propiedades copyComputeScale para el entorno de ejecución de integración administrado.

CredentialReference

Tipo de referencia de credencial.

CredentialReferenceType

Tipo de referencia de credencial.

CustomProperties

Las propiedades personalizadas se usan para ajustar el rendimiento del entorno de ejecución del flujo de datos.

DataFlowComputeType

Tipo de proceso del clúster que ejecutará el trabajo de flujo de datos.

EntityReference

Referencia de entidad.

IntegrationRuntimeComputeProperties

Propiedades de recursos de proceso para managed integration Runtime.

IntegrationRuntimeCustomerVirtualNetwork

Definición y propiedades de la red virtual 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.

IntegrationRuntimeDataFlowProperties

Propiedades de flujo de datos para el entorno de ejecución de integración administrado.

IntegrationRuntimeDataProxyProperties

Propiedades de proxy de datos para un entorno de ejecución de integración dedicado administrado.

IntegrationRuntimeEdition

Edición de SSIS Integration Runtime

IntegrationRuntimeEntityReferenceType

Tipo de esta entidad a la que se hace referencia.

IntegrationRuntimeLicenseType

Tipo de licencia para traer su propio escenario de licencia.

IntegrationRuntimeResource

Tipo de recurso de Integration Runtime.

IntegrationRuntimeSsisCatalogInfo

Información del catálogo para el entorno de ejecución de integración dedicado administrado.

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/

IntegrationRuntimeSsisProperties

Propiedades de SSIS para el entorno de ejecución de integración administrado.

IntegrationRuntimeState

Estado del entorno de ejecución de integración.

IntegrationRuntimeType

Tipo de entorno de ejecución de integración.

IntegrationRuntimeVNetProperties

Propiedades de red virtual para el entorno de ejecución de integración administrado.

LinkedIntegrationRuntimeKeyAuthorization

El tipo de autorización de clave integration Runtime.

LinkedIntegrationRuntimeRbacAuthorization

El tipo de autorización de control de acceso basado en rol (RBAC) integration Runtime.

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.

ManagedVirtualNetworkReference

Tipo de referencia de red virtual administrada.

ManagedVirtualNetworkReferenceType

Tipo de referencia de red virtual administrada.

PackageStore

Almacén de paquetes para el entorno de ejecución de integración de SSIS.

PipelineExternalComputeScaleProperties

Propiedades PipelineExternalComputeScale para el entorno de ejecución de integración administrado.

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.

SelfHostedIntegrationRuntime

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

CloudError[]

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

CredentialReferenceType

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

IntegrationRuntimeEntityReferenceType

Tipo de esta entidad a la que se hace referencia.

IntegrationRuntimeComputeProperties

Propiedades de recursos de proceso para managed integration Runtime.

Nombre Tipo Description
copyComputeScaleProperties

CopyComputeScaleProperties

Propiedades copyComputeScale para el entorno de ejecución de integración administrado.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

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

PipelineExternalComputeScaleProperties

Propiedades PipelineExternalComputeScale para el entorno de ejecución de integración administrado.

vNetProperties

IntegrationRuntimeVNetProperties

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

SecureString

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

DataFlowComputeType

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

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

EntityReference

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

EntityReference

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

SecureString

Contraseña de la cuenta de usuario administrador de la base de datos del catálogo.

catalogAdminUserName

string

minLength: 1
maxLength: 128

Nombre de usuario de administrador de la base de datos de catálogo.

catalogPricingTier

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/

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

IntegrationRuntimeSsisCatalogInfo

Información del catálogo para el entorno de ejecución de integración dedicado administrado.

credential

CredentialReference

Referencia de credenciales que contiene información de autenticación.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

Propiedades del script de instalación personalizada para un entorno de ejecución de integración dedicado administrado.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

Propiedades de proxy de datos para un entorno de ejecución de integración dedicado administrado.

edition

IntegrationRuntimeEdition

Edición de SSIS Integration Runtime

expressCustomSetupProperties

CustomSetupBase[]

Configuración personalizada sin propiedades de script para un entorno de ejecución de integración de SSIS.

licenseType

IntegrationRuntimeLicenseType

Tipo de licencia para traer su propio escenario de licencia.

packageStores

PackageStore[]

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

SecureString

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

CredentialReference

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

ManagedVirtualNetworkReference

Referencia de red virtual administrada.

state

IntegrationRuntimeState

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

IntegrationRuntimeComputeProperties

Recurso de proceso para el entorno de ejecución de integración administrado.

typeProperties.customerVirtualNetwork

IntegrationRuntimeCustomerVirtualNetwork

Nombre de la red virtual a la que se unirá Azure-SSIS integration Runtime.

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

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

ManagedVirtualNetworkReferenceType

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

EntityReference

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: 1
maximum: 10

Número de los nodos externos, que deben ser mayores que 0 y menores que 11.

numberOfPipelineNodes

integer (int32)

minimum: 1
maximum: 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:

SecureString

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:

SelfHosted

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.