Azure İşlev Uygulamasını Azure API Management'da API olarak içeri aktarma

UYGULANANLAR: Tüm API Management katmanları

Azure API Management, Azure İşlev Uygulamalarının yeni API olarak içeri aktarılmasını veya var olan API'lere eklenmesini destekler. Bu işlemin ardından Azure İşlev Uygulamasında otomatik olarak bir konak anahtarı oluşturulur. Bu anahtar daha sonra Azure API Management'taki bir adlandırılmış değere atanır.

Bu makalede, Azure İşlev Uygulamasını Azure API Management'ta API olarak içeri aktarma ve test etme adımları açıklanmaktadır.

Şunları öğrenirsiniz:

• Azure İşlev Uygulamalarını API olarak içeri aktarma
• Azure İşlev Uygulamalarını API'lere ekleme
• Yeni Azure İşlev Uygulaması ana bilgisayar anahtarını ve Azure API Management adlandırılmış değerini görüntüleme
• Azure portalında API’yi test etme

Önkoşullar

• Azure API Management örneği oluşturma hızlı başlangıcını tamamlayın.
• Aboneliğinizde bir Azure İşlevleri uygulaması bulunduğundan emin olun. Daha fazla bilgi için bkz. Azure İşlev Uygulaması oluşturma. İşlevlerin HTTP tetikleyicisi ve yetkilendirme düzeyi Anonim veya İşlev olarak ayarlanmalıdır.

Not

API'lerinizi içeri aktarmak ve yönetmek için Visual Studio Code için API Management Uzantısı'nı kullanabilirsiniz. Yüklemek ve kullanmaya başlamak için API Management Uzantısı öğreticisini izleyin.

API Management örneğinize gidin

1. Azure portalında API Management hizmetlerini arayın ve seçin.

   

2. API Management hizmetleri sayfasında API Management örneğinizi seçin.

   

Azure İşlev Uygulamasını yeni API olarak içeri aktarma

Bir Azure İşlev Uygulamasından yeni API oluşturmak için aşağıdaki adımları uygulayın.

1. Azure portalında API Management hizmetinize gidin ve menüden API'ler'i seçin.

2. Yeni API ekleyin listesinde İşlev Uygulaması'nı seçin.

   

3. İçeri aktarılacak İşlevleri seçmek için Gözat'a tıklayın.

   

4. Kullanılabilir İşlev Uygulamaları listesinden seçim yapmak için İşlev Uygulaması bölümüne tıklayın.

   

5. İşlevlerini içeri aktarmak istediğiniz İşlev Uygulamasını bulun, uygulamaya tıklayın ve Seç'e basın.

   

6. İçeri aktarmak istediğiniz İşlevleri seçin ve Seç'e tıklayın.

   • İşlevleri yalnızca ANONIM veya İşlev yetkilendirme düzeyleriyle HTTP tetikleyicisi temelinde içeri aktarabilirsiniz.

   

7. Tam görünümüne geçiş yapın ve yeni API’nize Ürün atayın.

8. Gerekirse, oluşturma sırasında diğer alanları belirtin veya daha sonra Ayarlar sekmesi aracılığıyla yapılandırın.

   • Ayarlar, İlk API'nizi içeri aktarma ve yayımlama öğreticisinde açıklanmıştır.

   Not

   Ürünler, geliştirici portalı aracılığıyla geliştiricilere sunulan bir veya daha fazla API'nin ilişkilendirmeleridir. İlk olarak geliştiricilerin API'ye erişmek için bir ürüne abone olması gerekir. Abone olduktan sonra bu üründeki herhangi bir API için abonelik anahtarı alır. API Management örneğinin oluşturucusu olarak bir yöneticisiniz ve varsayılan olarak her ürüne abonesiniz.

   Her API Management örneği iki varsayılan örnek ürünle birlikte gelir:

   • Başlangıç
   • Sınırsız

9. Oluştur’a tıklayın.

Azure İşlev Uygulaması'nın var olan bir API'ye eklenmesi

Azure İşlev Uygulamasını var olan bir API'ye eklemek için aşağıdaki adımları uygulayın.

1. Azure API Management hizmet örneğinizde soldaki menüden API'ler seçeneğini belirleyin.

2. Azure İşlev Uygulamasından içeri aktarmak istediğiniz bir API'yi seçin. ... simgesine tıklayın ve bağlam menüsünden İçeri Aktar'ı seçin.

   

3. İşlev Uygulaması kutucuğuna tıklayın.

   

4. Açılır pencerede Gözat'a tıklayın.

   

5. Kullanılabilir İşlev Uygulamaları listesinden seçim yapmak için İşlev Uygulaması bölümüne tıklayın.

   

6. İşlevlerini içeri aktarmak istediğiniz İşlev Uygulamasını bulun, uygulamaya tıklayın ve Seç'e basın.

   

7. İçeri aktarmak istediğiniz İşlevleri seçin ve Seç'e tıklayın.

   

8. İçe aktar'a tıklayın.

   

Yetkilendirme

Bir Azure İşlev Uygulaması içeri aktarıldığında aşağıdakiler otomatik olarak oluşturulur:

• İşlev Uygulamasının içinde apim-{Azure API Management hizmet örneğinizin adı} adlı konak anahtarı,
• Azure API Management örneğinin içinde oluşturulan konak anahtarını içeren {your Azure function App instance name}-key adlı değer.

4 Nisan 2019'dan sonra oluşturulan API'ler için, konak anahtarı API Management'tan İşlev Uygulamasına http isteklerinde üst bilgi olarak geçirilir. Eski API'ler konak anahtarını sorgu parametresi olarak geçirir. bu davranışı, İşlev Uygulaması ile ilişkilendirilmiş Arka uç varlığındaki REST API çağrısı aracılığıyla PATCH Backenddeğiştirebilirsiniz.

Uyarı

Azure İşlev Uygulaması ana bilgisayar anahtarı değerinin veya Azure API Management adlı değerin kaldırılması veya değiştirilmesi hizmetler arasındaki iletişimi bozar. Değerler otomatik olarak eşitlenmez.

Ana bilgisayar anahtarını döndürmeniz gerekirse Azure API Management'taki adlandırılmış değerin de değiştirildiğinden emin olun.

Azure İşlev Uygulaması ana bilgisayar anahtarına erişim

1. Azure İşlev Uygulaması örneğinize gidin.

   

2. Yan gezinti menüsünün İşlevler bölümünde Uygulama anahtarları'nı seçin.

   

3. Konak anahtarları bölümünde anahtarları bulun.

   

Azure API Management'taki adlandırılmış değere erişim

Azure API Management örneğinize gidin ve soldaki menüden Adlandırılmış değerler'i seçin. Azure İşlev Uygulaması anahtarı burada depolanır.

Azure portalında yeni API'yi test edin

İşlemleri doğrudan Azure portaldan çağırabilirsiniz. Azure portalı kullanarak bir API'nin işlemlerini kolayca görüntüleyebilir ve test edebilirsiniz.

1. Bir önceki bölümde oluşturduğunuz API'yi seçin.

2. Test sekmesini seçin.

3. Test etmek istediğiniz işlemi seçin.

   • Sayfada sorgu parametreleri ve üst bilgileri için alanlar görüntülenir.
   • Bu API ile ilişkili ürün aboneliği anahtarı için üst bilgilerden biri "Ocp-Apim-Subscription-Key"dir.
   • API Management örneğinin oluşturucusu olarak zaten bir yöneticisiniz, bu nedenle anahtar otomatik olarak doldurulur.

4. Gönder'i seçin.

   • Test başarılı olduğunda arka uç 200 Tamam ve bazı verilerle yanıt verir.

İlgili konular

• API içeri aktarma sınırlamaları
• OpenAPI belirtimini içeri aktarma
• SOAP API’sini içeri aktarma
• SOAP API'sini içeri aktarma ve REST’e dönüştürme
• App Service API'sini içeri aktarma
• Kapsayıcı Uygulama API'sini içeri aktarma
• WebSocket API'lerini içeri aktarma
• GraphQL API’sini içeri aktarma
• GraphQL şemasını içeri aktarma ve alan çözümleyicilerini ayarlama
• Azure İşlev Uygulamalarını içeri aktarma
• Azure Mantıksal Uygulamalarını içeri aktarma
• Service Fabric hizmetlerini içeri aktarma
• Azure OpenAI API'lerini içeri aktarma
• OData API'sini içeri aktarma
• SAP OData meta verilerini içeri aktarma
• gRPC API'lerini içeri aktarma
• API’yi düzenleme

Sonraki adımlar

Yayımlanan API’yi dönüştürme ve koruma