Azure API Management'tan Azure Service Bus'a ileti gönderme

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Standart | Premium

Bu makalede, ilke tabanlı tümleştirme kullanılarak API Management'tan Azure Service Bus'a ileti gönderme açıklanmaktadır. Service Bus'a ileti göndermek için güvenli ve ölçeklenebilir bir yol sağlamak için API Management'ı kullanın.

Azure Service Bus , uygulamaları ve hizmetleri ayırmak ve dağıtılmış sistemler arasında güvenilir bulut mesajlaşması sağlamak için tasarlanmış, tam olarak yönetilen bir kurumsal mesajlaşma hizmetidir. Sistemlerin bire bir iletişim için ileti kuyruklarına ileti göndermesi için AMQP'yi (Gelişmiş Message Queuing Protokolü) ve yayımlama/abone olma desenlerine yönelik konuları destekler. Service Bus, hibrit bulut ortamları arasında zaman uyumsuz işlemler, yük dengeleme veya tümleştirme gerektiren senaryolar için idealdir. Daha fazla bilgi için Azure Service Bus belgelerine bakın.

İlke tabanlı tümleştirme ile API Management şunları sağlar:

• Dış istemciler için güvenli REST tabanlı mesajlaşma - Yerel AMQP desteği olmayan dış sistemler ve mobil uygulamalar API Management aracılığıyla standart HTTP/REST API'lerini kullanarak Service Bus'a ileti gönderebilir. Bu yaklaşım tümleştirmeyi basitleştirir ve özel aracı ihtiyacını ortadan kaldırarak güvenliği artırır.
• yönetilen üçüncü taraf tümleştirmeleri - Kuruluşlar yerleşik yönetilen kimlik doğrulaması ile API Management aracılığıyla Service Bus uç noktalarını kullanıma sunarak iş ortakları ve üçüncü taraf uygulamaları için güvenli ve gözlemlenebilir mesajlaşma düzenlerini etkinleştirebilir.
• Ateşle ve unut modeli - Service Bus'a ileti göndermek için başka hiçbir arka uç hizmeti gerekmez; bu da daha basit mimarilere ve daha az operasyonel yük sağlar.

Uyarı

• API Management'ın Service Bus ile tümleştirilmesi şu anda önizleme aşamasındadır.
• Yalnızca Service Bus'a ileti gönderme desteklenir.

Uyarı

Şu anda bu özellik çalışma alanlarında kullanılamaz.

Önkoşullar

• Api Management hizmet örneği. Eğer bir tane yoksa, bkz. API Management hizmet örneği oluşturma.

• Service Bus'a ileti göndermek için kullanılan bir API Management API'si.

• İletileri almak için Azure Service Bus ad alanında bir kuyruk veya konu başlığı. Ayrıntılı adımlar için aşağıdakilerden birine bakın:

  • Service Bus ad alanı ve kuyruğu oluşturma
  • Service Bus konusu ve konu başlığına abonelikler oluşturma

  Uyarı

  • Konuları ve abonelikleri kullanmak istiyorsanız Service Bus Standard veya Premium katmanını seçin.
  • Service Bus kaynağı farklı bir abonelikte, hatta API Management kaynağından farklı bir kiracıda olabilir .

• Yönetilen kimliğe rol atama izinleri.

Service Bus'a erişimi yapılandırma

Service Bus'a ileti göndermek için API Management örneğiniz için bir yönetilen kimlik yapılandırmanız gerekir:

1. API Management örneğinizde API Management için sistem tarafından atanan veya kullanıcı tarafından atanan yönetilen kimliği etkinleştirin.

   • Kullanıcı tarafından atanan yönetilen kimliği etkinleştirirseniz, kimliğin İstemci Kimliğini not alın.

2. Kimliği, hizmet veri yolu kapsamındaki Azure Service Bus Veri Göndereni rolüne atayın. Rolü atamak için Azure portalını veya diğer Azure araçlarını kullanın.

Send-service-bus-message ilkesini konfigüre etme

İstenen kuyruğa veya konuya ileti göndermek için send-service-bus-message ilkesini yapılandırın.

Örneğin, bir API isteğinin talep gövdesini ağ geçidi tarafından alındığında göndermek için gelen ilke bölümünde send-service-bus-message politikasını kullanın.

1. Azure portalında API Management örneğine gidin.

2. Sol taraftaki menüde API'leri ve ardından ilkeyi eklemek istediğiniz API'yi seçin.

3. Tüm işlemler'i seçin.

4. Ekranın üst kısmında Tasarım sekmesini seçin.

5. Gelen işleme veya Giden işleme penceresinde (kod düzenleyicisi) simgesini seçin </> . Daha fazla bilgi için bkz. İlkeleri ayarlama veya düzenleme.

6. İmlecinizi inbound veya outbound ilke bölümüne getirin.

7. İlkeyi send-service-bus-message ilke yapılandırmasına ekleyin, ardından öznitelikleri ve öğeleri gerektiği gibi yapılandırın.

   Örneğin, istek gövdesini ileti olarak gönderin:

   <send-service-bus-message queue-name="my-queue">
       <payload>@(context.Request.Body.As<string>())</payload>
   </send-service-bus-message>
   

   payload öğesi için, dize döndüren herhangi bir ifadeyi değer olarak kullanabilirsiniz.

8. Güncelleştirilmiş ilke yapılandırmasını kaydetmek için Kaydet'i seçin. Kaydettiğiniz anda ilke etkin olur ve iletiler belirlenen hizmet veri yolu'na gönderilir.

İlgili içerik

• Dış hizmetleri kullanma
• send-service-bus-message yönergesi