다음을 통해 공유


Python용 Azure Storage 클라이언트 라이브러리

클라이언트 패키지(12.X.X) - 최신

패키지 이름 참조 패키지 관리자 원본
스토리지 Blob 참조 PyPi GitHub
스토리지 큐 참조 PyPi GitHub
스토리지 파일 공유 참조 PyPi GitHub
스토리지 파일 Data Lake(미리 보기) 참조 PyPi GitHub

클라이언트 패키지(2.X.X) - 레거시

패키지 이름 참조 패키지 관리자 원본
스토리지 Blob 참조 PyPi GitHub
스토리지 큐 참조 PyPi GitHub
스토리지 파일 공유 참조 PyPi GitHub

관리

패키지 이름 참조 패키지 관리자 원본
스토리지 관리 참조 PyPi GitHub

라이브러리 설치

클라이언트

Azure Storage 클라이언트 라이브러리는 Blob, 파일 공유 및 큐의 3개 패키지로 구성됩니다. Blob 패키지를 설치하려면 다음을 실행합니다.

pip install azure-storage-blob

관리

pip install azure-mgmt-storage

샘플

아티클 Description
Python에서 Azure Blob Storage 시작(영문) Azure Storage에서 파일과 개체를 생성, 판독, 업데이트, 액세스 제한 및 삭제합니다.
Azure Storage 계정 관리(영문) 스토리지 계정을 만들고, 업데이트하고, 삭제합니다. 스토리지 계정 액세스 키를 검색하고 다시 생성합니다.

앱에서 사용할 수 있는 Python 샘플 코드를 추가로 탐색합니다.

알려진 문제

이 섹션에서는 Python용 Azure Storage 클라이언트 라이브러리의 알려진 문제에 대해 자세히 설명합니다.

SDK의 베타 버전을 사용할 때 InvalidHeaderValue 오류 메시지

드문 시나리오에서는 최신 베타 또는 일반 공급 버전의 SDK로 업그레이드한 애플리케이션에 오류 메시지가 표시될 InvalidHeaderValue 수 있습니다. 이 문제는 Storage 라이브러리를 사용할 때 발생할 수 있습니다. 오류 메시지는 다음 샘플과 유사합니다.

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error> 

최신 베타로 업그레이드했거나 SDK에서 일반적으로 사용할 수 있는 경우 이 오류가 발생하는 경우 문제가 해결되는지 확인하려면 SDK의 이전 일반 공급 버전으로 다운그레이드하는 것이 좋습니다. 문제가 지속되거나 권장 사항이 실현 가능하지 않은 경우 지원 티켓을 열어 추가 옵션을 살펴봅니다.