Bir HTTP isteğiyle bir Azure işlevi yürütme

  • 10 dakika

HTTP isteği, çoğu platform ve cihazda ortak bir işlemdir. İster sözlükten bir sözcük bakmak için ister yerel hava durumunu öğrenmek için olsun, sürekli HTTP istekleri göndeririz. Azure İşlevleri HTTP isteği alındığında çalıştırılacak bir mantığı hızla oluşturmamızı sağlar.

Bu ünitede, HTTP tetikleyicisi kullanarak işlev oluşturmayı ve çağırmayı öğreneceksiniz. AYRıCA HTTP tetikleyicileri için kullanılabilen özelleştirme seçeneklerinden bazılarını da keşfedeceksiniz.

HTTP tetikleyicisi nedir?

HTTP tetikleyicisi, http isteği aldığında kodu yürüten bir tetikleyicidir. HTTP tetikleyicilerinin aşağıdakiler gibi birçok özelliği ve özelleştirmesi vardır:

  • Anahtar sağlayarak yetkili erişim sağlama.
  • Hangi HTTP fiillerinin desteklendiği kısıtlanıyor.
  • Verileri arayana geri döndürme.
  • Sorgu dizesi parametreleri veya istek gövdesi aracılığıyla veri alma.
  • İşlev URL'sini değiştirmek için URL yönlendirme şablonlarını destekleme.

HTTP tetikleyicisi oluşturduğunuzda, tetikleyici için bir ad sağlamanız ve yetkilendirme düzeyi seçmeniz gerekir.

HTTP tetikleyicisi Yetkilendirme düzeyi nedir?

HTTP tetikleyicisi Yetkilendirme düzeyi, gelen bir HTTP isteğinin yetkilendirme için BIR API anahtarına ihtiyacı olup olmadığını gösteren bir bayraktır.

Üç Yetkilendirme düzeyi vardır:

  1. İşlev
  2. Anonim
  3. Yönetici

İşlev ve Yönetici düzeyleri "anahtar" tabanlıdır. HTTP isteği göndermek için yetkilendirme için bir anahtar sağlamanız gerekir. İki tür anahtar vardır: işlev ve konak. İki anahtar arasındaki fark bunların kapsamlarıdır. İşlev anahtarları bir işleve özgüdür. Konak anahtarları işlev uygulamasındaki tüm işlevler için geçerlidir. Yetkilendirme düzeyiniz İşlev olarak ayarlandıysa işlev veya konak anahtarı kullanabilirsiniz. Yetkilendirme düzeyiniz Yönetici olarak ayarlandıysa konak anahtarı sağlamanız gerekir.

Önemli

Konak anahtarları işlev uygulamanıza yükseltilmiş erişim sağladığından, bunları güvenli bir şekilde taşımanız ve depolamanız gerekir.

Anonim düzeyi, yetkilendirmenin gerekli olmadığı anlamına gelir. Bu alıştırmada Anonim yetkilendirme düzeyi kullanılır.

HTTP tetikleyicisi oluşturma

Aynı zamanlayıcı tetikleyicisi gibi, HTTP tetikleyicisini de Azure portalından oluşturabilirsiniz. Azure işlevinizin içinde, önceden tanımlanmış tetikleyici türleri listesinden HTTP tetikleyicisi'ni seçin, ardından yürütmek istediğiniz mantığı girin ve belirli HTTP fiillerinin kullanımını kısıtlama gibi özelleştirmeler yapın.

Anlaşılması önemli olan bir ayar, Parametre adı iste ayarıdır. Bu ayar, gelen HTTP isteği hakkında bilgi içeren parametrenin adını temsil eden bir dizedir. Parametrenin adı varsayılan olarak req değeridir.

HTTP tetikleyicisini çağırma

HTTP tetikleyicisini çağırmak için, işlevinizin URL’sine bir HTTP isteği gönderirsiniz. Bu URL’yi almak için işlevinizin kod sayfasına gidin ve İşlev URL'sini alma bağlantısını seçin.

Uygulamanın İşlev URL’sini al düğmesinin vurgulandığı İşlevler Uygulaması bölmesini gösteren Azure portalı ekran görüntüsü.

İşlevinizin URL’sini aldıktan sonra HTTP istekleri gönderebilirsiniz. İşleviniz veri alıyorsa, sorgu dizesi parametrelerini kullanabileceğinizi veya verileri istek gövdesi aracılığıyla sağlayabildiğinizi unutmayın.

HTTP tetikleyicisi, işlev URL'sine bir HTTP isteği aldığında yürütülür. HTTP tetikleyicileri veri almanıza, mantık yürütmenize ve isteğe bağlı olarak verileri çağırana geri döndürmenize olanak tanır.