Öğretici: ürün oluşturma ve yayımlama

Makale
09/27/2021
Okumak için 4 dakika

Azure API Management, bir ürün bir veya daha fazla API ve kullanım koşulları ve kullanım koşulları içerir. Ürün yayımlandığında, geliştiriciler ürüne abone olabilir ve ürünün API'lerini kullanmaya başlayabilir.

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:

Ürün oluşturma ve yayımlama
Ürüne bir API ekleme

Portalda API Management ürünleri

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

Azure portal oturum açın ve API Management örneğinize gidin.
Sol gezinti bölmesinde, Ürünler > + Ekle' yi seçin.

Ürün Ekle penceresinde, ürününüzü oluşturmak için aşağıdaki tabloda açıklanan değerleri girin.

Portala ürün ekleme

Ad	Açıklama
Görünen ad	Geliştirici Portalındagörünmesini istediğiniz ad.
Description	Ürün hakkında, amacı, erişimi sağladığı API 'Ler ve diğer ayrıntılar gibi bilgiler sağlayın.
Durum	Ürünü yayımlamak istiyorsanız yayımlandı ' i seçin. Bir üründeki API'lerin çağrılabilmesi için önce ürünün yayımlanması gerekir. Varsayılan olarak, yeni ürünler yayımdan kaldırılır ve yalnızca Yöneticiler grubu tarafından görülebilir.
Abonelik gerektirir	Ürünü kullanmak için bir kullanıcının abone olması gerekiyorsa seçin.
Onay gerekiyor	Yöneticinin bu ürüne yönelik abonelik denemelerini gözden geçirmesini ve kabul etmesini ya da reddetmesini istiyorsanız seçin. Seçilmezse, abonelik girişimleri otomatik olarak onaylanır.
Abonelik sayısı limiti	İsteğe bağlı olarak birden çok eşzamanlı aboneliğin sayısını sınırlayın.
Yasal koşullar	Abonelerin ürünü kullanmak için kabul etmek zorunda olduğu ürün kullanım koşullarını ekleyebilirsiniz.
API'ler	Bir veya daha fazla API seçin. Ayrıca, ürünü oluşturduktan sonra API 'Leri ekleyebilirsiniz. Daha fazla bilgi için, bu makalede daha sonra bir ürüne API ekleme bölümüne bakın.

Yeni ürünü oluşturmak için Oluştur ' u seçin.

Azure CLı kullanmaya başlamak için:

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.

Bir ürün oluşturmak için az APIM Product Create komutunu çalıştırın:

az apim product create --resource-group apim-hello-word-resource-group \
    --product-name "Contoso product" --product-id contoso-product \
    --service-name apim-hello-world --subscription-required true \
    --state published --description "This is a test."

Ürününüz için çeşitli değerler belirtebilirsiniz:

Parametre	Açıklama
`--product-name`	Geliştirici Portalındagörünmesini istediğiniz ad.
`--description`	Ürün hakkında, amacı, erişimi sağladığı API 'Ler ve diğer ayrıntılar gibi bilgiler sağlayın.
`--state`	Ürünü yayımlamak istiyorsanız yayımlandı ' i seçin. Bir üründeki API'lerin çağrılabilmesi için önce ürünün yayımlanması gerekir. Varsayılan olarak, yeni ürünler yayımdan kaldırılır ve yalnızca Yöneticiler grubu tarafından görülebilir.
`--subscription-required`	Ürünü kullanmak için bir kullanıcının abone olması gerekiyorsa seçin.
`--approval-required`	Yöneticinin bu ürüne yönelik abonelik denemelerini gözden geçirmesini ve kabul etmesini ya da reddetmesini istiyorsanız seçin. Seçilmezse, abonelik girişimleri otomatik olarak onaylanır.
`--subscriptions-limit`	İsteğe bağlı olarak birden çok eşzamanlı aboneliğin sayısını sınırlayın.
`--legal-terms`	Abonelerin ürünü kullanmak için kabul etmek zorunda olduğu ürün kullanım koşullarını ekleyebilirsiniz.

Geçerli ürünlerinizi görmek için az APIM Product List komutunu kullanın:

az apim product list --resource-group apim-hello-word-resource-group \
    --service-name apim-hello-world --output table

Az APIM Product Delete komutunu kullanarak bir ürünü silebilirsiniz:

az apim product delete --product-id contoso-product \
    --resource-group apim-hello-word-resource-group \
    --service-name apim-hello-world --delete-subscriptions true

Daha fazla yapılandırma ekleme

Ürünü kaydettikten sonra yapılandırmaya devam edin. API Management Örneğinizde, Ürünler penceresinden ürünü seçin. Ekle veya güncelleştir:

Öğe	Açıklama
Ayarlar	Ürün meta verileri ve durumu
API'ler	Ürünle ilişkili API 'Ler
İlkeler	Ürün API 'Lerine uygulanan ilkeler
Erişim denetimi	Geliştiriciler veya Konuklar için ürün görünürlüğü
Abonelikler	Ürün aboneleri

Bir ürüne API ekleme

Ürünler bir veya daha fazla API arasındaki ilişkilendirmelerdir. Bir dizi API ekleyebilir ve geliştirici portalı aracılığıyla geliştiricilere sunabilirsiniz. Ürün oluşturma sırasında, bir veya daha fazla var olan API ekleyebilirsiniz. ayrıca, ürün Ayarlar sayfasından veya bir apı oluştururken daha sonra ürüne apı 'ler ekleyebilirsiniz.

Geliştiricilerin bir API’ye erişebilmesi için önce ürüne abone olması gerekir. Abone olduklarında, ilgili üründeki tüm API’ler için geçerli olan bir abonelik anahtarı edinirler. APIM örneğini siz oluşturduysanız zaten bir yöneticisinizdir ve varsayılan olarak tüm ürünlere abone olmuşsunuz demektir.

Mevcut bir ürüne API ekleme

Portal
Azure CLI

API Management örneğinizin sol gezinti bölmesinde Ürünler' i seçin.
Bir ürün seçin ve ardından API 'ler' i seçin.
+ Ekle'yi seçin.
Bir veya daha fazla API seçin ve ardından öğesini seçin.

Mevcut ürüne API ekleme

Yönetilen API 'lerinizi görmek için az APIM API List komutunu kullanın:

az apim api list --resource-group apim-hello-word-resource-group \
    --service-name apim-hello-world --output table

Ürününüzü bir API eklemek için az APIM Product API Add komutunu çalıştırın:

az apim product api add --resource-group apim-hello-word-resource-group \
    --api-id demo-conference-api --product-id contoso-product \
    --service-name apim-hello-world

Az APIM Product API List komutunu kullanarak eklemeyi doğrulayın:

az apim product api list --resource-group apim-hello-word-resource-group \
    --product-id contoso-product --service-name apim-hello-world --output table

Az APIM Product API Delete komutunu kullanarak bir üründen bir API 'yi kaldırabilirsiniz:

az apim product api delete --resource-group apim-hello-word-resource-group \
    --api-id demo-conference-api --product-id contoso-product \
    --service-name apim-hello-world

İpucu

Bir kullanıcının aboneliğini, bir REST API veya PowerShell komutu aracılığıyla özel abonelik anahtarlarıyla bir ürüne oluşturabilir veya güncelleyebilirsiniz.

Sonraki adımlar

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:

Ürün oluşturma ve yayımlama
Ürüne bir API ekleme

Sonraki öğreticiye ilerleyin:

Boş bir API ve sahte API yanıtları oluşturma