Gunakan pustaka Azure (SDK) untuk Python

Perpustakaan Azure sumber terbuka untuk Python menyederhanakan penyediaan, pengelolaan, dan penggunaan dari kode aplikasi Python pada sumber daya Azure.

Detail yang benar-benar ingin Anda ketahui

Gunakan pustaka Azure untuk berkomunikasi dengan layanan Azure dari kode Python yang Anda jalankan baik secara lokal maupun di cloud. Apakah Anda dapat menjalankan kode Python dalam cakupan layanan tertentu bergantung pada apakah layanan itu sendiri saat ini mendukung Python.
Pustaka mendukung Python 3.9 atau yang lebih baru. Untuk informasi selengkapnya tentang versi Python yang didukung, lihat kebijakan dukungan versi Azure SDKs Python. Jika Anda menggunakan PyPy, pastikan versi yang Anda gunakan setidaknya mendukung versi Python yang disebutkan sebelumnya.
Azure SDK untuk Python hanya terdiri dari lebih dari 180 pustaka Python individu yang terkait dengan layanan Azure tertentu. Tidak ada alat lain di SDK.
Saat Anda menjalankan kode secara lokal, mengautentikasi dengan Azure bergantung pada variabel lingkungan seperti yang dijelaskan dalam Cara mengautentikasi aplikasi Python ke layanan Azure menggunakan Azure SDK untuk Python.
Untuk menginstal paket pustaka dengan pip, gunakan pip install <library_name> menggunakan nama pustaka dari indeks paket. Untuk menginstal paket pustaka di lingkungan conda, gunakan conda install <package_name> menggunakan nama dari saluran Microsoft di anaconda.org. Untuk informasi selengkapnya, lihat Install paket pustaka Azure.
Ada pustaka manajemen dan pustaka klien yang berbeda (kadang-kadang disebut sebagai pustaka "sarana manajemen" dan "sarana data"). Setiap set melayani tujuan yang berbeda dan digunakan oleh berbagai jenis kode. Untuk informasi selengkapnya, lihat bagian berikut ini nanti di artikel ini:
- Buat dan kelola sumber daya Azure dengan pustaka manajemen
- Menghubungkan dan menggunakan sumber daya Azure dengan pustaka klien
Anda dapat menemukan dokumentasi untuk pustaka di Azure untuk Referensi Python, yang diatur oleh layanan Azure, atau browser API Python, yang diatur berdasarkan nama paket.
Untuk mencoba perpustakaan sendiri, pertama-tama siapkan lingkungan pengembangan lokal Anda. Kemudian Anda dapat mencoba salah satu contoh mandiri berikut (dalam urutan apa pun): Example: Membuat grup sumber daya, Example: Membuat dan menggunakan Azure Storage, Example: Membuat dan menyebarkan aplikasi web, Example: Membuat dan mengkueri database MySQL, dan Example: Buat komputer virtual.
Untuk video demonstrasi, lihat Mengintroduksi Azure SDK untuk Python (PyCon 2021) dan Gunakan Azure SDKs untuk berinteraksi dengan sumber daya Azure (PyCon 2020).

Tidak penting tetapi masih menarik detail

Karena Azure CLI ditulis dalam Python dan menggunakan pustaka manajemen, Anda dapat melakukan apa pun dengan perintah Azure CLI yang juga dapat Anda lakukan dari skrip Python. Perintah CLI menyediakan banyak fitur bermanfaat seperti melakukan beberapa tugas bersama-sama, secara otomatis menangani operasi asinkron, memformat output seperti string koneksi, dan banyak lagi. Jadi, menggunakan CLI (atau yang setara, Azure PowerShell) untuk pembuatan otomatis dan skrip manajemen bisa lebih nyaman daripada menulis kode Python yang setara, kecuali Anda ingin memiliki tingkat kontrol yang jauh lebih tepat atas proses.
Pustaka Azure untuk Python dibangun di atas Azure REST API yang mendasarinya, sehingga memungkinkan Anda menggunakan API tersebut melalui paradigma Python yang sudah dikenal. Namun, Anda selalu dapat menggunakan REST API langsung dari kode Python, jika diinginkan.
Anda dapat menemukan kode sumber untuk pustaka Azure di https://github.com/Azure/azure-sdk-for-python. Sebagai proyek sumber terbuka, kontribusi dipersilakan!
Meskipun Anda dapat menggunakan pustaka dengan interpreter seperti IronPython dan Jython yang tidak diuji Microsoft, Anda mungkin mengalami masalah dan ketidakcocokan yang terisolasi.
Repositori sumber untuk dokumentasi referensi API pustaka berada di https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
Mulai tahun 2019, Microsoft memperbarui pustaka Azure Python untuk berbagi pola cloud umum seperti protokol autentikasi, pengelogan, pelacakan, protokol transportasi, respons buffer, dan percobaan ulang. Pustaka yang diperbarui mematuhi pedoman Azure SDK terkini.
- Pada 31 Maret 2023, Microsoft menghentikan dukungan untuk pustaka Azure SDK yang tidak sesuai dengan panduan Azure SDK saat ini. Meskipun pustaka yang lebih lama masih dapat digunakan melebihi 31 Maret 2023, pustaka tersebut tidak lagi menerima dukungan dan pembaruan resmi dari Microsoft. Untuk informasi selengkapnya, lihat pemberitahuan Update pustaka Azure SDK Anda.
- Untuk menghindari ketinggalan pembaruan keamanan dan performa, tingkatkan kepada pustaka Azure SDK terbaru pada tanggal 31 Maret 2023.
- Untuk memeriksa pustaka Python mana yang terpengaruh, lihat Rilis Azure SDK Tidak Digunakan Lagi untuk Python.
Untuk detail tentang panduan yang diterapkan oleh Microsoft untuk pustaka, lihat Panduan Python: Pengenalan.

Membuat dan mengelola sumber daya Azure dengan pustaka manajemen

Pustaka management SDK (atau "sarana manajemen"), yang semuanya dimulai dengan azure-mgmt-, membantu Anda membuat, mengonfigurasi, dan mengelola sumber daya Azure dari skrip Python. Semua layanan Azure memiliki pustaka manajemen yang sesuai. Untuk informasi selengkapnya, lihat Azure Control Plane dan Data Plane.

Dengan menggunakan pustaka manajemen, Anda dapat menulis konfigurasi dan skrip penyebaran untuk melakukan tugas yang sama yang dapat Anda lakukan melalui portal Azure atau Azure CLI. (Seperti disebutkan sebelumnya, Azure CLI ditulis dalam Python dan menggunakan pustaka manajemen untuk mengimplementasikan berbagai perintahnya.)

Contoh berikut mengilustrasikan cara menggunakan beberapa pustaka manajemen utama:

Untuk detail tentang bekerja dengan setiap pustaka manajemen, lihat file README.md atau README.rst yang terletak di folder proyek pustaka di repositori GitHub SDK. Anda juga dapat menemukan lebih banyak cuplikan kode dalam dokumentasi referensi dan sampel Azure.

Migrasi dari pustaka manajemen versi lama

Jika Anda memigrasikan kode dari versi pustaka manajemen yang lebih lama, lihat detail berikut:

Jika Anda menggunakan ServicePrincipalCredentials kelas, silakan lihat Mengautentikasi dengan kredensial token.
Nama API asinkron telah berubah seperti yang dijelaskan pada pola penggunaan Pustaka - operasi asinkron. Nama API asinkron di pustaka yang lebih baru dimulai dengan begin_. Dalam kebanyakan kasus, tanda tangan API tetap sama.

Menghubungkan dan menggunakan sumber daya Azure dengan pustaka klien

Pustaka SDK client (atau "data plane") membantu Anda menulis kode aplikasi Python untuk berinteraksi dengan layanan yang sudah disediakan. Pustaka klien hanya ada untuk layanan yang mendukung API klien.

Artikel Example: Gunakan Azure Storage menyediakan ilustrasi dasar menggunakan pustaka klien.

Layanan Azure yang berbeda juga menyediakan contoh yang menggunakan pustaka ini. Lihat halaman indeks berikut untuk tautan lain:

Untuk detail tentang bekerja dengan setiap pustaka klien, lihat file README.md atau README.rst yang terletak di folder proyek pustaka di repositori GitHub SDK. Anda juga dapat menemukan lebih banyak cuplikan kode dalam dokumentasi referensi dan sampel Azure.

Mendapatkan bantuan dan terhubung dengan tim SDK

Kunjungi pustaka Azure untuk dokumentasi Python
Memposting pertanyaan ke komunitas di Stack Overflow
Buka masalah terhadap SDK pada GitHub
Sebutkan @AzureSDK di Twitter
Lengkapi survei singkat tentang Azure SDK untuk Python

Langkah selanjutnya

Siapkan lingkungan pengembangan lokal Anda sehingga Anda dapat dengan mudah menggunakan salah satu pustaka Azure untuk Python.

Menyiapkan lingkungan dev lokal Anda >>>

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-03-11