Microsoft.EventHub namespaces/eventhubs
Definicja zasobu Bicep
Typ zasobu przestrzeni nazw/usługi EventHubs można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.EventHub/namespaces/eventhubs, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.EventHub/namespaces/eventhubs@2024-05-01-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
captureDescription: {
destination: {
identity: {
type: 'string'
userAssignedIdentity: 'string'
}
name: 'string'
properties: {
archiveNameFormat: 'string'
blobContainer: 'string'
dataLakeAccountName: 'string'
dataLakeFolderPath: 'string'
dataLakeSubscriptionId: 'string'
storageAccountResourceId: 'string'
}
}
enabled: bool
encoding: 'string'
intervalInSeconds: int
sizeLimitInBytes: int
skipEmptyArchives: bool
}
messageRetentionInDays: int
messageTimestampDescription: {
timestampType: 'string'
}
partitionCount: int
retentionDescription: {
cleanupPolicy: 'string'
minCompactionLagInMins: int
retentionTimeInHours: int
tombstoneRetentionTimeInHours: int
}
status: 'string'
userMetadata: 'string'
}
}
Wartości właściwości
CaptureDescription
| Nazwa | Opis | Wartość |
|---|---|---|
| cel | Właściwości miejsca docelowego, w którym będzie przechowywane przechwytywanie. (Konto magazynu, nazwy obiektów blob) | docelowa |
| Włączone | Wartość wskazująca, czy opis przechwytywania jest włączony. | Bool |
| kodowanie | Wylicza możliwe wartości dla formatu kodowania opisu przechwytywania. Uwaga: "AvroDeflate" będzie przestarzała w nowej wersji interfejsu API | "Avro" "AvroDeflate" |
| intervalInSeconds | Przedział czasu umożliwia ustawienie częstotliwości, z jaką będzie wykonywane przechwytywanie obiektów blob platformy Azure. Wartość powinna wynosić od 60 do 900 sekund | Int |
| sizeLimitInBytes | Okno rozmiaru definiuje ilość danych skompilowanych w centrum zdarzeń przed operacją przechwytywania, wartość powinna należeć między 10485760 do 524288000 bajtów | Int |
| skipEmptyArchives | Wartość wskazująca, czy pominąć puste archiwa | Bool |
CaptureIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości zarządzanej usługi Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | Identyfikator usługi ARM tożsamości użytkownika zarządzanego. Ta właściwość jest wymagana, to typ UserAssignedIdentity. Jeśli typ to SystemAssigned, zostanie użyta tożsamość przypisana przez system skojarzona z przestrzenią nazw. | struna |
Cel
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Wartość wskazująca, czy opis przechwytywania jest włączony. | CaptureIdentity |
| nazwa | Nazwa miejsca docelowego przechwytywania | struna |
| Właściwości | Właściwości opisujące konto magazynu, kontener obiektów blob i format nazwy archiwum dla miejsca docelowego przechwytywania | DestinationProperties |
Właściwości docelowe
| Nazwa | Opis | Wartość |
|---|---|---|
| archiveNameFormat | Konwencja nazewnictwa obiektów blob dla archiwum, np. {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Tutaj wszystkie parametry (przestrzeń nazw, eventhub itp.) są obowiązkowe niezależnie od kolejności | struna |
| blobContainer | Nazwa kontenera obiektów blob | struna |
| dataLakeAccountName | Nazwa usługi Azure Data Lake Store dla przechwyconych zdarzeń | struna |
| dataLakeFolderPath | Ścieżka folderu docelowego dla przechwyconych zdarzeń | struna |
| dataLakeSubscriptionId | Identyfikator subskrypcji usługi Azure Data Lake Store | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | Identyfikator zasobu konta magazynu do utworzenia obiektów blob | struna |
EventhubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| captureDescription | Właściwości opisu przechwytywania | CaptureDescription |
| messageRetentionInDays | Liczba dni przechowywania zdarzeń dla tego centrum zdarzeń, wartość powinna wynosić od 1 do 7 dni | Int Ograniczenia: Minimalna wartość = 1 |
| messageTimestampDescription | Właściwości opisu elementu MessageTimestamp | MessageTimestampDescription |
| partitionCount | Liczba partycji utworzonych dla centrum zdarzeń dozwolone wartości to od 1 do 32 partycji. | Int Ograniczenia: Minimalna wartość = 1 |
| retentionDescription | Ustawienia przechowywania centrum zdarzeń | RetentionDescription |
| stan | Wylicza możliwe wartości stanu centrum zdarzeń. | "Aktywne" "Tworzenie" "Usuwanie" "Wyłączone" "ReceiveDisabled" "Zmiana nazwy" "Przywracanie" "SendDisabled" "Nieznany" |
| userMetadata | Pobiera i ustawia metadane użytkownika. | struna |
MessageTimestampDescription
| Nazwa | Opis | Wartość |
|---|---|---|
| timestampType | Określa typ znacznika czasu, który będzie przechowywać komunikat. Dwa typy sygnatur czasowych — "AppendTime" i "CreateTime". AppendTime odwołuje się do czasu dołączenia komunikatu wewnątrz dziennika brokera. CreateTime odnosi się do czasu, w którym komunikat został wygenerowany po stronie źródłowej, a producenci mogą ustawić ten znacznik czasu podczas wysyłania komunikatu. Wartość domyślna to AppendTime. Jeśli używasz protokołu AMQP, funkcja CreateTime równa AppendTime, a jego zachowanie pozostaje takie samo. | "Utwórz" "LogAppend" |
Microsoft.EventHub/przestrzenie nazw/eventhubs
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 256 (wymagana) |
| rodzic | W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu: przestrzeni nazw |
| Właściwości | Właściwości dostarczone do operacji Tworzenie lub aktualizowanie centrum zdarzeń. | EventhubProperties |
RetentionDescription (Opis przechowywania)
| Nazwa | Opis | Wartość |
|---|---|---|
| cleanupPolicy | Wylicza możliwe wartości zasad oczyszczania | "Compact" "Usuń" "DeleteOrCompact" |
| minCompactionLagInMins | Minimalny czas, przez który komunikat pozostanie niekwalifikowany do kompaktowania w dzienniku. Ta wartość jest używana, gdy cleanupPolicy to Compact lub DeleteOrCompact. | Int |
| retentionTimeInHours | Liczba godzin przechowywania zdarzeń dla tego centrum zdarzeń. Powinna to być wartość dodatnia do maksymalnej jednostki SKU przestrzeni nazw. -1 jest specjalnym przypadkiem, w którym czas przechowywania jest nieskończony, ale rozmiar jednostki jest ograniczony, a jego rozmiar zależy od typu jednostki SKU przestrzeni nazw. | Int |
| tombstoneRetentionTimeInHours | Liczba godzin przechowywania znaczników nagrobka skompaktowanego centrum zdarzeń. Ta wartość jest używana, gdy cleanupPolicy to Compact lub DeleteOrCompact. Użytkownik musi ukończyć odczytywanie znacznika grobowca w określonym czasie, jeśli użytkownik rozpoczyna się od przesunięcia początkowego, aby upewnić się, że otrzyma prawidłową migawkę dla określonego klucza opisanego przez znacznik grobowca w skompaktowanym centrum zdarzeń | Int |
Przykłady z przewodnika Szybki start
W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.
| Plik Bicep | Opis |
|---|---|
| usługi Azure Digital Twins z połączeniem historii danych czasowych | Ten szablon tworzy wystąpienie usługi Azure Digital Twins skonfigurowane przy użyciu połączenia historii danych szeregów czasowych. Aby utworzyć połączenie, należy utworzyć inne zasoby, takie jak przestrzeń nazw usługi Event Hubs, centrum zdarzeń, klaster usługi Azure Data Explorer i baza danych. Dane są wysyłane do centrum zdarzeń, które ostatecznie przekazuje dane do klastra usługi Azure Data Explorer. Dane są przechowywane w tabeli bazy danych w klastrze |
| aplikacji funkcji platformy Azure z usługą Event Hub i tożsamością zarządzaną | jego szablon aprowizuje aplikację funkcji platformy Azure w planie użycia systemu Linux wraz z centrum zdarzeń, usługą Azure Storage i usługą Application Insights. Aplikacja funkcji może używać tożsamości zarządzanej do nawiązywania połączenia z usługą Event Hub i kontem magazynu |
| Tworzenie centrum zdarzeń | Ten szablon umożliwia wdrożenie przestrzeni nazw usługi EventHubs za pomocą centrum zdarzeń. |
| tworzenie przestrzeni nazw usługi EventHubs, centrum zdarzeń & grupy odbiorców | Ten szablon umożliwia wdrożenie standardowej przestrzeni nazw usługi Event Hubs, centrum zdarzeń i grupy odbiorców. |
| tworzy klaster eventhub, nazwy & eventhub | Ten szablon umożliwia tworzenie klastra usługi EventHubs, przestrzeni nazw i usługi EventHub w klastrze |
| wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Event Grid | Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia usługi Event Grid. |
| wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia centrum zdarzeń | Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia centrum zdarzeń. |
| Wdrażanie usługi MedTech | Usługa MedTech jest jedną z usług Azure Health Data Services zaprojektowanych do pozyskiwania danych urządzeń z wielu urządzeń, przekształcania danych urządzenia w obserwacje FHIR, które następnie są utrwalane w usłudze FHIR usług Azure Health Data Services. |
| Wdrażanie usługi MedTech, w tym usługi Azure IoT Hub | Usługa MedTech jest jedną z usług Azure Health Data Services zaprojektowanych do pozyskiwania danych urządzeń z wielu urządzeń, przekształcania danych urządzenia w obserwacje FHIR, które następnie są utrwalane w usłudze FHIR usług Azure Health Data Services. |
| wdrażanie analizy sportowej na platformie Azure | Tworzy konto magazynu platformy Azure z włączoną usługą ADLS Gen 2, wystąpieniem usługi Azure Data Factory z połączonymi usługami dla konta magazynu (jeśli została wdrożona usługa Azure SQL Database) i wystąpieniem usługi Azure Databricks. Tożsamość usługi AAD dla użytkownika wdrażającego szablon i tożsamość zarządzana dla wystąpienia usługi ADF otrzymają rolę Współautor danych obiektu blob usługi Storage na koncie magazynu. Dostępne są również opcje wdrażania wystąpienia usługi Azure Key Vault, usługi Azure SQL Database i usługi Azure Event Hub (w przypadku przypadków użycia przesyłania strumieniowego). Po wdrożeniu usługi Azure Key Vault tożsamość zarządzana fabryki danych i tożsamość usługi AAD dla użytkownika wdrażającego szablon otrzymają rolę Użytkownik wpisów tajnych usługi Key Vault. |
| frontdoor CDN z zaporą aplikacji internetowej, domenami i dziennikami do usługi EventHub | Ten szablon tworzy nowy profil cdn usługi Azure FrontDoor. Utwórz zaporę aplikacji internetowej z niestandardowymi i zarządzanymi regułami, trasami cdn, źródłami i grupami ze skojarzeniem z zaporą aplikacji internetowej i trasami, konfiguruje domeny niestandardowe, twórz centrum zdarzeń i ustawienia diagnostyczne do wysyłania dzienników dostępu usługi CDN przy użyciu centrum zdarzeń. |
| Moesif API Analytics and Monetization | Szablon będzie rejestrować wywołania interfejsu API z usługi Azure API Management do analizy interfejsu API Moesif i platformy zarabiania |
Definicja zasobu szablonu usługi ARM
Typ zasobu przestrzeni nazw/usługi EventHubs można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.EventHub/namespaces/eventhubs, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.EventHub/namespaces/eventhubs",
"apiVersion": "2024-05-01-preview",
"name": "string",
"properties": {
"captureDescription": {
"destination": {
"identity": {
"type": "string",
"userAssignedIdentity": "string"
},
"name": "string",
"properties": {
"archiveNameFormat": "string",
"blobContainer": "string",
"dataLakeAccountName": "string",
"dataLakeFolderPath": "string",
"dataLakeSubscriptionId": "string",
"storageAccountResourceId": "string"
}
},
"enabled": "bool",
"encoding": "string",
"intervalInSeconds": "int",
"sizeLimitInBytes": "int",
"skipEmptyArchives": "bool"
},
"messageRetentionInDays": "int",
"messageTimestampDescription": {
"timestampType": "string"
},
"partitionCount": "int",
"retentionDescription": {
"cleanupPolicy": "string",
"minCompactionLagInMins": "int",
"retentionTimeInHours": "int",
"tombstoneRetentionTimeInHours": "int"
},
"status": "string",
"userMetadata": "string"
}
}
Wartości właściwości
CaptureDescription
| Nazwa | Opis | Wartość |
|---|---|---|
| cel | Właściwości miejsca docelowego, w którym będzie przechowywane przechwytywanie. (Konto magazynu, nazwy obiektów blob) | docelowa |
| Włączone | Wartość wskazująca, czy opis przechwytywania jest włączony. | Bool |
| kodowanie | Wylicza możliwe wartości dla formatu kodowania opisu przechwytywania. Uwaga: "AvroDeflate" będzie przestarzała w nowej wersji interfejsu API | "Avro" "AvroDeflate" |
| intervalInSeconds | Przedział czasu umożliwia ustawienie częstotliwości, z jaką będzie wykonywane przechwytywanie obiektów blob platformy Azure. Wartość powinna wynosić od 60 do 900 sekund | Int |
| sizeLimitInBytes | Okno rozmiaru definiuje ilość danych skompilowanych w centrum zdarzeń przed operacją przechwytywania, wartość powinna należeć między 10485760 do 524288000 bajtów | Int |
| skipEmptyArchives | Wartość wskazująca, czy pominąć puste archiwa | Bool |
CaptureIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości zarządzanej usługi Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | Identyfikator usługi ARM tożsamości użytkownika zarządzanego. Ta właściwość jest wymagana, to typ UserAssignedIdentity. Jeśli typ to SystemAssigned, zostanie użyta tożsamość przypisana przez system skojarzona z przestrzenią nazw. | struna |
Cel
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Wartość wskazująca, czy opis przechwytywania jest włączony. | CaptureIdentity |
| nazwa | Nazwa miejsca docelowego przechwytywania | struna |
| Właściwości | Właściwości opisujące konto magazynu, kontener obiektów blob i format nazwy archiwum dla miejsca docelowego przechwytywania | DestinationProperties |
Właściwości docelowe
| Nazwa | Opis | Wartość |
|---|---|---|
| archiveNameFormat | Konwencja nazewnictwa obiektów blob dla archiwum, np. {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Tutaj wszystkie parametry (przestrzeń nazw, eventhub itp.) są obowiązkowe niezależnie od kolejności | struna |
| blobContainer | Nazwa kontenera obiektów blob | struna |
| dataLakeAccountName | Nazwa usługi Azure Data Lake Store dla przechwyconych zdarzeń | struna |
| dataLakeFolderPath | Ścieżka folderu docelowego dla przechwyconych zdarzeń | struna |
| dataLakeSubscriptionId | Identyfikator subskrypcji usługi Azure Data Lake Store | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | Identyfikator zasobu konta magazynu do utworzenia obiektów blob | struna |
EventhubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| captureDescription | Właściwości opisu przechwytywania | CaptureDescription |
| messageRetentionInDays | Liczba dni przechowywania zdarzeń dla tego centrum zdarzeń, wartość powinna wynosić od 1 do 7 dni | Int Ograniczenia: Minimalna wartość = 1 |
| messageTimestampDescription | Właściwości opisu elementu MessageTimestamp | MessageTimestampDescription |
| partitionCount | Liczba partycji utworzonych dla centrum zdarzeń dozwolone wartości to od 1 do 32 partycji. | Int Ograniczenia: Minimalna wartość = 1 |
| retentionDescription | Ustawienia przechowywania centrum zdarzeń | RetentionDescription |
| stan | Wylicza możliwe wartości stanu centrum zdarzeń. | "Aktywne" "Tworzenie" "Usuwanie" "Wyłączone" "ReceiveDisabled" "Zmiana nazwy" "Przywracanie" "SendDisabled" "Nieznany" |
| userMetadata | Pobiera i ustawia metadane użytkownika. | struna |
MessageTimestampDescription
| Nazwa | Opis | Wartość |
|---|---|---|
| timestampType | Określa typ znacznika czasu, który będzie przechowywać komunikat. Dwa typy sygnatur czasowych — "AppendTime" i "CreateTime". AppendTime odwołuje się do czasu dołączenia komunikatu wewnątrz dziennika brokera. CreateTime odnosi się do czasu, w którym komunikat został wygenerowany po stronie źródłowej, a producenci mogą ustawić ten znacznik czasu podczas wysyłania komunikatu. Wartość domyślna to AppendTime. Jeśli używasz protokołu AMQP, funkcja CreateTime równa AppendTime, a jego zachowanie pozostaje takie samo. | "Utwórz" "LogAppend" |
Microsoft.EventHub/przestrzenie nazw/eventhubs
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | "2024-05-01-preview" |
| nazwa | Nazwa zasobu | struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 256 (wymagana) |
| Właściwości | Właściwości dostarczone do operacji Tworzenie lub aktualizowanie centrum zdarzeń. | EventhubProperties |
| typ | Typ zasobu | "Microsoft.EventHub/namespaces/eventhubs" |
RetentionDescription (Opis przechowywania)
| Nazwa | Opis | Wartość |
|---|---|---|
| cleanupPolicy | Wylicza możliwe wartości zasad oczyszczania | "Compact" "Usuń" "DeleteOrCompact" |
| minCompactionLagInMins | Minimalny czas, przez który komunikat pozostanie niekwalifikowany do kompaktowania w dzienniku. Ta wartość jest używana, gdy cleanupPolicy to Compact lub DeleteOrCompact. | Int |
| retentionTimeInHours | Liczba godzin przechowywania zdarzeń dla tego centrum zdarzeń. Powinna to być wartość dodatnia do maksymalnej jednostki SKU przestrzeni nazw. -1 jest specjalnym przypadkiem, w którym czas przechowywania jest nieskończony, ale rozmiar jednostki jest ograniczony, a jego rozmiar zależy od typu jednostki SKU przestrzeni nazw. | Int |
| tombstoneRetentionTimeInHours | Liczba godzin przechowywania znaczników nagrobka skompaktowanego centrum zdarzeń. Ta wartość jest używana, gdy cleanupPolicy to Compact lub DeleteOrCompact. Użytkownik musi ukończyć odczytywanie znacznika grobowca w określonym czasie, jeśli użytkownik rozpoczyna się od przesunięcia początkowego, aby upewnić się, że otrzyma prawidłową migawkę dla określonego klucza opisanego przez znacznik grobowca w skompaktowanym centrum zdarzeń | Int |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Szablon | Opis |
|---|---|
|
usługi Azure Digital Twins z połączeniem historii danych czasowych wdrażanie  |
Ten szablon tworzy wystąpienie usługi Azure Digital Twins skonfigurowane przy użyciu połączenia historii danych szeregów czasowych. Aby utworzyć połączenie, należy utworzyć inne zasoby, takie jak przestrzeń nazw usługi Event Hubs, centrum zdarzeń, klaster usługi Azure Data Explorer i baza danych. Dane są wysyłane do centrum zdarzeń, które ostatecznie przekazuje dane do klastra usługi Azure Data Explorer. Dane są przechowywane w tabeli bazy danych w klastrze |
|
aplikacji funkcji platformy Azure z usługą Event Hub i tożsamością zarządzaną wdrażanie |
jego szablon aprowizuje aplikację funkcji platformy Azure w planie użycia systemu Linux wraz z centrum zdarzeń, usługą Azure Storage i usługą Application Insights. Aplikacja funkcji może używać tożsamości zarządzanej do nawiązywania połączenia z usługą Event Hub i kontem magazynu |
|
Tworzenie centrum zdarzeń wdrażanie |
Ten szablon umożliwia wdrożenie przestrzeni nazw usługi EventHubs za pomocą centrum zdarzeń. |
|
tworzenie przestrzeni nazw usługi EventHubs, centrum zdarzeń & grupy odbiorców wdrażanie |
Ten szablon umożliwia wdrożenie standardowej przestrzeni nazw usługi Event Hubs, centrum zdarzeń i grupy odbiorców. |
|
tworzy klaster eventhub, nazwy & eventhub wdrażanie |
Ten szablon umożliwia tworzenie klastra usługi EventHubs, przestrzeni nazw i usługi EventHub w klastrze |
|
wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Event Grid wdrażanie |
Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia usługi Event Grid. |
|
wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia centrum zdarzeń wdrażanie |
Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia centrum zdarzeń. |
|
Wdrażanie usługi MedTech wdrażanie |
Usługa MedTech jest jedną z usług Azure Health Data Services zaprojektowanych do pozyskiwania danych urządzeń z wielu urządzeń, przekształcania danych urządzenia w obserwacje FHIR, które następnie są utrwalane w usłudze FHIR usług Azure Health Data Services. |
|
Wdrażanie usługi MedTech, w tym usługi Azure IoT Hub wdrażanie |
Usługa MedTech jest jedną z usług Azure Health Data Services zaprojektowanych do pozyskiwania danych urządzeń z wielu urządzeń, przekształcania danych urządzenia w obserwacje FHIR, które następnie są utrwalane w usłudze FHIR usług Azure Health Data Services. |
|
wdrażanie analizy sportowej na platformie Azure wdrażanie |
Tworzy konto magazynu platformy Azure z włączoną usługą ADLS Gen 2, wystąpieniem usługi Azure Data Factory z połączonymi usługami dla konta magazynu (jeśli została wdrożona usługa Azure SQL Database) i wystąpieniem usługi Azure Databricks. Tożsamość usługi AAD dla użytkownika wdrażającego szablon i tożsamość zarządzana dla wystąpienia usługi ADF otrzymają rolę Współautor danych obiektu blob usługi Storage na koncie magazynu. Dostępne są również opcje wdrażania wystąpienia usługi Azure Key Vault, usługi Azure SQL Database i usługi Azure Event Hub (w przypadku przypadków użycia przesyłania strumieniowego). Po wdrożeniu usługi Azure Key Vault tożsamość zarządzana fabryki danych i tożsamość usługi AAD dla użytkownika wdrażającego szablon otrzymają rolę Użytkownik wpisów tajnych usługi Key Vault. |
|
frontdoor CDN z zaporą aplikacji internetowej, domenami i dziennikami do usługi EventHub wdrażanie |
Ten szablon tworzy nowy profil cdn usługi Azure FrontDoor. Utwórz zaporę aplikacji internetowej z niestandardowymi i zarządzanymi regułami, trasami cdn, źródłami i grupami ze skojarzeniem z zaporą aplikacji internetowej i trasami, konfiguruje domeny niestandardowe, twórz centrum zdarzeń i ustawienia diagnostyczne do wysyłania dzienników dostępu usługi CDN przy użyciu centrum zdarzeń. |
|
Moesif API Analytics and Monetization wdrażanie |
Szablon będzie rejestrować wywołania interfejsu API z usługi Azure API Management do analizy interfejsu API Moesif i platformy zarabiania |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu przestrzeni nazw/usługi EventHubs można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.EventHub/namespaces/eventhubs, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventHub/namespaces/eventhubs@2024-05-01-preview"
name = "string"
body = jsonencode({
properties = {
captureDescription = {
destination = {
identity = {
type = "string"
userAssignedIdentity = "string"
}
name = "string"
properties = {
archiveNameFormat = "string"
blobContainer = "string"
dataLakeAccountName = "string"
dataLakeFolderPath = "string"
dataLakeSubscriptionId = "string"
storageAccountResourceId = "string"
}
}
enabled = bool
encoding = "string"
intervalInSeconds = int
sizeLimitInBytes = int
skipEmptyArchives = bool
}
messageRetentionInDays = int
messageTimestampDescription = {
timestampType = "string"
}
partitionCount = int
retentionDescription = {
cleanupPolicy = "string"
minCompactionLagInMins = int
retentionTimeInHours = int
tombstoneRetentionTimeInHours = int
}
status = "string"
userMetadata = "string"
}
})
}
Wartości właściwości
CaptureDescription
| Nazwa | Opis | Wartość |
|---|---|---|
| cel | Właściwości miejsca docelowego, w którym będzie przechowywane przechwytywanie. (Konto magazynu, nazwy obiektów blob) | docelowa |
| Włączone | Wartość wskazująca, czy opis przechwytywania jest włączony. | Bool |
| kodowanie | Wylicza możliwe wartości dla formatu kodowania opisu przechwytywania. Uwaga: "AvroDeflate" będzie przestarzała w nowej wersji interfejsu API | "Avro" "AvroDeflate" |
| intervalInSeconds | Przedział czasu umożliwia ustawienie częstotliwości, z jaką będzie wykonywane przechwytywanie obiektów blob platformy Azure. Wartość powinna wynosić od 60 do 900 sekund | Int |
| sizeLimitInBytes | Okno rozmiaru definiuje ilość danych skompilowanych w centrum zdarzeń przed operacją przechwytywania, wartość powinna należeć między 10485760 do 524288000 bajtów | Int |
| skipEmptyArchives | Wartość wskazująca, czy pominąć puste archiwa | Bool |
CaptureIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości zarządzanej usługi Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | Identyfikator usługi ARM tożsamości użytkownika zarządzanego. Ta właściwość jest wymagana, to typ UserAssignedIdentity. Jeśli typ to SystemAssigned, zostanie użyta tożsamość przypisana przez system skojarzona z przestrzenią nazw. | struna |
Cel
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Wartość wskazująca, czy opis przechwytywania jest włączony. | CaptureIdentity |
| nazwa | Nazwa miejsca docelowego przechwytywania | struna |
| Właściwości | Właściwości opisujące konto magazynu, kontener obiektów blob i format nazwy archiwum dla miejsca docelowego przechwytywania | DestinationProperties |
Właściwości docelowe
| Nazwa | Opis | Wartość |
|---|---|---|
| archiveNameFormat | Konwencja nazewnictwa obiektów blob dla archiwum, np. {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Tutaj wszystkie parametry (przestrzeń nazw, eventhub itp.) są obowiązkowe niezależnie od kolejności | struna |
| blobContainer | Nazwa kontenera obiektów blob | struna |
| dataLakeAccountName | Nazwa usługi Azure Data Lake Store dla przechwyconych zdarzeń | struna |
| dataLakeFolderPath | Ścieżka folderu docelowego dla przechwyconych zdarzeń | struna |
| dataLakeSubscriptionId | Identyfikator subskrypcji usługi Azure Data Lake Store | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | Identyfikator zasobu konta magazynu do utworzenia obiektów blob | struna |
EventhubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| captureDescription | Właściwości opisu przechwytywania | CaptureDescription |
| messageRetentionInDays | Liczba dni przechowywania zdarzeń dla tego centrum zdarzeń, wartość powinna wynosić od 1 do 7 dni | Int Ograniczenia: Minimalna wartość = 1 |
| messageTimestampDescription | Właściwości opisu elementu MessageTimestamp | MessageTimestampDescription |
| partitionCount | Liczba partycji utworzonych dla centrum zdarzeń dozwolone wartości to od 1 do 32 partycji. | Int Ograniczenia: Minimalna wartość = 1 |
| retentionDescription | Ustawienia przechowywania centrum zdarzeń | RetentionDescription |
| stan | Wylicza możliwe wartości stanu centrum zdarzeń. | "Aktywne" "Tworzenie" "Usuwanie" "Wyłączone" "ReceiveDisabled" "Zmiana nazwy" "Przywracanie" "SendDisabled" "Nieznany" |
| userMetadata | Pobiera i ustawia metadane użytkownika. | struna |
MessageTimestampDescription
| Nazwa | Opis | Wartość |
|---|---|---|
| timestampType | Określa typ znacznika czasu, który będzie przechowywać komunikat. Dwa typy sygnatur czasowych — "AppendTime" i "CreateTime". AppendTime odwołuje się do czasu dołączenia komunikatu wewnątrz dziennika brokera. CreateTime odnosi się do czasu, w którym komunikat został wygenerowany po stronie źródłowej, a producenci mogą ustawić ten znacznik czasu podczas wysyłania komunikatu. Wartość domyślna to AppendTime. Jeśli używasz protokołu AMQP, funkcja CreateTime równa AppendTime, a jego zachowanie pozostaje takie samo. | "Utwórz" "LogAppend" |
Microsoft.EventHub/przestrzenie nazw/eventhubs
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 256 (wymagana) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: przestrzeni nazw |
| Właściwości | Właściwości dostarczone do operacji Tworzenie lub aktualizowanie centrum zdarzeń. | EventhubProperties |
| typ | Typ zasobu | "Microsoft.EventHub/namespaces/eventhubs@2024-05-01-preview" |
RetentionDescription (Opis przechowywania)
| Nazwa | Opis | Wartość |
|---|---|---|
| cleanupPolicy | Wylicza możliwe wartości zasad oczyszczania | "Compact" "Usuń" "DeleteOrCompact" |
| minCompactionLagInMins | Minimalny czas, przez który komunikat pozostanie niekwalifikowany do kompaktowania w dzienniku. Ta wartość jest używana, gdy cleanupPolicy to Compact lub DeleteOrCompact. | Int |
| retentionTimeInHours | Liczba godzin przechowywania zdarzeń dla tego centrum zdarzeń. Powinna to być wartość dodatnia do maksymalnej jednostki SKU przestrzeni nazw. -1 jest specjalnym przypadkiem, w którym czas przechowywania jest nieskończony, ale rozmiar jednostki jest ograniczony, a jego rozmiar zależy od typu jednostki SKU przestrzeni nazw. | Int |
| tombstoneRetentionTimeInHours | Liczba godzin przechowywania znaczników nagrobka skompaktowanego centrum zdarzeń. Ta wartość jest używana, gdy cleanupPolicy to Compact lub DeleteOrCompact. Użytkownik musi ukończyć odczytywanie znacznika grobowca w określonym czasie, jeśli użytkownik rozpoczyna się od przesunięcia początkowego, aby upewnić się, że otrzyma prawidłową migawkę dla określonego klucza opisanego przez znacznik grobowca w skompaktowanym centrum zdarzeń | Int |