Integration Runtimes - Get

참조

서비스:: Synapse

API 버전:: 2021-06-01

통합 런타임 가져오기
통합 런타임 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/integrationRuntimes/{integrationRuntimeName}?api-version=2021-06-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
integrationRuntimeName	path	True	string	통합 런타임 이름
resourceGroupName	path	True	string	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
subscriptionId	path	True	string	대상 구독의 ID입니다.
workspaceName	path	True	string	작업 영역의 이름입니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 헤더

Name	필수	형식	Description
If-None-Match		string	통합 런타임 엔터티의 ETag입니다. get에 대해서만 지정해야 합니다. ETag가 기존 엔터티 태그와 일치하거나 * 가 제공된 경우 콘텐츠가 반환되지 않습니다.

응답

Name	형식	Description
200 OK	IntegrationRuntimeResource	그래.
Other Status Codes		수정되지 않았습니다.
Other Status Codes	ErrorResponse	GET 통합 런타임 작업에서 받은 오류 응답입니다.

예제

Get integration runtime

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.Synapse/workspaces/exampleWorkspace/integrationRuntimes/exampleIntegrationRuntime?api-version=2021-06-01

샘플 응답

상태 코드:: 200

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.Synapse/workspaces/exampleWorkspaceName/integrationruntimes/exampleIntegrationRuntime",
  "name": "exampleIntegrationRuntime",
  "type": "Microsoft.Synapse/workspaces/integrationruntimes",
  "properties": {
    "type": "SelfHosted",
    "description": "A selfhosted integration runtime"
  },
  "etag": "15003c4f-0000-0200-0000-5cbe090b0000"
}

상태 코드:: 304

상태 코드:: default

{
  "error": {
    "code": "Error code",
    "message": "Error message"
  }
}

정의

Name	Description
DataFlowComputeType	데이터 흐름 작업을 실행할 클러스터의 컴퓨팅 유형입니다.
EntityReference	엔터티 참조입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
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	관리되는 탄력적 및 관리되는 전용 통합 런타임을 포함한 관리되는 통합 런타임.
SecureString	Azure Synapse 보안 문자열 정의입니다. 문자열 값은 가져오기 또는 목록 API 호출 중에 별표 '*'로 마스킹됩니다.
SelfHostedIntegrationRuntime	자체 호스팅 통합 런타임.

DataFlowComputeType

Enumeration

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

값	Description
ComputeOptimized
General
MemoryOptimized

EntityReference

Object

엔터티 참조입니다.

Name	형식	Description
referenceName	string	참조된 이 엔터티의 이름입니다.
type	IntegrationRuntimeEntityReferenceType	참조된 이 엔터티의 형식입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

IntegrationRuntimeComputeProperties

Object

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

Name	형식	Description
dataFlowProperties	IntegrationRuntimeDataFlowProperties	관리되는 통합 런타임에 대한 데이터 흐름 속성입니다.
location	string	관리되는 통합 런타임의 위치입니다. 지원되는 지역은 https://docs.microsoft.com/en-us/azure/data-factory/data-factory-data-movement-activities 찾을 수 있습니다.
maxParallelExecutionsPerNode	integer	관리되는 통합 런타임에 대한 노드당 최대 병렬 실행 수입니다.
nodeSize	string	관리되는 통합 런타임에 대한 노드 크기 요구 사항입니다.
numberOfNodes	integer	관리되는 통합 런타임에 필요한 노드 수입니다.
vNetProperties	IntegrationRuntimeVNetProperties	관리되는 통합 런타임에 대한 VNet 속성입니다.

IntegrationRuntimeCustomerVirtualNetwork

Object

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

Name	형식	Description
subnetId	string	Azure-SSIS 통합 런타임이 조인할 서브넷의 ID입니다.

IntegrationRuntimeCustomSetupScriptProperties

Object

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

Name	형식	Description
blobContainerUri	string	사용자 지정 설치 스크립트를 포함하는 Azure Blob 컨테이너의 URI입니다.
sasToken	SecureString	Azure Blob 컨테이너의 SAS 토큰입니다.

IntegrationRuntimeDataFlowProperties

Object

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

Name	형식	Description
computeType	DataFlowComputeType	데이터 흐름 작업을 실행할 클러스터의 컴퓨팅 유형입니다.
coreCount	integer	데이터 흐름 작업을 실행할 클러스터의 코어 수입니다. 지원되는 값은 8, 16, 32, 48, 80, 144 및 272입니다.
timeToLive	integer	데이터 흐름 작업을 실행할 클러스터의 TL(Time to Live) 설정(분)입니다.

IntegrationRuntimeDataProxyProperties

Object

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

Name	형식	Description
connectVia	EntityReference	자체 호스팅 통합 런타임 참조입니다.
path	string	Blob Storage에 스테이징된 데이터를 포함할 경로입니다.
stagingLinkedService	EntityReference	스테이징 연결된 서비스 참조입니다.

IntegrationRuntimeEdition

Enumeration

SSIS Integration Runtime용 버전

값	Description
Enterprise
Standard

IntegrationRuntimeEntityReferenceType

Enumeration

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

값	Description
IntegrationRuntimeReference
LinkedServiceReference

IntegrationRuntimeLicenseType

Enumeration

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

값	Description
BasePrice
LicenseIncluded

IntegrationRuntimeResource

Object

통합 런타임 리소스 종류입니다.

Name	형식	Description
etag	string	리소스 Etag.
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름
properties	IntegrationRuntime: ManagedIntegrationRuntime SelfHostedIntegrationRuntime	통합 런타임 속성입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

IntegrationRuntimeSsisCatalogInfo

Object

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

Name	형식	Description
catalogAdminPassword	SecureString	카탈로그 데이터베이스의 관리자 사용자 계정 암호입니다.
catalogAdminUserName	string	카탈로그 데이터베이스의 관리자 사용자 이름입니다.
catalogPricingTier	IntegrationRuntimeSsisCatalogPricingTier	카탈로그 데이터베이스의 가격 책정 계층입니다. 유효한 값은 https://azure.microsoft.com/en-us/pricing/details/sql-database/ 찾을 수 있습니다.
catalogServerEndpoint	string	카탈로그 데이터베이스 서버 URL입니다.

IntegrationRuntimeSsisCatalogPricingTier

Enumeration

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

값	Description
Basic
Premium
PremiumRS
Standard

IntegrationRuntimeSsisProperties

Object

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

Name	형식	Description
catalogInfo	IntegrationRuntimeSsisCatalogInfo	관리되는 전용 통합 런타임에 대한 카탈로그 정보입니다.
customSetupScriptProperties	IntegrationRuntimeCustomSetupScriptProperties	관리형 전용 통합 런타임에 대한 사용자 지정 설정 스크립트 속성입니다.
dataProxyProperties	IntegrationRuntimeDataProxyProperties	관리되는 전용 통합 런타임에 대한 데이터 프록시 속성입니다.
edition	IntegrationRuntimeEdition	SSIS Integration Runtime용 버전
expressCustomSetupProperties	CustomSetupBase[]	SSIS 통합 런타임에 대한 스크립트 속성이 없는 사용자 지정 설정입니다.
licenseType	IntegrationRuntimeLicenseType	사용자 고유의 라이선스 시나리오를 가져오기 위한 라이선스 유형입니다.

IntegrationRuntimeState

Enumeration

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

값	Description
AccessDenied
Initial
Limited
NeedRegistration
Offline
Online
Started
Starting
Stopped
Stopping

IntegrationRuntimeType

Enumeration

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

값	Description
Managed
SelfHosted

IntegrationRuntimeVNetProperties

Object

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

Name	형식	Description
publicIPs	string[]	이 통합 런타임에서 사용할 공용 IP 주소의 리소스 ID입니다.
subnet	string	이 통합 런타임이 조인할 서브넷의 이름입니다.
subnetId	string	이 Azure-SSIS 통합 런타임이 조인될 서브넷의 ID입니다.
vNetId	string	이 통합 런타임이 조인할 VNet의 ID입니다.

LinkedIntegrationRuntimeKeyAuthorization

Object

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

Name	형식	Description
authorizationType	string: Key	통합 런타임 공유에 대한 권한 부여 유형입니다.
key	SecureString	권한 부여에 사용되는 키입니다.

LinkedIntegrationRuntimeRbacAuthorization

Object

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

Name	형식	Description
authorizationType	string: RBAC	통합 런타임 공유에 대한 권한 부여 유형입니다.
resourceId	string	공유할 통합 런타임의 리소스 식별자입니다.

ManagedIntegrationRuntime

Object

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

Name	형식	Description
description	string	통합 런타임 설명입니다.
managedVirtualNetwork.id	string	관리되는 가상 네트워크의 ID입니다.
managedVirtualNetwork.referenceName	string	관리되는 가상 네트워크의 참조 이름
managedVirtualNetwork.type	string	관리되는 가상 네트워크의 형식입니다.
provisioningState	IntegrationRuntimeState	통합 런타임 상태, 관리되는 전용 통합 런타임에만 유효합니다.
type	string: Managed	통합 런타임의 유형입니다.
typeProperties.computeProperties	IntegrationRuntimeComputeProperties	관리되는 통합 런타임에 대한 컴퓨팅 리소스입니다.
typeProperties.customerVirtualNetwork	IntegrationRuntimeCustomerVirtualNetwork	Azure-SSIS 통합 런타임이 조인할 가상 네트워크의 이름입니다.
typeProperties.ssisProperties	IntegrationRuntimeSsisProperties	관리되는 통합 런타임에 대한 SSIS 속성입니다.

SecureString

Object

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

Name	형식	Description
type	string: SecureString	비밀의 유형입니다.
value	string	보안 문자열의 값입니다.

SelfHostedIntegrationRuntime

Object

자체 호스팅 통합 런타임.

Name	형식	Description
description	string	통합 런타임 설명입니다.
type	string: SelfHosted	통합 런타임의 유형입니다.
typeProperties.linkedInfo	LinkedIntegrationRuntimeType: LinkedIntegrationRuntimeKeyAuthorization LinkedIntegrationRuntimeRbacAuthorization	데이터 팩터리의 연결된 통합 런타임 형식

다음을 통해 공유

Integration Runtimes - Get

URI 매개 변수

요청 헤더

응답

예제

Get integration runtime

샘플 요청

샘플 응답

정의

DataFlowComputeType

EntityReference

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IntegrationRuntimeComputeProperties

IntegrationRuntimeCustomerVirtualNetwork

IntegrationRuntimeCustomSetupScriptProperties

IntegrationRuntimeDataFlowProperties

IntegrationRuntimeDataProxyProperties

IntegrationRuntimeEdition

IntegrationRuntimeEntityReferenceType

IntegrationRuntimeLicenseType

IntegrationRuntimeResource

IntegrationRuntimeSsisCatalogInfo

IntegrationRuntimeSsisCatalogPricingTier

IntegrationRuntimeSsisProperties

IntegrationRuntimeState

IntegrationRuntimeType

IntegrationRuntimeVNetProperties

LinkedIntegrationRuntimeKeyAuthorization

LinkedIntegrationRuntimeRbacAuthorization

ManagedIntegrationRuntime

SecureString

SelfHostedIntegrationRuntime

추가 리소스