Udostępnij za pośrednictwem

Używanie bibliotek platformy Azure (SDK) dla języka Python

  • Artykuł

Biblioteki platformy Azure typu open source dla języka Python upraszczają aprowizowanie, zarządzanie zasobami platformy Azure i korzystanie z ich z kodu aplikacji w języku Python.

Szczegóły, które naprawdę chcesz znać

Nieistotnych, ale nadal interesujących szczegółów

  • Ponieważ interfejs wiersza polecenia platformy Azure jest napisany w języku Python przy użyciu bibliotek zarządzania, wszystko, co można zrobić za pomocą poleceń interfejsu wiersza polecenia platformy Azure, można również wykonać za pomocą skryptu języka Python. Oznacza to, że polecenia interfejsu wiersza polecenia zapewniają wiele przydatnych funkcji, takich jak wykonywanie wielu zadań razem, automatyczne obsługiwanie operacji asynchronicznych, formatowanie danych wyjściowych, takich jak parametry połączenia itd. Dlatego użycie interfejsu wiersza polecenia (lub jego odpowiednika, programu Azure PowerShell) do automatycznego tworzenia skryptów i zarządzania może być wygodniejsze niż pisanie równoważnego kodu w języku Python, chyba że chcesz mieć znacznie dokładniejszy stopień kontroli nad procesem.

  • Biblioteki platformy Azure dla języka Python bazują na podstawowym interfejsie API REST platformy Azure, co umożliwia korzystanie z tych interfejsów API za pomocą znanych paradygmatów języka Python. Jednak zawsze możesz używać interfejsu API REST bezpośrednio z poziomu kodu języka Python, jeśli jest to konieczne.

  • Kod źródłowy bibliotek platformy Azure można znaleźć w witrynie https://github.com/Azure/azure-sdk-for-python. W ramach projektu open source współtworzenie jest mile widziane!

  • Mimo że można używać bibliotek z interpreterami, takimi jak IronPython i Jython, których nie testujemy, mogą wystąpić izolowane problemy i niezgodności.

  • Repozytorium źródłowe dla dokumentacji referencyjnej interfejsu API biblioteki znajduje się w witrynie https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

  • Począwszy od 2019 r., zaktualizowaliśmy biblioteki języka Python platformy Azure, aby współużytkować typowe wzorce chmury, takie jak protokoły uwierzytelniania, rejestrowanie, śledzenie, protokoły transportu, buforowane odpowiedzi i ponawianie prób. Zaktualizowane biblioteki są zgodne z bieżącymi wytycznymi dotyczącymi zestawu Azure SDK.

    • 31 marca 2023 r. wycofaliśmy obsługę bibliotek zestawu Azure SDK, które nie są zgodne z bieżącymi wytycznymi dotyczącymi zestawu Azure SDK. Chociaż starsze biblioteki mogą być nadal używane poza 31 marca 2023 r., nie będą już otrzymywać oficjalnej pomocy technicznej i aktualizacji od firmy Microsoft. Aby uzyskać więcej informacji, zobacz powiadomienie Aktualizowanie bibliotek zestawu Azure SDK.

    • Aby uniknąć brakujących aktualizacji zabezpieczeń i wydajności zestawów SDK platformy Azure, przeprowadź uaktualnienie do najnowszych bibliotek zestawu Azure SDK do 31 marca 2023 r.

    • Aby sprawdzić, które biblioteki języka Python mają wpływ, zobacz Przestarzałe wersje zestawu Azure SDK dla języka Python.

  • Aby uzyskać szczegółowe informacje na temat wytycznych dotyczących bibliotek, zobacz Wytyczne dotyczące języka Python: Wprowadzenie.

Tworzenie zasobów platformy Azure i zarządzanie nimi za pomocą bibliotek zarządzania

Biblioteki zarządzania (lub "płaszczyzny zarządzania") zestawu SDK, nazwy, których nazwy zaczynają się od azure-mgmt-, ułatwiają tworzenie, konfigurowanie i zarządzanie zasobami platformy Azure za pomocą skryptów języka Python. Wszystkie usługi platformy Azure mają odpowiednie biblioteki zarządzania. Aby uzyskać więcej informacji, zobacz Płaszczyzna sterowania i płaszczyzna danych platformy Azure.

Za pomocą bibliotek zarządzania można pisać skrypty konfiguracji i wdrażania, aby wykonywać te same zadania, które można wykonać za pośrednictwem witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure. (Jak wspomniano wcześniej, interfejs wiersza polecenia platformy Azure jest napisany w języku Python i używa bibliotek zarządzania do implementowania różnych poleceń).

W poniższych przykładach pokazano, jak używać niektórych podstawowych bibliotek zarządzania:

Aby uzyskać szczegółowe informacje na temat pracy z każdą biblioteką zarządzania, zobacz plik README.md lub README.rst znajdujący się w folderze projektu biblioteki w repozytorium GitHub zestawu SDK. Więcej fragmentów kodu można również znaleźć w dokumentacji referencyjnej i przykładach platformy Azure.

Migrowanie ze starszych bibliotek zarządzania

Jeśli migrujesz kod ze starszych wersji bibliotek zarządzania, zobacz następujące szczegóły:

Połączenie do zasobów platformy Azure i korzystania z nich z bibliotekami klienta

Biblioteki klienta zestawu SDK (lub "płaszczyzny danych") ułatwiają pisanie kodu aplikacji w języku Python w celu interakcji z już aprowizowanymi usługami. Biblioteki klienckie istnieją tylko dla tych usług, które obsługują interfejs API klienta.

Artykuł Przykład: Korzystanie z usługi Azure Storage zawiera podstawową ilustrację korzystania z biblioteki klienta.

Różne usługi platformy Azure udostępniają również przykłady użycia tych bibliotek. Aby uzyskać inne linki, zobacz następujące strony indeksu:

Aby uzyskać szczegółowe informacje na temat pracy z każdą biblioteką klienta, zobacz plik README.md lub README.rst znajdujący się w folderze projektu biblioteki w repozytorium GitHub zestawu SDK. Więcej fragmentów kodu można również znaleźć w dokumentacji referencyjnej i przykładach platformy Azure.

Uzyskiwanie pomocy i nawiązywanie połączenia z zespołem zestawu SDK

Następny krok

Zdecydowanie zalecamy przeprowadzenie jednorazowej konfiguracji lokalnego środowiska deweloperskiego, aby można było łatwo użyć dowolnej biblioteki platformy Azure dla języka Python.

Konfigurowanie lokalnego środowiska deweloperskiego >>>