Event Hubs - Create Or Update
Ad Alanı içinde iç içe yerleştirilmiş bir kaynak olarak yeni bir Olay Hub'ı oluşturur veya güncelleştirir.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/eventhubs/{eventHubName}?api-version=2024-01-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
event
|
path | True |
string |
Olay Hub'ı adı |
namespace
|
path | True |
string |
Ad alanı adı Normal ifade deseni: |
resource
|
path | True |
string |
Azure aboneliğindeki kaynak grubunun adı. |
subscription
|
path | True |
string |
Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur. |
api-version
|
query | True |
string |
İstemci API Sürümü. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
properties.captureDescription |
Yakalama açıklamasının özellikleri |
|
properties.messageRetentionInDays |
integer |
Bu Olay Hub'ına ait olayların tutulacağı gün sayısı; değer 1 ile 7 gün aramalıdır |
properties.partitionCount |
integer |
Olay Hub'ı için oluşturulan bölüm sayısı; izin verilen değerler 1 ile 32 bölüm olabilir. |
properties.retentionDescription |
Olay Hub'ı bekletme ayarları |
|
properties.status |
Olay Hub'ının durumu için olası değerleri numaralandırır. |
|
properties.userMetadata |
string |
Kullanıcının Meta Verilerini Alır ve Ayarlar. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Olay Hub'ı başarıyla oluşturuldu. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan Eventhub hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
EventHubCreate
Örnek isteği
PUT https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-5357/eventhubs/sdk-EventHub-6547?api-version=2024-01-01
{
"properties": {
"messageRetentionInDays": 4,
"partitionCount": 4,
"status": "Active",
"userMetadata": "key",
"captureDescription": {
"enabled": true,
"encoding": "Avro",
"destination": {
"name": "EventHubArchive.AzureBlockBlob",
"properties": {
"storageAccountResourceId": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
"blobContainer": "container",
"archiveNameFormat": "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"
}
},
"intervalInSeconds": 120,
"sizeLimitInBytes": 10485763
},
"retentionDescription": {
"cleanupPolicy": "Compact",
"retentionTimeInHours": 96,
"tombstoneRetentionTimeInHours": 1
}
}
}
Örnek yanıt
{
"id": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-716/eventhubs/sdk-EventHub-10",
"name": "sdk-EventHub-10",
"type": "Microsoft.EventHub/Namespaces/EventHubs",
"properties": {
"messageRetentionInDays": 4,
"partitionCount": 4,
"status": "Active",
"userMetadata": "key",
"createdAt": "2017-06-28T02:45:55.877Z",
"updatedAt": "2017-06-28T02:46:05.877Z",
"partitionIds": [
"0",
"1",
"2",
"3"
],
"captureDescription": {
"enabled": true,
"encoding": "Avro",
"destination": {
"name": "EventHubArchive.AzureBlockBlob",
"properties": {
"storageAccountResourceId": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
"blobContainer": "container",
"archiveNameFormat": "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"
}
},
"intervalInSeconds": 120,
"sizeLimitInBytes": 10485763
},
"retentionDescription": {
"cleanupPolicy": "Compact",
"retentionTimeInHours": 96,
"tombstoneRetentionTimeInHours": 1
}
}
}
Tanımlar
Name | Description |
---|---|
Capture |
eventhub için yakalama açıklamasını yapılandıracak özellikler |
Capture |
Yakalama açıklamasının etkinleştirilip etkinleştirilmediğini gösteren değer. |
Capture |
Azure Active Directory Yönetilen Kimliği türü. |
Cleanup |
Temizleme ilkesi için olası değerleri numaralandırır |
created |
Kaynağı oluşturan kimliğin türü. |
Destination |
Yakalama açıklaması için depolama ayrıntılarını yakalama |
Encoding |
Yakalama açıklamasının kodlama biçimi için olası değerleri numaralandırır. Not: 'AvroDeflate' Yeni API Sürümünde kullanım dışı bırakılacak |
Entity |
Olay Hub'ının durumu için olası değerleri numaralandırır. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı, Event Hub hizmetinin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir. |
Eventhub |
Listele veya Olay Hub'ı Al işlemindeki tek öğe |
Retention |
Eventhub için bekletme ayarlarını yapılandırma özellikleri |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
CaptureDescription
eventhub için yakalama açıklamasını yapılandıracak özellikler
Name | Tür | Description |
---|---|---|
destination |
Yakalamanın depolandığı Hedefin özellikleri. (Depolama Hesabı, Blob Adları) |
|
enabled |
boolean |
Yakalama açıklamasının etkinleştirilip etkinleştirilmediğini gösteren değer. |
encoding |
Yakalama açıklamasının kodlama biçimi için olası değerleri numaralandırır. Not: 'AvroDeflate' Yeni API Sürümünde kullanım dışı bırakılacak |
|
intervalInSeconds |
integer |
Zaman penceresi, Azure Bloblarına yakalamanın gerçekleşeceği sıklığı ayarlamanıza olanak tanır, değer 60 ila 900 saniye arasında olmalıdır |
sizeLimitInBytes |
integer |
Boyut penceresi, bir yakalama işleminden önce Olay Hub'ınızda oluşturulan veri miktarını tanımlar, değer 10485760 ile 524288000 bayt arasında olmalıdır |
skipEmptyArchives |
boolean |
Boş Arşivlerin Atlanıp Atlanmayacağını gösteren bir değer |
CaptureIdentity
Yakalama açıklamasının etkinleştirilip etkinleştirilmediğini gösteren değer.
Name | Tür | Description |
---|---|---|
type |
Azure Active Directory Yönetilen Kimliği türü. |
|
userAssignedIdentity |
string |
Yönetilen Kullanıcı Kimliğinin ARM Kimliği. Bu özellik UserAssignedIdentity türünde gereklidir. Tür SystemAssigned ise, ad alanıyla ilişkili Sistem Tarafından Atanan Kimlik kullanılır. |
CaptureIdentityType
Azure Active Directory Yönetilen Kimliği türü.
Name | Tür | Description |
---|---|---|
SystemAssigned |
string |
|
UserAssigned |
string |
CleanupPolicyRetentionDescription
Temizleme ilkesi için olası değerleri numaralandırır
Name | Tür | Description |
---|---|---|
Compact |
string |
|
Delete |
string |
createdByType
Kaynağı oluşturan kimliğin türü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Destination
Yakalama açıklaması için depolama ayrıntılarını yakalama
Name | Tür | Description |
---|---|---|
identity |
Yakalama açıklamasının etkinleştirilip etkinleştirilmediğini gösteren değer. |
|
name |
string |
Yakalama hedefinin adı |
properties.archiveNameFormat |
string |
Arşiv için blob adlandırma kuralı, örneğin {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Burada sıralamadan bağımsız olarak tüm parametreler (Namespace,EventHub .. vb.) zorunlu olarak bulunur |
properties.blobContainer |
string |
Blob kapsayıcı adı |
properties.dataLakeAccountName |
string |
Yakalanan olaylar için Azure Data Lake Store adı |
properties.dataLakeFolderPath |
string |
Yakalanan olaylar için hedef klasör yolu |
properties.dataLakeSubscriptionId |
string |
Azure Data Lake Store'un Abonelik Kimliği |
properties.storageAccountResourceId |
string |
Blobları oluşturmak için kullanılacak depolama hesabının kaynak kimliği |
EncodingCaptureDescription
Yakalama açıklamasının kodlama biçimi için olası değerleri numaralandırır. Not: 'AvroDeflate' Yeni API Sürümünde kullanım dışı bırakılacak
Name | Tür | Description |
---|---|---|
Avro |
string |
|
AvroDeflate |
string |
EntityStatus
Olay Hub'ının durumu için olası değerleri numaralandırır.
Name | Tür | Description |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
ReceiveDisabled |
string |
|
Renaming |
string |
|
Restoring |
string |
|
SendDisabled |
string |
|
Unknown |
string |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı, Event Hub hizmetinin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir.
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
Eventhub
Listele veya Olay Hub'ı Al işlemindeki tek öğe
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Kaynağın bulunduğu coğrafi konum |
name |
string |
Kaynağın adı |
properties.captureDescription |
Yakalama açıklamasının özellikleri |
|
properties.createdAt |
string |
Olay Hub'ını tam olarak oluşturma zamanı. |
properties.messageRetentionInDays |
integer |
Bu Olay Hub'ına ait olayların tutulacağı gün sayısı; değer 1 ile 7 gün aramalıdır |
properties.partitionCount |
integer |
Olay Hub'ı için oluşturulan bölüm sayısı; izin verilen değerler 1 ile 32 bölüm olabilir. |
properties.partitionIds |
string[] |
Olay Hub'ının geçerli parça sayısı. |
properties.retentionDescription |
Olay Hub'ı bekletme ayarları |
|
properties.status |
Olay Hub'ının durumu için olası değerleri numaralandırır. |
|
properties.updatedAt |
string |
İletinin tam olarak güncelleştirilişi. |
properties.userMetadata |
string |
Kullanıcının Meta Verilerini Alır ve Ayarlar. |
systemData |
Bu kaynakla ilgili sistem meta verileri. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.EventHub/Namespaces" veya "Microsoft.EventHub/Namespaces/EventHubs" |
RetentionDescription
Eventhub için bekletme ayarlarını yapılandırma özellikleri
Name | Tür | Description |
---|---|---|
cleanupPolicy |
Temizleme ilkesi için olası değerleri numaralandırır |
|
retentionTimeInHours |
integer |
Bu Olay Hub'ına ait olayların tutulacak saat sayısı. Bu değer yalnızca cleanupPolicy Delete olduğunda kullanılır. cleanupPolicy Sıkıştır ise, bu özelliğin döndürülen değeri Long.MaxValue'dır |
tombstoneRetentionTimeInHours |
integer |
Sıkıştırılmış bir Olay Hub'ının kaldırılmış işaretleyicilerinin tutulacak saat sayısı. Bu değer yalnızca cleanupPolicy Compact olduğunda kullanılır. Tüketici, sıkıştırılmış Olay Hub'ının içindeki silinmiş öğe işareti tarafından açıklanan belirli bir anahtar için geçerli bir anlık görüntü elde etmek üzere uzaklığı başlatmaya başlarsa, tüketicinin belirtilen süre içinde silinmiş öğe işareti okuma işlemini tamamlaması gerekir |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
Kaynağı en son değiştiren kimliğin türü. |
lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimliğin türü. |