مشاركة عبر


مجالات Microsoft.EventGrid 2024-06-01-preview

تعريف مورد Bicep

يمكن نشر نوع مورد المجالات مع العمليات التي تستهدف:

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.EventGrid/domains، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.EventGrid/domains@2024-06-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    autoCreateTopicWithFirstSubscription: bool
    autoDeleteTopicWithLastSubscription: bool
    dataResidencyBoundary: 'string'
    disableLocalAuth: bool
    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'
    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

اسم وصف قيمة
الهوية معلومات الهوية لمورد مجال شبكة الأحداث. معلومات الهوية
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص مورد Event Grid Domain. DomainProperties
نطاق استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر. قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد الملحق.
سكو مستوى تسعير Sku لمورد Event Grid Domain. ResourceSku
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

خصائص المجال

اسم وصف قيمة
autoCreateTopicWithFirstSubscription يتم استخدام هذا المنطقي لتحديد آلية الإنشاء "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة إنشاء موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عندما تكون هذه الخاصية فارغة أو معينة إلى true، تكون Event Grid مسؤولة عن إنشاء موضوع المجال تلقائيا عندما يكون اشتراك الحدث الأول
تم إنشاؤه في نطاق موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيتطلب إنشاء اشتراك الحدث الأول إنشاء موضوع مجال
بواسطة المستخدم. يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم التحكم الكامل في وقت إنشاء موضوع المجال، بينما يوفر الوضع المدار تلقائيا
المرونة لتنفيذ عمليات أقل وإدارة موارد أقل من قبل المستخدم. لاحظ أيضا أنه في وضع الإنشاء المدار تلقائيا، يسمح للمستخدم بإنشاء
موضوع المجال عند الطلب إذا لزم الأمر.
قيمة منطقية
autoDeleteTopicWithLastSubscription يتم استخدام هذا المنطقي لتحديد آلية الحذف "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة حذف موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عند تعيين هذه الخاصية إلى true، تكون Event Grid مسؤولة عن حذف موضوع المجال تلقائيا عند اشتراك الحدث الأخير في النطاق
تم حذف موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيحتاج المستخدم إلى حذف موضوع المجال يدويا عندما لا تكون هناك حاجة إليه
(على سبيل المثال، عند حذف اشتراك الحدث الأخير وضرورة تنظيف المورد). يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم كامل
التحكم في الوقت الذي يحتاج فيه موضوع المجال إلى حذف، بينما يوفر الوضع المدار تلقائيا المرونة لتنفيذ عمليات أقل وإدارة أقل
الموارد من قبل المستخدم.
قيمة منطقية
dataResidencyBoundary حد موقع البيانات للمورد. "داخل Geopair"
"داخل المنطقة"
تعطيلLocalAuth يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام رمز AAD المميز فقط للمصادقة إذا سمح للمستخدم بالنشر إلى المجال. قيمة منطقية
معلومات عن نوع الحدث معلومات نوع الحدث للمجال. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل
المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها.
EventTypeInfo
قواعد Ip الواردة يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP معينة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. InboundIpRule[]
مخطط المدخلات يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة على مورد مجال شبكة الأحداث. "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping معلومات حول InputSchemaMapping التي حددت المعلومات حول تعيين حمولة الحدث. InputSchemaMapping
الحد الأدنى لTlsVersionAllowed الحد الأدنى لإصدار TLS للناشر المسموح له بالنشر إلى هذا المجال '1.0'
'1.1'
'1.2'
publicNetworkAccess يحدد هذا ما إذا كان يسمح بحركة المرور عبر الشبكة العامة. بشكل افتراضي يتم تمكينه.
يمكنك تقييد عناوين IP معينة عن طريق تكوين <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" />
"معطل"
"ممكن"
"SecuredByPerimeter"

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

ResourceSku

اسم وصف قيمة
اسم اسم Sku للمورد. القيم المحتملة هي: Basic أو Premium. "أساسي"
"بريميوم"

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

اسم وصف قيمة

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

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

أمثلة الاستخدام

الوحدات النمطية التي تم التحقق منها من Azure

يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.

الوحده النمطيه وصف
مجال شبكة الأحداث وحدة موارد AVM لمجال شبكة الأحداث

تعريف مورد قالب ARM

يمكن نشر نوع مورد المجالات مع العمليات التي تستهدف:

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.EventGrid/domains، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.EventGrid/domains",
  "apiVersion": "2024-06-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "autoCreateTopicWithFirstSubscription": "bool",
    "autoDeleteTopicWithLastSubscription": "bool",
    "dataResidencyBoundary": "string",
    "disableLocalAuth": "bool",
    "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",
    "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

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات "معاينة 2024-06-01"
الهوية معلومات الهوية لمورد مجال شبكة الأحداث. معلومات الهوية
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
خصائص خصائص مورد Event Grid Domain. DomainProperties
سكو مستوى تسعير Sku لمورد Event Grid Domain. ResourceSku
العلامات علامات الموارد قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
نوع نوع المورد "Microsoft.EventGrid/domains"

خصائص المجال

اسم وصف قيمة
autoCreateTopicWithFirstSubscription يتم استخدام هذا المنطقي لتحديد آلية الإنشاء "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة إنشاء موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عندما تكون هذه الخاصية فارغة أو معينة إلى true، تكون Event Grid مسؤولة عن إنشاء موضوع المجال تلقائيا عندما يكون اشتراك الحدث الأول
تم إنشاؤه في نطاق موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيتطلب إنشاء اشتراك الحدث الأول إنشاء موضوع مجال
بواسطة المستخدم. يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم التحكم الكامل في وقت إنشاء موضوع المجال، بينما يوفر الوضع المدار تلقائيا
المرونة لتنفيذ عمليات أقل وإدارة موارد أقل من قبل المستخدم. لاحظ أيضا أنه في وضع الإنشاء المدار تلقائيا، يسمح للمستخدم بإنشاء
موضوع المجال عند الطلب إذا لزم الأمر.
قيمة منطقية
autoDeleteTopicWithLastSubscription يتم استخدام هذا المنطقي لتحديد آلية الحذف "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة حذف موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عند تعيين هذه الخاصية إلى true، تكون Event Grid مسؤولة عن حذف موضوع المجال تلقائيا عند اشتراك الحدث الأخير في النطاق
تم حذف موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيحتاج المستخدم إلى حذف موضوع المجال يدويا عندما لا تكون هناك حاجة إليه
(على سبيل المثال، عند حذف اشتراك الحدث الأخير وضرورة تنظيف المورد). يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم كامل
التحكم في الوقت الذي يحتاج فيه موضوع المجال إلى حذف، بينما يوفر الوضع المدار تلقائيا المرونة لتنفيذ عمليات أقل وإدارة أقل
الموارد من قبل المستخدم.
قيمة منطقية
dataResidencyBoundary حد موقع البيانات للمورد. "داخل Geopair"
"داخل المنطقة"
تعطيلLocalAuth يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام رمز AAD المميز فقط للمصادقة إذا سمح للمستخدم بالنشر إلى المجال. قيمة منطقية
معلومات عن نوع الحدث معلومات نوع الحدث للمجال. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل
المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها.
EventTypeInfo
قواعد Ip الواردة يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP معينة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. InboundIpRule[]
مخطط المدخلات يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة على مورد مجال شبكة الأحداث. "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping معلومات حول InputSchemaMapping التي حددت المعلومات حول تعيين حمولة الحدث. InputSchemaMapping
الحد الأدنى لTlsVersionAllowed الحد الأدنى لإصدار TLS للناشر المسموح له بالنشر إلى هذا المجال '1.0'
'1.1'
'1.2'
publicNetworkAccess يحدد هذا ما إذا كان يسمح بحركة المرور عبر الشبكة العامة. بشكل افتراضي يتم تمكينه.
يمكنك تقييد عناوين IP معينة عن طريق تكوين <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" />
"معطل"
"ممكن"
"SecuredByPerimeter"

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

ResourceSku

اسم وصف قيمة
اسم اسم Sku للمورد. القيم المحتملة هي: Basic أو Premium. "أساسي"
"بريميوم"

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

اسم وصف قيمة

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

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

أمثلة الاستخدام

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد المجالات مع العمليات التي تستهدف:

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.EventGrid/domains، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/domains@2024-06-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      autoCreateTopicWithFirstSubscription = bool
      autoDeleteTopicWithLastSubscription = bool
      dataResidencyBoundary = "string"
      disableLocalAuth = bool
      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"
      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

اسم وصف قيمة
الهوية معلومات الهوية لمورد مجال شبكة الأحداث. معلومات الهوية
مكان موقع المورد. سلسلة (مطلوب)
اسم اسم المورد سلسلة (مطلوب)
parent_id معرف المورد لتطبيق مورد الملحق هذا عليه. سلسلة (مطلوب)
خصائص خصائص مورد Event Grid Domain. DomainProperties
سكو مستوى تسعير Sku لمورد Event Grid Domain. ResourceSku
العلامات علامات الموارد قاموس أسماء العلامات والقيم.
نوع نوع المورد "Microsoft.EventGrid / domains@2024-06-01-preview"

خصائص المجال

اسم وصف قيمة
autoCreateTopicWithFirstSubscription يتم استخدام هذا المنطقي لتحديد آلية الإنشاء "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة إنشاء موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عندما تكون هذه الخاصية فارغة أو معينة إلى true، تكون Event Grid مسؤولة عن إنشاء موضوع المجال تلقائيا عندما يكون اشتراك الحدث الأول
تم إنشاؤه في نطاق موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيتطلب إنشاء اشتراك الحدث الأول إنشاء موضوع مجال
بواسطة المستخدم. يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم التحكم الكامل في وقت إنشاء موضوع المجال، بينما يوفر الوضع المدار تلقائيا
المرونة لتنفيذ عمليات أقل وإدارة موارد أقل من قبل المستخدم. لاحظ أيضا أنه في وضع الإنشاء المدار تلقائيا، يسمح للمستخدم بإنشاء
موضوع المجال عند الطلب إذا لزم الأمر.
قيمة منطقية
autoDeleteTopicWithLastSubscription يتم استخدام هذا المنطقي لتحديد آلية الحذف "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة حذف موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عند تعيين هذه الخاصية إلى true، تكون Event Grid مسؤولة عن حذف موضوع المجال تلقائيا عند اشتراك الحدث الأخير في النطاق
تم حذف موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيحتاج المستخدم إلى حذف موضوع المجال يدويا عندما لا تكون هناك حاجة إليه
(على سبيل المثال، عند حذف اشتراك الحدث الأخير وضرورة تنظيف المورد). يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم كامل
التحكم في الوقت الذي يحتاج فيه موضوع المجال إلى حذف، بينما يوفر الوضع المدار تلقائيا المرونة لتنفيذ عمليات أقل وإدارة أقل
الموارد من قبل المستخدم.
قيمة منطقية
dataResidencyBoundary حد موقع البيانات للمورد. "داخل Geopair"
"داخل المنطقة"
تعطيلLocalAuth يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام رمز AAD المميز فقط للمصادقة إذا سمح للمستخدم بالنشر إلى المجال. قيمة منطقية
معلومات عن نوع الحدث معلومات نوع الحدث للمجال. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل
المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها.
EventTypeInfo
قواعد Ip الواردة يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP معينة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. InboundIpRule[]
مخطط المدخلات يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة على مورد مجال شبكة الأحداث. "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping معلومات حول InputSchemaMapping التي حددت المعلومات حول تعيين حمولة الحدث. InputSchemaMapping
الحد الأدنى لTlsVersionAllowed الحد الأدنى لإصدار TLS للناشر المسموح له بالنشر إلى هذا المجال '1.0'
'1.1'
'1.2'
publicNetworkAccess يحدد هذا ما إذا كان يسمح بحركة المرور عبر الشبكة العامة. بشكل افتراضي يتم تمكينه.
يمكنك تقييد عناوين IP معينة عن طريق تكوين <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" />
"معطل"
"ممكن"
"SecuredByPerimeter"

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

ResourceSku

اسم وصف قيمة
اسم اسم Sku للمورد. القيم المحتملة هي: Basic أو Premium. "أساسي"
"بريميوم"

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

اسم وصف قيمة

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

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

أمثلة الاستخدام

عينات 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" "domain" {
  type      = "Microsoft.EventGrid/domains@2021-12-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      autoCreateTopicWithFirstSubscription = true
      autoDeleteTopicWithLastSubscription  = true
      disableLocalAuth                     = false
      inputSchema                          = "EventGridSchema"
      inputSchemaMapping                   = null
      publicNetworkAccess                  = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}