Öğretici: API 'nizin birden fazla sürümünü yayımlama
API 'nize yönelik tüm çağıranların tam olarak aynı sürümü kullanması pratik olduğu durumlar vardır. Çağıranlar sonraki bir sürüme yükseltmek istiyorlarsa, anlaşılması kolay bir yaklaşım ister. Bu öğreticide gösterildiği gibi, Azure API Management 'de birden çok Sürüm sağlanması mümkündür.
Arka plan için bkz. sürümler & düzeltmeleri.
Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:
- Yeni bir sürümü mevcut bir API’ye ekleme
- Sürüm şeması seçme
- Sürümü bir ürüne ekleme
- Sürümü görüntülemek için geliştirici portalına göz atma
Önkoşullar
- Azure API Management terminolojisini öğrenin.
- Şu hızlı başlangıcı tamamlayın: Azure API Management örneği oluşturma.
- Ayrıca, şu öğreticiyi tamamlayın: İlk API'nizi içeri aktarma ve yayımlama.
Yeni bir sürüm ekleme
- Azure portalAPI Management örneğinize gidin.
- API’ler seçeneğini belirleyin.
- API listesinden Tanıtım Konferans API’sini seçin.
- Tanıtım Konferansı API 'sinin yanındaki bağlam menüsünü (...) seçin.
- Sürüm Ekle' yi seçin.
İpucu
Sürümler, yeni bir API oluşturduğunuzda da etkinleştirilebilir. API Ekle ekranında, Bu API 'yi, sürüm?' i seçin.
Sürüm oluşturma düzeni seçme
Azure API Management, bir sürüm oluşturma düzeni seçerek ÇAĞıRANLARıN API sürümünü nasıl belirtmesini istediğinizi seçersiniz: yol, üst bilgi veya sorgu dizesi. Aşağıdaki örnekte, Dizin oluşturma düzeni olarak kullanılır.
Aşağıdaki tablodaki değerleri girin. Ardından, sürümünüzü oluşturmak için Oluştur ' u seçin.
| Ayar | Değer | Açıklama |
|---|---|---|
| Ad | Tanıtım-konferans-API-v1 | API Management örneğiniz benzersiz adı. Bir sürüm aslında bir API 'nin düzeltmesinitemel alarak yenı bir API 'de olduğundan, bu ayar yeni API 'nin adıdır. |
| Sürüm oluşturma düzeni | Yol | Arayanlara API sürümünü belirtme şekli. |
| Sürüm tanımlayıcı | v1 | Sürümün şemaya özgü göstergesi. Yol IÇIN, API URL yolu için sonek. Üst bilgi veya sorgu dizesi seçilirse, ek bir değer girin: üst bilgi veya sorgu dizesi parametresinin adı. Kullanım örneği görüntülenir. |
| Ürünler | Sınırsız | İsteğe bağlı olarak, API sürümünün ilişkilendirildiği bir veya daha fazla ürün. API’yi yayımlamak için bir ürünle ilişkilendirmeniz gerekir. Ayrıca sürümü daha sonra bir ürüne ekleyebilirsiniz . |
Sürüm oluşturulduktan sonra API listesinde demo Conference API altında görüntülenir. Şimdi iki API görürsünüz: özgün ve v1.
Şimdi, v1 'yi orijinalden ayrı bir API olarak düzenleyebilir ve yapılandırabilirsiniz. Bir sürümde yapılan değişiklikler diğer bir sürümü etkilemez.
Not
Sürümü sürümü olmayan bir API 'ye sürüm eklerseniz, bir özgün de otomatik olarak oluşturulur. Bu sürüm varsayılan URL 'de yanıt verir. Orijinal sürüm oluşturmak, mevcut çağıranların sürüm ekleme işlemi tarafından kesilmemesini sağlar. Başlangıçta etkinleştirilmiş sürümlerle yeni bir API oluşturursanız, özgün bir oluşturulmaz.
Sürümü bir ürüne ekleme
Çağıranların yeni sürümü görmesi için sürümün ürüne eklenmesi gerekir. Sürümü henüz bir ürüne eklemediğiniz takdirde, uygulamayı dilediğiniz zaman bir ürüne ekleyebilirsiniz.
Örneğin, sürümü sınırsız ürüne eklemek için:
- Azure portal API Management örneğinize gidin.
- Ürünleri > sınırsız > API > + Ekle' yi seçin.
- Tanıtım Konferansı API 'si, sürüm v1' yi seçin.
- Seç’e tıklayın.
Sürüm kümelerini kullanma
Birden çok sürüm oluşturduğunuzda Azure portal, tek bir mantıksal API için bir sürüm kümesini temsil eden bir sürüm kümesi oluşturur. Birden çok sürümü olan bir API 'nin adını seçin. Azure portal, Sürüm kümesini görüntüler. Bir sanal küme adını ve açıklamasını özelleştirebilirsiniz.
Azure CLı kullanarak doğrudan sürüm kümeleriyle etkileşim kurabilirsiniz:
Azure Cloud Shell'Da Bash ortamını kullanın.
Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.
Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.
İstendiğinde, ilk kullanımda Azure CLI uzantılarını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
Tüm sürüm kümelerinizi görmek için az APIM API versionset List komutunu çalıştırın:
az apim api versionset list --resource-group apim-hello-word-resource-group \
--service-name apim-hello-world --output table
Azure portal sizin için bir sürüm kümesi oluşturduğunda, listenin ad sütununda görünen alfasayısal bir ad atar. Diğer Azure CLı komutlarında bu adı kullanın.
Bir sürüm kümesi hakkındaki ayrıntıları görmek için az APIM API versionset Show komutunu çalıştırın:
az apim api versionset show --resource-group apim-hello-word-resource-group \
--service-name apim-hello-world --version-set-id 00000000000000000000000
Sürüm kümeleri hakkında daha fazla bilgi için bkz. Azure API Management sürümler.
Sürümü görüntülemek için geliştirici portalına göz atma
Geliştirici PortalınıDENEDIYSENIZ, API sürümlerini burada görebilirsiniz.
- Üstteki menüden Geliştirici Portalı’nı seçin.
- API'ler ve ardından Tanıtım Konferans API’si öğesini seçin.
- API adının yanında birden fazla sürümü olan bir açılan menü görmeniz gerekir.
- v1’i seçin.
- Listedeki ilk işlemin İstek URL'sine dikkat edin. Bu, API URL’si yolunun v1 içerdiğini gösterir.
Sonraki adımlar
Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:
- Yeni bir sürümü mevcut bir API’ye ekleme
- Sürüm şeması seçme
- Sürümü bir ürüne ekleme
- Sürümü görüntülemek için geliştirici portalına göz atma
Sonraki öğreticiye ilerleyin: