你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Integration Runtimes - Create Or Update

服务:: Data Factory

API 版本:: 2018-06-01

创建或更新集成运行时。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}?api-version=2018-06-01

URI 参数

名称	在	必需	类型	说明
factoryName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	工厂名称。
integrationRuntimeName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	集成运行时名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	资源组名称。
subscriptionId	path	True	string	订阅标识符。
api-version	query	True	string	API 版本。

请求头

名称	必需	类型	说明
If-Match		string	集成运行时实体的 ETag。应仅指定用于更新，应将其与现有实体匹配，也可以为 * 进行无条件更新。

请求正文

名称	必需	类型	说明
properties	True	IntegrationRuntime: ManagedIntegrationRuntime SelfHostedIntegrationRuntime	集成运行时属性。

响应

名称	类型	说明
200 OK	IntegrationRuntimeResource	还行。
Other Status Codes	CloudError	从 PUT 集成运行时操作收到的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

IntegrationRuntimes_Create

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"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataFactory.Models;
using Azure.ResourceManager.DataFactory;

// Generated from example definition: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/IntegrationRuntimes_Create.json
// this example is just showing the usage of "IntegrationRuntimes_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataFactoryResource created on azure
// for more information of creating DataFactoryResource, please refer to the document of DataFactoryResource
string subscriptionId = "12345678-1234-1234-1234-12345678abc";
string resourceGroupName = "exampleResourceGroup";
string factoryName = "exampleFactoryName";
ResourceIdentifier dataFactoryResourceId = DataFactoryResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, factoryName);
DataFactoryResource dataFactory = client.GetDataFactoryResource(dataFactoryResourceId);

// get the collection of this DataFactoryIntegrationRuntimeResource
DataFactoryIntegrationRuntimeCollection collection = dataFactory.GetDataFactoryIntegrationRuntimes();

// invoke the operation
string integrationRuntimeName = "exampleIntegrationRuntime";
DataFactoryIntegrationRuntimeData data = new DataFactoryIntegrationRuntimeData(new SelfHostedIntegrationRuntime
{
    Description = "A selfhosted integration runtime",
});
ArmOperation<DataFactoryIntegrationRuntimeResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, integrationRuntimeName, data);
DataFactoryIntegrationRuntimeResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
DataFactoryIntegrationRuntimeData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 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.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"
}

定义

名称	说明
CloudError	定义 Azure 数据工厂错误响应结构的对象。
CopyComputeScaleProperties	托管集成运行时的 CopyComputeScale 属性。
CredentialReference	凭据引用类型。
CredentialReferenceType	凭据引用类型。
CustomProperties	自定义属性用于优化数据流运行时性能。
DataFlowComputeType	将执行数据流作业的群集的计算类型。
EntityReference	实体引用。
IntegrationRuntimeComputeProperties	托管集成运行时的计算资源属性。
IntegrationRuntimeCustomerVirtualNetwork	Azure-SSIS 集成运行时要加入的虚拟网络的定义和属性。
IntegrationRuntimeCustomSetupScriptProperties	托管专用集成运行时的自定义设置脚本属性。
IntegrationRuntimeDataFlowProperties	托管集成运行时的数据流属性。
IntegrationRuntimeDataProxyProperties	托管专用集成运行时的数据代理属性。
IntegrationRuntimeEdition	SSIS Integration Runtime 的版本
IntegrationRuntimeEntityReferenceType	此引用实体的类型。
IntegrationRuntimeLicenseType	用于自带许可证方案的许可证类型。
IntegrationRuntimeResource	集成运行时资源类型。
IntegrationRuntimeSsisCatalogInfo	托管专用集成运行时的目录信息。
IntegrationRuntimeSsisCatalogPricingTier	目录数据库的定价层。可以在 https://azure.microsoft.com/en-us/pricing/details/sql-database/ 中找到有效值
IntegrationRuntimeSsisProperties	托管集成运行时的 SSIS 属性。
IntegrationRuntimeState	集成运行时的状态。
IntegrationRuntimeType	集成运行时的类型。
IntegrationRuntimeVNetProperties	托管集成运行时的 VNet 属性。
InteractiveCapabilityStatus	交互式创作功能状态。必须是 InteractiveCapabilityStatus 之一。默认值为“启用”。
InteractiveQueryProperties	交互式创作功能类型属性。
LinkedIntegrationRuntimeKeyAuthorization	密钥授权类型集成运行时。
LinkedIntegrationRuntimeRbacAuthorization	基于角色的访问控制（RBAC）授权类型集成运行时。
ManagedIntegrationRuntime	托管集成运行时，包括托管的弹性和托管的专用集成运行时。
ManagedVirtualNetworkReference	托管虚拟网络引用类型。
ManagedVirtualNetworkReferenceType	托管虚拟网络引用类型。
PackageStore	SSIS 集成运行时的包存储。
PipelineExternalComputeScaleProperties	托管集成运行时的 PipelineExternalComputeScale 属性。
SecureString	Azure 数据工厂安全字符串定义。在获取或列出 API 调用期间，字符串值将用星号“*”屏蔽。
SelfHostedIntegrationRuntime	自承载集成运行时。

CloudError

对象

定义 Azure 数据工厂错误响应结构的对象。

名称	类型	说明
error.code	string	错误代码。
error.details	CloudError[]	包含其他错误详细信息的数组。
error.message	string	错误信息。
error.target	string	与错误关联的请求中的属性名称/路径。

CopyComputeScaleProperties

对象

托管集成运行时的 CopyComputeScale 属性。

名称	类型	说明
dataIntegrationUnit	integer (int32) minimum: 4	为复制活动执行保留的 DIU 编号设置。支持的值是 4-256 范围内的 4 的倍数。
timeToLive	integer (int32) minimum: 5	集成运行时的生存时间（以分钟为单位），该设置将执行复制活动。

CredentialReference

对象

凭据引用类型。

名称	类型	说明
referenceName	string	引用凭据名称。
type	CredentialReferenceType	凭据引用类型。

CredentialReferenceType

枚举

凭据引用类型。

值	说明
CredentialReference

CustomProperties

对象

自定义属性用于优化数据流运行时性能。

名称	类型	说明
name	string	自定义属性的名称。
value	string	自定义属性的值。

DataFlowComputeType

枚举

将执行数据流作业的群集的计算类型。

值	说明
General
MemoryOptimized
ComputeOptimized

EntityReference

对象

实体引用。

名称	类型	说明
referenceName	string	此引用实体的名称。
type	IntegrationRuntimeEntityReferenceType	此引用实体的类型。

IntegrationRuntimeComputeProperties

对象

托管集成运行时的计算资源属性。

名称	类型	说明
copyComputeScaleProperties	CopyComputeScaleProperties	托管集成运行时的 CopyComputeScale 属性。
dataFlowProperties	IntegrationRuntimeDataFlowProperties	托管集成运行时的数据流属性。
location	string	托管集成运行时的位置。可在 https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities 找到支持的区域
maxParallelExecutionsPerNode	integer minimum: 1	托管集成运行时每个节点的最大并行执行计数。
nodeSize	string	托管集成运行时的节点大小要求。
numberOfNodes	integer minimum: 1	托管集成运行时所需的节点数。
pipelineExternalComputeScaleProperties	PipelineExternalComputeScaleProperties	托管集成运行时的 PipelineExternalComputeScale 属性。
vNetProperties	IntegrationRuntimeVNetProperties	托管集成运行时的 VNet 属性。

IntegrationRuntimeCustomerVirtualNetwork

对象

Azure-SSIS 集成运行时要加入的虚拟网络的定义和属性。

名称	类型	说明
subnetId	string	Azure-SSIS 集成运行时要加入的子网的 ID。

IntegrationRuntimeCustomSetupScriptProperties

对象

托管专用集成运行时的自定义设置脚本属性。

名称	类型	说明
blobContainerUri	string	包含自定义安装脚本的 Azure Blob 容器的 URI。
sasToken	SecureString	Azure Blob 容器的 SAS 令牌。

IntegrationRuntimeDataFlowProperties

对象

托管集成运行时的数据流属性。

名称	类型	说明
cleanup	boolean	群集不会回收，并且将在下一个数据流活动运行中使用，直到达到 TTL（生存时间）（如果设置为 false）。默认值为 true。
computeType	DataFlowComputeType	将执行数据流作业的群集的计算类型。
coreCount	integer	将执行数据流作业的群集的核心计数。支持的值为：8、16、32、48、80、144 和 272。
customProperties	CustomProperties[]	自定义属性用于优化数据流运行时性能。
timeToLive	integer minimum: 0	将执行数据流作业的群集生存时间（以分钟为单位）。

IntegrationRuntimeDataProxyProperties

对象

托管专用集成运行时的数据代理属性。

名称	类型	说明
connectVia	EntityReference	自承载集成运行时参考。
path	string	包含 Blob 存储中暂存数据的路径。
stagingLinkedService	EntityReference	暂存链接服务引用。

IntegrationRuntimeEdition

枚举

SSIS Integration Runtime 的版本

值	说明
Standard
Enterprise

IntegrationRuntimeEntityReferenceType

枚举

此引用实体的类型。

值	说明
IntegrationRuntimeReference
LinkedServiceReference

IntegrationRuntimeLicenseType

枚举

用于自带许可证方案的许可证类型。

值	说明
BasePrice
LicenseIncluded

IntegrationRuntimeResource

对象

集成运行时资源类型。

名称	类型	说明
etag	string	Etag 标识资源中的更改。
id	string	资源标识符。
name	string	资源名称。
properties	IntegrationRuntime: ManagedIntegrationRuntime SelfHostedIntegrationRuntime	集成运行时属性。
type	string	资源类型。

IntegrationRuntimeSsisCatalogInfo

对象

托管专用集成运行时的目录信息。

名称	类型	说明
catalogAdminPassword	SecureString	目录数据库的管理员用户帐户的密码。
catalogAdminUserName	string minLength: 1 maxLength: 128	目录数据库的管理员用户名。
catalogPricingTier	IntegrationRuntimeSsisCatalogPricingTier	目录数据库的定价层。可以在 https://azure.microsoft.com/en-us/pricing/details/sql-database/ 中找到有效值
catalogServerEndpoint	string	目录数据库服务器 URL。
dualStandbyPairName	string	用于支持 SSISDB 故障转移的 Azure-SSIS Integration Runtime 的双备用对名称。

IntegrationRuntimeSsisCatalogPricingTier

枚举

目录数据库的定价层。可以在 https://azure.microsoft.com/en-us/pricing/details/sql-database/ 中找到有效值

值	说明
Basic
Standard
Premium
PremiumRS

IntegrationRuntimeSsisProperties

对象

托管集成运行时的 SSIS 属性。

名称	类型	说明
catalogInfo	IntegrationRuntimeSsisCatalogInfo	托管专用集成运行时的目录信息。
credential	CredentialReference	包含身份验证信息的凭据引用。
customSetupScriptProperties	IntegrationRuntimeCustomSetupScriptProperties	托管专用集成运行时的自定义设置脚本属性。
dataProxyProperties	IntegrationRuntimeDataProxyProperties	托管专用集成运行时的数据代理属性。
edition	IntegrationRuntimeEdition	SSIS Integration Runtime 的版本
expressCustomSetupProperties	CustomSetupBase[]	没有 SSIS 集成运行时的脚本属性的自定义设置。
licenseType	IntegrationRuntimeLicenseType	用于自带许可证方案的许可证类型。
packageStores	PackageStore[]	SSIS Integration Runtime 的包存储。

IntegrationRuntimeState

枚举

集成运行时的状态。

值	说明
Initial
Stopped
Started
Starting
Stopping
NeedRegistration
Online
Limited
Offline
AccessDenied

IntegrationRuntimeType

枚举

集成运行时的类型。

值	说明
Managed
SelfHosted

IntegrationRuntimeVNetProperties

对象

托管集成运行时的 VNet 属性。

名称	类型	说明
publicIPs	string[]	此集成运行时将使用的公共 IP 地址的资源 ID。
subnet	string	此集成运行时将加入的子网的名称。
subnetId	string	要加入此 Azure-SSIS 集成运行时的子网 ID。
vNetId	string	此集成运行时将加入的 VNet 的 ID。

InteractiveCapabilityStatus

枚举

交互式创作功能状态。必须是 InteractiveCapabilityStatus 之一。默认值为“启用”。

值	说明
Enabling
Enabled
Disabling
Disabled

InteractiveQueryProperties

对象

交互式创作功能类型属性。

名称	类型	说明
autoTerminationMinutes	integer	交互式创作的允许空闲时间。
status	InteractiveCapabilityStatus	交互式创作功能状态。必须是 InteractiveCapabilityStatus 之一。默认值为“启用”。

LinkedIntegrationRuntimeKeyAuthorization

对象

密钥授权类型集成运行时。

名称	类型	说明
authorizationType	string: Key	集成运行时共享的授权类型。
key	SecureString	用于授权的密钥。

LinkedIntegrationRuntimeRbacAuthorization

对象

基于角色的访问控制（RBAC）授权类型集成运行时。

名称	类型	说明
authorizationType	string: RBAC	集成运行时共享的授权类型。
credential	CredentialReference	包含身份验证信息的凭据引用。
resourceId	string	要共享的集成运行时的资源标识符。

ManagedIntegrationRuntime

对象

托管集成运行时，包括托管的弹性和托管的专用集成运行时。

名称	类型	说明
description	string	集成运行时说明。
managedVirtualNetwork	ManagedVirtualNetworkReference	托管虚拟网络参考。
state	IntegrationRuntimeState	集成运行时状态，仅适用于托管专用集成运行时。
type	string: Managed	集成运行时的类型。
typeProperties.computeProperties	IntegrationRuntimeComputeProperties	托管集成运行时的计算资源。
typeProperties.customerVirtualNetwork	IntegrationRuntimeCustomerVirtualNetwork	Azure-SSIS 集成运行时要加入的虚拟网络的名称
typeProperties.interactiveQuery	InteractiveQueryProperties	交互式创作功能参考。
typeProperties.ssisProperties	IntegrationRuntimeSsisProperties	托管集成运行时的 SSIS 属性。

ManagedVirtualNetworkReference

对象

托管虚拟网络引用类型。

名称	类型	说明
referenceName	string	引用 ManagedVirtualNetwork 名称。
type	ManagedVirtualNetworkReferenceType	托管虚拟网络引用类型。

ManagedVirtualNetworkReferenceType

枚举