BLOB 계층 설정

Set Blob Tier작업은 blob에 대 한 액세스 계층을 설정 합니다. 작업은 premium storage 계정의 페이지 blob 및 blob storage 또는 범용 v2 계정의 블록 blob에서 허용 됩니다. 프리미엄 페이지 blob 계층은 blob의 허용 되는 크기, IOPS 및 대역폭을 결정 합니다. 블록 blob의 계층은 Hot / Cool / Archive 저장소 유형을 결정 합니다. 이 작업을 수행 해도 blob의 ETag는 업데이트 되지 않습니다.

블록 blob 수준 계층화에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.

요청

다음과 같이 Set Blob Tier 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다. Myaccount은 저장소 계정 이름으로, myblob은 계층을 변경할 blob 이름으로 바꿉니다.

방법 요청 URI HTTP 버전
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

URI 매개 변수

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.

매개 변수 설명
snapshot 선택 사항입니다. Snapshot 매개 변수는 DateTime 있는 경우 계층을 설정할 blob 스냅숏을 지정 하는 불투명 값입니다. Blob 스냅숏을 사용 하는 방법에 대 한 자세한 내용은 blob의 스냅숏 만들기 를 참조 하세요.
versionid 버전 2019-12-12 이상 버전의 경우 선택 사항입니다. 이 매개 변수는 DateTime 있는 경우 계층을 설정할 blob의 버전을 지정 하는 불투명 값입니다.
timeout 선택 사항입니다. 시간 초과 매개 변수는 초 단위로 표현됩니다. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더 설명
Authorization 필수 요소. 권한 부여 체계, 저장소 계정 이름 및 서명을 지정 합니다. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.
Date 또는 x-ms-date 필수 요소. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.
x-ms-access-tier 필수 요소. Blob에 설정할 계층을 나타냅니다. 허용 되는 프리미엄 페이지 blob 계층 목록은 vm에 대 한 고성능 Premium Storage 및 managed disks를 참조 하세요. Blob storage 또는 범용 v2 계정의 경우 유효한 값은 Hot / Cool / Archive 입니다. 표준 blob 계정 blob 수준 계층화에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.
x-ms-version 모든 권한이 부여 된 요청에 필요 합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.
x-ms-client-request-id 선택 사항입니다. 저장소 분석 로깅을 사용 하도록 설정한 경우 분석 로그에 기록 되는 1kb 문자 제한을 사용 하 여 클라이언트에서 생성 한 불투명 값을 제공 합니다. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다. 자세한 내용은 스토리지 분석 로깅Azure 로깅 정보: 로그를 사용 하 여 저장소 요청 추적을 참조 하세요.
x-ms-rehydrate-priority 선택 사항입니다. 보관 된 blob을 리하이드레이션 우선 순위를 나타냅니다. 블록 blob의 경우 2019-02-02 이상 버전에서 지원 됩니다. 유효한 값은 High / Standard 입니다. 우선 순위는 blob에서 한 번만 설정할 수 있습니다. 이 헤더는 동일한 blob에 대 한 후속 요청에서 무시 됩니다. 이 헤더가 없는 기본 우선 순위는 Standard 입니다.

이 작업은 또한 지정 된 조건이 충족 될 경우에만 blob을 계층화 하는 조건부 헤더 사용을 지원 합니다. 자세한 내용은 Blob 서비스 작업의 조건부 헤더 지정을 참조하세요.

요청 본문

없음

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

상태 코드

작업에 성공 하면 새 계층이 즉시 적용 되는 경우 상태 코드 200 (정상)이 반환 되 고, 새 계층으로의 전환이 보류 중인 경우에는 상태 코드 202 (수락 됨)가 반환 됩니다. Premium 계정 페이지 blob 작업은 상태 코드 200 (정상)을 반환 합니다. 블록 blob의 경우 아래 표에서는 현재 계층 및 blob의 요청 된 계층을 기반으로 반환 되는 http 상태 코드에 대해 설명 합니다.

Hot Cool Archive
계층의 Blob Hot 200 200 200
계층의 Blob Cool 200 200 200
계층의 Blob Archive 202 202 200
Archive계층 리하이드레이션의 BlobHot 202 409 409
Archive계층 리하이드레이션의 BlobCool 409 202 409

상태 코드에 대 한 자세한 내용은 상태 및 오류 코드를 참조 하세요.

응답 헤더

이 작업에 대 한 응답에는 아래 헤더가 포함 됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을따릅니다.

응답 헤더 설명
x-ms-request-id 이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다. 자세한 내용은 API 작업 문제 해결을 참조 하세요.
x-ms-version 요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다. 이 헤더는 버전 2009-09-19 이상에 대해 수행 된 요청에 대해 반환 됩니다.
x-ms-client-request-id 이 헤더를 사용 하 여 요청 및 해당 응답의 문제를 해결할 수 있습니다. 이 헤더의 값은 요청에 있는 경우 헤더의 값과 같으며 x-ms-client-request-id , 값은 최대 1024 표시 ASCII 문자입니다. x-ms-client-request-id요청에 헤더가 없는 경우이 헤더는 응답에 표시 되지 않습니다.

권한 부여

이 작업은 저장소 계정 소유자 및이 blob 또는 해당 컨테이너에 쓸 수 있는 권한이 있는 공유 액세스 서명을 가진 모든 사용자만 호출할 수 있습니다.

설명

Premium 계정에서 페이지 blob에 대 한 blob 계층을 설정 하는 데는 다음과 같은 제한 사항이 있습니다.

Blob storage 또는 범용 v2 계정에서 블록 blob의 계층을 설정 하는 데는 다음과 같은 제한 사항이 있습니다.

  • 스냅숏에서 계층 설정은 REST 버전 2019-12-12을 시작할 수 있습니다.
  • 보관에 계층화 된 스냅숏은 스냅숏으로 다시 이동할 수 없습니다. 예: 스냅숏은 핫/쿨 계층으로 다시 가져올 수 없습니다. 보관 된 스냅숏 또는 버전에서 데이터를 검색 하는 방법은 새 blob에 복사 하는 것입니다.
  • 버전이 루트 blob 인 경우 핫 또는 쿨로 다시 전환할 수 있습니다.
  • 보관 된 상태의 스냅숏 또는 버전은 루트로 승격 될 수 없습니다.
  • 버전 관리를 사용 하는 경우 리하이드레이션 보류 중에 루트 blob을 삭제 하면 리하이드레이션 취소가 발생 하 고 버전이 보관 됨 상태가 됩니다.
  • 리하이드레이션 pending 및 소프트 삭제 상태에서 blob을 덮어쓰는 경우 리하이드레이션 취소가 발생 하 고 버전이 나 소프트 삭제 된 스냅숏이 보관 된 상태가 됩니다.

지원 되는 계층 목록은 요청 버전에 의해 제한 되지 않으며 새 계층은 나중에 추가 될 수 있습니다.

참고

블록 blob 수준 계층화에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.

참고 항목

Azure Storage에 대 한 요청 권한 부여
상태 및 오류 코드
Blob 서비스 오류 코드
Blob 서비스 작업에 대한 제한 시간 설정