다음을 통해 공유

Python용 Azure 라이브러리(SDK) 사용

  • 아티클

Python용 오픈 소스 Azure 라이브러리는 Python 애플리케이션 코드의 Azure 리소스 프로비저닝, 관리 및 사용을 간소화합니다.

당신이 정말로 알고 싶은 세부 사항

필수적이지는 않지만 여전히 흥미로운 세부 정보

  • Azure CLI 관리 라이브러리를 사용하여 Python으로 작성되므로 Azure CLI 명령으로 수행할 수 있는 모든 작업은 Python 스크립트에서도 수행할 수 있습니다. 즉, CLI 명령은 여러 작업을 함께 수행, 자동으로 비동기 작업 처리, 연결 문자열과 같은 출력 서식 지정 등과 같은 많은 유용한 기능을 제공합니다. 따라서 프로세스에 대해 훨씬 더 정확한 제어 수준을 갖지 않으려면 CLI(또는 해당 Azure PowerShell)를 사용하여 자동화된 만들기 및 관리 스크립트를 사용하는 것이 동등한 Python 코드를 작성하는 것보다 더 편리할 수 있습니다.

  • Python용 Azure 라이브러리는 기본 Azure REST API기반으로 빌드되므로 익숙한 Python 패러다임을 통해 이러한 API를 사용할 수 있습니다. 그러나 원하는 경우 언제든지 Python 코드에서 직접 REST API를 사용할 수 있습니다.

  • Azure 라이브러리의 소스 코드는 https://github.com/Azure/azure-sdk-for-python에서 찾을 수 있습니다. 오픈 소스 프로젝트로서 기여를 환영합니다!

  • 테스트하지 않는 IronPython 및 Jython과 같은 인터프리터와 함께 라이브러리를 사용할 수 있지만 격리된 문제와 비호환성이 발생할 수 있습니다.

  • 라이브러리 API 참조 설명서의 원본 리포지토리는 https://github.com/MicrosoftDocs/azure-docs-sdk-python/상주합니다.

  • 2019년부터 인증 프로토콜, 로깅, 추적, 전송 프로토콜, 버퍼링된 응답 및 재시도와 같은 일반적인 클라우드 패턴을 공유하도록 Azure Python 라이브러리를 업데이트했습니다. 업데이트된 라이브러리는 현재 Azure SDK 지침 준수합니다.

    • 2023년 3월 31일에 현재 Azure SDK 지침을 준수하지 않는 Azure SDK 라이브러리에 대한 지원이 중지되었습니다. 이전 라이브러리는 2023년 3월 31일 이후에도 계속 사용할 수 있지만 더 이상 Microsoft에서 공식 지원 및 업데이트를 받지 않습니다. 자세한 내용은 Azure SDK 라이브러리 업데이트알림을 참조하세요.

    • Azure SDK에 대한 보안 및 성능 업데이트가 누락되는 것을 방지하려면 2023년 3월 31일까지 최신 Azure SDK 라이브러리 업그레이드합니다.

    • 영향을 받는 Python 라이브러리를 확인하려면 Azure SDK의 Python 사용 중단 릴리스를 참조하세요.

  • 라이브러리에 적용되는 지침에 대한 자세한 내용은 Python 지침: 소개참조하세요.

관리 라이브러리를 사용하여 Azure 리소스 만들기 및 관리

SDK의 관리(또는 "관리 평면") 라이브러리는 모두 azure-mgmt-시작하여 Python 스크립트에서 Azure 리소스를 만들고 구성하고 관리하는 데 도움이 됩니다. 모든 Azure 서비스에는 해당 관리 라이브러리가 있습니다. 자세한 내용은 Azure 컨트롤 플레인 및 데이터 평면 참조하세요.

관리 라이브러리를 사용하면 구성 및 배포 스크립트를 작성하여 Azure Portal 또는 Azure CLI통해 수행할 수 있는 동일한 작업을 수행할 수 있습니다. (앞에서 설명한 대로 Azure CLI는 Python으로 작성되었으며 관리 라이브러리를 사용하여 다양한 명령을 구현합니다.)

다음 예제에서는 일부 기본 관리 라이브러리를 사용하는 방법을 보여 줍니다.

각 관리 라이브러리 작업에 대한 자세한 내용은 SDK GitHub 리포지토리라이브러리의 프로젝트 폴더에 있는 README.md 또는 README.rst 파일을 참조하세요. 참조 설명서 및 Azure 샘플더 많은 코드 조각을 찾을 수도 있습니다.

이전 관리 라이브러리에서 마이그레이션

이전 버전의 관리 라이브러리에서 코드를 마이그레이션하는 경우 다음 세부 정보를 참조하세요.

  • ServicePrincipalCredentials 클래스를 사용하는 경우 토큰 자격 증명인증을 참조하세요.
  • 비동기 API의 이름이 라이브러리 사용 패턴 - 비동기 작업에서 설명된 대로 변경되었습니다. 최신 라이브러리의 비동기 API 이름은 begin_시작합니다. 대부분의 경우 API 서명은 동일하게 유지됩니다.

클라이언트 라이브러리를 사용하여 Azure 리소스에 연결 및 사용

SDK의 클라이언트(또는 "데이터 평면") 라이브러리를 사용하면 Python 애플리케이션 코드를 작성하여 이미 프로비전된 서비스와 상호 작용할 수 있습니다. 클라이언트 라이브러리는 클라이언트 API를 지원하는 서비스에만 존재합니다.

예제: Azure Storage사용 문서는 클라이언트 라이브러리 사용에 대한 기본 그림을 제공합니다.

다른 Azure 서비스는 이러한 라이브러리를 사용하는 예제도 제공합니다. 다른 링크는 다음 인덱스 페이지를 참조하세요.

각 클라이언트 라이브러리 작업에 대한 자세한 내용은 SDK의 GitHub 리포지토리라이브러리의 프로젝트 폴더에 있는 README.md 또는 README.rst 파일을 참조하세요. 참조 설명서 및 Azure 샘플더 많은 코드 조각을 찾을 수도 있습니다.

도움말 보기 및 SDK 팀과 연결

다음 단계

Python용 Azure 라이브러리를 쉽게 사용할 수 있도록 로컬 개발 환경의 일회성 설정을 수행하는 것이 좋습니다.

로컬 개발 환경 >>> 설정