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

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

إشعار

توفر مصادقة Microsoft Entra دعما فائقا للمصادقة مقارنة بمفتاح الوصول أو مصادقة الرمز المميز لتوقيع الوصول المشترك (SAS). باستخدام مصادقة Microsoft Entra، يتم التحقق من صحة الهوية مقابل موفر هوية Microsoft Entra. بصفتك مطورا، لن تضطر إلى معالجة المفاتيح في التعليمات البرمجية الخاصة بك إذا كنت تستخدم مصادقة Microsoft Entra. ستستفيد أيضا من جميع ميزات الأمان المضمنة في النظام الأساسي للهويات في Microsoft، مثل الوصول المشروط، والتي يمكن أن تساعدك على تحسين موقف أمان التطبيق الخاص بك. لمزيد من المعلومات، راجع مصادقة عملاء النشر باستخدام معرف Microsoft Entra.

نقطة النهاية

عند إرسال منشور 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، استخدم:

مدخل Microsoft Azure

يمكنك العثور على نقطة نهاية الموضوع في علامة التبويب نظرة عامة في صفحة موضوع شبكة الأحداث في مدخل Microsoft Azure.

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

الرأس

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

مدخل Microsoft Azure

للحصول على مفتاح الوصول للموضوع المخصص، حدد علامة التبويب مفاتيح الوصول في صفحة موضوع شبكة الأحداث في مدخل Microsoft Azure.

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

بيانات الحدث

بالنسبة للمواضيع المخصصة، تحتوي بيانات المستوى الأعلى على نفس الحقول مثل المورد القياسي المعرف من قبل المورد. إحدى هذه الخصائص هي 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"
}]

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

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

مدخل Microsoft Azure

1. في مدخل Microsoft Azure، قم بتشغيل Cloud Shell.

2. في Cloud Shell، قم بتشغيل الأوامر من Azure PowerShell أو Azure CLI في جلسة عمل Bash أو PowerShell .

   

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}

استجابة

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

نتيجة	استجابة
نجاح	200 جيد
بيانات الحدث لنموذج غير صحيح	400 طلب غير صالح
المفتاح الخاص بالاختصار غير صالح	401 غير مصرح به
نقطة النهاية غير سليمة	404 لم يتم إيجادها
يتجاوز الصفيف أو الحدث حدود الحجم	413 حمولة كبيرة للغاية

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

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

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

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