Python için Azure kitaplıklarını (SDK) kullanma

Python için açık kaynak Azure kitaplıkları, Python uygulama kodundan Azure kaynakları sağlamayı, yönetmeyi ve kullanmayı basitleştirir.

Gerçekten bilmek istediğiniz ayrıntılar

• yerel olarak veya bulutta çalıştırdığınız Azure hizmetleri from Python koduyla iletişim kurmak için Azure kitaplıklarını kullanın. Belirli bir hizmet kapsamında Python kodu çalıştırıp çalıştıramayacağınız, hizmetin şu anda Python destekleyip desteklemediğine bağlıdır.

• Kitaplıklar Python 3.9 veya üzerini destekler. desteklenen Python sürümleri hakkında daha fazla bilgi için bkz. Azure SDKs Python sürüm destek ilkesi. PyPy kullanıyorsanız, kullandığınız sürümün en azından daha önce bahsedilen Python sürümünü desteklediğinden emin olun.

• Python için Azure SDK yalnızca belirli Azure hizmetleriyle ilgili 180'den fazla bireysel Python kitaplığından oluşur. SDK'da başka araç yoktur.

• Kodu yerel olarak çalıştırdığınızda, Azure ile kimlik doğrulama, Azure SDK for Python kullanarak Python uygulamalarını Azure hizmetleriyle nasıl kimlik doğrulacağınıza dair belgede açıklandığı gibi çevre değişkenlerine dayanır.

• Pip ile kitaplık paketleri yüklemek için pip install <library_name>kitaplık adlarını kullanarak kullanın. Conda ortamlarına kütüphane paketleri yüklemek için conda install <package_name> komutunu, anaconda.org üzerindeki Microsoft kanalında yer alan adları kullanarak çalıştırın. Daha fazla bilgi için bkz. Azure kütüphane paketlerini yükleme.

• Farklı yönetim ve istemci kitaplıkları vardır (bazen "yönetim düzlemi" ve "veri düzlemi" kitaplıkları olarak da adlandırılır). Her küme farklı amaçlara hizmet eder ve farklı kod türleri tarafından kullanılır. Daha fazla bilgi için bu makalenin devamında yer alan aşağıdaki bölümlere bakın:

  • Yönetim kitaplıklarıyla Azure kaynakları oluşturma ve yönetme
  • İstemci kitaplıklarıyla Azure kaynaklarına bağlanıp kullanın

• Azure Hizmetine göre düzenlenmiş Azure için Python Referansı veya paket adına göre düzenlenmiş Python API tarayıcısı üzerinde, kitaplıkların belgelerini bulabilirsiniz.

• Kitaplıkları kendiniz denemek için önce yerel geliştirme ortamınızı ayarlayın. Ardından aşağıdaki tek başına örneklerden herhangi birini (herhangi bir sırayla) deneyebilirsiniz: Example: Kaynak grubu oluşturma, Example: Azure Storage, Example: Web uygulaması oluşturma ve dağıtma, Example: MySQL veritabanı oluşturma ve sorgulama, ve Example: Sanal makine oluşturun.

• Demonstrasyon videoları için bkz. Python için Azure SDK Tanıtımı (PyCon 2021) ve Azure kaynaklarıyla etkileşimde Azure SDK'larını kullanma (PyCon 2020).

Önemsiz ama yine de ilginç ayrıntılar

• Azure CLI Python yazılmış olduğundan ve yönetim kitaplıklarını kullandığından, Python betiğinden de yapabileceğiniz Azure CLI komutlarla her şeyi yapabilirsiniz. CLI komutları birden çok görevi birlikte gerçekleştirme, zaman uyumsuz işlemleri otomatik olarak işleme, bağlantı dizeleri gibi çıkışı biçimlendirme ve daha fazlası gibi birçok yararlı özellik sağlar. Bu nedenle, otomatik oluşturma ve yönetim betikleri için CLI(veya eşdeğeri Azure PowerShell) kullanmak, işlem üzerinde çok daha kesin bir denetim sahibi olmak istemiyorsanız eşdeğer Python kodu yazmaktan daha kullanışlı olabilir.

• Python için Azure kitaplıkları, temel alınan Azure REST API üzerine derlenir, böylece bu API'leri tanıdık Python paradigmalar aracılığıyla kullanabilirsiniz. Ancak, isterseniz REST API'yi doğrudan Python kodundan kullanabilirsiniz.

• Azure kitaplıklarının kaynak kodunu https://github.com/Azure/azure-sdk-for-python'da bulabilirsiniz. Açık kaynak bir proje olarak, katkılar memnuniyetle karşılanır!

• Kitaplıkları Microsoft'un test etmediği IronPython ve Jython gibi yorumlayıcılarla kullanabilirsiniz ancak yalıtılmış sorunlarla ve uyumsuzluklarla karşılaşabilirsiniz.

• Kitaplık API'sine başvuru belgelerinin kaynak deposu https://github.com/MicrosoftDocs/azure-docs-sdk-python/üzerinde bulunur.

• 2019'dan itibaren Microsoft, kimlik doğrulama protokolleri, günlüğe kaydetme, izleme, aktarım protokolleri, arabelleğe alınan yanıtlar ve yeniden denemeler gibi yaygın bulut desenlerini paylaşmak için Azure Python kitaplıklarını güncelleştirdi. Güncelleştirilmiş kitaplıklar geçerli Azure SDK yönergelerine bağlıdır.

  • 31 Mart 2023'te Microsoft, geçerli Azure SDK yönergelerine uymayan Azure SDK kitaplıkları desteğini kullanımdan kaldırmıştı. Eski kitaplıklar 31 Mart 2023'ten sonra da kullanılabilir olsa da artık Microsoft'tan resmi destek ve güncelleştirme almamaktadır. Daha fazla bilgi için bkz. Azure SDK kitaplıklarınızı güncelleştirme.

  • Azure SDKs güvenlik ve performans güncelleştirmelerinin eksik olmasını önlemek için 31 Mart 2023'e kadar en son Azure SDK kitaplıklarına yükseltin.

  • Hangi Python kitaplıklarının etkilendiğini denetlemek için bkz. Azure SDK Python.

• Microsoft'un kitaplıklar için uyguladığı yönergelerle ilgili ayrıntılar için bkz. Python Yönergeleri: Giriş.

Yönetim kitaplıklarıyla Azure kaynakları oluşturma ve yönetme

SDK'nın management (veya "yönetim düzlemi") kitaplıkları, adları azure-mgmt- ile başlar, Python betiklerden Azure kaynakları oluşturmanıza, yapılandırmanıza ve yönetmenize yardımcı olur. Tüm Azure hizmetlerin karşılık gelen yönetim kitaplıkları vardır. Daha fazla bilgi için bkz. Azure kontrol düzlemi ve veri düzlemi.

Yönetim kitaplıklarını kullanarak, Azure portal veya Azure CLI aracılığıyla gerçekleştirebileceğiniz görevlerin aynısını gerçekleştirmek için yapılandırma ve dağıtım betikleri yazabilirsiniz. (Daha önce belirtildiği gibi, Azure CLI Python yazılır ve çeşitli komutlarını uygulamak için yönetim kitaplıklarını kullanır.)

Aşağıdaki örneklerde bazı birincil yönetim kitaplıklarının nasıl kullanılacağı gösterilmektedir:

• Kaynak grubu oluşturma
• Abonelikteki kaynak gruplarını listeleme
• Azure Storage hesabı ve Blob depolama kapsayıcısı oluşturun
• App Service'a bir web uygulaması oluşturma ve dağıtma
• Azure MySQL veritabanı oluşturma ve sorgulama
• Sanal makine oluşturma

Her yönetim kitaplığıyla çalışma hakkında ayrıntılı bilgi için kitaplığın SDK GitHub deposundaki proje klasöründe bulunan README.md veya README.rst dosyasına bakın. Ayrıca reference belgelerinde ve Azure Samples daha fazla kod parçacığı bulabilirsiniz.

Eski yönetim kitaplıklarından geçiş yapma

Yönetim kitaplıklarının eski sürümlerinden kod geçiriyorsanız aşağıdaki ayrıntılara bakın:

• ServicePrincipalCredentials sınıfını kullanıyorsanız, belirteç kimlik bilgileriyle kimlik doğrulaması için bkz. .
• Asenkron API'lerin adları, Kütüphane kullanım desenlerinde açıklandığı gibi değişti - asenkron işlemler. Yeni kitaplıklardaki asenkron API'lerin adları begin_ile başlar. Çoğu durumda API imzası aynı kalır.

İstemci kitaplıklarıyla Azure kaynaklarına bağlanma ve bunları kullanma

SDK'nın client (veya "veri düzlemi") kitaplıkları, önceden sağlanan hizmetlerle etkileşime geçmek için Python uygulama kodu yazmanıza yardımcı olur. İstemci kitaplıkları yalnızca bir istemci API'sini destekleyen hizmetler için mevcuttur.

Example: Use Azure Storage makalesi, istemci kitaplığı kullanımına ilişkin temel bir çizim sağlar.

Farklı Azure hizmetleri de bu kitaplıkları kullanan örnekler sağlar. Diğer bağlantılar için aşağıdaki dizin sayfalarına bakın:

• Uygulama barındırma
• Bilişsel Hizmetler
• Veri çözümleri
• kimlik ve güvenlik
• Makine öğrenmesi
• Mesajlaşma ve IoT
• Diğer hizmetler

Her istemci kitaplığıyla çalışma hakkında ayrıntılı bilgi için README.md veya README.rst dosyasına SDK'nin GitHub deposunda bakın. Ayrıca reference belgelerinde ve Azure Samples daha fazla kod parçacığı bulabilirsiniz.

Yardım alın ve SDK ekibiyle bağlantı kurun

• Python belgeleri için Azure kitaplıklarını ziyaret edin
• Stack Overflow'da topluluğa sorular gönderin
• GitHub üzerinde SDK ile ilgili açık sorunlar
• Twitter'da @AzureSDK bahsetme
• Python

Sonraki adım

Python için Azure kitaplıklarından herhangi birini kolayca kullanabilmeniz için yerel geliştirme ortamınızı ayarlayın.

Yerel geliştirme ortamınızı ayarlama >>>