Azure Logic Apps'te HTTP web kancalarını kullanarak olayların iş akışlarını çalıştırmasını bekleyin ve abone olun
Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)
Bir hizmet uç noktasını veya bu uç noktayı çağıran eylemi düzenli olarak denetleten veya yoklayan bir tetikleyici kullanmak yerine, bir hizmet uç noktasına abone olan, belirli olayları bekleyen ve iş akışınızda belirli eylemleri çalıştıran bir HTTP Web Kancası tetikleyicisi veya eylemi kullanabilirsiniz.
Aşağıda web kancası tabanlı iş akışlarına örnek verilmiştir:
- bir iş akışı çalıştırmasını tetiklemeden önce Azure Event Hubs'dan bir olayın gelmesini bekleyin.
- bir iş akışına devam etmeden önce onay bekleyin.
Bu kılavuzda, iş akışınızın bir hizmet uç noktasındaki olayları alıp yanıtlaması için HTTP Web kancası tetikleyicisi ve Web kancası eyleminin nasıl kullanılacağı gösterilmektedir.
Web kancaları nasıl çalışır?
Web kancası tetikleyicisi olay tabanlıdır ve yeni veriler veya olaylar için düzenli olarak denetlenmesi veya yoklanması gerekmez. Boş bir iş akışına web kancası tetikleyicisi ekledikten ve sonra iş akışını kaydettikten sonra veya devre dışı bırakılmış bir mantıksal uygulama kaynağını yeniden etkinleştirdikten sonra, web kancası tetikleyicisi bu uç noktaya bir geri çağırma URL'si kaydederek belirtilen hizmet uç noktasına abone olur. Tetikleyici daha sonra bu hizmet uç noktasının URL'yi çağırmasını bekler ve bu da tetikleyiciyi tetikler ve iş akışını başlatır. İstek tetikleyicisine benzer şekilde, bir web kancası tetikleyicisi hemen tetikler. Aşağıdaki eylemleri el ile gerçekleştirmediğiniz sürece web kancası tetikleyicisi de hizmet uç noktasına abone olarak kalır:
- Tetikleyicinin parametre değerlerini değiştirin.
- Tetikleyiciyi silin ve iş akışınızı kaydedin.
- Mantıksal uygulama kaynağınızı devre dışı bırakın.
Web kancası tetikleyicisine benzer şekilde, web kancası eylemi de olay tabanlı çalışır. Var olan bir iş akışına web kancası eylemi ekledikten ve sonra iş akışını kaydettikten sonra veya devre dışı bırakılmış bir mantıksal uygulama kaynağını yeniden etkinleştirdikten sonra, web kancası eylemi bu uç noktaya bir geri çağırma URL'si kaydederek belirtilen hizmet uç noktasına abone olur. İş akışı çalıştırıldığında, web kancası eylemi iş akışını duraklatır ve iş akışı çalışmaya devam etmeden önce hizmet uç noktası URL'yi çağırana kadar bekler. Aşağıdaki koşullar oluştuğunda bir web kancası eyleminin abonelikleri hizmet uç noktasından çıkar:
- Web kancası eylemi başarıyla tamamlar.
- Yanıt beklenirken iş akışı çalıştırması iptal edilir.
- Bir iş akışı çalıştırması zaman aşımına uğramadan önce.
- Web kancası tetikleyicisi tarafından giriş olarak kullanılan tüm web kancası eylem parametre değerlerini değiştirirsiniz.
Örneğin, Office 365 Outlook bağlayıcısının Onay e-postası gönder eylemi, bu deseni izleyen bir web kancası eylemi örneğidir. Web kancası eylemini kullanarak bu düzeni herhangi bir hizmete genişletebilirsiniz.
Daha fazla bilgi için, aşağıdaki belgelere bakın:
Daha önce Güvenli Yuva Katmanı (SSL) olarak bilinen Aktarım Katmanı Güvenliği (TLS) veya Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth) gibi mantıksal uygulamanıza gelen çağrılar için şifreleme, güvenlik ve yetkilendirme hakkında bilgi için bkz. Güvenli erişim ve veri - İstek tabanlı tetikleyicilere gelen çağrılar için erişim.
Bağlayıcı teknik başvurusu
Tetikleyici ve eylem parametreleri hakkında daha fazla bilgi için bkz . HTTP Web kancası parametreleri.
Önkoşullar
Bir Azure hesabı ve aboneliği Azure aboneliğiniz yoksa ücretsiz bir Azure hesabı için kaydolun.
İş akışlarında web kancası tetikleyicilerine veya iş akışlarındaki web kancası eylemlerine uygun şekilde web kancası tetikleyicileri için abone olma ve abonelikten çıkma desenini destekleyen, zaten dağıtılmış bir uç noktanın veya API'nin URL'si
Hedef uç noktada belirli olayları beklemek istediğiniz Standart veya Tüketim mantıksal uygulaması iş akışı. HTTP Web Kancası tetikleyicisiyle başlamak için boş bir iş akışı içeren bir mantıksal uygulama oluşturun. HTTP Web Kancası eylemini kullanmak için iş akışınızı istediğiniz tetikleyiciyle başlatın. Bu örnekte, ilk adım olarak HTTP tetikleyicisi kullanılır.
HTTP Web Kancası tetikleyicisi ekleme
Bu yerleşik tetikleyici, hedef hizmette abone olma uç noktasını çağırır ve hedef hizmete bir geri çağırma URL'si kaydeder. Ardından iş akışınız hedef hizmetin geri çağırma URL'sine istek HTTP POST
göndermesini bekler. Bu olay gerçekleştiğinde tetikleyici tetikler ve istekteki tüm verileri iş akışına geçirir.
Azure portalında Standart mantıksal uygulamanızı ve boş iş akışınızı tasarımcıda açın.
HTTP Web Kancası adlı tetikleyiciyi iş akışınıza eklemek için bu genel adımları izleyin.
Bu örnek, adımın daha açıklayıcı bir ada sahip olması için tetikleyiciyi HTTP Web Kancası tetikleyicisi olarak yeniden adlandırır. Ayrıca, örnek daha sonra bir HTTP Web Kancası eylemi ekler ve her iki ad da benzersiz olmalıdır.
Abone olma ve abonelikten çıkma çağrıları için kullanmak istediğiniz HTTP Web Kancası tetikleyici parametrelerinin değerlerini sağlayın.
Özellik Zorunlu Açıklama Abonelik - Yöntem Yes Hedef uç noktaya abone olduğunuzda kullanılacak yöntem Abone Ol - URI Yes Hedef uç noktaya abone olmak için kullanılacak URL Abone Ol - Gövde Hayır Abone olma isteğine eklenecek herhangi bir ileti gövdesi. Bu örnek, mantıksal uygulamanızın geri çağırma URL'sini almak için ifadesini kullanarak mantıksal uygulamanız olan aboneyi @listCallbackUrl()
benzersiz olarak tanımlayan geri çağırma URL'sini içerir.Abonelikten Çık - Yöntem Hayır Hedef uç noktadan abonelikten çıkarıldığında kullanılacak yöntem Aboneliği kaldır - URI Hayır Hedef uç noktadan abonelikten çıkmak için kullanılacak URL Abonelikten Çık - Gövde Hayır Abonelikten çıkma isteğine eklenecek isteğe bağlı ileti gövdesi
Not: Bu özellik işlevininlistCallbackUrl()
kullanılmasını desteklemez. Ancak tetikleyici otomatikx-ms-client-tracking-id
olarak üst bilgileri ve hedef hizmetin aboneyi benzersiz olarak tanımlamak için kullanabileceği üst bilgileri içerir vex-ms-workflow-operation-name
gönderir.Not
Aboneliği Kaldır - Yöntem ve Abonelikten Çık - URI özellikleri için Gelişmiş parametreler listesini açarak bunları eyleminize ekleyin.
Örneğin, aşağıdaki tetikleyici abone olma ve abonelikten çıkma işlemlerini gerçekleştirirken kullanılacak yöntemleri, URI'leri ve ileti gövdelerini içerir.
Kimlik doğrulamasını kullanmanız gerekiyorsa Abone Ol - Kimlik Doğrulaması ve Aboneliği Kaldır - Kimlik doğrulama özelliklerini ekleyebilirsiniz. HTTP Web Kancası için kullanılabilen kimlik doğrulama türleri hakkında daha fazla bilgi için bkz . Giden çağrılara kimlik doğrulaması ekleme.
Tetikleyici tetiklendiğinde çalıştırılacak eylemlerle iş akışınızı oluşturmaya devam edin.
Tamamladığınızda, iş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.
İş akışınızı kaydettiğinizde hedef hizmette abone olma uç noktası çağrılır ve geri çağırma URL'si kaydedilir. Ardından iş akışınız hedef hizmetin geri çağırma URL'sine istek HTTP POST
göndermesini bekler. Bu olay gerçekleştiğinde tetikleyici tetikler ve istekteki tüm verileri iş akışına geçirir. Bu işlem başarıyla tamamlanırsa, tetikleyici uç noktadan abonelikten çıkar ve iş akışınız bir sonraki eyleme devam eder.
HTTP Web Kancası eylemi ekleme
Bu yerleşik eylem, hedef hizmette abone olma uç noktasını çağırır ve hedef hizmete bir geri çağırma URL'si kaydeder. Ardından iş akışınız duraklatılır ve hedef hizmetin geri arama URL'sine istek HTTP POST
göndermesini bekler. Bu olay gerçekleştiğinde, eylem istekteki tüm verileri iş akışına geçirir. İşlem başarıyla tamamlanırsa, eylem uç noktadan abonelikten çıkar ve iş akışınız sonraki eyleme devam eder.
Bu örnekte, ilk adım olarak HTTP Web Kancası tetikleyicisi kullanılır.
Azure portalında Standart mantıksal uygulamanızı ve iş akışınızı tasarımcıda açın.
http web kancası adlı eylemi iş akışınıza eklemek için bu genel adımları izleyin.
Bu örnek, adımın daha açıklayıcı bir ada sahip olması için eylemi HTTP Web Kancası eylemi olarak yeniden adlandırır.
Abone olma ve abonelikten çıkma çağrıları için kullanmak istediğiniz HTTP Web kancası tetikleyici parametrelerine benzer HTTP Web kancası eylem parametrelerinin değerlerini sağlayın.
Özellik Zorunlu Açıklama Abonelik - Yöntem Yes Hedef uç noktaya abone olduğunuzda kullanılacak yöntem Abone Ol - URI Yes Hedef uç noktaya abone olmak için kullanılacak URL Abone Ol - Gövde Hayır Abone olma isteğine eklenecek herhangi bir ileti gövdesi. Bu örnek, mantıksal uygulamanızın geri çağırma URL'sini almak için ifadesini kullanarak mantıksal uygulamanız olan aboneyi @listCallbackUrl()
benzersiz olarak tanımlayan geri çağırma URL'sini içerir.Abonelikten Çık - Yöntem Hayır Hedef uç noktadan abonelikten çıkarıldığında kullanılacak yöntem Aboneliği kaldır - URI Hayır Hedef uç noktadan abonelikten çıkmak için kullanılacak URL Abonelikten Çık - Gövde Hayır Abonelikten çıkma isteğine eklenecek isteğe bağlı ileti gövdesi
Not: Bu özellik işlevininlistCallbackUrl()
kullanılmasını desteklemez. Ancak, eylem otomatik olarak üst bilgileri ve hedef hizmetin aboneyi benzersiz olarak tanımlamak için kullanabileceği üst bilgilerix-ms-client-tracking-id
içerir vex-ms-workflow-operation-name
gönderir.Not
Aboneliği Kaldır - Yöntem ve Abonelikten Çık - URI özellikleri için Gelişmiş parametreler listesini açarak bunları eyleminize ekleyin.
Örneğin, aşağıdaki eylem abone olma ve abonelikten çıkma işlemlerini gerçekleştirirken kullanılacak yöntemleri, URI'leri ve ileti gövdelerini içerir.
Diğer eylem özelliklerini eklemek için Gelişmiş parametreler listesini açın.
Örneğin, kimlik doğrulaması kullanmanız gerekiyorsa Abone Ol - Kimlik Doğrulaması ve Aboneliği Kaldır - Kimlik Doğrulama özelliklerini ekleyebilirsiniz. HTTP Web Kancası için kullanılabilen kimlik doğrulama türleri hakkında daha fazla bilgi için bkz . Giden çağrılara kimlik doğrulaması ekleme.
Tamamladığınızda, iş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.
Bu eylem çalıştırıldığında iş akışınız hedef hizmette abone olma uç noktasını çağırır ve geri çağırma URL'sini kaydeder. Ardından iş akışı duraklatılır ve hedef hizmetin geri arama URL'sine istek HTTP POST
göndermesini bekler. Bu olay gerçekleştiğinde, eylem istekteki tüm verileri iş akışına geçirir. İşlem başarıyla tamamlanırsa, eylem uç noktadan abonelikten çıkar ve iş akışınız sonraki eyleme devam eder.
Tetikleyici ve eylem çıkışları
Http Web Kancası tetikleyicisinden veya eyleminden elde edilen ve bu bilgileri döndüren çıkışlar hakkında daha fazla bilgi aşağıdadır:
Özellik adı | Türü | Açıklama |
---|---|---|
üst bilgiler | nesne | İstekten alınan üst bilgiler |
gövde | nesne | İstekten gövde içeriğine sahip nesne |
durum kodu | int | İstekten gelen durum kodu |
Durum kodu | Açıklama |
---|---|
200 | Tamam |
202 | Kabul edildi |
400 | Hatalı istek |
Kategori 401 | Yetkisiz |
403 | Yasak |
404 | Bulunamadı |
500 | İç sunucu hatası. Bilinmeyen bir hata oluştu. |