Blob 태그 가져오기

Get Blob Tags작업은 지정 된 blob, 버전 또는 스냅숏에 대 한 모든 사용자 정의 태그를 반환 합니다.

요청

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

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

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

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

URI 매개 변수

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

매개 변수 Description
snapshot 선택 사항입니다. 스냅숏 매개 변수는 불투명 DateTime 값이며, 제공된 경우 검색할 blob 스냅숏을 지정합니다. Blob 스냅숏을 사용 하는 방법에 대 한 자세한 내용은 blob의 스냅숏 만들기 를 참조 하세요.
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에 대 한 버전 관리를 참조 하세요.
x-ms-lease-id:<ID> blob에 활성 임대가 포함된 경우 필수입니다.

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

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

요청 본문

없음

응답

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

상태 코드

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

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

응답 헤더

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

응답 헤더 Description
Content-Type application/xml
Content-Length 반환 된 XML 문서의 크기 (바이트)입니다.
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요청에 헤더가 없는 경우이 헤더는 응답에 표시 되지 않습니다.

응답 본문

응답 본문의 형식은 다음과 같습니다.

<?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 문서입니다.

권한 부여

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

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

설명

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

태그의 순서는 응답에서 보장 되지 않습니다.

저장소 서비스는 blob과 해당 태그 사이에서 강력한 일관성을 유지 하지만, 보조 인덱스는 궁극적으로 일치 합니다. 태그는 Get Blob Tags 작업에 표시 되기 전에에 대 한 응답에서 표시 될 수 있습니다 Find Blobs by Tags .

참고 항목

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