다음을 통해 공유


Integration Runtimes - Create Or Update

통합 런타임을 만들거나 업데이트합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
factoryName
path True

string

팩터리 이름입니다.

regex 패턴: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

integrationRuntimeName
path True

string

통합 런타임 이름입니다.

regex 패턴: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

리소스 그룹 이름입니다.

regex 패턴: ^[-\w\._\(\)]+$

subscriptionId
path True

string

구독 식별자입니다.

api-version
query True

string

API 버전입니다.

요청 헤더

Name 필수 형식 Description
If-Match

string

통합 런타임 엔터티의 ETag입니다. 기존 엔터티와 일치해야 하거나 무조건 업데이트의 경우 *일 수 있는 업데이트에 대해서만 지정해야 합니다.

요청 본문

Name 필수 형식 Description
properties True IntegrationRuntime:

통합 런타임 속성.

응답

Name 형식 Description
200 OK

IntegrationRuntimeResource

OK.

Other Status Codes

CloudError

PUT 통합 런타임 작업에서 받은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

IntegrationRuntimes_Create

Sample request

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

Sample response

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

정의

Name Description
CloudError

Azure Data Factory 오류 응답의 구조를 정의하는 개체입니다.

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 속성입니다.

LinkedIntegrationRuntimeKeyAuthorization

키 권한 부여 유형 통합 런타임입니다.

LinkedIntegrationRuntimeRbacAuthorization

RBAC(역할 기반 액세스 제어) 권한 부여 유형 통합 런타임입니다.

ManagedIntegrationRuntime

관리되는 탄력적 및 관리되는 전용 통합 런타임을 포함한 관리되는 통합 런타임.

ManagedVirtualNetworkReference

관리되는 Virtual Network 참조 형식입니다.

ManagedVirtualNetworkReferenceType

관리되는 Virtual Network 참조 형식입니다.

PackageStore

SSIS 통합 런타임용 패키지 저장소입니다.

PipelineExternalComputeScaleProperties

관리되는 통합 런타임에 대한 PipelineExternalComputeScale 속성입니다.

SecureString

보안 문자열 정의를 Azure Data Factory. 문자열 값은 가져오기 또는 목록 API 호출 중에 별표 '*'로 마스킹됩니다.

SelfHostedIntegrationRuntime

자체 호스팅 통합 런타임입니다.

CloudError

Azure Data Factory 오류 응답의 구조를 정의하는 개체입니다.

Name 형식 Description
error.code

string

오류 코드

error.details

CloudError[]

추가 오류 세부 정보가 있는 배열입니다.

error.message

string

오류 메시지입니다.

error.target

string

오류와 관련된 요청의 속성 이름/경로입니다.

CopyComputeScaleProperties

관리되는 통합 런타임에 대한 CopyComputeScale 속성입니다.

Name 형식 Description
dataIntegrationUnit

integer

복사 작업 실행을 위해 예약된 DIU 번호 설정입니다. 지원되는 값은 4-256 범위에서 4의 배수입니다.

timeToLive

integer

복사 작업을 실행할 통합 런타임의 TL(Time to Live) 설정(분)입니다.

CredentialReference

자격 증명 참조 형식입니다.

Name 형식 Description
referenceName

string

참조 자격 증명 이름입니다.

type

CredentialReferenceType

자격 증명 참조 형식입니다.

CredentialReferenceType

자격 증명 참조 형식입니다.

Name 형식 Description
CredentialReference

string

CustomProperties

사용자 지정 속성은 데이터 흐름 런타임 성능을 조정하는 데 사용됩니다.

Name 형식 Description
name

string

사용자 지정 속성의 이름입니다.

value

string

사용자 지정 속성의 값입니다.

DataFlowComputeType

데이터 흐름 작업을 실행할 클러스터의 컴퓨팅 유형입니다.

Name 형식 Description
ComputeOptimized

string

General

string

MemoryOptimized

string

EntityReference

엔터티 참조입니다.

Name 형식 Description
referenceName

string

참조된 이 엔터티의 이름입니다.

type

IntegrationRuntimeEntityReferenceType

참조된 이 엔터티의 형식입니다.

IntegrationRuntimeComputeProperties

관리되는 통합 런타임에 대한 컴퓨팅 리소스 속성입니다.

Name 형식 Description
copyComputeScaleProperties

CopyComputeScaleProperties

관리되는 통합 런타임에 대한 CopyComputeScale 속성입니다.

dataFlowProperties

IntegrationRuntimeDataFlowProperties

관리되는 통합 런타임에 대한 데이터 흐름 속성입니다.

location

string

관리되는 통합 런타임의 위치입니다. 지원되는 지역은 에서 찾을 수 있습니다. https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities

maxParallelExecutionsPerNode

integer

관리되는 통합 런타임에 대한 노드당 최대 병렬 실행 수입니다.

nodeSize

string

관리형 통합 런타임에 대한 노드 크기 요구 사항입니다.

numberOfNodes

integer

관리되는 통합 런타임에 필요한 노드 수입니다.

pipelineExternalComputeScaleProperties

PipelineExternalComputeScaleProperties

관리되는 통합 런타임에 대한 PipelineExternalComputeScale 속성입니다.

vNetProperties

IntegrationRuntimeVNetProperties

관리되는 통합 런타임에 대한 VNet 속성입니다.

IntegrationRuntimeCustomerVirtualNetwork

Azure-SSIS 통합 런타임이 조인할 가상 네트워크의 정의 및 속성입니다.

Name 형식 Description
subnetId

string

Azure-SSIS 통합 런타임이 조인할 서브넷의 ID입니다.

IntegrationRuntimeCustomSetupScriptProperties

관리형 전용 통합 런타임에 대한 사용자 지정 설정 스크립트 속성입니다.

Name 형식 Description
blobContainerUri

string

사용자 지정 설정 스크립트를 포함하는 Azure Blob 컨테이너의 URI입니다.

sasToken

SecureString

Azure Blob 컨테이너의 SAS 토큰입니다.

IntegrationRuntimeDataFlowProperties

관리되는 통합 런타임에 대한 데이터 흐름 속성입니다.

Name 형식 Description
cleanup

boolean

클러스터는 재활용되지 않으며, 이 가 false로 설정된 경우 TTL(Time to Live)에 도달할 때까지 다음 데이터 흐름 작업 실행에 사용됩니다. 기본값은 true입니다.

computeType

DataFlowComputeType

데이터 흐름 작업을 실행할 클러스터의 컴퓨팅 유형입니다.

coreCount

integer

데이터 흐름 작업을 실행할 클러스터의 코어 수입니다. 지원되는 값은 8, 16, 32, 48, 80, 144 및 272입니다.

customProperties

CustomProperties[]

사용자 지정 속성은 데이터 흐름 런타임 성능을 조정하는 데 사용됩니다.

timeToLive

integer

데이터 흐름 작업을 실행할 클러스터의 TL(Time to Live) 설정(분)입니다.

IntegrationRuntimeDataProxyProperties

관리되는 전용 통합 런타임에 대한 데이터 프록시 속성입니다.

Name 형식 Description
connectVia

EntityReference

자체 호스팅 통합 런타임 참조입니다.

path

string

Blob Storage에 스테이징된 데이터를 포함할 경로입니다.

stagingLinkedService

EntityReference

스테이징 연결된 서비스 참조입니다.

IntegrationRuntimeEdition

SSIS Integration Runtime 버전

Name 형식 Description
Enterprise

string

Standard

string

IntegrationRuntimeEntityReferenceType

참조된 이 엔터티의 형식입니다.

Name 형식 Description
IntegrationRuntimeReference

string

LinkedServiceReference

string

IntegrationRuntimeLicenseType

고유한 라이선스 시나리오를 가져오기 위한 라이선스 유형입니다.

Name 형식 Description
BasePrice

string

LicenseIncluded

string

IntegrationRuntimeResource

통합 런타임 리소스 유형입니다.

Name 형식 Description
etag

string

Etag는 리소스의 변경 사항을 식별합니다.

id

string

리소스 식별자입니다.

name

string

리소스 이름입니다.

properties IntegrationRuntime:

통합 런타임 속성.

type

string

리소스 종류입니다.

IntegrationRuntimeSsisCatalogInfo

관리되는 전용 통합 런타임에 대한 카탈로그 정보입니다.

Name 형식 Description
catalogAdminPassword

SecureString

카탈로그 데이터베이스의 관리자 사용자 계정 암호입니다.

catalogAdminUserName

string

카탈로그 데이터베이스의 관리자 사용자 이름입니다.

catalogPricingTier

IntegrationRuntimeSsisCatalogPricingTier

카탈로그 데이터베이스의 가격 책정 계층입니다. 유효한 값은 에서 찾을 수 있습니다. https://azure.microsoft.com/en-us/pricing/details/sql-database/

catalogServerEndpoint

string

카탈로그 데이터베이스 서버 URL입니다.

dualStandbyPairName

string

SSISDB 장애 조치(failover)를 지원하는 Azure-SSIS Integration Runtimes의 이중 대기 쌍 이름입니다.

IntegrationRuntimeSsisCatalogPricingTier

카탈로그 데이터베이스의 가격 책정 계층입니다. 유효한 값은 에서 찾을 수 있습니다. https://azure.microsoft.com/en-us/pricing/details/sql-database/

Name 형식 Description
Basic

string

Premium

string

PremiumRS

string

Standard

string

IntegrationRuntimeSsisProperties

관리되는 통합 런타임에 대한 SSIS 속성입니다.

Name 형식 Description
catalogInfo

IntegrationRuntimeSsisCatalogInfo

관리되는 전용 통합 런타임에 대한 카탈로그 정보입니다.

credential

CredentialReference

인증 정보를 포함하는 자격 증명 참조입니다.

customSetupScriptProperties

IntegrationRuntimeCustomSetupScriptProperties

관리형 전용 통합 런타임에 대한 사용자 지정 설정 스크립트 속성입니다.

dataProxyProperties

IntegrationRuntimeDataProxyProperties

관리되는 전용 통합 런타임에 대한 데이터 프록시 속성입니다.

edition

IntegrationRuntimeEdition

SSIS Integration Runtime 버전

expressCustomSetupProperties

CustomSetupBase[]

SSIS 통합 런타임에 대한 스크립트 속성이 없는 사용자 지정 설정입니다.

licenseType

IntegrationRuntimeLicenseType

고유한 라이선스 시나리오를 가져오기 위한 라이선스 유형입니다.

packageStores

PackageStore[]

SSIS Integration Runtime 대한 패키지 저장소입니다.

IntegrationRuntimeState

통합 런타임의 상태입니다.

Name 형식 Description
AccessDenied

string

Initial

string

Limited

string

NeedRegistration

string

Offline

string

Online

string

Started

string

Starting

string

Stopped

string

Stopping

string

IntegrationRuntimeType

통합 런타임의 유형입니다.

Name 형식 Description
Managed

string

SelfHosted

string

IntegrationRuntimeVNetProperties

관리되는 통합 런타임에 대한 VNet 속성입니다.

Name 형식 Description
publicIPs

string[]

이 통합 런타임에서 사용할 공용 IP 주소의 리소스 ID입니다.

subnet

string

이 통합 런타임이 조인할 서브넷의 이름입니다.

subnetId

string

이 Azure-SSIS 통합 런타임이 조인될 서브넷의 ID입니다.

vNetId

string

이 통합 런타임이 조인할 VNet의 ID입니다.

LinkedIntegrationRuntimeKeyAuthorization

키 권한 부여 유형 통합 런타임입니다.

Name 형식 Description
authorizationType string:

Key

통합 런타임 공유에 대한 권한 부여 유형입니다.

key

SecureString

권한 부여에 사용되는 키입니다.

LinkedIntegrationRuntimeRbacAuthorization

RBAC(역할 기반 액세스 제어) 권한 부여 유형 통합 런타임입니다.

Name 형식 Description
authorizationType string:

RBAC

통합 런타임 공유에 대한 권한 부여 유형입니다.

credential

CredentialReference

인증 정보를 포함하는 자격 증명 참조입니다.

resourceId

string

공유할 통합 런타임의 리소스 식별자입니다.

ManagedIntegrationRuntime

관리되는 탄력적 및 관리되는 전용 통합 런타임을 포함한 관리되는 통합 런타임.

Name 형식 Description
description

string

통합 런타임 설명.

managedVirtualNetwork

ManagedVirtualNetworkReference

관리되는 Virtual Network 참조입니다.

state

IntegrationRuntimeState

통합 런타임 상태이며 관리되는 전용 통합 런타임에만 유효합니다.

type string:

Managed

통합 런타임 유형입니다.

typeProperties.computeProperties

IntegrationRuntimeComputeProperties

관리형 통합 런타임에 대한 컴퓨팅 리소스입니다.

typeProperties.customerVirtualNetwork

IntegrationRuntimeCustomerVirtualNetwork

Azure-SSIS 통합 런타임이 조인할 가상 네트워크의 이름

typeProperties.ssisProperties

IntegrationRuntimeSsisProperties

관리되는 통합 런타임에 대한 SSIS 속성입니다.

ManagedVirtualNetworkReference

관리되는 Virtual Network 참조 형식입니다.

Name 형식 Description
referenceName

string

ManagedVirtualNetwork 이름을 참조합니다.

type

ManagedVirtualNetworkReferenceType

관리되는 Virtual Network 참조 형식입니다.

ManagedVirtualNetworkReferenceType

관리되는 Virtual Network 참조 형식입니다.

Name 형식 Description
ManagedVirtualNetworkReference

string

PackageStore

SSIS 통합 런타임용 패키지 저장소입니다.

Name 형식 Description
name

string

패키지 저장소의 이름

packageStoreLinkedService

EntityReference

패키지 저장소 연결된 서비스 참조입니다.

PipelineExternalComputeScaleProperties

관리되는 통합 런타임에 대한 PipelineExternalComputeScale 속성입니다.

Name 형식 Description
numberOfExternalNodes

integer

0보다 크고 11보다 작아야 하는 외부 노드의 수입니다.

numberOfPipelineNodes

integer

0보다 크고 11보다 작아야 하는 파이프라인 노드의 수입니다.

timeToLive

integer

파이프라인 및 외부 작업을 실행하는 통합 런타임의 TL(Time to Live) 설정(분)입니다.

SecureString

보안 문자열 정의를 Azure Data Factory. 문자열 값은 가져오기 또는 목록 API 호출 중에 별표 '*'로 마스킹됩니다.

Name 형식 Description
type string:

SecureString

비밀의 유형입니다.

value

string

보안 문자열의 값입니다.

SelfHostedIntegrationRuntime

자체 호스팅 통합 런타임입니다.

Name 형식 Description
description

string

통합 런타임 설명.

type string:

SelfHosted

통합 런타임 유형입니다.

typeProperties.linkedInfo LinkedIntegrationRuntimeType:

연결된 통합 런타임의 기본 정의입니다.

typeProperties.selfContainedInteractiveAuthoringEnabled

boolean

자체 호스팅 통합 런타임이 Azure Relay와의 연결을 설정할 수 없는 경우 대화형 작성 기능을 보장하는 다른 옵션입니다.