Publicera händelser till Azure Event Grid-anpassade ämnen genom att använda accessnycklar

Ett Event Grid-anpassat ämne är en endpoint som dina applikationer skickar sina egna händelser till, så att Event Grid kan dirigera dessa händelser till intresserade prenumeranter. Den här artikeln visar hur du publicerar händelser till ett anpassat ämne med hjälp av accessnycklar, som autentiserar dina förfrågningar utan att du behöver ställa in Microsoft Entra ID. Du får ämnesändpunkten och accessnyckeln, formaterar en händelsepayload, skickar ett exempelevent och granskar svaret.

Service Level Agreement (SLA) gäller endast för inlägg som matchar det förväntade formatet.

Förutsättningar

• Ett anpassat ämne för Azure Event Grid. För att skapa en, se Skicka anpassade händelser till en webbterminal genom att använda Azure-portalen.
• Azure CLI,Azure PowerShell, eller tillgång till Azure-portalen för att hämta ämnesändpunkten och åtkomstnyckeln.
• Ett verktyg som kan skicka HTTP POST-förfrågningar, såsom curl.

Hämta ämnesslutpunkten

För att publicera händelser till ett anpassat ämne, skicka en HTTP POST-förfrågan med följande URI-format: https://<topic-endpoint>?api-version=2018-01-01. En giltig URI är till exempel: https://exampletopic.westus2-1.eventgrid.azure.net/api/events?api-version=2018-01-01. För att få endpointen för ett anpassat ämne, använd Azure-portalen, Azure CLI eller Azure PowerShell.

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

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

Hämta åtkomstnyckeln

I begäran ska du inkludera ett rubrikvärde med namnet aeg-sas-key som innehåller en nyckel för autentisering. Ett giltigt rubrikvärde är aeg-sas-key: xxxxxxxxxxxxxxxxxxxxxxxtill exempel . För att få nyckeln till ett anpassat ämne, använd Azure-portalen, Azure CLI eller Azure PowerShell.

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

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

Formatera händelsens nyttolast

Formatera varje händelse som ett JSON-objekt. Fälten på högsta nivå är desamma som standard resursdefinierade händelser, och egenskapen data innehåller de egenskaper som är unika för ditt anpassade ämne. Som utgivare definierar du innehållet i objektet data . För en beskrivning av varje egenskap, se Azure Event Grid event schema.

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

Ha dessa storleksgränser i åtanke när du bygger lasten:

• Händelsearrayen kan ha en total storlek på upp till 1 MB.
• Maxstorleken för en enskild händelse är 1 MB. Händelser över 64 KB medför avgifter i 64-KB-steg.
• En batch kan innehålla maximalt 5 000 händelser.

Följande exempel visar en giltig händelsenyttolast:

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

Skicka en exempelhändelse

Det här avsnittet visar hur du skickar en exempelhändelse till det anpassade ämnet.

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

$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}

Granska svaret

Efter att du postat på ämnesändpunkten får du ett svar. Svaret är en HTTP-standardsvarskod. Några vanliga svar är:

Vid fel används följande format i meddelandetexten:

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

Relaterat innehåll

• Övervaka Leverans av Event Grid-meddelanden: Lär dig hur du spårar och felsöker händelseleveranser.
• Säkerhet och autentisering i Event Grid: Förstå hur du skyddar dina händelser med autentiseringsnycklar.
• Event Grid-prenumerationsschema: Stegvis vägledning om hur du skapar en Event Grid-prenumeration.