Udostępnij za pośrednictwem


Microsoft.EventHub namespaces/eventhubs 2021-11-01

Definicja zasobu Bicep

Typ zasobu przestrzeni nazw/usługi EventHubs można wdrożyć przy użyciu operacji docelowych:

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@2021-11-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    captureDescription: {
      destination: {
        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
    partitionCount: int
    status: '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

Cel

Nazwa Opis Wartość
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
partitionCount Liczba partycji utworzonych dla centrum zdarzeń dozwolone wartości to od 1 do 32 partycji. Int

Ograniczenia:
Minimalna wartość = 1
stan Wylicza możliwe wartości stanu centrum zdarzeń. "Aktywne"
"Tworzenie"
"Usuwanie"
"Wyłączone"
"ReceiveDisabled"
"Zmiana nazwy"
"Przywracanie"
"SendDisabled"
"Nieznany"

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

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:

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": "2021-11-01",
  "name": "string",
  "properties": {
    "captureDescription": {
      "destination": {
        "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",
    "partitionCount": "int",
    "status": "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

Cel

Nazwa Opis Wartość
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
partitionCount Liczba partycji utworzonych dla centrum zdarzeń dozwolone wartości to od 1 do 32 partycji. Int

Ograniczenia:
Minimalna wartość = 1
stan Wylicza możliwe wartości stanu centrum zdarzeń. "Aktywne"
"Tworzenie"
"Usuwanie"
"Wyłączone"
"ReceiveDisabled"
"Zmiana nazwy"
"Przywracanie"
"SendDisabled"
"Nieznany"

Microsoft.EventHub/przestrzenie nazw/eventhubs

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2021-11-01'
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"

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 w usłudze Azure
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 w usłudze Azure
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 w usłudze Azure
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 w usłudze Azure
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 w usłudze Azure
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 w usłudze Azure
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 w usłudze Azure
Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia centrum zdarzeń.
Wdrażanie usługi MedTech

wdrażanie w usłudze Azure
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 w usłudze Azure
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 w usłudze 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

wdrażanie w usłudze Azure
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 w usłudze Azure
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@2021-11-01"
  name = "string"
  body = jsonencode({
    properties = {
      captureDescription = {
        destination = {
          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
      partitionCount = int
      status = "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

Cel

Nazwa Opis Wartość
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
partitionCount Liczba partycji utworzonych dla centrum zdarzeń dozwolone wartości to od 1 do 32 partycji. Int

Ograniczenia:
Minimalna wartość = 1
stan Wylicza możliwe wartości stanu centrum zdarzeń. "Aktywne"
"Tworzenie"
"Usuwanie"
"Wyłączone"
"ReceiveDisabled"
"Zmiana nazwy"
"Przywracanie"
"SendDisabled"
"Nieznany"

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@2021-11-01"