Pustaka klien Administrasi Azure Purview untuk Python - versi 1.0.0b1
Azure Purview adalah layanan cloud yang dikelola sepenuhnya.
Harap sangat bergantung pada dokumentasi layanan untuk menggunakan pustaka ini
Kode sumber | Paket (PyPI) | Dokumentasi| referensi API Dokumentasi produk
Pengelakan
Dukungan paket Azure SDK Python untuk Python 2.7 berakhir pada 01 Januari 2022. Untuk informasi lebih lanjut dan pertanyaan, silakan merujuk ke https://github.com/Azure/azure-sdk-for-python/issues/20691
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 berikut untuk membuat sumber daya Purview Anda
Instal paketnya
Instal pustaka klien Akun Azure Purview untuk Python dengan pip:
pip install azure-purview-administration
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.administration.account import PurviewAccountClient
from azure.purview.administration.metadatapolicies import PurviewMetadataPoliciesClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
endpoint = "https://<my-account-name>.purview.azure.com"
account_client = PurviewAccountClient(endpoint=endpoint, credential=credential)
metadatapolicy_client = PurviewMetadataPoliciesClient(endpoint=endpoint, credential=credential)
Konsep utama
Klien
Paket berisi dua jenis klien: PurviewAccountClient
dan PurviewMetadataPoliciesClient
. Anda dapat menggunakannya dengan satu paket sesuai dengan kebutuhan Anda.
Contoh
Bagian berikut ini memperlihatkan kepada Anda cara menginisialisasi dan mengautentikasi klien Anda, lalu mencantumkan semua kunci Anda.
Dapatkan Kunci
from azure.purview.administration.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)
Bagian berikut ini memperlihatkan kepada Anda cara menginisialisasi dan mengautentikasi klien Anda, lalu mencantumkan semua peran Anda.
Daftar Peran
from azure.purview.administration.metadatapolicies import PurviewMetadataPoliciesClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
client = PurviewMetadataPoliciesClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
response = client.metadata_roles.list()
result = [item for item in response]
print(result)
Pemecahan Masalah
Umum
Klien 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.administration.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