Event Grid yönetmek için olay etki alanlarını anlamaUnderstand event domains for managing Event Grid topics

Bu makalede, çeşitli iş kuruluşlarınız, müşterileriniz veya uygulamalarınız için özel olayların akışını yönetmek üzere olay etki alanlarının nasıl kullanılacağı açıklanır.This article describes how to use event domains to manage the flow of custom events to your various business organizations, customers, or applications. Olay etki alanlarını kullanarak şunları yapın:Use event domains to:

  • Çok kiracılı olay mimarilerini ölçeklendirerek yönetin.Manage multitenant eventing architectures at scale.
  • Yetkilendirmeyi ve kimlik doğrulamayı yönetin.Manage your authorization and authentication.
  • Her birini ayrı ayrı yönetmeden konuları bölümleyin.Partition your topics without managing each individually.
  • Konu uç noktalarınızın her birinde tek tek yayımlamayı önleyin.Avoid individually publishing to each of your topic endpoints.

Olay etki alanına genel bakışEvent domain overview

Olay etki alanı, aynı uygulamayla ilgili çok sayıda Event Grid konu başlığı için bir yönetim aracıdır.An event domain is a management tool for large numbers of Event Grid topics related to the same application. Bunu, binlerce bireysel konuya sahip bir meta konu olarak düşünebilirsiniz.You can think of it as a meta-topic that can have thousands of individual topics.

Olay etki alanları, olaylarını yayımlamak için Azure Hizmetleri (depolama ve IoT Hub gibi) tarafından kullanılan mimaride kullanılabilir hale getirir.Event domains make available to you the same architecture used by Azure services (like Storage and IoT Hub) to publish their events. Bunlar binlerce konuya etkinlik yayımlamanıza izin verir.They allow you to publish events to thousands of topics. Etki alanları, Kiracılarınızı bölümleyerek her konu için yetkilendirme ve kimlik doğrulama denetimi de sağlar.Domains also give you authorization and authentication control over each topic so you can partition your tenants.

Örnek kullanım örneğiExample use case

Olay etki alanları bir örnek kullanılarak kolayca açıklanmıştır.Event domains are most easily explained using an example. Tractors, dijitalde ekipman ve diğer ağır makineleri ürettiğiniz contoso oluşturma makinemizin olduğunu varsayalım.Let’s say you run Contoso Construction Machinery, where you manufacture tractors, digging equipment, and other heavy machinery. İşletmeyi çalıştırmanın bir parçası olarak, donanım bakımı, sistem durumu ve sözleşme güncelleştirmeleri hakkındaki müşterilere gerçek zamanlı bilgiler gönderirsiniz.As a part of running the business, you push real-time information to customers about equipment maintenance, systems health, and contract updates. Bu bilgilerin tümü, uygulamanız, müşteri uç noktaları ve müşterilerin ayarladığı diğer altyapıda dahil olmak üzere çeşitli uç noktalara gider.All of this information goes to various endpoints including your app, customer endpoints, and other infrastructure that customers have set up.

Olay etki alanları, contoso oluşturma makineleri tek bir olay varlığı olarak modelleyebilir.Event domains allow you to model Contoso Construction Machinery as a single eventing entity. Müşterilerinizin her biri etki alanı içinde bir konu olarak temsil edilir.Each of your customers is represented as a topic within the domain. Kimlik doğrulama ve yetkilendirme Azure Active Directory kullanılarak işlenir.Authentication and authorization are handled using Azure Active Directory. Müşterilerinizin her biri konuya abone olabilir ve olaylarını kendilerine teslim edebilir.Each of your customers can subscribe to their topic and get their events delivered to them. Olay etki alanı üzerinden yönetilen erişim, yalnızca kendi konularına erişebilmelerini sağlar.Managed access through the event domain ensures they can only access their topic.

Ayrıca, size tüm müşteri olaylarınızı yayımlayabilmeniz için tek bir uç nokta sağlar.It also gives you a single endpoint, which you can publish all of your customer events to. Event Grid her konunun yalnızca kiracının kapsamına alınmış olayların farkında olduğundan emin olunacaktır.Event Grid will take care of making sure each topic is only aware of events scoped to its tenant.

Contoso yapımı örneği

Erişim yönetimiAccess management

Bir etki alanı ile, Azure 'un rol tabanlı erişim denetimi (RBAC) aracılığıyla her konu üzerinde ince bir yetkilendirme ve kimlik doğrulama denetimi edinirsiniz.With a domain, you get fine grain authorization and authentication control over each topic via Azure's role-based access control (RBAC). Uygulamanızdaki her bir kiracıyı yalnızca erişim vermek istediğiniz konularda kısıtlamak için bu rolleri kullanabilirsiniz.You can use these roles to restrict each tenant in your application to only the topics you wish to grant them access to.

Olay etki alanlarında RBAC, Event Grid ve Azure 'un geri kalanında aynı şekilde yönetilen erişim denetimi ile çalışmaktadır.RBAC in event domains works the same way managed access control works in the rest of Event Grid and Azure. Olay etki alanlarında özel rol tanımları oluşturmak ve zorlamak için RBAC kullanın.Use RBAC to create and enforce custom role definitions in event domains.

Yerleşik rollerBuilt in roles

Event Grid, RBAC 'nin olay etki alanlarıyla çalışmaya daha kolay hale getirmek için iki yerleşik rol tanımına sahiptir.Event Grid has two built-in role definitions to make RBAC easier for working with event domains. Bu roller Eventgrid Olayaboneliğine katkıda bulunan (Önizleme) ve Eventgrid eventsubscription Reader (Önizleme) .These roles are EventGrid EventSubscription Contributor (Preview) and EventGrid EventSubscription Reader (Preview). Bu rolleri, olay etki alanındaki konulara abone olmaları gereken kullanıcılara atarsınız.You assign these roles to users who need to subscribe to topics in your event domain. Rol atamasını yalnızca kullanıcıların abone olmaları gereken konuya göre kapsamınız.You scope the role assignment to only the topic that users need to subscribe to.

Bu roller hakkında daha fazla bilgi için bkz. Event Grid Için yerleşik roller.For information about these roles, see Built-in roles for Event Grid.

Konulara abone olmaSubscribing to topics

Bir olay etki alanı içindeki bir konudaki olaylara abone olmak, özel bir konu üzerinde olay aboneliği oluşturma veya bir Azure hizmetinden bir olaya abone olma ile aynıdır.Subscribing to events on a topic within an event domain is the same as creating an Event Subscription on a custom topic or subscribing to an event from an Azure service.

Etki alanı kapsamı abonelikleriDomain scope subscriptions

Olay etki alanları da etki alanı kapsamı aboneliklerine izin verir.Event domains also allow for domain-scope subscriptions. Olay etki alanındaki bir olay aboneliği, olayların gönderildiği konuya bakılmaksızın etki alanına gönderilen tüm olayları alır.An event subscription on an event domain will receive all events sent to the domain regardless of the topic the events are sent to. Etki alanı kapsamı abonelikleri, yönetim ve denetim amacıyla yararlı olabilir.Domain scope subscriptions can be useful for management and auditing purposes.

Bir olay etki alanına yayımlamaPublishing to an event domain

Bir olay etki alanı oluşturduğunuzda, Event Grid ' de bir konu oluşturduysanız, şuna benzer bir yayımlama uç noktası vermiş olursunuz.When you create an event domain, you're given a publishing endpoint similar to if you had created a topic in Event Grid.

Olayları bir olay etki alanında herhangi bir konuya yayımlamak için olayları, özel konu için yaptığınız gibi, etki alanının uç noktasına gönderin.To publish events to any topic in an Event Domain, push the events to the domain's endpoint the same way you would for a custom topic. Tek fark, etkinliğin teslim edilmesini istediğiniz konuyu belirtmektir.The only difference is that you must specify the topic you'd like the event to be delivered to.

Örneğin, aşağıdaki olay dizisinin yayımlanması "id": "1111" , ile "id": "2222" olayı konuya bargönderilecek şekilde olayı konusuna foo gönderir:For example, publishing the following array of events would send event with "id": "1111" to topic foo while the event with "id": "2222" would be sent to topic bar:

[{
  "topic": "foo",
  "id": "1111",
  "eventType": "maintenanceRequested",
  "subject": "myapp/vehicles/diggers",
  "eventTime": "2018-10-30T21:03:07+00:00",
  "data": {
    "make": "Contoso",
    "model": "Small Digger"
  },
  "dataVersion": "1.0"
},
{
  "topic": "bar",
  "id": "2222",
  "eventType": "maintenanceCompleted",
  "subject": "myapp/vehicles/tractors",
  "eventTime": "2018-10-30T21:04:12+00:00",
  "data": {
    "make": "Contoso",
    "model": "Big Tractor"
  },
  "dataVersion": "1.0"
}]

Olay etki alanları, sizin için konularda yayımlamayı işler.Event domains handle publishing to topics for you. Tek tek yönettiğiniz her konuya olay yayımlamak yerine, tüm olaylarınızı etki alanının uç noktasına yayımlayabilirsiniz.Instead of publishing events to each topic you manage individually, you can publish all of your events to the domain's endpoint. Event Grid her olayın doğru konuya gönderildiğinden emin olur.Event Grid makes sure each event is sent to the correct topic.

Limitler ve kotalarLimits and quotas

Olay etki alanlarıyla ilgili sınırlamalar ve Kotalar aşağıda verilmiştir:Here are the limits and quotas related to event domains:

  • olay etki alanı başına 100.000 konu100,000 topics per event domain
  • Azure aboneliği başına 100 olay etki alanı100 event domains per Azure subscription
  • Bir olay etki alanında konu başına 500 olay aboneliği500 event subscriptions per topic in an event domain
  • 50 etki alanı kapsamı abonelikleri50 domain scope subscriptions
  • saniye başına 5.000 olay alma oranı (bir etki alanına)5,000 events per second ingestion rate (into a domain)

Bu limitlere uygun değilse, bir destek bileti açarak veya uygulamasına askgrid@microsoft.combir e-posta göndererek ürün ekibine ulaşın.If these limits don't suit you, reach out the product team by opening a support ticket or by sending an email to askgrid@microsoft.com.

FiyatlandırmaPricing

Olay etki alanları, Event Grid ' deki diğer tüm özelliklerin kullandığı aynı işlem fiyatlandırmasını kullanır.Event domains use the same operations pricing that all other features in Event Grid use.

İşlemler, olay etki alanlarında özel konularda olduğu gibi çalışır.Operations work the same in event domains as they do in custom topics. Bir olayın olay etki alanına her giriş işlemi bir işlemdir ve bir olaya yönelik her bir teslim girişimi bir işlemdir.Each ingress of an event to an event domain is an operation, and each delivery attempt for an event is an operation.

Sonraki adımlarNext steps

  • Olay etki alanlarını ayarlama, konu oluşturma, olay abonelikleri oluşturma ve olayları yayımlama hakkında bilgi edinmek için bkz. olay etki alanlarını yönetme.To learn about setting up event domains, creating topics, creating event subscriptions, and publishing events, see Manage event domains.