Event Hubs - Create Or Update
Létrehoz vagy frissít egy új eseményközpontot beágyazott erőforrásként egy névtéren belül.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/eventhubs/{eventHubName}?api-version=2024-01-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
event
|
path | True |
string |
Az Eseményközpont neve |
namespace
|
path | True |
string |
A névtér neve Reguláris kifejezési minta: |
resource
|
path | True |
string |
Az azure-előfizetésben található erőforráscsoport neve. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
properties.captureDescription |
A rögzítési leírás tulajdonságai |
|
properties.messageRetentionInDays |
integer |
Az eseményközpont eseményeinek megőrzéséhez szükséges napok száma, az értéknek 1–7 napnak kell lennie |
properties.partitionCount |
integer |
Az Eseményközponthoz létrehozott partíciók száma, az engedélyezett értékek 1 és 32 partíció között vannak. |
properties.retentionDescription |
Az Event Hub adatmegőrzési beállításai |
|
properties.status |
Az Eseményközpont állapotának lehetséges értékeinek számbavétele. |
|
properties.userMetadata |
string |
Lekéri és beállítja a felhasználó metaadatait. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Az Event Hub létrehozása sikerült. |
|
Other Status Codes |
Az EventHub hibaválasza, amely leírja, hogy a művelet miért nem sikerült. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
EventHubCreate
Mintakérelem
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
}
}
}
Mintaválasz
{
"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
}
}
}
Definíciók
Name | Description |
---|---|
Capture |
Az eventhub rögzítési leírásának konfigurálásához szükséges tulajdonságok |
Capture |
Egy érték, amely azt jelzi, hogy engedélyezve van-e a rögzítési leírás. |
Capture |
Az Azure Active Directory felügyelt identitásának típusa. |
Cleanup |
A törlési szabályzat lehetséges értékeinek számbavétele |
created |
Az erőforrást létrehozó identitás típusa. |
Destination |
Tárolási adatok rögzítése a rögzítés leírásához |
Encoding |
Számba adja a rögzítési leírás kódolási formátumának lehetséges értékeit. Megjegyzés: Az "AvroDeflate" elavult lesz az Új API-verzióban |
Entity |
Az Eseményközpont állapotának lehetséges értékeinek számbavétele. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
A hibaválasz azt jelzi, hogy az Event Hub szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. |
Eventhub |
Egyetlen elem a Lista vagy az Eseményközpont lekérése műveletben |
Retention |
Tulajdonságok az eventhub adatmegőrzési beállításainak konfigurálásához |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
CaptureDescription
Az eventhub rögzítési leírásának konfigurálásához szükséges tulajdonságok
Name | Típus | Description |
---|---|---|
destination |
A célhely tulajdonságai, ahol a rögzítés lesz tárolva. (Tárfiók, blobnevek) |
|
enabled |
boolean |
Egy érték, amely azt jelzi, hogy engedélyezve van-e a rögzítési leírás. |
encoding |
Számba adja a rögzítési leírás kódolási formátumának lehetséges értékeit. Megjegyzés: Az "AvroDeflate" elavult lesz az Új API-verzióban |
|
intervalInSeconds |
integer |
Az időablakban beállíthatja, hogy milyen gyakorisággal történjen a rögzítés az Azure Blobokra, az értéknek 60 és 900 másodperc között kell lennie |
sizeLimitInBytes |
integer |
A méretablak határozza meg az eseményközpontban a rögzítési művelet előtt létrehozott adatok mennyiségét, az értéknek 10485760 és 524288000 bájt között kell lennie |
skipEmptyArchives |
boolean |
Az üres archívumok kihagyását jelző érték |
CaptureIdentity
Egy érték, amely azt jelzi, hogy engedélyezve van-e a rögzítési leírás.
Name | Típus | Description |
---|---|---|
type |
Az Azure Active Directory felügyelt identitásának típusa. |
|
userAssignedIdentity |
string |
Felügyelt felhasználói identitás ARM-azonosítója. Ehhez a tulajdonsághoz a UserAssignedIdentity típus szükséges. Ha a típus SystemAssigned, akkor a rendszer a névtérhez társított rendszer hozzárendelt identitását fogja használni. |
CaptureIdentityType
Az Azure Active Directory felügyelt identitásának típusa.
Name | Típus | Description |
---|---|---|
SystemAssigned |
string |
|
UserAssigned |
string |
CleanupPolicyRetentionDescription
A törlési szabályzat lehetséges értékeinek számbavétele
Name | Típus | Description |
---|---|---|
Compact |
string |
|
Delete |
string |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
Destination
Tárolási adatok rögzítése a rögzítés leírásához
Name | Típus | Description |
---|---|---|
identity |
Egy érték, amely azt jelzi, hogy engedélyezve van-e a rögzítési leírás. |
|
name |
string |
A rögzítési cél neve |
properties.archiveNameFormat |
string |
Blobok elnevezési konvenciója az archívumhoz, például: {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Itt az összes paraméter (Névtér, EventHub stb.) kötelező, függetlenül a sorrendtől |
properties.blobContainer |
string |
Blobtároló neve |
properties.dataLakeAccountName |
string |
A rögzített események Azure Data Lake Store-neve |
properties.dataLakeFolderPath |
string |
A rögzített események célmappájának elérési útja |
properties.dataLakeSubscriptionId |
string |
Az Azure Data Lake Store előfizetés-azonosítója |
properties.storageAccountResourceId |
string |
A blobok létrehozásához használni kívánt tárfiók erőforrás-azonosítója |
EncodingCaptureDescription
Számba adja a rögzítési leírás kódolási formátumának lehetséges értékeit. Megjegyzés: Az "AvroDeflate" elavult lesz az Új API-verzióban
Name | Típus | Description |
---|---|---|
Avro |
string |
|
AvroDeflate |
string |
EntityStatus
Az Eseményközpont állapotának lehetséges értékeinek számbavétele.
Name | Típus | Description |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
ReceiveDisabled |
string |
|
Renaming |
string |
|
Restoring |
string |
|
SendDisabled |
string |
|
Unknown |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
A hibaválasz azt jelzi, hogy az Event Hub szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
Eventhub
Egyetlen elem a Lista vagy az Eseményközpont lekérése műveletben
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Az a földrajzi hely, ahol az erőforrás él |
name |
string |
Az erőforrás neve |
properties.captureDescription |
A rögzítési leírás tulajdonságai |
|
properties.createdAt |
string |
Az Eseményközpont létrehozásának pontos időpontja. |
properties.messageRetentionInDays |
integer |
Az eseményközpont eseményeinek megőrzéséhez szükséges napok száma, az értéknek 1–7 napnak kell lennie |
properties.partitionCount |
integer |
Az Eseményközponthoz létrehozott partíciók száma, az engedélyezett értékek 1 és 32 partíció között vannak. |
properties.partitionIds |
string[] |
A szegmensek aktuális száma az Event Hubon. |
properties.retentionDescription |
Az Event Hub adatmegőrzési beállításai |
|
properties.status |
Az Eseményközpont állapotának lehetséges értékeinek számbavétele. |
|
properties.updatedAt |
string |
Az üzenet frissítésének pontos időpontja. |
properties.userMetadata |
string |
Lekéri és beállítja a felhasználó metaadatait. |
systemData |
Az erőforráshoz kapcsolódó rendszer metaadatai. |
|
type |
string |
Az erőforrás típusa. Például "Microsoft.EventHub/Namespaces" vagy "Microsoft.EventHub/Namespaces/EventHubs" |
RetentionDescription
Tulajdonságok az eventhub adatmegőrzési beállításainak konfigurálásához
Name | Típus | Description |
---|---|---|
cleanupPolicy |
A törlési szabályzat lehetséges értékeinek számbavétele |
|
retentionTimeInHours |
integer |
Az eseményközpont eseményeinek megőrzéséhez szükséges órák száma. Ez az érték csak akkor használatos, ha a cleanupPolicy a Delete. Ha a cleanupPolicy kompakt, a tulajdonság visszaadott értéke Long.MaxValue |
tombstoneRetentionTimeInHours |
integer |
A tömörített eseményközpont sírkőjelölőinek megőrzéséhez tartozó órák száma. Ez az érték csak akkor használatos, ha a cleanupPolicy kompakt. A fogyasztónak be kell olvasnia a sírkőjelölőt ezen a megadott időn belül, ha a fogyasztó az eltolás kezdetétől kezdődik, hogy érvényes pillanatképet kapjon a tömörített eseményközpontban található sírkőjelölő által leírt konkrét kulcsról |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrást legutóbb módosító identitás típusa. |
lastModifiedBy |
string |
Az az identitás, amely legutóbb módosította az erőforrást. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |