موضوعات Microsoft.EventGrid

تعريف مورد 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/الموضوعات

اسم وصف قيمة
توسيع الموقع الموقع الموسع للمورد. ExtendedLocation
الهوية معلومات الهوية للمورد. معلومات الهوية
نوع نوع المورد. "Azure"
"AzureArc"
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص الموضوع. TopicProperties
سكو مستوى تسعير Sku للموضوع. ResourceSku
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

الحوسبة السرية

اسم وصف قيمة
الوضع تحدد هذه الخاصية نمط تكوين 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. JsonField
نوع الحدث معلومات التعيين لخاصية EventType لحدث Event Grid. JsonFieldWithDefault
معرف معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. JsonField
موضوع معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. JsonFieldWithDefault
موضوع معلومات التعيين للخاصية Topic لحدث Event Grid. JsonField

تشفير المفتاح

اسم وصف قيمة
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
إنشاء موضوع مخصص لشبكة أحداث Azure واشتراك قائمة انتظار ناقل الخدمة. القالب الذي تم تأليفه في الأصل بواسطة Markus Meyer.
إنشاء موضوع مخصص لشبكة أحداث Azure الاشتراك

نشر في Azure
إنشاء موضوع مخصص Azure Event Grid واشتراك webhook. القالب الذي ألفه جون داونز في الأصل.
إنشاء اشتراك موضوع مخصص لشبكة أحداث Azure

نشر في Azure
إنشاء موضوع مخصص لشبكة أحداث Azure واشتراك موضوع ناقل الخدمة. القالب الذي تم تأليفه في الأصل بواسطة Markus Meyer.
إنشاء موضوع مخصص لشبكة الأحداث ومعالج مركز الأحداث

نشر في Azure
إنشاء موضوع مخصص ل Azure Event Grid ومركز أحداث للتعامل مع الأحداث.
موضوع/اشتراك شبكة أحداث Azure المخصصة مع CloudEvents

نشر في Azure
إنشاء موضوع 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'
توسيع الموقع الموقع الموسع للمورد. ExtendedLocation
الهوية معلومات الهوية للمورد. معلومات الهوية
نوع نوع المورد. "Azure"
"AzureArc"
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص الموضوع. TopicProperties
سكو مستوى تسعير Sku للموضوع. ResourceSku
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع نوع المورد "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. JsonField
نوع الحدث معلومات التعيين لخاصية EventType لحدث Event Grid. JsonFieldWithDefault
معرف معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. JsonField
موضوع معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. JsonFieldWithDefault
موضوع معلومات التعيين للخاصية Topic لحدث Event Grid. JsonField

تشفير المفتاح

اسم وصف قيمة
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/الموضوعات

اسم وصف قيمة
توسيع الموقع الموقع الموسع للمورد. ExtendedLocation
الهوية معلومات الهوية للمورد. معلومات الهوية
نوع نوع المورد. "Azure"
"AzureArc"
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص الموضوع. TopicProperties
سكو مستوى تسعير Sku للموضوع. ResourceSku
العلامات علامات الموارد قاموس أسماء العلامات والقيم.
نوع نوع المورد "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. JsonField
نوع الحدث معلومات التعيين لخاصية EventType لحدث Event Grid. JsonFieldWithDefault
معرف معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. JsonField
موضوع معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. JsonFieldWithDefault
موضوع معلومات التعيين للخاصية Topic لحدث Event Grid. JsonField

تشفير المفتاح

اسم وصف قيمة
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"

تتبع المواردالعلامات

اسم وصف قيمة

خصائص معرف المستخدم

اسم وصف قيمة
معرف العميل معرف العميل للهوية المعينة من قبل المستخدم. خيط
معرف أساسي المعرف الأساسي للهوية المعينة من قبل المستخدم. خيط