다음을 통해 공유

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

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

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

중요하지는 않지만 여전히 흥미로운 세부 정보

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

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

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

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

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

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

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

    • Azure SDKs 대한 보안 및 성능 업데이트가 누락되지 않도록 하려면 2023년 3월 31일까지 latest Azure SDK 라이브러리로 업그레이드합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

도움말 보기 및 SDK 팀과 연결

다음 단계

Python 위해 Azure 라이브러리를 쉽게 사용할 수 있도록 로컬 개발 환경을 설정합니다.

로컬 개발 환경 >>> 설정

  • Last updated on