Blob 서비스 리소스에 대한 속성 및 메타데이터 설정 및 검색

  • 아티클

컨테이너 및 blob에는 HTTP 헤더로 표시되는 사용자 지정 메타데이터가 지원됩니다. 메타데이터 헤더는 새 컨테이너 또는 blob 리소스를 만드는 요청에 대해 또는 기존 리소스에서 속성을 명시적으로 만드는 요청에 대해 설정할 수 있습니다.

이 항목에는 다음과 같은 하위 항목이 포함되어 있습니다.

메타데이터 헤더 형식

메타데이터에 대한 작업

컨테이너 및 Blob에 대한 표준 HTTP 속성

Blob은 Blob 서비스에서 자동으로 인덱싱되는 특수한 유형의 사용자 지정 메타데이터인 태그도 지원합니다. 자세한 내용은 Blob 인덱스로 Azure Blob Storage 데이터 관리 및 찾기를 참조하세요.

메타데이터 헤더 형식

메타데이터 헤더는 이름/값 쌍입니다. 헤더 형식은 다음과 같습니다.

x-ms-meta-name:string-value

버전 2009-09-19부터 메타데이터 이름은 C# 식별자에 대한 명명 규칙을 준수해야 합니다.

이름은 대/소문자를 구분하지 않습니다. 메타데이터를 만들 때는 이름에서 대/소문자를 구분하지만 설정하거나 읽을 때에는 대/소문자를 구분하지 않습니다. 리소스에 대해 동일한 이름의 메타데이터 헤더가 두 개 이상 제출될 경우 Blob 서비스는 상태 코드 400(잘못된 요청)을 반환합니다.

메타데이터는 이름/값 쌍으로 구성됩니다. 모든 메타데이터 쌍의 총 크기는 최대 8KB입니다.

메타데이터 이름/값 쌍은 유효한 HTTP 헤더이므로 HTTP 헤더와 관련된 모든 제한 사항을 준수합니다.

메타데이터의 작업

blob 또는 컨테이너 리소스에 대한 메타데이터는 리소스 콘텐츠를 반환하거나 수정하지 않고 직접적으로 검색 또는 설정할 수 있습니다.

메타데이터 값은 전체에 대해서만 읽거나 쓸 수 있으며, 부분 업데이트가 지원되지 않습니다. 리소스에 메타데이터를 설정하면 해당 리소스에 대한 기존 메타데이터 값을 덮어씁니다.

속성 및 메타데이터 검색

GET 및 HEAD 작업은 모두 지정된 컨테이너 또는 blob에 대한 메타데이터 헤더를 검색합니다. HEAD 작업은 헤더만 반환하며 응답 본문을 반환하지 않습니다.

컨테이너에서 메타데이터 헤더 검색을 위한 URI 구문은 다음과 같습니다.

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

blob에서 메타데이터 헤더 검색을 위한 URI 구문은 다음과 같습니다.

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

메타데이터 헤더 설정

PUT 작업은 지정된 컨테이너 또는 blob에서 메타데이터 헤더를 설정하여 해당 리소스의 모든 기존 메타데이터를 덮어씁니다. 요청에 대한 헤더 없이 PUT를 호출하면 해당 리소스의 모든 기존 메타데이터가 지워집니다.

컨테이너에서 메타데이터 헤더 설정을 위한 URI 구문은 다음과 같습니다.

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container

blob에서 메타데이터 헤더 설정을 위한 URI 구문은 다음과 같습니다.

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

컨테이너 및 blob에 대한 표준 HTTP 속성

컨테이너 및 blob에는 또한 특정 표준 HTTP 속성이 지원됩니다. 속성 및 메타데이터는 모두 표준 HTTP 헤더로 표시됩니다. 이 두 가지는 지정한 헤더 이름으로 구분됩니다. 메타데이터 헤더 이름은 헤더 접두사 x-ms-meta- 및 사용자 지정 이름을 사용해서 지정됩니다. 속성 헤더는 HTTP/1.1 프로토콜 사양의 헤더 필드 정의 섹션 14에 지정된 대로 표준 HTTP 헤더 이름을 사용합니다.

컨테이너에서 지원되는 표준 HTTP 헤더는 다음을 포함합니다.

  • ETag

  • Last-Modified

blob에서 지원되는 표준 HTTP 헤더는 다음을 포함합니다.

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

참고 항목

컨테이너 만들기
컨테이너 속성 가져오기
컨테이너 메타데이터 설정
Blob 배치
Blob 복사
Blob 속성 가져오기
Blob 메타데이터 가져오기
Blob 메타데이터 설정
Blob Service 개념
Blob 인덱스를 사용하여 Azure Blob Storage에서 데이터 관리 및 찾기