إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
- أحدث
- 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-معاينة
- معاينة 2018-09-15
تعريف مورد 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. | |
| نطاق | استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر. | قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد الملحق. |
| سكو | مستوى تسعير Sku لمورد Event Grid Domain. | |
| العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
خصائص المجال
| اسم | وصف | قيمة |
|---|---|---|
| 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. | |
| نوع الحدث | معلومات التعيين لخاصية EventType لحدث Event Grid. | JsonFieldWithDefault |
| معرف | معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. | |
| موضوع | معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. | JsonFieldWithDefault |
| موضوع | معلومات التعيين للخاصية Topic لحدث Event Grid. | |
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. | |
| سكو | مستوى تسعير Sku لمورد Event Grid Domain. | |
| العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. راجع العلامات في القوالب |
| نوع | نوع المورد | "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. | |
| نوع الحدث | معلومات التعيين لخاصية EventType لحدث Event Grid. | JsonFieldWithDefault |
| معرف | معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. | |
| موضوع | معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. | JsonFieldWithDefault |
| موضوع | معلومات التعيين للخاصية Topic لحدث Event Grid. | |
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. | |
| سكو | مستوى تسعير Sku لمورد Event Grid Domain. | |
| العلامات | علامات الموارد | قاموس أسماء العلامات والقيم. |
| نوع | نوع المورد | "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. | |
| نوع الحدث | معلومات التعيين لخاصية EventType لحدث Event Grid. | JsonFieldWithDefault |
| معرف | معلومات التعيين لخاصية المعرف لحدث شبكة الأحداث. | |
| موضوع | معلومات التعيين لخاصية الموضوع لحدث شبكة الأحداث. | JsonFieldWithDefault |
| موضوع | معلومات التعيين للخاصية Topic لحدث Event Grid. | |
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 = ["*"]
}