Aracılığıyla paylaş

REST API API Management doğrudan yönetim

  • Makale

Azure API Management, kullanıcılar, gruplar, ürünler ve abonelikler gibi seçili varlıklar üzerinde işlemler gerçekleştirmek için bir doğrudan yönetim REST API'sini sağlar. Doğrudan yönetim API'si, Azure Resource Manager tabanlı API'nin istek azaltma gibi belirli sınırlarını atlayabilir.

Önemli

Bu bölümde REST API'API Management doğrudan yönetime nasıl erişilmesi açıklanır. Bu API, Azure Resource Manager'dan farklı bir kimlik doğrulama mekanizmasına sahiptir ve farklı bir temel URL kullanır.

Doğrudan yönetim REST API'sine erişimi etkinleştirme

Çağrıların başarıyla yapılabilmesi için doğrudan yönetim API Management REST API'sine erişim verilmelidir.

  1. Azure portal Azure API Management örneğine gidin.

  2. Sol taraftaki menünün Dağıtım + altyapı bölümünde Yönetim API'sini seçin.

    Azure portal Yönetim API'sini seçin

  3. API Management REST API'sini etkinleştir bölümünde Evet'i seçin.

    Önemli

    API MANAGEMENT REST API'sini etkinleştir seçili değilse, bu hizmet örneği için REST API'ye yapılan çağrılar başarısız olur.

    Azure portal API Management API'sini etkinleştirme

Varsayılan medya türü

İstekler ve yanıtlar için varsayılan medya türü şeklindedir application/json. Dikkate alınan durumlarda, bazı işlemler diğer içerik türlerini destekler. Belirli bir işlem için ek içerik türünden bahsedilmiyorsa, medya türü olur application/json.

Kimlik Doğrulaması

API Management REST API'sine yapılan her isteğe, aşağıdaki örnekte gösterildiği gibi geçerli bir Authorization paylaşılan erişim belirteci içeren bir üst bilgi eşlik etmelidir.

Authorization: SharedAccessSignature uid=53dd860e1b72ff0467030003&ex=2014-08-04T22:03:00.0000000Z&sn=ItH6scUyCazNKHULKA0Yv6T+Skk4bdVmLqcPPPdWoxl2n1+rVbhKlplFrqjkoUFRr0og4wjeDz4yfThC82OjfQ==

Bu erişim belirteci program aracılığıyla veya API Management yayımcı portalından oluşturulabilir. Erişim belirtecini oluşturma ve alma yönergeleri için bkz. El ile erişim belirteci oluşturma ve Program aracılığıyla erişim belirteci oluşturma.

Temel URL

Doğrudan yönetim API Management REST API'sinin Temel URL'si aşağıdaki şablona uygundur.

https://{servicename}.management.azure-api.net

Bu şablon aşağıdaki parametreyi içerir.

  • {serviceName} , hizmet oluşturma sırasında belirtildiği gibi hizmet adıdır, örneğin https://contosoapi.management.azure-api.net.

API Management REST API tarafından döndürülen tüm URL'ler bu temel URL'ye göredir ve REST API'ye yapılan tüm isteklerin bu temel URL şablonunu kullanması gerekir.

Sürüm Sorgusu Parametresi

Tüm işlemler, biçiminde bir değere YYYY-MM-DDsahip bir sorgu parametresi beklerapi-version, örneğin2021-08-01.

Not

API Management REST API'sinin -preview önizleme süresi boyunca, sürüm sorgusu parametresine eklenir, örneğin2021-04-01-preview.

Bu sorgu parametresi bir isteğin sorgu dizesinde geçirilmediyse, sunucu durum kodunu 400 Bad Requestdöndürür. Desteklenen sürümlerin listesi için bkz. REST API başvurusu API Management.

Sonraki adımlar