مجالات Microsoft.EventGrid

  • مقالة

تعريف مورد Bicep

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.EventGrid/domains@2023-12-15-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  properties: {
    autoCreateTopicWithFirstSubscription: bool
    autoDeleteTopicWithLastSubscription: bool
    dataResidencyBoundary: 'string'
    disableLocalAuth: bool
    eventTypeInfo: {
      inlineEventTypes: {
        {customized property}: {
          dataSchemaUrl: 'string'
          description: 'string'
          displayName: 'string'
          documentationUrl: 'string'
        }
      }
      kind: 'Inline'
    }
    inboundIpRules: [
      {
        action: 'Allow'
        ipMask: 'string'
      }
    ]
    inputSchema: 'string'
    inputSchemaMapping: {
      inputSchemaMappingType: 'string'
      // For remaining properties, see InputSchemaMapping objects
    }
    minimumTlsVersionAllowed: 'string'
    publicNetworkAccess: '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'
    }
  }

قيم Property

مجالات

الاسم الوصف القيمة
الاسم اسم المورد سلسلة (مطلوب)

حد الحرف: 3-50

أحرف صالحة:
الأبجدية الرقمية والواصلات.
الموقع موقع المورد. سلسلة (مطلوب)
العلامات علامات المورد. قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
sku مستوى تسعير Sku لمورد مجال شبكة الأحداث. ResourceSku
الهوية معلومات الهوية لمورد مجال شبكة الأحداث. IdentityInfo
خصائص خصائص مورد مجال شبكة الأحداث. خصائص المجال

IdentityInfo

الاسم الوصف القيمة
معرف أساسي المعرف الأساسي لهوية المورد. سلسلة
معرّف المستأجر معرف المستأجر للمورد. سلسلة
النوع نوع الهوية المدارة المستخدمة. يتضمن النوع "SystemAssigned, UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هوية. 'بلا'
'SystemAssigned'
'SystemAssigned, UserAssigned'
"UserAssigned"
userAssignedIdentities قائمة هويات المستخدم المقترنة بالمورد. ستكون المراجع الرئيسية لقاموس هوية المستخدم معرفات موارد ARM في النموذج:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
هذه الخاصية غير مستخدمة حاليا ومحجوزة للاستخدام في المستقبل.
 IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} UserIdentityProperties

UserIdentityProperties

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

خصائص المجال

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

EventTypeInfo

الاسم الوصف القيمة
أنواع InlineEventTypes مجموعة من أنواع الأحداث المضمنة للمورد. مفاتيح نوع الحدث المضمنة هي من سلسلة النوع التي تمثل اسم الحدث.
مثال على اسم حدث مضمن صالح هو "Contoso.OrderCreated".
قيم نوع الحدث المضمنة من النوع InlineEventProperties وستحتوي على معلومات إضافية لكل نوع حدث مضمن.		 EventTypeInfoInlineEventTypes
نوع نوع الحدث المستخدم. "مضمن"

EventTypeInfoInlineEventTypes

الاسم الوصف القيمة
{خاصية مخصصة} InlineEventProperties

InlineEventProperties

الاسم الوصف القيمة
dataSchemaUrl dataSchemaUrl للحدث المضمن. سلسلة
الوصف وصف الحدث المضمن. سلسلة
اسم المستخدم displayName للحدث المضمن. سلسلة
documentationUrl documentationUrl للحدث المضمن. سلسلة

InboundIpRule

الاسم الوصف القيمة
إجراء الإجراء المطلوب تنفيذه استنادا إلى التطابق أو عدم تطابق IpMask. "السماح"
ipMask عنوان IP في رمز CIDR على سبيل المثال، 10.0.0.0/8. سلسلة

InputSchemaMapping

الاسم الوصف القيمة
inputSchemaMappingType تعيين نوع الكائن Json (مطلوب)

JsonInputSchemaMapping

الاسم الوصف القيمة
inputSchemaMappingType نوع التعيين المخصص 'Json' (مطلوب)
خصائص خصائص JSON لتعيين مخطط الإدخال JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

الاسم الوصف القيمة
⁧⁧⁩⁩إصدار البيانات⁧⁧⁩⁩ معلومات التعيين لخاصية DataVersion لحدث Event Grid. JsonFieldWithDefault
⁧⁩توقيت الحدث⁧⁩ معلومات التعيين لخاصية EventTime لحدث Event Grid. JsonField
⁧⁩نوع الحدث⁧⁩ معلومات التعيين لخاصية EventType لحدث Event Grid. JsonFieldWithDefault
المعرف معلومات التعيين لخاصية المعرف لحدث Event Grid. JsonField
الموضوع معلومات التعيين للخاصية Subject لحدث Event Grid. JsonFieldWithDefault
الموضوع معلومات التعيين للخاصية Topic لحدث Event Grid. JsonField

JsonFieldWithDefault

الاسم الوصف القيمة
القيمة الظاهرية القيمة الافتراضية التي سيتم استخدامها للتعيين عند عدم توفير SourceField أو إذا لم تكن هناك خاصية بالاسم المحدد في حمولة حدث JSON المنشورة. سلسلة
حقل المصدر اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر للتعيين. سلسلة

JsonField

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

ResourceSku

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

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.EventGrid/domains",
  "apiVersion": "2023-12-15-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "properties": {
    "autoCreateTopicWithFirstSubscription": "bool",
    "autoDeleteTopicWithLastSubscription": "bool",
    "dataResidencyBoundary": "string",
    "disableLocalAuth": "bool",
    "eventTypeInfo": {
      "inlineEventTypes": {
        "{customized property}": {
          "dataSchemaUrl": "string",
          "description": "string",
          "displayName": "string",
          "documentationUrl": "string"
        }
      },
      "kind": "Inline"
    },
    "inboundIpRules": [
      {
        "action": "Allow",
        "ipMask": "string"
      }
    ],
    "inputSchema": "string",
    "inputSchemaMapping": {
      "inputSchemaMappingType": "string"
      // For remaining properties, see InputSchemaMapping objects
    },
    "minimumTlsVersionAllowed": "string",
    "publicNetworkAccess": "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"
    }
  }

قيم Property

مجالات

الاسم الوصف القيمة
النوع نوع المورد 'Microsoft.EventGrid/domains'
apiVersion إصدار واجهة برمجة تطبيقات المورد 'معاينة 2023-12-15'
الاسم اسم المورد سلسلة (مطلوبة)

حد الحرف: 3-50

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

IdentityInfo

الاسم الوصف القيمة
معرف أساسي المعرف الأساسي لهوية المورد. سلسلة
معرّف المستأجر معرف المستأجر للمورد. سلسلة
النوع نوع الهوية المدارة المستخدمة. يتضمن النوع "SystemAssigned, UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هوية. 'بلا'
'SystemAssigned'
'SystemAssigned, UserAssigned'
"تعيين المستخدم"
userAssignedIdentities قائمة هويات المستخدم المقترنة بالمورد. ستكون المراجع الرئيسية لقاموس هوية المستخدم معرفات موارد ARM في النموذج:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
هذه الخاصية غير مستخدمة حاليا ومحجوزة للاستخدام المستقبلي.
 IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} خصائص معرف المستخدم

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

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

خصائص المجال

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

EventTypeInfo

الاسم الوصف القيمة
أنواع InlineEventTypes مجموعة من أنواع الأحداث المضمنة للمورد. مفاتيح نوع الحدث المضمنة هي من سلسلة النوع التي تمثل اسم الحدث.
مثال على اسم حدث مضمن صالح هو "Contoso.OrderCreated".
قيم نوع الحدث المضمنة من النوع InlineEventProperties وستحتوي على معلومات إضافية لكل نوع حدث مضمن.		 EventTypeInfoInlineEventTypes
نوع نوع الحدث المستخدم. "مضمن"

EventTypeInfoInlineEventTypes

الاسم الوصف القيمة
{خاصية مخصصة} InlineEventProperties

InlineEventProperties

الاسم الوصف القيمة
dataSchemaUrl dataSchemaUrl للحدث المضمن. سلسلة
الوصف وصف الحدث المضمن. سلسلة
اسم المستخدم displayName للحدث المضمن. سلسلة
documentationUrl documentationUrl للحدث المضمن. سلسلة

InboundIpRule

الاسم الوصف القيمة
إجراء إجراء يجب تنفيذه استنادا إلى تطابق IpMask أو عدم وجوده. "السماح"
ipMask عنوان IP في رمز CIDR، على سبيل المثال، 10.0.0.0/8. سلسلة

InputSchemaMapping

الاسم الوصف القيمة
inputSchemaMappingType تعيين نوع العنصر Json (مطلوب)

JsonInputSchemaMapping

الاسم الوصف القيمة
inputSchemaMappingType نوع التعيين المخصص 'Json' (مطلوب)
خصائص خصائص JSON لتعيين مخطط الإدخال JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

الاسم الوصف القيمة
⁧⁧⁩⁩إصدار البيانات⁧⁧⁩⁩ معلومات التعيين لخاصية DataVersion لحدث شبكة الأحداث. JsonFieldWithDefault
⁧⁩توقيت الحدث⁧⁩ معلومات التعيين لخاصية EventTime لحدث Event Grid. JsonField
⁧⁩نوع الحدث⁧⁩ معلومات التعيين لخاصية EventType لحدث شبكة الأحداث. JsonFieldWithDefault
المعرف معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. JsonField
الموضوع معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. JsonFieldWithDefault
الموضوع معلومات التعيين للخاصية Topic لحدث Event Grid. JsonField

JsonFieldWithDefault

الاسم الوصف القيمة
القيمة الظاهرية القيمة الافتراضية التي سيتم استخدامها للتعيين عند عدم توفير SourceField أو إذا لم تكن هناك خاصية بالاسم المحدد في حمولة حدث JSON المنشورة. سلسلة
sourceField اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. سلسلة

JsonField

الاسم الوصف القيمة
sourceField اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر لتعيين. سلسلة

ResourceSku

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

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

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

  • مجموعات الموارد

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/domains@2023-12-15-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      autoCreateTopicWithFirstSubscription = bool
      autoDeleteTopicWithLastSubscription = bool
      dataResidencyBoundary = "string"
      disableLocalAuth = bool
      eventTypeInfo = {
        inlineEventTypes = {
          {customized property} = {
            dataSchemaUrl = "string"
            description = "string"
            displayName = "string"
            documentationUrl = "string"
          }
        }
        kind = "Inline"
      }
      inboundIpRules = [
        {
          action = "Allow"
          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"
    }
  }

قيم Property

مجالات

الاسم الوصف القيمة
النوع نوع المورد "Microsoft.EventGrid/domains@2023-12-15-preview"
الاسم اسم المورد سلسلة (مطلوب)

حد الحرف: 3-50

أحرف صالحة:
الأبجدية الرقمية والواصلات.
الموقع موقع المورد. سلسلة (مطلوب)
parent_id للنشر إلى مجموعة موارد، استخدم معرف مجموعة الموارد هذه. سلسلة (مطلوب)
العلامات علامات المورد. قاموس أسماء العلامات والقيم.
sku مستوى تسعير Sku لمورد مجال شبكة الأحداث. ResourceSku
الهوية معلومات الهوية لمورد مجال شبكة الأحداث. IdentityInfo
خصائص خصائص مورد مجال شبكة الأحداث. خصائص المجال

IdentityInfo

الاسم الوصف القيمة
النوع نوع الهوية المدارة المستخدمة. يتضمن النوع "SystemAssigned, UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هوية. "SystemAssigned"
"SystemAssigned، UserAssigned"
"UserAssigned"
identity_ids قائمة هويات المستخدم المقترنة بالمورد. ستكون المراجع الرئيسية لقاموس هوية المستخدم معرفات موارد ARM في النموذج:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
هذه الخاصية غير مستخدمة حاليا ومحجوزة للاستخدام في المستقبل.
 صفيف معرفات هوية المستخدم.

IdentityInfoUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} UserIdentityProperties

UserIdentityProperties

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

خصائص المجال

الاسم الوصف القيمة
autoCreateTopicWithFirstSubscription يتم استخدام هذا المنطقي لتحديد آلية الإنشاء ل "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة إنشاء موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عندما تكون هذه الخاصية فارغة أو معينة إلى true، تكون Event Grid مسؤولة عن إنشاء موضوع المجال تلقائيا عندما يكون اشتراك الحدث الأول هو
تم إنشاؤه في نطاق موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيتطلب إنشاء اشتراك الحدث الأول إنشاء موضوع مجال
من قبل المستخدم. يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم التحكم الكامل في وقت إنشاء موضوع المجال، بينما يوفر الوضع المدار تلقائيا
المرونة لتنفيذ عمليات أقل وإدارة موارد أقل من قبل المستخدم. لاحظ أيضا أنه في وضع الإنشاء المدار تلقائيا، يسمح للمستخدم بإنشاء
موضوع المجال عند الطلب إذا لزم الأمر.		 Bool
autoDeleteTopicWithLastSubscription يتم استخدام هذا المنطقي لتحديد آلية الحذف ل "الكل" مواضيع مجال شبكة الأحداث المقترنة بمورد مجال شبكة الأحداث هذا.
في هذا السياق، يمكن إدارة حذف موضوع المجال تلقائيا (عندما يكون صحيحا) أو مدارا ذاتيا (عندما يكون خطأ). القيمة الافتراضية لهذه الخاصية صحيحة.
عند تعيين هذه الخاصية إلى true، تكون Event Grid مسؤولة عن حذف موضوع المجال تلقائيا عند اشتراك الحدث الأخير في النطاق
تم حذف موضوع المجال. إذا تم تعيين هذه الخاصية إلى خطأ، فسيحتاج المستخدم إلى حذف موضوع المجال يدويا عندما لا تكون هناك حاجة إليه
(على سبيل المثال، عند حذف اشتراك الحدث الأخير وضرورة تنظيف المورد). يمكن استخدام وضع الإدارة الذاتية إذا أراد المستخدم كامل
التحكم في الوقت الذي يحتاج فيه موضوع المجال إلى حذف، بينما يوفر الوضع المدار تلقائيا المرونة لتنفيذ عمليات أقل وإدارة أقل
الموارد من قبل المستخدم.		 Bool
dataResidencyBoundary Data Residency حد المورد. "WithinGeopair"
"WithinRegion"
disableLocalAuth يتم استخدام هذا المنطقي لتمكين المصادقة المحلية أو تعطيلها. القيمة الافتراضية خاطئة. عند تعيين الخاصية إلى true، سيتم استخدام رمز AAD المميز فقط للمصادقة إذا تم السماح للمستخدم بالنشر إلى المجال. Bool
eventTypeInfo معلومات نوع الحدث للمجال. يتم توفير هذه المعلومات من قبل الناشر ويمكن استخدامها من قبل
المشترك لعرض أنواع مختلفة من الأحداث التي يتم نشرها.		 EventTypeInfo
InboundIpRules يمكن استخدام هذا لتقييد نسبة استخدام الشبكة من عناوين IP محددة بدلا من جميع عناوين IP. ملاحظة: يتم اعتبارها فقط إذا تم تمكين PublicNetworkAccess. InboundIpRule[]
inputSchema يحدد هذا التنسيق الذي يجب أن تتوقعه Event Grid للأحداث الواردة المنشورة في مورد مجال Event Grid. "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping معلومات حول InputSchemaMapping التي حددت معلومات حول تعيين حمولة الحدث. InputSchemaMapping
minimumTlsVersionAllowed الحد الأدنى من إصدار 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 وستحتوي على معلومات إضافية لكل نوع حدث مضمن.		 EventTypeInfoInlineEventTypes
نوع نوع الحدث المستخدم. "مضمن"

EventTypeInfoInlineEventTypes

الاسم الوصف القيمة
{خاصية مخصصة} خصائص الأحداث المضمنة

خصائص الأحداث المضمنة

الاسم الوصف القيمة
dataSchemaUrl dataSchemaUrl للحدث المضمن. سلسلة
الوصف وصف الحدث المضمن. سلسلة
اسم المستخدم displayName للحدث المضمن. سلسلة
عنوان URL للوثائق documentationUrl للحدث المضمن. سلسلة

InboundIpRule

الاسم الوصف القيمة
إجراء الإجراء المطلوب تنفيذه استنادا إلى التطابق أو عدم تطابق IpMask. "السماح"
ipMask عنوان IP في رمز CIDR على سبيل المثال، 10.0.0.0/8. سلسلة

InputSchemaMapping

الاسم الوصف القيمة
inputSchemaMappingType تعيين نوع الكائن Json (مطلوب)

JsonInputSchemaMapping

الاسم الوصف القيمة
inputSchemaMappingType نوع التعيين المخصص "Json" (مطلوب)
خصائص خصائص JSON لتعيين مخطط الإدخال JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

الاسم الوصف القيمة
⁧⁧⁩⁩إصدار البيانات⁧⁧⁩⁩ معلومات التعيين لخاصية DataVersion لحدث Event Grid. JsonFieldWithDefault
⁧⁩توقيت الحدث⁧⁩ معلومات التعيين لخاصية EventTime لحدث Event Grid. JsonField
⁧⁩نوع الحدث⁧⁩ معلومات التعيين لخاصية EventType لحدث Event Grid. JsonFieldWithDefault
المعرف معلومات التعيين لخاصية المعرف لحدث Event Grid. JsonField
الموضوع معلومات التعيين للخاصية Subject لحدث Event Grid. JsonFieldWithDefault
الموضوع معلومات التعيين للخاصية Topic لحدث Event Grid. JsonField

JsonFieldWithDefault

الاسم الوصف القيمة
القيمة الظاهرية القيمة الافتراضية التي سيتم استخدامها للتعيين عند عدم توفير SourceField أو إذا لم تكن هناك خاصية بالاسم المحدد في حمولة حدث JSON المنشورة. سلسلة
حقل المصدر اسم حقل في مخطط حدث الإدخال الذي سيتم استخدامه كمصدر للتعيين. سلسلة

JsonField

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

ResourceSku

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