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를 사용할 수 있습니다.

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

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

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

  • 현재 인증 프로토콜, 로깅, 추적, 전송 프로토콜, 버퍼링된 응답 및 재시도와 같은 일반적인 클라우드 패턴을 공유하도록 Python 라이브러리용 Azure 라이브러리를 업데이트하고 있습니다.

    • 이 공유 기능은 azure-core 라이브러리에 포함되어 있습니다.

    • 현재 코어 라이브러리와 작동하는 라이브러리는 Python용 Azure SDK 최신 릴리스에 나열되어 있습니다. 이러한 라이브러리는 주로 클라이언트 라이브러리이며 "트랙 2"라고 하는 경우도 있습니다.

    • 관리 라이브러리와 아직 업데이트되지 않은 다른 라이브러리를 "트랙 1"이라고도 합니다.

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

관리 라이브러리를 사용하여 Azure 리소스 프로비저닝 및 관리

SDK의 관리(또는 "관리 평면") 라이브러리는 이름이 모두 azure-mgmt-로 시작되며 Python 스크립트에서 Azure 리소스를 생성, 프로비저닝 및 관리하는 데 유용합니다. 모든 Azure 서비스에는 해당하는 관리 라이브러리가 있습니다.

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

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

각 관리 라이브러리를 사용하는 방법에 대한 자세한 내용은 SDK GitHub 리포지토리에서 라이브러리의 프로젝트 폴더에 있는 README.md 또는 README.rst 파일을 참조하세요. 참조 설명서Azure 샘플에서 추가 코드 조각을 확인할 수도 있습니다.

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

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

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

SDK의 클라이언트(또는 "데이터 평면") 라이브러리는 이미 프로비저닝된 서비스와 상호 작용하는 Python 애플리케이션 코드를 작성하는 데 유용합니다. 클라이언트 라이브러리는 클라이언트 API를 지원하는 서비스를 위해서만 존재합니다.

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

그 외에도 이러한 라이브러리의 사용 예제를 제공하는 여러 Azure 서비스가 있습니다. 다른 링크는 다음 인덱스 페이지를 참조하세요.

각 클라이언트 라이브러리를 사용하는 방법에 대한 자세한 내용은 SDK GitHub 리포지토리에서 라이브러리의 프로젝트 폴더에 있는 README.md 또는 README.rst 파일을 참조하세요. 참조 설명서Azure 샘플에서 추가 코드 조각을 확인할 수도 있습니다.

SDK 팀과 교류하고 도움 받기

다음 단계

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