Integration Runtimes - Get
통합 런타임을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/integrationRuntimes/{integrationRuntimeName}?api-version=2018-06-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
factory
|
path | True |
string |
팩터리 이름입니다. regex 패턴: |
integration
|
path | True |
string |
통합 런타임 이름입니다. regex 패턴: |
resource
|
path | True |
string |
리소스 그룹 이름입니다. regex 패턴: |
subscription
|
path | True |
string |
구독 식별자입니다. |
api-version
|
query | True |
string |
API 버전입니다. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
If-None-Match |
string |
통합 런타임 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 * 가 제공된 경우 콘텐츠가 반환되지 않습니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
OK. |
|
Other Status Codes |
수정되지 않습니다. |
|
Other Status Codes |
GET 통합 런타임 작업에서 받은 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
IntegrationRuntimes_Get
샘플 요청
샘플 응답
Date: Mon, 22 Apr 2019 18:33:47 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 11997
x-ms-request-id: ad824326-e577-4a47-a092-2e621c4d59d9
x-ms-correlation-request-id: ad824326-e577-4a47-a092-2e621c4d59d9
{
"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": "15003c4f-0000-0200-0000-5cbe090b0000"
}
정의
Name | Description |
---|---|
Cloud |
Azure Data Factory 오류 응답의 구조를 정의하는 개체입니다. |
Copy |
관리되는 통합 런타임에 대한 CopyComputeScale 속성입니다. |
Credential |
자격 증명 참조 형식입니다. |
Credential |
자격 증명 참조 형식입니다. |
Custom |
사용자 지정 속성은 데이터 흐름 런타임 성능을 조정하는 데 사용됩니다. |
Data |
데이터 흐름 작업을 실행할 클러스터의 컴퓨팅 유형입니다. |
Entity |
엔터티 참조입니다. |
Integration |
관리되는 통합 런타임에 대한 컴퓨팅 리소스 속성입니다. |
Integration |
Azure-SSIS 통합 런타임이 조인할 가상 네트워크의 정의 및 속성입니다. |
Integration |
관리형 전용 통합 런타임에 대한 사용자 지정 설정 스크립트 속성입니다. |
Integration |
관리되는 통합 런타임에 대한 데이터 흐름 속성입니다. |
Integration |
관리되는 전용 통합 런타임에 대한 데이터 프록시 속성입니다. |
Integration |
SSIS Integration Runtime 버전 |
Integration |
이 참조된 엔터티의 형식입니다. |
Integration |
고유한 라이선스 시나리오를 가져오기 위한 라이선스 유형입니다. |
Integration |
통합 런타임 리소스 유형입니다. |
Integration |
관리되는 전용 통합 런타임에 대한 카탈로그 정보입니다. |
Integration |
카탈로그 데이터베이스의 가격 책정 계층입니다. 유효한 값은 에서 찾을 수 있습니다. https://azure.microsoft.com/en-us/pricing/details/sql-database/ |
Integration |
관리되는 통합 런타임에 대한 SSIS 속성입니다. |
Integration |
통합 런타임의 상태입니다. |
Integration |
통합 런타임의 유형입니다. |
Integration |
관리되는 통합 런타임에 대한 VNet 속성입니다. |
Linked |
키 권한 부여 유형 통합 런타임입니다. |
Linked |
RBAC(역할 기반 액세스 제어) 권한 부여 유형 통합 런타임입니다. |
Managed |
관리되는 탄력적 및 관리되는 전용 통합 런타임을 포함한 관리되는 통합 런타임. |
Managed |
관리되는 Virtual Network 참조 형식입니다. |
Managed |
관리되는 Virtual Network 참조 형식입니다. |
Package |
SSIS 통합 런타임용 패키지 저장소입니다. |
Pipeline |
관리되는 통합 런타임에 대한 PipelineExternalComputeScale 속성입니다. |
Secure |
보안 문자열 정의를 Azure Data Factory. 문자열 값은 Get 또는 List API 호출 중에 별표 '*'로 마스킹됩니다. |
Self |
자체 호스팅 통합 런타임입니다. |
CloudError
Azure Data Factory 오류 응답의 구조를 정의하는 개체입니다.
Name | 형식 | Description |
---|---|---|
error.code |
string |
오류 코드 |
error.details |
추가 오류 세부 정보가 있는 배열입니다. |
|
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
자격 증명 참조 형식입니다.
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 |
이 참조된 엔터티의 형식입니다. |
IntegrationRuntimeComputeProperties
관리되는 통합 런타임에 대한 컴퓨팅 리소스 속성입니다.
Name | 형식 | Description |
---|---|---|
copyComputeScaleProperties |
관리되는 통합 런타임에 대한 CopyComputeScale 속성입니다. |
|
dataFlowProperties |
관리되는 통합 런타임에 대한 데이터 흐름 속성입니다. |
|
location |
string |
관리되는 통합 런타임의 위치입니다. 지원되는 지역은 에서 찾을 수 있습니다. https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities |
maxParallelExecutionsPerNode |
integer |
관리되는 통합 런타임에 대한 노드당 최대 병렬 실행 수입니다. |
nodeSize |
string |
관리형 통합 런타임에 대한 노드 크기 요구 사항입니다. |
numberOfNodes |
integer |
관리되는 통합 런타임에 필요한 노드 수입니다. |
pipelineExternalComputeScaleProperties |
관리되는 통합 런타임에 대한 PipelineExternalComputeScale 속성입니다. |
|
vNetProperties |
관리되는 통합 런타임에 대한 VNet 속성입니다. |
IntegrationRuntimeCustomerVirtualNetwork
Azure-SSIS 통합 런타임이 조인할 가상 네트워크의 정의 및 속성입니다.
Name | 형식 | Description |
---|---|---|
subnetId |
string |
Azure-SSIS 통합 런타임이 조인할 서브넷의 ID입니다. |
IntegrationRuntimeCustomSetupScriptProperties
관리형 전용 통합 런타임에 대한 사용자 지정 설정 스크립트 속성입니다.
Name | 형식 | Description |
---|---|---|
blobContainerUri |
string |
사용자 지정 설정 스크립트를 포함하는 Azure Blob 컨테이너의 URI입니다. |
sasToken |
Azure Blob 컨테이너의 SAS 토큰입니다. |
IntegrationRuntimeDataFlowProperties
관리되는 통합 런타임에 대한 데이터 흐름 속성입니다.
Name | 형식 | Description |
---|---|---|
cleanup |
boolean |
클러스터는 재활용되지 않으며, 이 가 false로 설정된 경우 TTL(Time to Live)에 도달할 때까지 다음 데이터 흐름 작업 실행에 사용됩니다. 기본값은 true입니다. |
computeType |
데이터 흐름 작업을 실행할 클러스터의 컴퓨팅 유형입니다. |
|
coreCount |
integer |
데이터 흐름 작업을 실행할 클러스터의 코어 수입니다. 지원되는 값은 8, 16, 32, 48, 80, 144 및 272입니다. |
customProperties |
사용자 지정 속성은 데이터 흐름 런타임 성능을 조정하는 데 사용됩니다. |
|
timeToLive |
integer |
데이터 흐름 작업을 실행할 클러스터의 TL(Time to Live) 설정(분)입니다. |
IntegrationRuntimeDataProxyProperties
관리되는 전용 통합 런타임에 대한 데이터 프록시 속성입니다.
Name | 형식 | Description |
---|---|---|
connectVia |
자체 호스팅 통합 런타임 참조입니다. |
|
path |
string |
Blob Storage에 스테이징된 데이터를 포함할 경로입니다. |
stagingLinkedService |
스테이징 연결된 서비스 참조입니다. |
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 |
카탈로그 데이터베이스의 관리자 사용자 계정 암호입니다. |
|
catalogAdminUserName |
string |
카탈로그 데이터베이스의 관리자 사용자 이름입니다. |
catalogPricingTier |
카탈로그 데이터베이스의 가격 책정 계층입니다. 유효한 값은 에서 찾을 수 있습니다. 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 |
관리되는 전용 통합 런타임에 대한 카탈로그 정보입니다. |
|
credential |
인증 정보를 포함하는 자격 증명 참조입니다. |
|
customSetupScriptProperties |
관리형 전용 통합 런타임에 대한 사용자 지정 설정 스크립트 속성입니다. |
|
dataProxyProperties |
관리되는 전용 통합 런타임에 대한 데이터 프록시 속성입니다. |
|
edition |
SSIS Integration Runtime 버전 |
|
expressCustomSetupProperties |
Custom |
SSIS 통합 런타임에 대한 스크립트 속성이 없는 사용자 지정 설정입니다. |
licenseType |
고유한 라이선스 시나리오를 가져오기 위한 라이선스 유형입니다. |
|
packageStores |
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 |
권한 부여에 사용되는 키입니다. |
LinkedIntegrationRuntimeRbacAuthorization
RBAC(역할 기반 액세스 제어) 권한 부여 유형 통합 런타임입니다.
Name | 형식 | Description |
---|---|---|
authorizationType |
string:
RBAC |
통합 런타임 공유에 대한 권한 부여 유형입니다. |
credential |
인증 정보를 포함하는 자격 증명 참조입니다. |
|
resourceId |
string |
공유할 통합 런타임의 리소스 식별자입니다. |
ManagedIntegrationRuntime
관리되는 탄력적 및 관리되는 전용 통합 런타임을 포함한 관리되는 통합 런타임.
Name | 형식 | Description |
---|---|---|
description |
string |
통합 런타임 설명. |
managedVirtualNetwork |
관리되는 Virtual Network 참조입니다. |
|
state |
통합 런타임 상태이며 관리되는 전용 통합 런타임에만 유효합니다. |
|
type |
string:
Managed |
통합 런타임 유형입니다. |
typeProperties.computeProperties |
관리형 통합 런타임에 대한 컴퓨팅 리소스입니다. |
|
typeProperties.customerVirtualNetwork |
Azure-SSIS 통합 런타임이 조인할 가상 네트워크의 이름 |
|
typeProperties.ssisProperties |
관리되는 통합 런타임에 대한 SSIS 속성입니다. |
ManagedVirtualNetworkReference
관리되는 Virtual Network 참조 형식입니다.
Name | 형식 | Description |
---|---|---|
referenceName |
string |
ManagedVirtualNetwork 이름을 참조합니다. |
type |
관리되는 Virtual Network 참조 형식입니다. |
ManagedVirtualNetworkReferenceType
관리되는 Virtual Network 참조 형식입니다.
Name | 형식 | Description |
---|---|---|
ManagedVirtualNetworkReference |
string |
PackageStore
SSIS 통합 런타임용 패키지 저장소입니다.
Name | 형식 | Description |
---|---|---|
name |
string |
패키지 저장소의 이름 |
packageStoreLinkedService |
패키지 저장소 연결된 서비스 참조입니다. |
PipelineExternalComputeScaleProperties
관리되는 통합 런타임에 대한 PipelineExternalComputeScale 속성입니다.
Name | 형식 | Description |
---|---|---|
numberOfExternalNodes |
integer |
0보다 크고 11보다 작아야 하는 외부 노드의 수입니다. |
numberOfPipelineNodes |
integer |
0보다 크고 11보다 작아야 하는 파이프라인 노드의 수입니다. |
timeToLive |
integer |
파이프라인 및 외부 작업을 실행하는 통합 런타임의 TL(Time to Live) 설정(분)입니다. |
SecureString
보안 문자열 정의를 Azure Data Factory. 문자열 값은 Get 또는 List API 호출 중에 별표 '*'로 마스킹됩니다.
Name | 형식 | Description |
---|---|---|
type | string: |
비밀의 유형입니다. |
value |
string |
보안 문자열의 값입니다. |
SelfHostedIntegrationRuntime
자체 호스팅 통합 런타임입니다.
Name | 형식 | Description |
---|---|---|
description |
string |
통합 런타임 설명. |
type |
string:
Self |
통합 런타임 유형입니다. |
typeProperties.linkedInfo | LinkedIntegrationRuntimeType: |
연결된 통합 런타임의 기본 정의입니다. |
typeProperties.selfContainedInteractiveAuthoringEnabled |
boolean |
자체 호스팅 통합 런타임이 Azure Relay와의 연결을 설정할 수 없는 경우 대화형 작성 기능을 보장하는 다른 옵션입니다. |