Azure Logic Apps'te HTTP web kancalarını kullanarak olayların iş akışlarını çalıştırmasını bekleyin ve abone olun

  • Makale

Ş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ğlan veya teknik başvuru

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.

  1. Azure portalında Standart mantıksal uygulamanızı ve boş iş akışınızı tasarımcıda açın.

  2. 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.

  3. 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şlevinin listCallbackUrl() kullanılmasını desteklemez. Ancak tetikleyici otomatik x-ms-client-tracking-id olarak üst bilgileri ve hedef hizmetin aboneyi benzersiz olarak tanımlamak için kullanabileceği üst bilgileri içerir ve x-ms-workflow-operation-namegönderir.

    Not

    Abonelikten Çık - 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.

    Screenshot shows Standard workflow with HTTP Webhook trigger parameters.

    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.

  4. Tetikleyici tetiklendiğinde çalıştırılacak eylemlerle iş akışınızı oluşturmaya devam edin.

  5. 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.

  1. Azure portalında Standart mantıksal uygulamanızı ve iş akışınızı tasarımcıda açın.

  2. 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.

  3. 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şlevinin listCallbackUrl() kullanılmasını desteklemez. Ancak, eylem otomatik olarak üst bilgileri ve hedef hizmetin aboneyi benzersiz olarak tanımlamak için kullanabileceği üst bilgileri x-ms-client-tracking-id içerir ve x-ms-workflow-operation-namegönderir.

    Not

    Abonelikten Çık - 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.

    Screenshot shows Standard workflow with HTTP Webhook action parameters.

  4. 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.

  5. 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.

Sonraki adımlar