نشر الأحداث إلى المواضيع المخصصة لخطوط شبكة حدث Azure باستخدام مفاتيح الاختصار

توضح هذه المقالة طريقة نشر حدث إلى موضوع مخصص باستخدام مفتاح الاختصار. وهو يبين نموذج بيانات النشر والحدث. تنطبق اتفاقية مستوى الخدمة (SLA) فقط على الوظائف التي تنشر تطابق النموذج المتوقع.

نقطة النهاية

عند إرسال منشور HTTP إلى موضوع مخصص، استخدم نموذج URI:https://<topic-endpoint>?api-version=2018-01-01. على سبيل المثال، اسم صالح URI:https://exampletopic.westus2-1.eventgrid.azure.net/api/events?api-version=2018-01-01. للحصول على نقطة النهاية لموضوع مخصص باستخدام Azure CLI، استخدم:

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

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

الرأس

في الطلب، ضمّن قيمة عنوان يسميaeg-sas-keyيتضمن على مفتاح للمصادقة. على سبيل المثال، قيمة عنوان صالحة هيaeg-sas-key: xxxxxxxxxxxxxxxxxxxxxxx. للحصول على مفتاح موضوع مخصص باستخدام Azure CLI، استخدم:

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

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

بيانات الحدث

بالنسبة للمواضيع المخصصة، تحتوي بيانات المستوى الأعلى على نفس الحقول مثل المورد القياسي المعرف من قبل المورد. إحدى هذه الخصائص هي data خاصية تحتوي على خصائص فريدة للموضوع المخصص. بصفتك ناشر حدث، يمكنك تحديد خصائص عنصر البيانات هذا. إليك المخطط:

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

للحصول على وصف لهذه الخصائص، راجع مخطط الحدث لخطوط الشبكة الحدث. عندما يرسل العميل أحداثا إلى موضوع Event Grid، يمكن أن يكون للصفيف حجم إجمالي يصل إلى 1 ميغابايت. يعد الحد الأقصى المسموح به الخاص بحجم الحدث هو أيضا 1 ميغابايت. يتم فرض رسوم على الأحداث التي تزيد عن 64 كيلوبايت بزيادات 64 كيلوبايت. عندما يتلقى العميل أحداثا في دفعة، يكون الحد الأقصى المسموح به لعدد الأحداث هو 5000 لكل دفعة.

على سبيل المثال، مخطط البيانات لحدث صالح هو:

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

إرسال نموذج الحدث

يوضح هذا القسم كيفية إرسال نموذج حدث إلى الموضوع المخصص.

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}

استجابة

بعد النشر إلى نقطة نهاية الموضوع، تتلقى استجابة. الاستجابة هي تعليمة برمجية قياسية لاستجابة HTTP. بعض الاستجابات المعروفة هي:

للأخطاء، نص الرسالة يحتوي على النموذج التالي:

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

المحتوى ذو الصلة

• للحصول على تفاصيل حول مراقبة تسليم الأحداث، راجعمراقبة تسليم رسالة خطوط شبكة الحدث.
• للحصول على مزيدٍ من المعلومات حول مفتاح المصادقة، راجع أمان خطوط شبكة الأحداث والمصادقة.
• لمزيد من المعلومات حول إنشاء اشتراك Azure Event Grid، راجع مخطط اشتراك شبكة الأحداث.