Események közzététele egyéni Azure Event Grid-témakörökben hozzáférési kulcsokkal

Ez a cikk azt ismerteti, hogyan tehet közzé eseményt egy egyéni témakörbe egy hozzáférési kulcs használatával. A bejegyzés és az esemény adatainak formátumát jeleníti meg. A szolgáltatásiszint-szerződés (SLA) csak a várt formátumnak megfelelő bejegyzésekre vonatkozik.

Feljegyzés

A Microsoft Entra-hitelesítés a hozzáférési kulcs vagy a közös hozzáférésű jogosultságkód (SAS) jogkivonat-hitelesítés által kínáltnál magasabb szintű hitelesítési támogatást nyújt. A Microsoft Entra-hitelesítéssel az identitás a Microsoft Entra identitásszolgáltatón lesz érvényesítve. Fejlesztőként nem kell kezelnie a kód kulcsait, ha Microsoft Entra-hitelesítést használ. Emellett a Microsoft Identitásplatform beépített összes biztonsági funkció, például a feltételes hozzáférés előnyeit is élvezheti, amelyek segíthetnek az alkalmazás biztonsági helyzetének javításában. További információ: Közzétételi ügyfelek hitelesítése a Microsoft Entra-azonosítóval.

Végpont

Ha a HTTP POST-et egyéni témakörbe küldi, használja az URI formátumot: https://<topic-endpoint>?api-version=2018-01-01. Egy érvényes URI például a következő: https://exampletopic.westus2-1.eventgrid.azure.net/api/events?api-version=2018-01-01. Ha az Azure CLI-vel szeretné lekérni egy egyéni témakör végpontot, használja a következőt:

Azure Portal

A témakör végpontja az Eseményrács témakör lapJának Áttekintés lapján található az Azure Portalon.

Azure CLI

az eventgrid topic show --name <topic-name> -g <topic-resource-group> --query "endpoint"

Azure PowerShell

(Get-AzEventGridTopic -ResourceGroupName <topic-resource-group> -Name <topic-name>).Endpoint

Fejléc

A kérelemben adjon meg egy fejlécértéket aeg-sas-key , amely tartalmazza a hitelesítés kulcsát. Az érvényes fejlécérték például a következő aeg-sas-key: xxxxxxxxxxxxxxxxxxxxxxx: . Ha az Azure CLI használatával szeretné lekérni egy egyéni témakör kulcsát, használja a következőt:

Azure Portal

Az egyéni témakör hozzáférési kulcsának lekéréséhez válassza az Access billentyűk lapját az Azure Portal Event Grid-témakör lapján.

Azure CLI

az eventgrid topic key list --name <topic-name> -g <topic-resource-group> --query "key1"

Azure PowerShell

(Get-AzEventGridTopicKey -ResourceGroupName <topic-resource-group> -Name <topic-name>).Key1

Eseményadatok

Egyéni témakörök esetén a legfelső szintű adatok ugyanazokat a mezőket tartalmazzák, mint a standard erőforrás által definiált események. Ezen tulajdonságok egyike az data egyéni témakörhöz egyedi tulajdonságokat tartalmazó tulajdonság. Esemény közzétevőként ön határozza meg az adatobjektum tulajdonságait. A séma a következő:

[
  {
    "id": string,    
    "eventType": string,
    "subject": string,
    "eventTime": string-in-date-time-format,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string
  }
]

Ezeknek a tulajdonságoknak a leírását az Azure Event Grid eseményséma tartalmazza. Amikor egy ügyfél eseményeket küld egy Event Grid-témakörnek, a tömb teljes mérete legfeljebb 1 MB lehet. Az esemény maximális megengedett mérete szintén 1 MB. A 64 KB-nál nagyobb eseményeket 64 KB-os növekményekben számítjuk fel. Amikor egy ügyfél eseményeket fogad egy kötegben, az események maximális száma kötegenként 5000.

Egy érvényes eseményadat-séma például a következő:

[{
  "id": "1807",
  "eventType": "recordInserted",
  "subject": "myapp/vehicles/motorcycles",
  "eventTime": "2017-08-10T21:03:07+00:00",
  "data": {
    "make": "Ducati",
    "model": "Monster"
  },
  "dataVersion": "1.0"
}]

A mintaesemény elküldése

Ez a szakasz bemutatja, hogyan küldhet mintaeseményt az egyéni témakörnek.

Azure Portal

1. Az Azure Portalon indítsa el a Cloud Shellt.

2. A Cloud Shellben futtassa a parancsokat az Azure PowerShellből vagy az Azure CLI-ből a Bash- vagy PowerShell-munkamenetben.

   

Azure CLI

endpoint=$(az eventgrid topic show --name <topic name> -g <resource group name> --query "endpoint" --output tsv)

key=$(az eventgrid topic key list --name <topic name> -g <resource group name> --query "key1" --output tsv)

event='[ {"id": "'"$RANDOM"'", "eventType": "recordInserted", "subject": "myapp/vehicles/motorcycles", "eventTime": "'`date +%Y-%m-%dT%H:%M:%S%z`'", "data":{ "make": "Ducati", "model": "Monster"},"dataVersion": "1.0"} ]'

curl -X POST -H "aeg-sas-key: $key" -d "$event" $endpoint

Azure PowerShell

$resourceGroupName = "<resource group name>"
$topicName = "<topic name>"

$endpoint = (Get-AzEventGridTopic -ResourceGroupName $resourceGroupName -Name $topicName).Endpoint

$keys = Get-AzEventGridTopicKey -ResourceGroupName $resourceGroupName -Name $topicName

$eventID = Get-Random 99999
#Date format should be SortableDateTimePattern (ISO 8601)
$eventDate = Get-Date -Format s

#Construct body using Hashtable
$htbody = @{
    id= $eventID
    eventType="recordInserted"
    subject="myapp/vehicles/motorcycles"
    eventTime= $eventDate   
    data= @{
        make="Ducati"
        model="Monster"
    }
    dataVersion="1.0"
}

#Use ConvertTo-Json to convert event body from Hashtable to JSON Object
#Append square brackets to the converted JSON payload since they are expected in the event's JSON payload syntax
$body = "["+(ConvertTo-Json $htbody)+"]"

Invoke-WebRequest -Uri $endpoint -Method POST -Body $body -Headers @{"aeg-sas-key" = $keys.Key1}

Válasz

Miután közzétette a témakörvégpontot, választ kap. A válasz egy szabványos HTTP-válaszkód. Néhány gyakori válasz:

Eredmény	Válasz
Siker	200 OK
Az eseményadatok formátuma helytelen	400 Hibás kérés
Érvénytelen hozzáférési kulcs	401 Nem engedélyezett
Helytelen végpont	404 Nem található
A tömb vagy esemény túllépi a méretkorlátokat	413 Túl nagy hasznos adat

Hibák esetén az üzenettörzs formátuma a következő:

{
    "error": {
        "code": "<HTTP status code>",
        "message": "<description>",
        "details": [{
            "code": "<HTTP status code>",
            "message": "<description>"
    }]
  }
}

Kapcsolódó tartalom

• Az eseménykézbesítések monitorozásáról további információt az Event Grid üzenetkézbesítésének monitorozása című témakörben talál.
• A hitelesítési kulccsal kapcsolatos további információkért tekintse meg az Event Grid biztonságát és hitelesítését.
• Az Azure Event Grid-előfizetések létrehozásával kapcsolatos további információkért tekintse meg az Event Grid-előfizetés sémáját.