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 |
---|---|---|---|---|
environment
|
path | True |
string |
Belirtilen kaynak grubuyla ilişkili Time Series Insights ortamının adı. |
event
|
path | True |
string |
Olay kaynağının adı. Regex pattern: |
resource
|
path | True |
string |
Azure Kaynak grubunun adı. |
subscription
|
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 |
---|---|
Event |
Bir EventHub olay kaynağı için Olay Kaynağı Oluşturma veya Güncelleştirme işlemine sağlanan parametreler. |
Io |
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. |
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 |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
||
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. |
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 |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
||
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 |
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
Create |
Event |
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 |
---|---|
Cloud |
API hatası hakkında bilgi içerir. |
Cloud |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
Event |
EventHub olay kaynağı için Olay Kaynağı Oluştur veya Güncelleştir işlemine sağlanan parametreler. |
Event |
Azure EventHub'dan verilerini alan bir olay kaynağı. |
Ingress |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
Io |
Bir IoTHub olay kaynağı için Olay Kaynağı Oluşturma veya Güncelleştirme işlemine sağlanan parametreler. |
Io |
Azure IoTHub'dan verilerini alan olay kaynağı. |
Local |
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. |
Local |
Ayarlanması gereken yerel zaman damgası özelliğinin biçimini temsil eden bir sabit listesi. |
Provisioning |
Kaynağın sağlama durumu. |
Time |
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 |
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 |
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 |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
|
kind |
string:
Microsoft. |
Olay kaynağının 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. |
|
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 |
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 |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
|
kind |
string:
Microsoft. |
Olay kaynağının 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. |
|
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 |
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 |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
|
kind |
string:
Microsoft. |
Olay kaynağının 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. |
|
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 |
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 |
ingressStartAt türü, "EarliestAvailable", "EventSourceCreationTime", "CustomEnqueuedTime" olabilir. |
|
kind |
string:
Microsoft. |
Olay kaynağının 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. |
|
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 |
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 |
Ayarlanması gereken yerel zaman damgası özelliğinin biçimini temsil eden bir sabit listesi. |
|
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) |