Event Sources - Get

지정된 환경에서 지정된 이름의 이벤트 원본을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/eventSources/{eventSourceName}?api-version=2020-05-15

URI 매개 변수

Name In Required Type Description
environmentName
path True
  • string

지정된 리소스 그룹과 연결된 시계열 Insights 환경의 이름입니다.

eventSourceName
path True
  • string

시계열 Insights 지정된 환경과 연결된 이벤트 원본의 이름입니다.

resourceGroupName
path True
  • string

Azure 리소스 그룹의 이름입니다.

subscriptionId
path True
  • string

Azure 구독 ID입니다.

api-version
query True
  • string

클라이언트 요청과 함께 사용할 API의 버전입니다.

응답

Name Type Description
200 OK EventSourceResource:

이벤트 원본 정의가 성공적으로 검색되었으며 응답에 있습니다.

Other Status Codes

HTTP 404(찾을 수 없음): 구독, 리소스 그룹, 환경 또는 이벤트 원본을 찾을 수 없습니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

GetEventHubEventSource

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/environments/env1/eventSources/es1?api-version=2020-05-15

Sample Response

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.TimeSeriesInsights/Environments/env1/eventSources/es1",
  "location": "West US",
  "name": "es1",
  "type": "Microsoft.TimeSeriesInsights/Environments/EventSources",
  "tags": {},
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "provisioningState": "Succeeded",
    "creationTime": "2017-04-18T19:20:33.2288820Z",
    "localTimestamp": {
      "format": "TimeSpan",
      "timeZoneOffset": {
        "propertyName": "someEventPropertyName"
      }
    },
    "ingressStartAt": {
      "type": "EarliestAvailable"
    }
  }
}

정의

CloudError

API 오류에 대한 정보를 포함합니다.

CloudErrorBody

오류 코드 및 메시지와 함께 특정 API 오류에 대해 설명합니다.

EventHubEventSourceResource

Azure EventHub에서 데이터를 수신하는 이벤트 원본입니다.

IngressStartAtType

ingressStartAt의 형식으로, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime"일 수 있습니다.

IoTHubEventSourceResource

Azure IoTHub에서 데이터를 수신하는 이벤트 원본입니다.

LocalTimestamp

로컬 타임스탬프 속성을 나타내는 개체입니다. 사용해야 하는 로컬 타임스탬프 형식과 해당 표준 시간대 오프셋 정보가 포함됩니다. localTimestamp에 대해 값이 지정되지 않았거나 null이면 로컬 타임스탬프가 이벤트와 함께 수신되지 않습니다.

LocalTimestampFormat

설정해야 하는 로컬 타임스탬프 속성의 형식을 나타내는 열거형입니다.

ProvisioningState

리소스의 프로비전 상태입니다.

TimeZoneOffset

지정된 로컬 타임스탬프 형식의 오프셋 정보를 나타내는 개체입니다. LocalTimestampFormat - Embedded에 대해 지정해서는 안 됩니다.

CloudError

API 오류에 대한 정보를 포함합니다.

Name Type Description
error

오류 코드 및 메시지와 함께 특정 API 오류에 대해 설명합니다.

CloudErrorBody

오류 코드 및 메시지와 함께 특정 API 오류에 대해 설명합니다.

Name Type Description
code
  • string

HTTP 상태 코드보다 오류 조건을 보다 정확하게 설명하는 오류 코드입니다. 프로그래밍 방식으로 특정 오류 사례를 처리하는 데 사용할 수 있습니다.

details

이 오류와 관련된 중첩된 오류를 포함합니다.

message
  • string

오류를 자세히 설명하고 디버깅 정보를 제공하는 메시지입니다.

target
  • string

특정 오류의 대상입니다(예: 오류의 속성 이름).

EventHubEventSourceResource

Azure EventHub에서 데이터를 수신하는 이벤트 원본입니다.

Name Type Description
creationTime
  • string

리소스를 만든 시간입니다.

eventSourceResourceId
  • string

Azure Resource Manager 이벤트 원본의 리소스 ID입니다.

id
  • string

리소스 ID

ingressStartAt.time
  • string

ISO8601 UTC 날짜/시간(초 정밀도(밀리초는 선택 사항)이며, 사용할 이벤트의 시작점이 될 날짜와 시간을 지정합니다.

ingressStartAt.type

ingressStartAt의 형식으로, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime"일 수 있습니다.

kind string:
  • Microsoft.EventHub

이벤트 원본의 종류입니다.

localTimestamp

로컬 타임스탬프 속성을 나타내는 개체입니다. 사용해야 하는 로컬 타임스탬프 형식과 해당 표준 시간대 오프셋 정보가 포함됩니다. localTimestamp에 대해 값이 지정되지 않았거나 null이면 로컬 타임스탬프가 이벤트와 함께 수신되지 않습니다.

location
  • string

리소스 위치

name
  • string

리소스 이름

properties.consumerGroupName
  • string

이벤트를 읽을 파티션을 보유하는 이벤트 허브의 소비자 그룹의 이름입니다.

properties.eventHubName
  • string

이벤트 허브의 이름입니다.

properties.keyName
  • string

이벤트 허브에 대한 Time Series Insights 서비스 액세스 권한을 부여하는 SAS 키의 이름입니다. 이 키에 대한 공유 액세스 정책은 이벤트 허브에 '수신' 권한을 부여해야 합니다.

properties.serviceBusNamespace
  • string

이벤트 허브를 포함하는 서비스 버스의 이름입니다.

provisioningState

리소스의 프로비전 상태입니다.

tags
  • object

리소스 태그

timestampPropertyName
  • string

이벤트 원본의 타임스탬프로 사용될 이벤트 속성입니다. timestampPropertyName에 대한 값을 지정하지 않은 경우 또는 null 또는 빈 문자열을 지정하는 경우 이벤트 생성 시간이 사용됩니다.

type
  • string

리소스 유형

IngressStartAtType

ingressStartAt의 형식으로, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime"일 수 있습니다.

Name Type Description
CustomEnqueuedTime
  • string
EarliestAvailable
  • string
EventSourceCreationTime
  • string

IoTHubEventSourceResource

Azure IoTHub에서 데이터를 수신하는 이벤트 원본입니다.

Name Type Description
creationTime
  • string

리소스를 만든 시간입니다.

eventSourceResourceId
  • string

Azure Resource Manager 이벤트 원본의 리소스 ID입니다.

id
  • string

리소스 ID

ingressStartAt.time
  • string

ISO8601 UTC 날짜/시간(초 정밀도(밀리초는 선택 사항)이며, 사용할 이벤트의 시작점이 될 날짜와 시간을 지정합니다.

ingressStartAt.type

ingressStartAt의 형식으로, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime"일 수 있습니다.

kind string:
  • Microsoft.IoTHub

이벤트 원본의 종류입니다.

localTimestamp

로컬 타임스탬프 속성을 나타내는 개체입니다. 사용해야 하는 로컬 타임스탬프 형식과 해당 표준 시간대 오프셋 정보가 포함됩니다. localTimestamp에 대해 값이 지정되지 않았거나 null이면 로컬 타임스탬프가 이벤트와 함께 수신되지 않습니다.

location
  • string

리소스 위치

name
  • string

리소스 이름

properties.consumerGroupName
  • string

이벤트를 읽을 파티션을 보유하는 iot Hub의 소비자 그룹의 이름입니다.

properties.iotHubName
  • string

IoT Hub의 이름입니다.

properties.keyName
  • string

IoT Hub에 대한 시계열 Insights 서비스 액세스 권한을 부여하는 공유 액세스 정책 키의 이름입니다. 이 공유 액세스 정책 키는 iot 허브에 '서비스 연결' 권한을 부여해야 합니다.

provisioningState

리소스의 프로비전 상태입니다.

tags
  • object

리소스 태그

timestampPropertyName
  • string

이벤트 원본의 타임스탬프로 사용될 이벤트 속성입니다. timestampPropertyName에 대한 값을 지정하지 않은 경우 또는 null 또는 빈 문자열을 지정하는 경우 이벤트 생성 시간이 사용됩니다.

type
  • string

리소스 유형

LocalTimestamp

로컬 타임스탬프 속성을 나타내는 개체입니다. 사용해야 하는 로컬 타임스탬프 형식과 해당 표준 시간대 오프셋 정보가 포함됩니다. localTimestamp에 대해 값이 지정되지 않았거나 null이면 로컬 타임스탬프가 이벤트와 함께 수신되지 않습니다.

Name Type Description
format

설정해야 하는 로컬 타임스탬프 속성의 형식을 나타내는 열거형입니다.

timeZoneOffset

지정된 로컬 타임스탬프 형식의 오프셋 정보를 나타내는 개체입니다. LocalTimestampFormat - Embedded에 대해 지정해서는 안 됩니다.

LocalTimestampFormat

설정해야 하는 로컬 타임스탬프 속성의 형식을 나타내는 열거형입니다.

Name Type Description
Embedded
  • string

ProvisioningState

리소스의 프로비전 상태입니다.

Name Type Description
Accepted
  • string
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

TimeZoneOffset

지정된 로컬 타임스탬프 형식의 오프셋 정보를 나타내는 개체입니다. LocalTimestampFormat - Embedded에 대해 지정해서는 안 됩니다.

Name Type Description
propertyName
  • string

로컬 타임스탬프를 계산하는 오프셋 정보를 포함할 이벤트 속성입니다. LocalTimestampFormat이 Iana인 경우 속성 이름에는 IANA 표준 시간대 이름(예: 아메리카/로스앤젤레스)이 포함된 열의 이름이 포함됩니다. LocalTimestampFormat이 Timespan인 경우 오프셋을 나타내는 값을 포함하는 속성의 이름이 포함됩니다(예: P1D 또는 1.00:00:00).