내보내기(0) 인쇄
모두 확장

Azure 저장소 서비스 버전 관리

업데이트 날짜: 2014년 5월

Microsoft Azure 저장소 서비스는 여러 버전을 지원합니다. 저장소 서비스에 대해 요청을 수행하려면 요청이 익명이 아닌 한 해당 작업에 사용할 버전을 지정해야 합니다.

현재 버전의 Azure 저장소 서비스는 2014-02-14이며, 가능한 한 이 버전을 사용하는 것이 좋습니다. 지원되는 다른 모든 버전 목록과 각 버전 사용에 대한 자세한 내용은 Azure Storage Services Versions 2013-08-15 and Earlier를 참조하십시오.

버전 14.02.14에는 다음 변경 내용이 포함됩니다.

  • 새 Microsoft Azure 파일 서비스에서는 Microsoft Azure 데이터 센터에서 실행되는 VM(가상 컴퓨터)이 SMB 프로토콜을 사용하여 공유 파일 시스템을 탑재하고 표준 Windows 파일 API를 사용하여 파일 시스템에 액세스할 수 있습니다. 여러 VM 또는 클라우드 서비스에서 실행되는 여러 역할에서 이러한 파일 시스템에 동시에 연결할 수 있으므로 여러 역할 및 인스턴스 간에 영구 데이터를 쉽게 공유할 수 있습니다. 파일 서비스 REST API는 Blob 서비스 API와 유사하며, Windows 파일 API 외에 파일에 액세스할 수 있는 또 다른 방법을 제공합니다. 자세한 내용은 File Service REST API을 참조하십시오.

  • 이제 공유 액세스 서명에서 SignedVersion (sv) 매개 변수 외에 api-version 매개 변수를 지원합니다. 이러한 매개 변수를 통해 요청을 인증하고 권한을 부여하는 데 사용되는 저장소 서비스 버전과 API 작업을 실행하는 데 사용되는 버전을 제어할 수 있습니다. 아래의 공유 액세스 서명으로 인증된 요청 섹션을 참조하십시오.

요청에 사용할 저장소 서비스 버전을 지정하는 방법은 해당 요청이 인증되는 방법과 관련이 있습니다. 다음 섹션에서는 인증 옵션과 각 옵션에 대해 서비스 버전이 지정되는 방법을 설명합니다.

  1. 공유 키 또는 Shared Key Lite를 사용하는 요청. 공유 키/Shared Key Lite를 사용하는 요청을 인증하려면 요청에서 x-ms-version 헤더를 전달해야 합니다. Blob 서비스의 경우 Blob 서비스 속성 설정를 호출하여 모든 요청에 대해 기본 버전을 지정할 수 있습니다.

  2. SAS(공유 액세스 서명)를 사용하는 요청. 공유 액세스 서명에 대해 두 가지 버전 관리 옵션을 지정할 수 있습니다. 선택적 api-version 헤더를 지정한 경우 이는 API 작업을 실행하는 데 사용할 서비스 버전을 나타냅니다. SignedVersion (sv) 매개 변수는 SAS에 대한 요청을 인증하고 권한을 부여하는 데 사용할 서비스 버전을 지정합니다. api-version 헤더를 지정하지 않으면 SignedVersion (sv) 매개 변수도 API 작업을 실행하는 데 사용할 버전을 나타냅니다.

  3. 익명 액세스를 사용하는 요청. Blob 서비스에 대한 익명 액세스의 경우 아무 버전도 전달되지 않습니다. 이 경우 요청에 사용되는 버전에 대한 추론은 아래에 설명되어 있습니다.

공유 키/Shared Key Lite를 사용하여 요청을 인증하려면 요청에서 x-ms-version 헤더를 지정합니다. x-ms-version 요청 헤더 값은 YYYY-MM-DD 형식으로 지정해야 합니다. 예를 들면 다음과 같습니다.

Request Headers:
x-ms-version: 2014-02-14

다음 규칙은 공유 키/Shared Key Lite를 사용하는 요청을 평가하여 해당 요청을 처리하는 데 사용할 버전을 결정하는 방법을 나타냅니다.

  • 요청에 유효한 x-ms-version 헤더가 포함되어 있으면 저장소 서비스가 지정된 버전을 사용합니다. 공유 액세스 서명을 사용하지 않는 테이블 및 큐 서비스에 대한 모든 요청에서는 x-ms-version 헤더를 지정해야 합니다. 공유 액세스 서명을 사용하지 않는 Blob 서비스에 대한 모든 요청에서는 아래 설명된 대로 기본 버전이 설정되지 않은 경우 x-ms-version 헤더를 지정해야 합니다.

  • Blob 서비스에 대한 요청에 x-ms-version 헤더가 없지만 계정 소유자가 Blob 서비스 속성 설정를 사용하여 기본 버전을 설정한 경우에는 지정한 기본 버전이 해당 요청의 버전으로 사용됩니다.

버전 2014-02-14를 사용하여 생성한 SAS(공유 액세스 서명)는 다음 두 가지 버전 관리 옵션을 지원합니다.

  • api-version 쿼리 매개 변수는 SAS를 사용하여 수행된 요청을 처리하는 데 사용할 REST 프로토콜 버전을 정의합니다.

  • SignedVersion (sv) 쿼리 매개 변수는 인증 및 권한 부여에 사용할 SAS 버전을 정의합니다.

SignedVersion 쿼리 매개 변수는 클라이언트가 SAS를 사용하여 요청한 경우 인증 및 권한 부여에 사용됩니다. si, sr, sp, sig, st, se, tn, spk, srk, epkerk와 같은 인증 및 권한 부여 매개 변수는 모든 버전 2014-02-14를 사용하여 해석됩니다.

rscc, rscd, rsce, rsclrsct와 같은 REST 프로토콜 매개 변수는 api-version 매개 변수 헤더에 제공된 버전을 사용하여 적용됩니다. api-version 헤더가 지정되지 않은 경우에는 SignedVersion에 대해 제공된 서비스 버전이 사용됩니다.

api-version 매개 변수는 공유 액세스 서명 URI 생성에 설명된 대로 인증에서 서명할 문자열의 일부가 아닙니다.

다음 표에서는 서비스에서 인증 및 권한 부여에 사용하는 버전 관리 체계 및 SignedVersion 매개 변수가 버전 2014-02-14 이상으로 설정된 경우 REST 프로토콜을 호출하는 데 사용하는 버전 관리 체계를 설명합니다.

 

api-version 매개 변수 값 인증 및 권한 부여에 사용되는 버전 프로토콜 동작에 사용되는 버전

지정되지 않음

sv 매개 변수에 지정된 버전

sv 매개 변수에 지정된 버전

XXXX-XX-XX 형식의 모든 유효한 저장소 서비스 버전

sv 매개 변수에 지정된 버전

XXXX-XX-XX 형식의 유효한 저장소 서비스 버전

예 1

다음 샘플 요청은 sv=2014-02-14를 사용하여 api-version 매개 변수 없이 Blob 나열를 호출합니다.

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2014-02-14&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d

이 경우 서비스는 버전 2014-02-14를 사용하여 요청을 인증하고 권한을 부여하며, 버전 2014-02-14를 사용하여 작업을 실행합니다.

예 2

다음 샘플 요청은 sv=2014-02-14를 사용하여 api-version 매개 변수와 함께 Blob 나열를 호출합니다.

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2014-02-14&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d&api-version=2012-02-12

이 경우 서비스는 버전 2014-02-14를 사용하여 요청을 인증하고 권한을 부여하며, 버전 2012-02-12를 사용하여 작업을 실행합니다.

note참고
.NET 저장소 클라이언트 라이브러리는 REST 프로토콜 버전(api-version 매개 변수에 지정)을 항상 해당 버전의 기반이 되는 버전으로 설정합니다.

Blob 서비스에 대한 요청에서 x-ms-version 헤더를 지정하지 않고 Blob 서비스 속성 설정를 사용하여 서비스의 기본 버전을 설정하지 않은 경우에는 가장 오래된 버전의 Blob 서비스를 사용하여 요청이 처리됩니다. 그러나 버전 2009-09-19 이상을 사용하여 수행된 컨테이너 ACL 설정 작업에서 컨테이너를 공용으로 지정한 경우에는 버전 2009-09-19를 사용하여 요청이 처리됩니다.

참고 항목

표시:
© 2014 Microsoft