Pustaka klien Akun Azure Purview untuk Python - versi 1.0.0b1
Akun Azure Purview adalah layanan cloud yang dikelola sepenuhnya.
Harap sangat bergantung pada dokumentasi layanan dan dokumen klien kami untuk menggunakan pustaka ini
Kode sumber | Paket (PyPI) | Dokumentasi| referensi API Dokumentasi produk
Memulai
Prasyarat
- Python 2.7, atau 3.6 atau yang lebih baru diperlukan untuk menggunakan paket ini.
- Anda harus memiliki langganan Azure dan Purview untuk menggunakan paket ini.
Membuat Sumber Daya Purview
Ikuti petunjuk ini untuk membuat sumber daya Purview Anda
Instal paketnya
Instal pustaka klien Akun Azure Purview untuk Python dengan pip:
pip install azure-purview-account
Mengautentikasi klien
Untuk menggunakan kredensial token Azure Active Directory (AAD), berikan instans jenis kredensial yang diinginkan yang diperoleh dari pustaka identitas azure .
Untuk mengautentikasi dengan AAD, Anda harus terlebih dahulu menginstal azure-identity
pip dan mengaktifkan autentikasi AAD pada sumber daya Purview Anda
Setelah penyiapan, Anda dapat memilih jenis kredensial mana dari azure.identity yang akan digunakan. Sebagai contoh, DefaultAzureCredential dapat digunakan untuk mengautentikasi klien:
Atur nilai ID klien, ID penyewa, dan rahasia klien aplikasi AAD sebagai variabel lingkungan: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
Gunakan kredensial token yang dikembalikan untuk mengautentikasi klien:
from azure.purview.account import PurviewAccountClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
client = PurviewAccountClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
Konsep utama
Klien
Contoh
Bagian berikut ini memperlihatkan kepada Anda cara menginisialisasi dan mengautentikasi klien Anda, lalu mencantumkan semua kunci Anda.
Dapatkan Kunci
from azure.purview.account import PurviewAccountClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
client = PurviewAccountClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
response = client.accounts.get_access_keys()
print(response)
Pemecahan Masalah
Umum
Klien Akun Purview akan mengajukan pengecualian jika kode status respons Anda tidak ditentukan.
Pembuatan Log
Pustaka ini menggunakan pustaka pengelogan standar untuk pengelogan. Informasi dasar tentang sesi HTTP (URL, header, dll.) dicatat di tingkat INFO.
Pengelogan tingkat DEBUG mendetail, termasuk isi permintaan/respons dan header yang tidak diedit, dapat diaktifkan pada klien dengan argumen kata kunci logging_enable
:
import sys
import logging
from azure.identity import DefaultAzureCredential
from azure.purview.account import PurviewAccountClient
# Create a logger for the 'azure' SDK
logger = logging.getLogger('azure')
logger.setLevel(logging.DEBUG)
# Configure a console output
handler = logging.StreamHandler(stream=sys.stdout)
logger.addHandler(handler)
endpoint = "https://<my-account-name>.purview.azure.com"
credential = DefaultAzureCredential()
# This client will log detailed information about its HTTP sessions, at DEBUG level
client = PurviewAccountClient(endpoint=endpoint, credential=credential, logging_enable=True)
Demikian pula, logging_enable
dapat mengaktifkan pengelogan terperinci untuk satu panggilan, bahkan ketika tidak diaktifkan untuk klien:
result = client.accounts.get_access_keys(logging_enable=True)
Langkah berikutnya
Untuk sampel umum lainnya, lihat dokumen klien kami.
Berkontribusi
Proyek ini menyambut baik kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar-benar melakukannya, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi cla.microsoft.com.
Ketika Anda mengirimkan permintaan tarik, CLA-bot akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghias PR dengan tepat (misalnya, label, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repos menggunakan CLA kami.
Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Tata Tertib atau hubungi opencode@microsoft.com untuk pertanyaan atau komentar lainnya.
Azure SDK for Python
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk