إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
- أحدث
- معاينة 2025-07-15
- 2025-04-01-معاينة
- 2025-02-15
- معاينة
2024-12-15 - 2024-06-01-معاينة
- معاينة
2023-12-15 - 2023-06-01-معاينة
- 2022-06-15
- 2021-12-01
- 2021-10-15-معاينة
- 2021-06-01-معاينة
- معاينة
2020-10-15 -
2020-06-01 - معاينة
2020-04-01 - 2020-01-01-معاينة
- 2019-06-01
- 2019-02-01-معاينة
- 2019-01-01
- معاينة 2018-09-15
- معاينة
2018-05-01 - 2018-01-01
- 2017-09-15-معاينة
- معاينة
2017-06-15
تعريف مورد Bicep
يمكن نشر نوع مورد الموضوعات مع العمليات التي تستهدف:
للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .
أمثلة الاستخدام
عينات Bicep
مثال أساسي لنشر موضوع EventGrid.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource topic 'Microsoft.EventGrid/topics@2021-12-01' = {
name: resourceName
location: location
properties: {
disableLocalAuth: false
inputSchema: 'EventGridSchema'
publicNetworkAccess: 'Enabled'
}
}
الوحدات النمطية التي تم التحقق منها من Azure
يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.
| الوحده النمطيه | وصف |
|---|---|
| موضوع شبكة الأحداث | وحدة موارد AVM لموضوع شبكة الأحداث |
نماذج Azure Quickstart
تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.
| ملف Bicep | وصف |
|---|---|
| إنشاء موضوع مخصص لشبكة أحداث Azure الاشتراك في قائمة الانتظار | إنشاء موضوع مخصص لشبكة أحداث Azure واشتراك قائمة انتظار ناقل الخدمة. القالب الذي تم تأليفه في الأصل بواسطة Markus Meyer. |
| إنشاء موضوع مخصص لشبكة أحداث Azure الاشتراك | إنشاء موضوع مخصص Azure Event Grid واشتراك webhook. القالب الذي ألفه جون داونز في الأصل. |
تنسيق المورد
لإنشاء مورد Microsoft.EventGrid/topics، أضف Bicep التالي إلى القالب الخاص بك.
resource symbolicname 'Microsoft.EventGrid/topics@2025-07-15-preview' = {
extendedLocation: {
name: 'string'
type: 'string'
}
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {
{customized property}: {
clientId: 'string'
principalId: 'string'
}
}
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
dataResidencyBoundary: 'string'
disableLocalAuth: bool
encryption: {
customerManagedKeyEncryption: [
{
keyEncryptionKeyIdentity: {
type: 'string'
userAssignedIdentityResourceId: 'string'
}
keyEncryptionKeyUrl: 'string'
}
]
}
eventTypeInfo: {
inlineEventTypes: {
{customized property}: {
dataSchemaUrl: 'string'
description: 'string'
displayName: 'string'
documentationUrl: 'string'
}
}
kind: 'string'
}
inboundIpRules: [
{
action: 'string'
ipMask: 'string'
}
]
inputSchema: 'string'
inputSchemaMapping: {
inputSchemaMappingType: 'string'
// For remaining properties, see InputSchemaMapping objects
}
minimumTlsVersionAllowed: 'string'
platformCapabilities: {
confidentialCompute: {
mode: 'string'
}
}
publicNetworkAccess: 'string'
}
sku: {
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
كائنات InputSchemaMapping
تعيين الخاصية inputSchemaMappingType
بالنسبة Json، استخدم:
{
inputSchemaMappingType: 'Json'
properties: {
dataVersion: {
defaultValue: 'string'
sourceField: 'string'
}
eventTime: {
sourceField: 'string'
}
eventType: {
defaultValue: 'string'
sourceField: 'string'
}
id: {
sourceField: 'string'
}
subject: {
defaultValue: 'string'
sourceField: 'string'
}
topic: {
sourceField: 'string'
}
}
}
قيم الخصائص
Microsoft.EventGrid/الموضوعات
| اسم | وصف | قيمة |
|---|---|---|
| توسيع الموقع | الموقع الموسع للمورد. | |
| الهوية | معلومات الهوية للمورد. | معلومات الهوية |
| نوع | نوع المورد. | "Azure" "AzureArc" |
| مكان | موقع المورد. | سلسلة (مطلوب) |
| اسم | اسم المورد | سلسلة (مطلوب) |
| خصائص | خصائص الموضوع. | |
| سكو | مستوى تسعير Sku للموضوع. | |
| العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
الحوسبة السرية
| اسم | وصف | قيمة |
|---|---|---|
| الوضع | تحدد هذه الخاصية نمط تكوين Azure Confidential Compute (تكوين). القيم الممكنة هي 'معطل' أو 'مفعل'. هذه خاصية ثابتة في وقت إنشاء الموارد ولا يمكن تعديلها لاحقا. تفعيل هذه الخاصية يضمن معالجة الرسائل وتخزينها في بيئة Azure Confidential Compute (حسابات سرية). |
"معطل" "ممكن" (مطلوب) |
CustomerManagedKeyEncryption
| اسم | وصف | قيمة |
|---|---|---|
| keyEncryptionKeyIdentity | جميع تكوينات الهوية لإعدادات المفاتيح التي يديرها العميل والتي تحدد الهوية التي يجب استخدامها للمصادقة على Key Vault. هذه خاصية اختيارية. عندما لا يتم تحديدها، سيتم استخدام هوية SystemAssign. |
KeyEncryptionKeyIdentity |
| keyEncryptionKeyUrl | رابط مفتاح تشفير المفتاح. يمكن أن يكون هذا الرابط إما نسخة (مثلا، https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78)، أو غير معد (مثلا،https://contosovault.vault.azure.net/keys/contosokek. عند استخدام عنوان URL المعدل، سيستخدم هذا الإصدار من المفتاح بواسطة Event Grid Runtime حتى لو تم تدويره. إنه المستخدم مسؤولية تحديث رابط URL بالإصدار الجديد عن طريق تحديث مورد مساحة الاسم. عند استخدام عنوان URL بدون نسخة، يقوم Event Grid بالاستعلام والحصول على أحدث إصدار وسيتم تستخدم تلقائيا. |
سلسلة (مطلوب) |
EventTypeInfo
| اسم | وصف | قيمة |
|---|---|---|
| أنواع الأحداث المضمنة | مجموعة من أنواع الأحداث المضمنة للمورد. مفاتيح نوع الحدث المضمنة هي من سلسلة النوع التي تمثل اسم الحدث. مثال على اسم حدث مضمن صالح هو "Contoso.OrderCreated". قيم نوع الحدث المضمنة من النوع InlineEventProperties وستحتوي على معلومات إضافية لكل نوع حدث مضمن. |
أنواع الأحداثInfoInlineEventTypes |
| نوع | نوع الحدث المستخدم. | "مضمن" |
أنواع الأحداثInfoInlineEventTypes
| اسم | وصف | قيمة |
|---|
توسيع الموقع
| اسم | وصف | قيمة |
|---|---|---|
| اسم | اسم مؤهل بالكامل للموقع الموسع. | خيط |
| نوع | نوع الموقع الموسع. | خيط |
معلومات الهوية
| اسم | وصف | قيمة |
|---|---|---|
| معرف أساسي | المعرف الأساسي لهوية المورد. | خيط |
| معرف المستأجر | معرف المستأجر للمورد. | خيط |
| نوع | نوع الهوية المدارة المستخدمة. يتضمن النوع "SystemAssigned, UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هوية. | "بلا" "تم تعيين النظام" "SystemAssigned, UserAssigned" "تعيين المستخدم" |
| معرفات تعيين المستخدم | قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفتاح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. هذه الخاصية غير مستخدمة حاليا ومحفوظة للاستخدام المستقبلي. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
| اسم | وصف | قيمة |
|---|
InboundIpRule
| اسم | وصف | قيمة |
|---|---|---|
| فعل | الإجراء المطلوب تنفيذه استنادا إلى تطابق IpMask أو عدم تطابقه. | "السماح" |
| قناع بروتوكول الإنترنت | عنوان IP في رمز CIDR على سبيل المثال، 10.0.0.0/8. | خيط |
خصائص الأحداث المضمنة
| اسم | وصف | قيمة |
|---|---|---|
| dataSchemaUrl | dataSchemaUrl للحدث المضمن. | خيط |
| وصف | وصف الحدث المضمن. | خيط |
| اسم العرض | displayName للحدث المضمن. | خيط |
| عنوان URL للتوثيق | documentationUrl للحدث المضمن. | خيط |
InputSchemaMapping
| اسم | وصف | قيمة |
|---|---|---|
| inputSchemaMappingType | قم بتعيين إلى "Json" للنوع JsonInputSchemaMapping. | 'Json' (مطلوب) |
جسونفيلد
| اسم | وصف | قيمة |
|---|---|---|
| حقل المصدر | اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. | خيط |
JsonFieldWithDefault
| اسم | وصف | قيمة |
|---|---|---|
| القيمة الافتراضية | القيمة الافتراضية التي سيتم استخدامها لتعيين عندما لا يتم توفير SourceField أو إذا لم تكن هناك خاصية بالاسم المحدد في حمولة حدث JSON المنشورة. | خيط |
| حقل المصدر | اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. | خيط |
JsonInputSchemaMapping
| اسم | وصف | قيمة |
|---|---|---|
| inputSchemaMappingType | نوع التعيين المخصص | 'Json' (مطلوب) |
| خصائص | خصائص JSON لتعيين مخطط الإدخال | خصائص JsonInputSchemaMappingProperties |
خصائص JsonInputSchemaMappingProperties
| اسم | وصف | قيمة |
|---|---|---|
| إصدار البيانات | معلومات التعيين لخاصية DataVersion لحدث شبكة الأحداث. | JsonFieldWithDefault |
| وقت الحدث | معلومات التعيين لخاصية EventTime لحدث Event Grid. | |
| نوع الحدث | معلومات التعيين لخاصية EventType لحدث Event Grid. | JsonFieldWithDefault |
| معرف | معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. | |
| موضوع | معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. | JsonFieldWithDefault |
| موضوع | معلومات التعيين للخاصية Topic لحدث Event Grid. | |
تشفير المفتاح
| اسم | وصف | قيمة |
|---|---|---|
| customerManagedKeyEncryption | قائمة بجميع خصائص تشفير المفاتيح المدارة من قبل العميل للمورد. ومع ذلك، يتم دعم مفتاح واحد فقط في كل مرة. | تشفير CustomerManagedKey[] (مطلوب) |
KeyEncryptionKeyIdentity
| اسم | وصف | قيمة |
|---|---|---|
| نوع | نوع الهوية المدارة المستخدمة. يتم دعم فقط UserAssign أو SystemAssign Identity. | "تم تعيين النظام" "UserAssigned" (مطلوب) |
| userAssignedIdentityResourceId | يؤهل Azure Resource معرف الهوية المعينة من قبل المستخدم المرتبط بالمورد. يأخذ معرف المورد التنسيق التالي: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
خيط |
قدرات النظام الأساسي
| اسم | وصف | قيمة |
|---|---|---|
| سريالحوسبة | يمثل خصائص Azure Confidential Compute للمورد. | الحوسبة السرية |
ResourceSku
| اسم | وصف | قيمة |
|---|---|---|
| اسم | اسم Sku للمورد. القيم المحتملة هي: Basic أو Premium. | "أساسي" "بريميوم" |
خصائص الموضوع
| اسم | وصف | قيمة |
|---|---|---|
| dataResidencyBoundary | حد موقع البيانات للمورد. | "داخل Geopair" "داخل المنطقة" |
| تعطيلLocalAuth | يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام الرمز المميز لمعرف Microsoft Entra فقط للمصادقة إذا كان مسموحا للمستخدم بالنشر على الموضوع. | قيمة منطقية |
| التشفير | خصائص تكوين التشفير الرئيسي لمورد الموضوع. هذه خاصية اختيارية. عندما لا يتم تحديده، لا يستخدم تشفير مفتاح. | تشفير المفتاح |
| معلومات عن نوع الحدث | معلومات نوع الحدث لموضوع المستخدم. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها. |
EventTypeInfo |
| قواعد Ip الواردة | يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP معينة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. | InboundIpRule[] |
| مخطط المدخلات | يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة على الموضوع. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
| inputSchemaMapping | يتيح ذلك النشر باستخدام مخططات الأحداث المخصصة. يمكن تحديد InputSchemaMapping لتعيين خصائص مختلفة لمخطط مصدر إلى خصائص مختلفة مطلوبة لمخطط EventGridEvent. | InputSchemaMapping |
| الحد الأدنى لTlsVersionAllowed | الحد الأدنى لإصدار TLS للناشر المسموح له بالنشر إلى هذا الموضوع | '1.0' '1.1' '1.2' |
| المنصةالقدرات | يمثل قدرات منصة المورد، بما في ذلك الخصائص المتعلقة بحساب Azure Confidential. | قدرات النظام الأساسي |
| publicNetworkAccess | يحدد هذا ما إذا كان يسمح بحركة المرور عبر الشبكة العامة. بشكل افتراضي يتم تمكينه. يمكنك تقييد عناوين IP معينة عن طريق تكوين <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /> |
"معطل" "ممكن" "SecuredByPerimeter" |
تتبع المواردالعلامات
| اسم | وصف | قيمة |
|---|
خصائص معرف المستخدم
| اسم | وصف | قيمة |
|---|---|---|
| معرف العميل | معرف العميل للهوية المعينة من قبل المستخدم. | خيط |
| معرف أساسي | المعرف الأساسي للهوية المعينة من قبل المستخدم. | خيط |
تعريف مورد قالب ARM
يمكن نشر نوع مورد الموضوعات مع العمليات التي تستهدف:
- مجموعات الموارد - راجع أوامر نشر مجموعة الموارد لقائمة الخصائص المتغيرة في كل إصدار من واجهة برمجة التطبيقات، راجع سجل التغيير.
أمثلة الاستخدام
قوالب Azure Quickstart
قوالب Azure Quickstart التالية توزيع نوع المورد هذا.
| قالب | وصف |
|---|---|
|
إنشاء موضوع مخصص لشبكة أحداث Azure الاشتراك في قائمة الانتظار |
إنشاء موضوع مخصص لشبكة أحداث Azure واشتراك قائمة انتظار ناقل الخدمة. القالب الذي تم تأليفه في الأصل بواسطة Markus Meyer. |
|
إنشاء موضوع مخصص لشبكة أحداث Azure الاشتراك |
إنشاء موضوع مخصص Azure Event Grid واشتراك webhook. القالب الذي ألفه جون داونز في الأصل. |
|
إنشاء اشتراك موضوع مخصص لشبكة أحداث Azure |
إنشاء موضوع مخصص لشبكة أحداث Azure واشتراك موضوع ناقل الخدمة. القالب الذي تم تأليفه في الأصل بواسطة Markus Meyer. |
|
إنشاء موضوع مخصص لشبكة الأحداث ومعالج مركز الأحداث |
إنشاء موضوع مخصص ل Azure Event Grid ومركز أحداث للتعامل مع الأحداث. |
|
موضوع/اشتراك شبكة أحداث Azure المخصصة مع CloudEvents |
إنشاء موضوع Azure Event Grid مخصص، واشتراك webhook يحتوي على مخطط CloudEvents، وLogic App كمعالج أحداث. القالب الذي تم تأليفه في الأصل بواسطة Justin Yoo. |
تنسيق المورد
لإنشاء مورد Microsoft.EventGrid/topics، أضف JSON التالي إلى القالب الخاص بك.
{
"type": "Microsoft.EventGrid/topics",
"apiVersion": "2025-07-15-preview",
"name": "string",
"extendedLocation": {
"name": "string",
"type": "string"
},
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
"clientId": "string",
"principalId": "string"
}
}
},
"kind": "string",
"location": "string",
"properties": {
"dataResidencyBoundary": "string",
"disableLocalAuth": "bool",
"encryption": {
"customerManagedKeyEncryption": [
{
"keyEncryptionKeyIdentity": {
"type": "string",
"userAssignedIdentityResourceId": "string"
},
"keyEncryptionKeyUrl": "string"
}
]
},
"eventTypeInfo": {
"inlineEventTypes": {
"{customized property}": {
"dataSchemaUrl": "string",
"description": "string",
"displayName": "string",
"documentationUrl": "string"
}
},
"kind": "string"
},
"inboundIpRules": [
{
"action": "string",
"ipMask": "string"
}
],
"inputSchema": "string",
"inputSchemaMapping": {
"inputSchemaMappingType": "string"
// For remaining properties, see InputSchemaMapping objects
},
"minimumTlsVersionAllowed": "string",
"platformCapabilities": {
"confidentialCompute": {
"mode": "string"
}
},
"publicNetworkAccess": "string"
},
"sku": {
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
كائنات InputSchemaMapping
تعيين الخاصية inputSchemaMappingType
بالنسبة Json، استخدم:
{
"inputSchemaMappingType": "Json",
"properties": {
"dataVersion": {
"defaultValue": "string",
"sourceField": "string"
},
"eventTime": {
"sourceField": "string"
},
"eventType": {
"defaultValue": "string",
"sourceField": "string"
},
"id": {
"sourceField": "string"
},
"subject": {
"defaultValue": "string",
"sourceField": "string"
},
"topic": {
"sourceField": "string"
}
}
}
قيم الخصائص
Microsoft.EventGrid/الموضوعات
| اسم | وصف | قيمة |
|---|---|---|
| apiVersion | إصدار واجهة برمجة التطبيقات | 'معاينة 2025-07-15' |
| توسيع الموقع | الموقع الموسع للمورد. | |
| الهوية | معلومات الهوية للمورد. | معلومات الهوية |
| نوع | نوع المورد. | "Azure" "AzureArc" |
| مكان | موقع المورد. | سلسلة (مطلوب) |
| اسم | اسم المورد | سلسلة (مطلوب) |
| خصائص | خصائص الموضوع. | |
| سكو | مستوى تسعير Sku للموضوع. | |
| العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
| نوع | نوع المورد | "Microsoft.EventGrid/المواضيع" |
الحوسبة السرية
| اسم | وصف | قيمة |
|---|---|---|
| الوضع | تحدد هذه الخاصية نمط تكوين Azure Confidential Compute (تكوين). القيم الممكنة هي 'معطل' أو 'مفعل'. هذه خاصية ثابتة في وقت إنشاء الموارد ولا يمكن تعديلها لاحقا. تفعيل هذه الخاصية يضمن معالجة الرسائل وتخزينها في بيئة Azure Confidential Compute (حسابات سرية). |
"معطل" "ممكن" (مطلوب) |
CustomerManagedKeyEncryption
| اسم | وصف | قيمة |
|---|---|---|
| keyEncryptionKeyIdentity | جميع تكوينات الهوية لإعدادات المفاتيح التي يديرها العميل والتي تحدد الهوية التي يجب استخدامها للمصادقة على Key Vault. هذه خاصية اختيارية. عندما لا يتم تحديدها، سيتم استخدام هوية SystemAssign. |
KeyEncryptionKeyIdentity |
| keyEncryptionKeyUrl | رابط مفتاح تشفير المفتاح. يمكن أن يكون هذا الرابط إما نسخة (مثلا، https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78)، أو غير معد (مثلا،https://contosovault.vault.azure.net/keys/contosokek. عند استخدام عنوان URL المعدل، سيستخدم هذا الإصدار من المفتاح بواسطة Event Grid Runtime حتى لو تم تدويره. إنه المستخدم مسؤولية تحديث رابط URL بالإصدار الجديد عن طريق تحديث مورد مساحة الاسم. عند استخدام عنوان URL بدون نسخة، يقوم Event Grid بالاستعلام والحصول على أحدث إصدار وسيتم تستخدم تلقائيا. |
سلسلة (مطلوب) |
EventTypeInfo
| اسم | وصف | قيمة |
|---|---|---|
| أنواع الأحداث المضمنة | مجموعة من أنواع الأحداث المضمنة للمورد. مفاتيح نوع الحدث المضمنة هي من سلسلة النوع التي تمثل اسم الحدث. مثال على اسم حدث مضمن صالح هو "Contoso.OrderCreated". قيم نوع الحدث المضمنة من النوع InlineEventProperties وستحتوي على معلومات إضافية لكل نوع حدث مضمن. |
أنواع الأحداثInfoInlineEventTypes |
| نوع | نوع الحدث المستخدم. | "مضمن" |
أنواع الأحداثInfoInlineEventTypes
| اسم | وصف | قيمة |
|---|
توسيع الموقع
| اسم | وصف | قيمة |
|---|---|---|
| اسم | اسم مؤهل بالكامل للموقع الموسع. | خيط |
| نوع | نوع الموقع الموسع. | خيط |
معلومات الهوية
| اسم | وصف | قيمة |
|---|---|---|
| معرف أساسي | المعرف الأساسي لهوية المورد. | خيط |
| معرف المستأجر | معرف المستأجر للمورد. | خيط |
| نوع | نوع الهوية المدارة المستخدمة. يتضمن النوع "SystemAssigned, UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هوية. | "بلا" "تم تعيين النظام" "SystemAssigned, UserAssigned" "تعيين المستخدم" |
| معرفات تعيين المستخدم | قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفتاح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. هذه الخاصية غير مستخدمة حاليا ومحفوظة للاستخدام المستقبلي. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
| اسم | وصف | قيمة |
|---|
InboundIpRule
| اسم | وصف | قيمة |
|---|---|---|
| فعل | الإجراء المطلوب تنفيذه استنادا إلى تطابق IpMask أو عدم تطابقه. | "السماح" |
| قناع بروتوكول الإنترنت | عنوان IP في رمز CIDR على سبيل المثال، 10.0.0.0/8. | خيط |
خصائص الأحداث المضمنة
| اسم | وصف | قيمة |
|---|---|---|
| dataSchemaUrl | dataSchemaUrl للحدث المضمن. | خيط |
| وصف | وصف الحدث المضمن. | خيط |
| اسم العرض | displayName للحدث المضمن. | خيط |
| عنوان URL للتوثيق | documentationUrl للحدث المضمن. | خيط |
InputSchemaMapping
| اسم | وصف | قيمة |
|---|---|---|
| inputSchemaMappingType | قم بتعيين إلى "Json" للنوع JsonInputSchemaMapping. | 'Json' (مطلوب) |
جسونفيلد
| اسم | وصف | قيمة |
|---|---|---|
| حقل المصدر | اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. | خيط |
JsonFieldWithDefault
| اسم | وصف | قيمة |
|---|---|---|
| القيمة الافتراضية | القيمة الافتراضية التي سيتم استخدامها لتعيين عندما لا يتم توفير SourceField أو إذا لم تكن هناك خاصية بالاسم المحدد في حمولة حدث JSON المنشورة. | خيط |
| حقل المصدر | اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. | خيط |
JsonInputSchemaMapping
| اسم | وصف | قيمة |
|---|---|---|
| inputSchemaMappingType | نوع التعيين المخصص | 'Json' (مطلوب) |
| خصائص | خصائص JSON لتعيين مخطط الإدخال | خصائص JsonInputSchemaMappingProperties |
خصائص JsonInputSchemaMappingProperties
| اسم | وصف | قيمة |
|---|---|---|
| إصدار البيانات | معلومات التعيين لخاصية DataVersion لحدث شبكة الأحداث. | JsonFieldWithDefault |
| وقت الحدث | معلومات التعيين لخاصية EventTime لحدث Event Grid. | |
| نوع الحدث | معلومات التعيين لخاصية EventType لحدث Event Grid. | JsonFieldWithDefault |
| معرف | معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. | |
| موضوع | معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. | JsonFieldWithDefault |
| موضوع | معلومات التعيين للخاصية Topic لحدث Event Grid. | |
تشفير المفتاح
| اسم | وصف | قيمة |
|---|---|---|
| customerManagedKeyEncryption | قائمة بجميع خصائص تشفير المفاتيح المدارة من قبل العميل للمورد. ومع ذلك، يتم دعم مفتاح واحد فقط في كل مرة. | تشفير CustomerManagedKey[] (مطلوب) |
KeyEncryptionKeyIdentity
| اسم | وصف | قيمة |
|---|---|---|
| نوع | نوع الهوية المدارة المستخدمة. يتم دعم فقط UserAssign أو SystemAssign Identity. | "تم تعيين النظام" "UserAssigned" (مطلوب) |
| userAssignedIdentityResourceId | يؤهل Azure Resource معرف الهوية المعينة من قبل المستخدم المرتبط بالمورد. يأخذ معرف المورد التنسيق التالي: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
خيط |
قدرات النظام الأساسي
| اسم | وصف | قيمة |
|---|---|---|
| سريالحوسبة | يمثل خصائص Azure Confidential Compute للمورد. | الحوسبة السرية |
ResourceSku
| اسم | وصف | قيمة |
|---|---|---|
| اسم | اسم Sku للمورد. القيم المحتملة هي: Basic أو Premium. | "أساسي" "بريميوم" |
خصائص الموضوع
| اسم | وصف | قيمة |
|---|---|---|
| dataResidencyBoundary | حد موقع البيانات للمورد. | "داخل Geopair" "داخل المنطقة" |
| تعطيلLocalAuth | يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام الرمز المميز لمعرف Microsoft Entra فقط للمصادقة إذا كان مسموحا للمستخدم بالنشر على الموضوع. | قيمة منطقية |
| التشفير | خصائص تكوين التشفير الرئيسي لمورد الموضوع. هذه خاصية اختيارية. عندما لا يتم تحديده، لا يستخدم تشفير مفتاح. | تشفير المفتاح |
| معلومات عن نوع الحدث | معلومات نوع الحدث لموضوع المستخدم. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها. |
EventTypeInfo |
| قواعد Ip الواردة | يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP معينة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. | InboundIpRule[] |
| مخطط المدخلات | يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة على الموضوع. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
| inputSchemaMapping | يتيح ذلك النشر باستخدام مخططات الأحداث المخصصة. يمكن تحديد InputSchemaMapping لتعيين خصائص مختلفة لمخطط مصدر إلى خصائص مختلفة مطلوبة لمخطط EventGridEvent. | InputSchemaMapping |
| الحد الأدنى لTlsVersionAllowed | الحد الأدنى لإصدار TLS للناشر المسموح له بالنشر إلى هذا الموضوع | '1.0' '1.1' '1.2' |
| المنصةالقدرات | يمثل قدرات منصة المورد، بما في ذلك الخصائص المتعلقة بحساب Azure Confidential. | قدرات النظام الأساسي |
| publicNetworkAccess | يحدد هذا ما إذا كان يسمح بحركة المرور عبر الشبكة العامة. بشكل افتراضي يتم تمكينه. يمكنك تقييد عناوين IP معينة عن طريق تكوين <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /> |
"معطل" "ممكن" "SecuredByPerimeter" |
تتبع المواردالعلامات
| اسم | وصف | قيمة |
|---|
خصائص معرف المستخدم
| اسم | وصف | قيمة |
|---|---|---|
| معرف العميل | معرف العميل للهوية المعينة من قبل المستخدم. | خيط |
| معرف أساسي | المعرف الأساسي للهوية المعينة من قبل المستخدم. | خيط |
تعريف مورد Terraform (موفر AzAPI)
يمكن نشر نوع مورد الموضوعات مع العمليات التي تستهدف:
- مجموعات الموارد للحصول على قائمة بالخصائص المتغيرة في كل إصدار من واجهة برمجة التطبيقات، انظر سجل التغيير.
أمثلة الاستخدام
عينات Terraform
مثال أساسي لنشر موضوع EventGrid.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "topic" {
type = "Microsoft.EventGrid/topics@2021-12-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
disableLocalAuth = false
inputSchema = "EventGridSchema"
inputSchemaMapping = null
publicNetworkAccess = "Enabled"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
الوحدات النمطية التي تم التحقق منها من Azure
يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.
| الوحده النمطيه | وصف |
|---|---|
| موضوع شبكة الأحداث | وحدة موارد AVM لموضوع شبكة الأحداث |
تنسيق المورد
لإنشاء مورد Microsoft.EventGrid/topics، أضف Terraform التالي إلى القالب الخاص بك.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventGrid/topics@2025-07-15-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
extendedLocation = {
name = "string"
type = "string"
}
kind = "string"
properties = {
dataResidencyBoundary = "string"
disableLocalAuth = bool
encryption = {
customerManagedKeyEncryption = [
{
keyEncryptionKeyIdentity = {
type = "string"
userAssignedIdentityResourceId = "string"
}
keyEncryptionKeyUrl = "string"
}
]
}
eventTypeInfo = {
inlineEventTypes = {
{customized property} = {
dataSchemaUrl = "string"
description = "string"
displayName = "string"
documentationUrl = "string"
}
}
kind = "string"
}
inboundIpRules = [
{
action = "string"
ipMask = "string"
}
]
inputSchema = "string"
inputSchemaMapping = {
inputSchemaMappingType = "string"
// For remaining properties, see InputSchemaMapping objects
}
minimumTlsVersionAllowed = "string"
platformCapabilities = {
confidentialCompute = {
mode = "string"
}
}
publicNetworkAccess = "string"
}
sku = {
name = "string"
}
}
}
كائنات InputSchemaMapping
تعيين الخاصية inputSchemaMappingType
بالنسبة Json، استخدم:
{
inputSchemaMappingType = "Json"
properties = {
dataVersion = {
defaultValue = "string"
sourceField = "string"
}
eventTime = {
sourceField = "string"
}
eventType = {
defaultValue = "string"
sourceField = "string"
}
id = {
sourceField = "string"
}
subject = {
defaultValue = "string"
sourceField = "string"
}
topic = {
sourceField = "string"
}
}
}
قيم الخصائص
Microsoft.EventGrid/الموضوعات
| اسم | وصف | قيمة |
|---|---|---|
| توسيع الموقع | الموقع الموسع للمورد. | |
| الهوية | معلومات الهوية للمورد. | معلومات الهوية |
| نوع | نوع المورد. | "Azure" "AzureArc" |
| مكان | موقع المورد. | سلسلة (مطلوب) |
| اسم | اسم المورد | سلسلة (مطلوب) |
| خصائص | خصائص الموضوع. | |
| سكو | مستوى تسعير Sku للموضوع. | |
| العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. |
| نوع | نوع المورد | "Microsoft.EventGrid/topics@2025-07-15-preview" |
الحوسبة السرية
| اسم | وصف | قيمة |
|---|---|---|
| الوضع | تحدد هذه الخاصية نمط تكوين Azure Confidential Compute (تكوين). القيم الممكنة هي 'معطل' أو 'مفعل'. هذه خاصية ثابتة في وقت إنشاء الموارد ولا يمكن تعديلها لاحقا. تفعيل هذه الخاصية يضمن معالجة الرسائل وتخزينها في بيئة Azure Confidential Compute (حسابات سرية). |
"معطل" "ممكن" (مطلوب) |
CustomerManagedKeyEncryption
| اسم | وصف | قيمة |
|---|---|---|
| keyEncryptionKeyIdentity | جميع تكوينات الهوية لإعدادات المفاتيح التي يديرها العميل والتي تحدد الهوية التي يجب استخدامها للمصادقة على Key Vault. هذه خاصية اختيارية. عندما لا يتم تحديدها، سيتم استخدام هوية SystemAssign. |
KeyEncryptionKeyIdentity |
| keyEncryptionKeyUrl | رابط مفتاح تشفير المفتاح. يمكن أن يكون هذا الرابط إما نسخة (مثلا، https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78)، أو غير معد (مثلا،https://contosovault.vault.azure.net/keys/contosokek. عند استخدام عنوان URL المعدل، سيستخدم هذا الإصدار من المفتاح بواسطة Event Grid Runtime حتى لو تم تدويره. إنه المستخدم مسؤولية تحديث رابط URL بالإصدار الجديد عن طريق تحديث مورد مساحة الاسم. عند استخدام عنوان URL بدون نسخة، يقوم Event Grid بالاستعلام والحصول على أحدث إصدار وسيتم تستخدم تلقائيا. |
سلسلة (مطلوب) |
EventTypeInfo
| اسم | وصف | قيمة |
|---|---|---|
| أنواع الأحداث المضمنة | مجموعة من أنواع الأحداث المضمنة للمورد. مفاتيح نوع الحدث المضمنة هي من سلسلة النوع التي تمثل اسم الحدث. مثال على اسم حدث مضمن صالح هو "Contoso.OrderCreated". قيم نوع الحدث المضمنة من النوع InlineEventProperties وستحتوي على معلومات إضافية لكل نوع حدث مضمن. |
أنواع الأحداثInfoInlineEventTypes |
| نوع | نوع الحدث المستخدم. | "مضمن" |
أنواع الأحداثInfoInlineEventTypes
| اسم | وصف | قيمة |
|---|
توسيع الموقع
| اسم | وصف | قيمة |
|---|---|---|
| اسم | اسم مؤهل بالكامل للموقع الموسع. | خيط |
| نوع | نوع الموقع الموسع. | خيط |
معلومات الهوية
| اسم | وصف | قيمة |
|---|---|---|
| معرف أساسي | المعرف الأساسي لهوية المورد. | خيط |
| معرف المستأجر | معرف المستأجر للمورد. | خيط |
| نوع | نوع الهوية المدارة المستخدمة. يتضمن النوع "SystemAssigned, UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هوية. | "بلا" "تم تعيين النظام" "SystemAssigned, UserAssigned" "تعيين المستخدم" |
| معرفات تعيين المستخدم | قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفتاح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. هذه الخاصية غير مستخدمة حاليا ومحفوظة للاستخدام المستقبلي. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
| اسم | وصف | قيمة |
|---|
InboundIpRule
| اسم | وصف | قيمة |
|---|---|---|
| فعل | الإجراء المطلوب تنفيذه استنادا إلى تطابق IpMask أو عدم تطابقه. | "السماح" |
| قناع بروتوكول الإنترنت | عنوان IP في رمز CIDR على سبيل المثال، 10.0.0.0/8. | خيط |
خصائص الأحداث المضمنة
| اسم | وصف | قيمة |
|---|---|---|
| dataSchemaUrl | dataSchemaUrl للحدث المضمن. | خيط |
| وصف | وصف الحدث المضمن. | خيط |
| اسم العرض | displayName للحدث المضمن. | خيط |
| عنوان URL للتوثيق | documentationUrl للحدث المضمن. | خيط |
InputSchemaMapping
| اسم | وصف | قيمة |
|---|---|---|
| inputSchemaMappingType | قم بتعيين إلى "Json" للنوع JsonInputSchemaMapping. | 'Json' (مطلوب) |
جسونفيلد
| اسم | وصف | قيمة |
|---|---|---|
| حقل المصدر | اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. | خيط |
JsonFieldWithDefault
| اسم | وصف | قيمة |
|---|---|---|
| القيمة الافتراضية | القيمة الافتراضية التي سيتم استخدامها لتعيين عندما لا يتم توفير SourceField أو إذا لم تكن هناك خاصية بالاسم المحدد في حمولة حدث JSON المنشورة. | خيط |
| حقل المصدر | اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. | خيط |
JsonInputSchemaMapping
| اسم | وصف | قيمة |
|---|---|---|
| inputSchemaMappingType | نوع التعيين المخصص | 'Json' (مطلوب) |
| خصائص | خصائص JSON لتعيين مخطط الإدخال | خصائص JsonInputSchemaMappingProperties |
خصائص JsonInputSchemaMappingProperties
| اسم | وصف | قيمة |
|---|---|---|
| إصدار البيانات | معلومات التعيين لخاصية DataVersion لحدث شبكة الأحداث. | JsonFieldWithDefault |
| وقت الحدث | معلومات التعيين لخاصية EventTime لحدث Event Grid. | |
| نوع الحدث | معلومات التعيين لخاصية EventType لحدث Event Grid. | JsonFieldWithDefault |
| معرف | معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. | |
| موضوع | معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. | JsonFieldWithDefault |
| موضوع | معلومات التعيين للخاصية Topic لحدث Event Grid. | |
تشفير المفتاح
| اسم | وصف | قيمة |
|---|---|---|
| customerManagedKeyEncryption | قائمة بجميع خصائص تشفير المفاتيح المدارة من قبل العميل للمورد. ومع ذلك، يتم دعم مفتاح واحد فقط في كل مرة. | تشفير CustomerManagedKey[] (مطلوب) |
KeyEncryptionKeyIdentity
| اسم | وصف | قيمة |
|---|---|---|
| نوع | نوع الهوية المدارة المستخدمة. يتم دعم فقط UserAssign أو SystemAssign Identity. | "تم تعيين النظام" "UserAssigned" (مطلوب) |
| userAssignedIdentityResourceId | يؤهل Azure Resource معرف الهوية المعينة من قبل المستخدم المرتبط بالمورد. يأخذ معرف المورد التنسيق التالي: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
خيط |
قدرات النظام الأساسي
| اسم | وصف | قيمة |
|---|---|---|
| سريالحوسبة | يمثل خصائص Azure Confidential Compute للمورد. | الحوسبة السرية |
ResourceSku
| اسم | وصف | قيمة |
|---|---|---|
| اسم | اسم Sku للمورد. القيم المحتملة هي: Basic أو Premium. | "أساسي" "بريميوم" |
خصائص الموضوع
| اسم | وصف | قيمة |
|---|---|---|
| dataResidencyBoundary | حد موقع البيانات للمورد. | "داخل Geopair" "داخل المنطقة" |
| تعطيلLocalAuth | يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام الرمز المميز لمعرف Microsoft Entra فقط للمصادقة إذا كان مسموحا للمستخدم بالنشر على الموضوع. | قيمة منطقية |
| التشفير | خصائص تكوين التشفير الرئيسي لمورد الموضوع. هذه خاصية اختيارية. عندما لا يتم تحديده، لا يستخدم تشفير مفتاح. | تشفير المفتاح |
| معلومات عن نوع الحدث | معلومات نوع الحدث لموضوع المستخدم. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها. |
EventTypeInfo |
| قواعد Ip الواردة | يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP معينة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. | InboundIpRule[] |
| مخطط المدخلات | يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة على الموضوع. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
| inputSchemaMapping | يتيح ذلك النشر باستخدام مخططات الأحداث المخصصة. يمكن تحديد InputSchemaMapping لتعيين خصائص مختلفة لمخطط مصدر إلى خصائص مختلفة مطلوبة لمخطط EventGridEvent. | InputSchemaMapping |
| الحد الأدنى لTlsVersionAllowed | الحد الأدنى لإصدار TLS للناشر المسموح له بالنشر إلى هذا الموضوع | '1.0' '1.1' '1.2' |
| المنصةالقدرات | يمثل قدرات منصة المورد، بما في ذلك الخصائص المتعلقة بحساب Azure Confidential. | قدرات النظام الأساسي |
| publicNetworkAccess | يحدد هذا ما إذا كان يسمح بحركة المرور عبر الشبكة العامة. بشكل افتراضي يتم تمكينه. يمكنك تقييد عناوين IP معينة عن طريق تكوين <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /> |
"معطل" "ممكن" "SecuredByPerimeter" |
تتبع المواردالعلامات
| اسم | وصف | قيمة |
|---|
خصائص معرف المستخدم
| اسم | وصف | قيمة |
|---|---|---|
| معرف العميل | معرف العميل للهوية المعينة من قبل المستخدم. | خيط |
| معرف أساسي | المعرف الأساسي للهوية المعينة من قبل المستخدم. | خيط |