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

  • Makale

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

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

Temel olmayan ama yine de ilginç ayrıntılar

  • Azure CLI yönetim kitaplıkları kullanılarak Python'da yazıldığından, Azure CLI komutlarıyla yapabileceğiniz her şeyi python betiğinden de yapabilirsiniz. Buna göre, CLI komutları birden çok görevi birlikte gerçekleştirme, zaman uyumsuz işlemleri otomatik olarak işleme, bağlantı dizesi gibi çıktıları biçimlendirme 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 derecesine sahip olmak istemiyorsanız eşdeğer Python kodunu yazmaktan daha kullanışlı olabilir.

  • Python için Azure kitaplıkları, temel alınan Azure REST API'nin üzerinde derlenir ve bu API'leri tanıdık Python paradigmalarıyla kullanmanıza olanak sağlar. Ancak, isterseniz REST API'yi doğrudan Python kodundan kullanabilirsiniz.

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

  • Kitaplıkları test etmediğimiz 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 üzerinde https://github.com/MicrosoftDocs/azure-docs-sdk-python/bulunur.

  • 2019'dan itibaren Azure Python kitaplıklarını 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şacak şekilde güncelleştirdik. Güncelleştirilmiş kitaplıklar geçerli Azure SDK yönergelerine bağlıdır.

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

    • Azure SDK'larında 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 . Python için Azure SDK Kullanım Dışı Sürümleri.

  • Kitaplıklara uyguladığımız 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

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

Yönetim kitaplıklarıyla, 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'da 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:

Her yönetim kitaplığıyla çalışma hakkında ayrıntılı bilgi için sdk GitHub deposunda kitaplığın proje klasöründe bulunan README.md veya README.rst dosyasına bakın. Başvuru belgelerinde ve Azure Örnekleri'nde daha fazla kod parçacığı da bulabilirsiniz.

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

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

  • sınıfını ServicePrincipalCredentials kullanıyorsanız bkz . Belirteç kimlik bilgileriyle kimlik doğrulaması.
  • Zaman uyumsuz API'lerin adları Kitaplık kullanım desenleri - zaman uyumsuz işlemler bölümünde açıklandığı gibi değişmiştir. Yeni kitaplıklardaki zaman uyumsuz API'lerin adları ile begin_başlar. Çoğu durumda API imzası aynı kalır.

azure kaynaklarını istemci kitaplıklarıyla Bağlan ve kullanma

SDK'nın istemci (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.

Örnek: Azure Depolama kullanma makalesi, istemci kitaplığını kullanmaya ilişkin temel bir çizim sağlar.

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

Her istemci kitaplığıyla çalışma hakkında ayrıntılı bilgi için SDK'nın GitHub deposunda kitaplığın proje klasöründe bulunan README.md veya README.rst dosyasına bakın. Başvuru belgelerinde ve Azure Örnekleri'nde daha fazla kod parçacığı da bulabilirsiniz.

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

Sonraki adım

Python için Azure kitaplıklarından herhangi birini kolayca kullanabilmeniz için yerel geliştirme ortamınızı tek seferlik ayarlamanızı kesinlikle öneririz.

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