Blob 태그 설정

Set Blob Tags작업은 지정 된 blob에 대 한 사용자 정의 태그를 하나 이상의 키-값 쌍으로 설정 합니다.

요청

다음과 같이 Set Blob Tags 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다. Myaccount 을 사용자의 저장소 계정 이름으로 바꿉니다.

PUT 메서드 요청 URI HTTP 버전
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&versionid=<DateTime>
HTTP/1.1

URI 매개 변수

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

매개 변수 Description
versionid 버전 2019-12-12 이상 버전의 경우 선택 사항입니다. 이 매개 변수는 불투명 DateTime 값 이며, 있는 경우 검색할 blob의 버전을 지정 합니다.
timeout 선택 사항입니다. timeout 매개 변수는 초 단위로 표시됩니다. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.

요청 헤더

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

요청 헤더 Description
Authorization 필수 요소. 인증 체계, 계정 이름 및 서명을 지정 합니다. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.
Date 또는 x-ms-date 필수 요소. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.
x-ms-version 모든 권한이 부여 된 요청에 필요 합니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.
Content-Length 필수 요소. 요청 콘텐츠의 길이(바이트 수)입니다. 이 헤더는 blob 자체가 아닌 태그 문서의 콘텐츠 길이를 참조 합니다.
Content-Type 필수 요소. 이 헤더의 값은 application/xml 이어야 합니다. charset = UTF-8.
Content-MD5 선택 사항입니다. 요청 콘텐츠의 MD5 해시입니다. 이 해시는 전송 중 요청 콘텐츠의 무결성을 확인하는 데 사용됩니다. 두 해시가 일치하지 않으면 작업이 실패하고 오류 코드 400(잘못된 요청)이 표시됩니다.

이 헤더는 blob 콘텐츠 자체가 아니라 요청 콘텐츠와 연관됩니다.
x-ms-content-crc64 선택 사항입니다. 요청 콘텐츠의 CRC64 해시입니다. 이 해시는 전송 중 요청 콘텐츠의 무결성을 확인하는 데 사용됩니다. 두 해시가 일치하지 않으면 작업이 실패하고 오류 코드 400(잘못된 요청)이 표시됩니다.

이 헤더는 blob 콘텐츠 자체가 아니라 요청 콘텐츠와 연관됩니다.

Content-MD5및 헤더가 모두 x-ms-content-crc64 있는 경우 요청이 실패 하 고 오류 코드 400 (잘못 된 요청)이 표시 됩니다.
x-ms-lease-id:<ID> blob에 활성 임대가 포함된 경우 필수입니다.

활성 임대가 포함된 blob에서 이 작업을 수행하려면 이 헤더에 대해 유효한 임대 ID를 지정합니다. 요청에 유효한 임대 ID가 지정되지 않은 경우 작업이 실패하고 상태 코드 403(사용 권한 없음)이 나타납니다.
x-ms-client-request-id 선택 사항입니다. 저장소 분석 로깅을 사용 하도록 설정한 경우 분석 로그에 기록 되는 1 KiB 문자 제한이 있는 클라이언트 생성 불투명 값을 제공 합니다. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다. 자세한 내용은 스토리지 분석 로깅Azure 로깅: 로그를 사용 하 여 저장소 요청 추적을 참조 하세요.

이 작업 x-ms-if-tags 은 지정 된 조건이 충족 될 경우에만 blob 태그를 설정 하는 조건부 헤더를 지원 합니다. 자세한 내용은 Blob 서비스 작업의 조건부 헤더 지정을 참조하세요.

요청 본문

요청 본문의 형식은 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>  

요청 본문은 blob에 대 한 태그를 나타내는 태그 집합을 포함 하는 올바른 형식의 UTF-8 XML 문서 여야 합니다.

태그 집합에는 최대 10 개의 태그가 포함 될 수 있습니다. 태그 키 및 값은 대/소문자를 구분 합니다. 태그 키는 1에서 128 자 사이 여야 하 고 태그 값은 0에서 256 자 사이 여야 합니다. 유효한 태그 키 및 값 문자는 다음과 같습니다.

  • 소문자 및 대문자 (a-z, a-z)
  • 숫자 (0-9)
  • 공백 ()
  • 더하기 (+), 빼기 (-), 마침표 (.), 슬래시 (/), 콜론 (:), 같음 (=) 및 밑줄 (_)

응답

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

상태 코드

작업이 성공하면 상태 코드 204(콘텐츠 없음)이 반환됩니다.

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

응답 헤더

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

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

응답 본문

없음

권한 부여

이 작업은 계정 소유자 및 blob 태그 (SAS 권한)에 대 한 사용 권한이 있는 공유 액세스 서명을 가진 누구 든 지 호출할 수 있습니다 t .

또한 권한이 있는 RBAC 사용자는 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write 이 작업을 수행할 수 있습니다.

설명

Set Blob Tags작업은 REST API 버전 2019-12-12 이상에서 지원 됩니다.

Set Blob Tags작업은 blob의 모든 기존 태그를 덮어씁니다. Blob에서 모든 태그를 제거 하려면 Set Blob Tags 빈를 포함 하는 요청을 보냅니다 <TagSet> .

이 작업을 수행 해도 blob의 ETag 또는 마지막으로 수정 된 시간은 업데이트 되지 않습니다. 보관 된 blob에 태그를 설정할 수 있습니다.

저장소 서비스는 blob과 해당 태그 간의 강력한 일관성을 유지 합니다. Blob 태그에 대 한 변경 내용은 Get Blob Tags blob에 대 한 후속 작업에 즉시 표시 됩니다. 그러나 보조 인덱스는 궁극적으로 일치 합니다. blob 태그에 대 한 변경 내용은 작업에 즉시 표시 되지 않을 수 있습니다 Find Blobs by Tags .

요청에서 잘못 된 태그를 제공 하는 경우 Blob service는 상태 코드 400 (잘못 된 요청)을 반환 합니다.

참고 항목

Blob 인덱스를 사용하여 Azure Blob Storage에서 데이터 관리 및 찾기
Azure Storage에 대 한 요청 권한 부여
상태 및 오류 코드
Blob 서비스 오류 코드