Aracılığıyla paylaş

Öğretici: API'ler için ortam ve dağıtım ekleme

Bu öğreticide, API ortamları ve dağıtımları hakkında bilgi ekleyerek API merkezinizdeki envanteri artırma açıklanmaktadır.

  • Ortam, API çalışma zamanının dağıtılabildiği bir konumu (örneğin, bir API yönetim platformu) temsil eder.
  • Dağıtım, kullanıcıların bir API'ye erişebileceği bir konum veya adrestir.

Azure API Center'da envanter oluşturabileceğiniz API'ler, dağıtımlar ve diğer varlıklar hakkında daha fazla bilgi için bkz. Temel kavramlar.

Bu öğreticide portalı kullanarak şunları yapmayı öğreneceksiniz:

  • API ortamları hakkında bilgi ekleme
  • API dağıtımları hakkında bilgi ekleme

Önkoşullar

Ortam ekleme

Gerçek dünyadaki API ortamlarınızı izlemek için API merkezinizi kullanın. Örneğin, API'lerinizin bazılarını dağıtmak, güvenliğini sağlamak ve izlemek için Azure API Management'ı veya başka bir çözümü kullanabilirsiniz. Veya işlem hizmetini veya Kubernetes kümesini kullanarak bazı API'leri doğrudan kullanabilirsiniz.

Burada API merkezinize kurgusal bir Azure API Management ortamı hakkında bilgi eklersiniz. İsterseniz, mevcut ortamlarınızdan biri hakkında bilgi ekleyin. Hem yerleşik meta verilerinizi hem de önceki öğreticide tanımladığınız özel meta verileri yapılandırın.

  1. Azure portalında oturum açın, ardından API merkezinize gidin.

  2. Kenar çubuğu menüsündeki Varlıklar'ın altında Ortamlar>+ Yeni ortam'ı seçin.

  3. Yeni ortam sayfasında aşağıdaki bilgileri ekleyin. Daha önce özel İş kolu meta verilerini veya ortamlara atanan diğer meta verileri tanımladıysanız, bunları sayfanın en altında görürsünüz.

    Setting Değer Description
    Ortam başlığı Testim'i girin. Ortam için seçtiğiniz ad
    Tanımlama Önceki başlığı girdikten sonra Azure API Center bu tanımlayıcıyı oluşturur ve bu tanımlayıcıyı geçersiz kılabilirsiniz. Ortam için Azure kaynak adı
    Ortam türü Açılan listeden Test'i seçin. API'ler için ortam türü
    Açıklama İsteğe bağlı olarak bir açıklama girin. Ortamın açıklaması
    Sunucu
    Türü İsteğe bağlı olarak açılan listeden Azure API Management'ı seçin. Kullanılan API yönetim çözümünün türü
    Yönetim portalı URL'si İsteğe bağlı olarak, bir yönetim arabiriminin URL'sini girin, örneğin https://admin.contoso.com Ortam için yönetim arabirimi URL'si
    Ekleme
    Geliştirme portalı URL'si İsteğe bağlı olarak, bir geliştirici portalının URL'sini girin, örneğin https://developer.contoso.com Platformda geliştirici katılımı için arabirimin URL'si
    Yönergeler İsteğe bağlı olarak Düzenle'yi seçin ve standart Markdown'a ekleme yönergelerini girin. Ortamdan API'lere dahil olma/entegre olma yönergeleri
    İş kolu Bu özel meta verileri eklediyseniz, isteğe bağlı olarak açılan listeden BT gibi bir seçim yapın. Ortamı yöneten iş birimini tanımlayan özel meta veriler

    Portalda API ortamı ekleme işleminin ekran görüntüsü.

  4. Oluştur'i seçin. Ortam, ortam listesinde görünür.

Dağıtım ekleme

API center ayrıca, takip ettiğiniz API'lerin dağıtıldığı çalışma zamanı ortamları olan API dağıtımlarınızı kataloglayabilir.

Burada API'lerinizden birini önceki bölümde oluşturduğunuz ortamla ilişkilendirerek bir dağıtım ekleyebilirsiniz. Hem yerleşik meta verileri hem de tanımladığınız özel meta verileri yapılandırabilirsiniz.

  1. Azure portalında API merkezinize gidin.

  2. Kenar çubuğu menüsündeki Varlıklar'ın altında API'ler'i seçin.

  3. Konferans API'si gibi bir API seçin.

  4. Konferans API'sinin sayfasındaki Ayrıntılar'ın altında Dağıtımlar> ekle'yi seçin.

  5. Dağıtım ekle sayfasında aşağıdaki bilgileri ekleyin. Daha önce özel İş kolu meta verilerini veya ortamlara atanan diğer meta verileri tanımladıysanız, bunları sayfanın en altında görebilirsiniz.

    Setting Değer Description
    Başlık V1 Dağıtımı girin. Dağıtım için seçtiğiniz isim
    Tanımlama Önceki başlığı girdikten sonra Azure API Center bu tanımlayıcıyı oluşturur ve bu tanımlayıcıyı geçersiz kılabilirsiniz. Dağıtım için Azure kaynak adı
    Açıklama İsteğe bağlı olarak bir açıklama girin. Dağıtımın açıklaması
    Çevre Açılan listeden Testim gibi bir seçim yapın veya isteğe bağlı olarak Yeni oluştur'u seçin. API sürümünün dağıtıldığı yeni veya mevcut ortam
    Tanım Konferans API'sinin bir sürümü için bir tanım dosyası seçin veya ekleyin. API tanım dosyası
    Çalışma Zamanı URL'si Temel URL'yi girin, örneğin, https://api.contoso.com. Ortamdaki API için temel çalışma zamanı URL'si
    İş kolu Bu özel meta verileri eklediyseniz, isteğe bağlı olarak açılan listeden BT gibi bir seçim yapın. OrtamdaKI API'leri yöneten iş birimini tanımlayan özel meta veriler

    Portalda API dağıtımı ekleme işleminin ekran görüntüsü.

  6. Oluştur'i seçin. Dağıtım, dağıtım listesinde görünür.

Bu öğreticide portalı kullanarak şunları yapmayı öğrendiniz:

  • API ortamları hakkında bilgi ekleme
  • API dağıtımları hakkında bilgi ekleme

İlgili içerik

  • Last updated on