이전 Azure Storage 버전
Azure Storage는 여러 버전을 지원합니다. Storage에 대해 요청을 수행하려면 요청이 익명이 아닌 한 해당 작업에 사용할 버전을 지정해야 합니다.
사용 가능한 버전
현재 버전의 Azure Storage는 2025-05-05이며 가능한 경우 해당 버전을 사용하는 것이 좋습니다. 최신 버전에 대한 자세한 내용은 Azure Storage 대한버전 관리를 참조하세요.
지원되는 추가 버전은 다음과 같습니다.
공유 액세스 서명을 통해 권한이 부여된 요청
공유 액세스 서명을 통해 수행되는 요청은 SAS를 생성하는 데 사용하는 버전에 따라 처리됩니다. 버전 2013-08-15 및 2012-02-12에는 SAS 요청을 승인하고 실행하는 데 사용할 버전을 지정하는 버전 관리 매개 변수(SignedVersion또는 sv)가 포함됩니다.
버전 2012-02-12 이상
버전 2012-02-12 이상을 사용하여 생성된 공유 액세스 서명이 있는 요청에는 SignedVersion (sv) 매개 변수가 필요합니다.
SignedVersion 권한 부여 및 API 작업 호출에 사용되는 서비스 버전을 나타냅니다. 요청에 x-ms-version 헤더가 전달되면 무시됩니다.
SignedVersion (sv) 매개 변수만 공유 액세스 서명을 통해 수행된 요청을 처리하는 데 사용할 서비스 버전을 결정합니다.
메모
버전 2013-08-15 이하의 경우 공유 액세스 서명 URL(즉, 공유 액세스 서명 공급자 또는 생성기)을 준비하고 배포하는 서비스가 클라이언트 소프트웨어(즉, 공유 액세스 서명 소비자)가 이해하는 Azure Storage 서비스 버전을 지정해야 합니다.
다음 표에서는 공유 액세스 서명을 통해 수행된 요청에 대해 어떤 버전이 지원되는지를 나타냅니다.
SignedVersion (sv) 매개 변수의 값 |
지원되는 서비스 |
|---|---|
| 2015-12-11 | 모두(Azure Blob Storage, Azure Queue Storage, Azure Table Storage 및 Azure Files) |
| 2015-04-05 | 모두(Blob Storage, Queue Storage, Table Storage 및 Azure Files) |
| 2015-02-21 | 모두(Blob Storage, Queue Storage, Table Storage 및 Azure Files) |
| 2014-02-14 | Blob Storage, Queue Storage 및 Table Storage |
| 2013-08-15 | Blob Storage, Queue Storage 및 Table Storage |
| 2012-02-12 | Blob Storage, Queue Storage 및 Table Storage |
다음 예제에서는 sv=2013-08-15사용하여 Blob 호출하는 공유 액세스 서명을 보여 줍니다.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
이 예제에서 서비스는 버전 2013-08-15를 사용하여 요청을 승인하고 실행합니다. 응답은 2013-08-15 버전에서 제거되었으므로 Blob 요소 아래에 Url 요소가 포함되지 않습니다.
클라이언트 애플리케이션이 버전 2012-02-12를 기반으로 하는 Storage 클라이언트 라이브러리 버전을 사용하고 이 공유 액세스 서명을 사용하는 요청을 만드는 경우 클라이언트는 Uri 요소를 예상합니다. 따라서 NullReferenceException요청이 실패합니다.
2012-02-12 이전 버전(Blob Storage에만 해당)
Blob Storage는 버전 2009-07-17에서 공유 액세스 서명을 도입했습니다. Table Storage 및 Queue Storage는 버전 2012-02-12에서 공유 액세스 서명을 도입했기 때문에 버전 2012-02-12 이전의 공유 액세스 서명 동작은 Blob Storage에만 적용됩니다.
버전 2012-02-12에는 공유 액세스 서명 생성기가 요청을 처리하는 데 사용할 버전을 지정할 수 있는 SignedVersion (sv) 매개 변수도 도입되었습니다. 2012-02-12 이전 버전으로 생성된 공유 액세스 서명은 요청을 처리하는 데 사용할 버전을 지정할 수 없으므로 권한 부여 및 API 실행에 대한 다음 규칙에 의존합니다.
요청에 유효한
x-ms-version헤더가 있는 경우 가장 빠른 유효한 버전(2009-07-17)을 사용하여 공유 액세스 서명 매개 변수를 해석합니다.x-ms-version지정된 버전은 Blob Storage 작업을 수행하는 데 사용됩니다.요청에
x-ms-version헤더가 없고 소유자가 Blob Storage 속성설정하여 기본 버전을 설정한 경우 버전 2009-07-17을 사용하여 매개 변수를 해석합니다. 소유자가 지정한 기본 버전은 Blob Storage 작업을 수행하는 데 사용됩니다.요청에
x-ms-version헤더가 없고 소유자가 기본 버전을 설정하지 않은 경우 Blob Storage는 가장 빠른 유효한 버전(2009-07-17)을 사용하여 매개 변수를 해석합니다. 컨테이너가 공용이고 해당 액세스 제한이 버전 2009-09-19 이상을 사용하는 컨테이너 ACL 설정 작업으로 설정된 경우 버전 2009-09-19는 Blob Storage 작업을 수행하는 데 사용됩니다.요청에
x-ms-version헤더가 없고 소유자가 기본 버전을 설정하지 않은 경우 Blob Storage는 가장 빠른 유효한 버전(2009-07-17)을 사용하여 매개 변수를 해석합니다. 버전 2009-09-19 이상을 사용한 컨테이너 ACL 설정 작업으로 컨테이너 액세스 제한이 설정되지 않은 경우 Blob Storage 작업은 서비스의 초기 버전을 사용하여 수행됩니다.
다음 표에서는 이러한 규칙을 다양한 시나리오에 적용하고 SignedVersion 매개 변수가 포함되지 않은 것으로 가정합니다.
| x-ms-version 헤더 값 | Blob Storage에 대한 권한 부여 및 권한 부여에 대한 매개 변수를 해석하는 데 사용되는 버전 | Blob Storage 작업을 수행하는 데 사용되는 버전 |
|---|---|---|
| 없음 | 가장 먼저 유효한 공유 액세스 서명 버전(2009-07-17) | 2009-09-19는 버전 2009-09-19 이상을 사용하여 컨테이너 ACL 설정하여 컨테이너를 공용으로 설정한 경우 사용됩니다. 그렇지 않으면 Blob Storage의 초기 버전이 사용됩니다. |
| 2011-08-18 | 가장 먼저 유효한 공유 액세스 서명 버전(2009-07-17) | 2011-08-18. |
| 모든 버전 XXXX-XX-XX | 가장 먼저 유효한 공유 액세스 서명 버전(2009-07-17) | 버전 XXXX-XX-XX |
메모
따옴표 붙은 ETag 값 또는 유효한 Accept-Ranges 응답 헤더가 필요한 시나리오에는 버전 2011-08-18 이상을 사용하는 것이 좋습니다. 브라우저 및 기타 스트리밍 클라이언트는 효율적인 다운로드 및 재시도를 위해 이러한 헤더가 필요합니다.