Aracılığıyla paylaş


Event Sources - Create Or Update

Belirtilen ortam altında bir olay kaynağı oluşturun veya güncelleştirin.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
environmentName
path True

string

Belirtilen kaynak grubuyla ilişkili Time Series Insights ortamının adı.

eventSourceName
path True

string

Olay kaynağının adı.

Regex pattern: ^[-\w\._\(\)]+$

resourceGroupName
path True

string

Azure Kaynak grubunun adı.

subscriptionId
path True

string

Azure Abonelik Kimliği.

api-version
query True

string

İstemci isteğiyle kullanılacak API'nin sürümü.

İstek Gövdesi

İstek gövdesi şunlardan biri olabilir:

Name Description
EventHubEventSourceCreateOrUpdateParameters

Bir EventHub olay kaynağı için Olay Kaynağı Oluşturma veya Güncelleştirme işlemine sağlanan parametreler.

IoTHubEventSourceCreateOrUpdateParameters

IoTHub olay kaynağı için Olay Kaynağı Oluştur veya Güncelleştir işlemine sağlanan parametreler.

EventHubEventSourceCreateOrUpdateParameters

Bir EventHub olay kaynağı için Olay Kaynağı Oluşturma veya Güncelleştirme işlemine sağlanan parametreler.

Name Gerekli Tür Description
eventSourceResourceId True

string

Azure Resource Manager olay kaynağının kaynak kimliği.

kind True string:

Microsoft.EventHub

Olay kaynağının türü.

location True

string

Kaynağın konumu.

properties.consumerGroupName True

string

Olayların okunacağı bölümleri tutan olay hub'ının tüketici grubunun adı.

properties.eventHubName True

string

Olay hub'ının adı.

properties.keyName True

string

Olay hub'ına Time Series Insights hizmeti erişimi veren SAS anahtarının adı. Bu anahtarın paylaşılan erişim ilkeleri olay hub'ına 'Dinleme' izinleri vermelidir.

properties.serviceBusNamespace True

string

Olay hub'ını içeren hizmet veri yolunun adı.

properties.sharedAccessKey True

string

Time Series Insights hizmetine olay hub'ına okuma erişimi veren paylaşılan erişim anahtarının değeri. Bu özellik olay kaynağı yanıtlarında gösterilmez.

ingressStartAt.time

string

ISO8601 UTC tarih saat değerini saniye duyarlılığıyla (milisaniyeler isteğe bağlıdır), olayların tüketileceği başlangıç noktası olacak tarih ve saati belirtir.

ingressStartAt.type

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

localTimestamp

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklık bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

tags

object

Kaynak için ek özelliklerin anahtar-değer çiftleri.

timestampPropertyName

string

Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya boş dize belirtilirse, olay oluşturma zamanı kullanılır.

IoTHubEventSourceCreateOrUpdateParameters

IoTHub olay kaynağı için Olay Kaynağı Oluştur veya Güncelleştir işlemine sağlanan parametreler.

Name Gerekli Tür Description
eventSourceResourceId True

string

Azure Resource Manager olay kaynağının kaynak kimliği.

kind True string:

Microsoft.IoTHub

Olay kaynağının türü.

location True

string

Kaynağın konumu.

properties.consumerGroupName True

string

Olayların okunacağı bölümleri tutan iot hub'ının tüketici grubunun adı.

properties.iotHubName True

string

IoT hub'ının adı.

properties.keyName True

string

Time Series Insights hizmetine iot hub'ına erişim veren Paylaşılan Erişim İlkesi anahtarının adı. Bu paylaşılan erişim ilkesi anahtarı, iot hub'ına 'hizmet bağlantısı' izinleri vermelidir.

properties.sharedAccessKey True

string

Time Series Insights hizmetine iot hub'ına okuma erişimi veren Paylaşılan Erişim İlkesi anahtarının değeri. Bu özellik olay kaynağı yanıtlarında gösterilmez.

ingressStartAt.time

string

ISO8601 UTC tarih saat değerini saniye duyarlılığıyla (milisaniyeler isteğe bağlıdır), olayların tüketileceği başlangıç noktası olacak tarih ve saati belirtir.

ingressStartAt.type

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

localTimestamp

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklık bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

tags

object

Kaynak için ek özelliklerin anahtar-değer çiftleri.

timestampPropertyName

string

Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya boş dize belirtilirse, olay oluşturma zamanı kullanılır.

Yanıtlar

Name Tür Description
200 OK EventSourceResource:

Mevcut olay kaynağı tanımı başarıyla güncelleştirildi.

201 Created EventSourceResource:

Olay kaynağı başarıyla oluşturuldu.

Other Status Codes

CloudError

HTTP 400 (Hatalı İstek): Verilen olay kaynağı isteği gövdesi geçersiz; Ayrıntılar için yanıttaki hata koduna ve iletiye bakın.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

CreateEventHubEventSource
EventSourcesCreateEventHubWithCustomEnquedTime

CreateEventHubEventSource

Sample Request

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

{
  "location": "West US",
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "sharedAccessKey": "someSecretvalue",
    "timestampPropertyName": "someTimestampProperty",
    "localTimestamp": {
      "format": "TimeSpan",
      "timeZoneOffset": {
        "propertyName": "someEventPropertyName"
      }
    },
    "ingressStartAt": {
      "type": "EarliestAvailable"
    }
  }
}

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

EventSourcesCreateEventHubWithCustomEnquedTime

Sample Request

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

{
  "location": "West US",
  "kind": "Microsoft.EventHub",
  "properties": {
    "eventSourceResourceId": "somePathInArm",
    "serviceBusNamespace": "sbn",
    "consumerGroupName": "cgn",
    "eventHubName": "ehn",
    "keyName": "managementKey",
    "sharedAccessKey": "someSecretvalue",
    "timestampPropertyName": "someTimestampProperty",
    "ingressStartAt": {
      "type": "CustomEnqueuedTime",
      "time": "2017-04-01T19:20:33.2288820Z"
    }
  }
}

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",
    "ingressStartAt": {
      "type": "CustomEnqueuedTime",
      "time": "2017-04-01T19:20:33.2288820Z"
    }
  }
}
{
  "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",
    "ingressStartAt": {
      "type": "CustomEnqueuedTime",
      "time": "2017-04-01T19:20:33.2288820Z"
    }
  }
}

Tanımlar

Name Description
CloudError

API hatası hakkında bilgi içerir.

CloudErrorBody

Hata kodu ve ileti içeren belirli bir API hatası açıklanır.

EventHubEventSourceCreateOrUpdateParameters

EventHub olay kaynağı için Olay Kaynağı Oluştur veya Güncelleştir işlemine sağlanan parametreler.

EventHubEventSourceResource

Azure EventHub'dan verilerini alan bir olay kaynağı.

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

IoTHubEventSourceCreateOrUpdateParameters

Bir IoTHub olay kaynağı için Olay Kaynağı Oluşturma veya Güncelleştirme işlemine sağlanan parametreler.

IoTHubEventSourceResource

Azure IoTHub'dan verilerini alan olay kaynağı.

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklığı bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

LocalTimestampFormat

Ayarlanması gereken yerel zaman damgası özelliğinin biçimini temsil eden bir sabit listesi.

ProvisioningState

Kaynağın sağlama durumu.

TimeZoneOffset

Belirtilen yerel zaman damgası biçimi için uzaklık bilgilerini temsil eden bir nesne. LocalTimestampFormat - Embedded için belirtilmemelidir.

CloudError

API hatası hakkında bilgi içerir.

Name Tür Description
error

CloudErrorBody

Hata kodu ve ileti içeren belirli bir API hatası açıklanır.

CloudErrorBody

Hata kodu ve ileti içeren belirli bir API hatası açıklanır.

Name Tür Description
code

string

Http durum kodundan daha kesin bir şekilde hata koşulunu açıklayan bir hata kodu. Belirli hata durumlarını program aracılığıyla işlemek için kullanılabilir.

details

CloudErrorBody[]

Bu hatayla ilgili iç içe hatalar içerir.

message

string

Hatayı ayrıntılı olarak açıklayan ve hata ayıklama bilgileri sağlayan bir ileti.

target

string

Belirli bir hatanın hedefi (örneğin, hatadaki özelliğin adı).

EventHubEventSourceCreateOrUpdateParameters

EventHub olay kaynağı için Olay Kaynağı Oluştur veya Güncelleştir işlemine sağlanan parametreler.

Name Tür Description
creationTime

string

Kaynağın oluşturulduğu saat.

eventSourceResourceId

string

Azure Resource Manager olay kaynağının kaynak kimliği.

ingressStartAt.time

string

Utc tarih saatine saniye duyarlığıyla ISO8601 (milisaniyeler isteğe bağlıdır), olayların tüketileceği başlangıç noktası olacak tarih ve saati belirtin.

ingressStartAt.type

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

kind string:

Microsoft.EventHub

Olay kaynağının türü.

localTimestamp

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklığı bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

location

string

Kaynağın konumu.

properties.consumerGroupName

string

Olayların okunacağı bölümleri tutan olay hub'ının tüketici grubunun adı.

properties.eventHubName

string

Olay hub'ının adı.

properties.keyName

string

Olay hub'ına Time Series Insights hizmeti erişimi veren SAS anahtarının adı. Bu anahtarın paylaşılan erişim ilkeleri olay hub'ına 'Dinleme' izinleri vermelidir.

properties.serviceBusNamespace

string

Olay hub'ını içeren hizmet veri yolunun adı.

properties.sharedAccessKey

string

Time Series Insights hizmetine olay hub'ına okuma erişimi veren paylaşılan erişim anahtarının değeri. Bu özellik olay kaynağı yanıtlarında gösterilmez.

provisioningState

ProvisioningState

Kaynağın sağlama durumu.

tags

object

Kaynak için ek özelliklerin anahtar-değer çiftleri.

timestampPropertyName

string

Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya empty-string belirtilirse, olay oluşturma zamanı kullanılır.

EventHubEventSourceResource

Azure EventHub'dan verilerini alan bir olay kaynağı.

Name Tür Description
creationTime

string

Kaynağın oluşturulduğu saat.

eventSourceResourceId

string

Azure Resource Manager olay kaynağının kaynak kimliği.

id

string

Kaynak Kimliği

ingressStartAt.time

string

Utc tarih saatine saniye duyarlığıyla ISO8601 (milisaniyeler isteğe bağlıdır), olayların tüketileceği başlangıç noktası olacak tarih ve saati belirtin.

ingressStartAt.type

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

kind string:

Microsoft.EventHub

Olay kaynağının türü.

localTimestamp

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklığı bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

location

string

Kaynak konumu

name

string

Kaynak adı

properties.consumerGroupName

string

Olayların okunacağı bölümleri tutan olay hub'ının tüketici grubunun adı.

properties.eventHubName

string

Olay hub'ının adı.

properties.keyName

string

Olay hub'ına Time Series Insights hizmeti erişimi veren SAS anahtarının adı. Bu anahtarın paylaşılan erişim ilkeleri olay hub'ına 'Dinleme' izinleri vermelidir.

properties.serviceBusNamespace

string

Olay hub'ını içeren hizmet veri yolunun adı.

provisioningState

ProvisioningState

Kaynağın sağlama durumu.

tags

object

Kaynak etiketleri

timestampPropertyName

string

Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya empty-string belirtilirse, olay oluşturma zamanı kullanılır.

type

string

Kaynak türü

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

Name Tür Description
CustomEnqueuedTime

string

EarliestAvailable

string

EventSourceCreationTime

string

IoTHubEventSourceCreateOrUpdateParameters

Bir IoTHub olay kaynağı için Olay Kaynağı Oluşturma veya Güncelleştirme işlemine sağlanan parametreler.

Name Tür Description
creationTime

string

Kaynağın oluşturulduğu saat.

eventSourceResourceId

string

Azure Resource Manager olay kaynağının kaynak kimliği.

ingressStartAt.time

string

Utc tarih saatine saniye duyarlığıyla ISO8601 (milisaniyeler isteğe bağlıdır), olayların tüketileceği başlangıç noktası olacak tarih ve saati belirtin.

ingressStartAt.type

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

kind string:

Microsoft.IoTHub

Olay kaynağının türü.

localTimestamp

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklığı bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

location

string

Kaynağın konumu.

properties.consumerGroupName

string

Olayların okunacağı bölümleri tutan iot hub'ının tüketici grubunun adı.

properties.iotHubName

string

IoT hub'ının adı.

properties.keyName

string

Time Series Insights hizmetine iot hub'ına erişim veren Paylaşılan Erişim İlkesi anahtarının adı. Bu paylaşılan erişim ilkesi anahtarı, iot hub'ına 'hizmet bağlantısı' izinleri vermelidir.

properties.sharedAccessKey

string

Time Series Insights hizmetine iot hub'ına okuma erişimi veren Paylaşılan Erişim İlkesi anahtarının değeri. Bu özellik olay kaynağı yanıtlarında gösterilmez.

provisioningState

ProvisioningState

Kaynağın sağlama durumu.

tags

object

Kaynak için ek özelliklerin anahtar-değer çiftleri.

timestampPropertyName

string

Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya empty-string belirtilirse, olay oluşturma zamanı kullanılır.

IoTHubEventSourceResource

Azure IoTHub'dan verilerini alan olay kaynağı.

Name Tür Description
creationTime

string

Kaynağın oluşturulduğu saat.

eventSourceResourceId

string

Azure Resource Manager olay kaynağının kaynak kimliği.

id

string

Kaynak Kimliği

ingressStartAt.time

string

Utc tarih saatine saniye duyarlığıyla ISO8601 (milisaniyeler isteğe bağlıdır), olayların tüketileceği başlangıç noktası olacak tarih ve saati belirtin.

ingressStartAt.type

IngressStartAtType

ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir.

kind string:

Microsoft.IoTHub

Olay kaynağının türü.

localTimestamp

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklığı bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

location

string

Kaynak konumu

name

string

Kaynak adı

properties.consumerGroupName

string

Olayların okunacağı bölümleri tutan iot hub'ının tüketici grubunun adı.

properties.iotHubName

string

IoT hub'ının adı.

properties.keyName

string

Time Series Insights hizmetine iot hub'ına erişim veren Paylaşılan Erişim İlkesi anahtarının adı. Bu paylaşılan erişim ilkesi anahtarı, iot hub'ına 'hizmet bağlantısı' izinleri vermelidir.

provisioningState

ProvisioningState

Kaynağın sağlama durumu.

tags

object

Kaynak etiketleri

timestampPropertyName

string

Olay kaynağının zaman damgası olarak kullanılacak olay özelliği. timestampPropertyName için bir değer belirtilmezse veya null veya empty-string belirtilirse, olay oluşturma zamanı kullanılır.

type

string

Kaynak türü

LocalTimestamp

Yerel zaman damgası özelliğini temsil eden bir nesne. Kullanılması gereken yerel zaman damgasının biçimini ve buna karşılık gelen saat dilimi uzaklığı bilgilerini içerir. localTimestamp için bir değer belirtilmezse veya null ise, yerel zaman damgası olaylarla girilmez.

Name Tür Description
format

LocalTimestampFormat

Ayarlanması gereken yerel zaman damgası özelliğinin biçimini temsil eden bir sabit listesi.

timeZoneOffset

TimeZoneOffset

Belirtilen yerel zaman damgası biçimi için uzaklık bilgilerini temsil eden bir nesne. LocalTimestampFormat - Embedded için belirtilmemelidir.

LocalTimestampFormat

Ayarlanması gereken yerel zaman damgası özelliğinin biçimini temsil eden bir sabit listesi.

Name Tür Description
Embedded

string

ProvisioningState

Kaynağın sağlama durumu.

Name Tür Description
Accepted

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

TimeZoneOffset

Belirtilen yerel zaman damgası biçimi için uzaklık bilgilerini temsil eden bir nesne. LocalTimestampFormat - Embedded için belirtilmemelidir.

Name Tür Description
propertyName

string

Yerel zaman damgasını hesaplamak için uzaklık bilgilerini içerecek olay özelliği. LocalTimestampFormat Iana olduğunda, özellik adı IANA Saat Dilimi Adı 'nı içeren sütunun adını içerir (örneğin: Americas/Los Angeles). LocalTimestampFormat Timespan olduğunda, uzaklığı temsil eden değerleri içeren özelliğin adını içerir (örneğin: P1D veya 1.00:00:00)