Blob 속성 가져오기Get Blob Properties

Get Blob Properties 작업은 blob에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다.The Get Blob Properties operation returns all user-defined metadata, standard HTTP properties, and system properties for the blob. blob의 콘텐츠는 반환하지 않습니다.It does not return the content of the blob.

요청Request

다음과 같이 Get Blob Properties 요청을 생성할 수 있습니다.The Get Blob Properties request may be constructed as follows. HTTPS를 사용하는 것이 좋습니다.HTTPS is recommended. Myaccount 을 사용자의 저장소 계정 이름으로 바꿉니다.Replace myaccount with the name of your storage account:

HEAD 메서드 요청 URIHEAD Method Request URI HTTP 버전HTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob

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

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

에뮬레이트된 저장소 서비스 URIEmulated storage service URI

에뮬레이트된 저장소 서비스에 대해 요청을 수행할 때는 에뮬레이터 호스트 이름 및 Blob 서비스 포트를 127.0.0.1:10000으로 지정하고 뒤에 에뮬레이트된 저장소 계정 이름을 붙입니다.When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

HEAD 메서드 요청 URIHEAD Method Request URI HTTP 버전HTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1HTTP/1.1

자세한 내용은 개발 및 테스트에 Azure Storage 에뮬레이터 사용을 참조 하세요.For more information, see Using the Azure Storage Emulator for Development and Testing.

URI 매개 변수URI parameters

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.The following additional parameters may be specified on the request URI.

매개 변수Parameter DescriptionDescription
snapshot 선택 사항입니다.Optional. 스냅숏 매개 변수는 불투명 DateTime 값이며, 제공된 경우 검색할 blob 스냅숏을 지정합니다.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to retrieve. Blob 스냅숏을 사용 하는 방법에 대 한 자세한 내용은 blob의 스냅숏 만들기 를 참조 하세요.For more information on working with blob snapshots, see Creating a Snapshot of a Blob
versionid 선택 사항, 버전 2019-12-12 이상.Optional, version 2019-12-12 and newer. 이 매개 변수는 불투명 DateTime 값 이며, 있는 경우 검색할 blob의 버전을 지정 합니다.The versionid parameter is an opaque DateTime value that, when present, specifies the Version of the blob to retrieve.
timeout 선택 사항입니다.Optional. timeout 매개 변수는 초 단위로 표시됩니다.The timeout parameter is expressed in seconds. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.For more information, see Setting Timeouts for Blob Service Operations.

요청 헤더Request Headers

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.The following table describes required and optional request headers.

요청 헤더Request Header DescriptionDescription
Authorization 필수 요소.Required. 인증 체계, 계정 이름 및 서명을 지정 합니다.Specifies the authorization scheme, account name, and signature. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.For more information, see Authorize requests to Azure Storage.
Date 또는 x-ms-dateDate or x-ms-date 필수 요소.Required. 요청에 대한 UTC(협정 세계시)를 지정합니다.Specifies the Coordinated Universal Time (UTC) for the request. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.For more information, see Authorize requests to Azure Storage.
x-ms-version 모든 권한이 부여 된 요청에 필요 합니다. 익명 요청의 경우 선택 사항입니다.Required for all authorized requests, optional for anonymous requests. 이 요청에 사용할 작업의 버전을 지정합니다.Specifies the version of the operation to use for this request. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.For more information, see Versioning for the Azure Storage Services.
x-ms-lease-id: <ID> 선택 사항입니다.Optional. 이 헤더가 지정되었으면 다음 조건이 모두 충족될 경우에만 Get Blob Properties 작업이 수행됩니다.If this header is specified, the Get Blob Properties operation will be performed only if both of the following conditions are met:

-Blob의 임대가 현재 활성 상태입니다.- The blob's lease is currently active.
-요청에 지정 된 임대 ID가 blob의 임대 ID와 일치 합니다.- The lease ID specified in the request matches that of the blob.

이러한 조건이 모두 충족되지 않은 경우 요청이 실패하고 Get Blob Properties 작업이 실패하며 상태 코드 412(전제 조건 실패)가 표시됩니다.If both of these conditions are not met, the request will fail and the Get Blob Properties operation will fail with status code 412 (Precondition Failed).
x-ms-client-request-id 선택 사항입니다.Optional. 저장소 분석 로깅을 사용 하도록 설정한 경우 분석 로그에 기록 되는 1 KiB 문자 제한이 있는 클라이언트 생성 불투명 값을 제공 합니다.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다.Using this header is highly recommended for correlating client-side activities with requests received by the server. 자세한 내용은 스토리지 분석 로깅Azure 로깅: 로그를 사용 하 여 저장소 요청 추적을 참조 하세요.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

이 작업에서는 또한 지정된 조건이 충족될 경우에만 blob 속성과 메타데이터를 반환하는 조건부 헤더 사용이 지원됩니다.This operation also supports the use of conditional headers to return blob properties and metadata only if a specified condition is met. 자세한 내용은 Blob 서비스 작업의 조건부 헤더 지정을 참조하세요.For more information, see Specifying Conditional Headers for Blob Service Operations.

요청 헤더 (고객이 제공한 암호화 키)Request Headers (Customer-provided encryption keys)

버전 2019-02-02부터, 고객이 제공한 키로 암호화 된 blob을 읽기 위해 요청에 다음 헤더를 지정할 수 있습니다.Beginning with version 2019-02-02, the following headers may be specified on the request to read a blob encrypted with a customer-provided key. 고객이 제공한 키 (및 해당 헤더 집합)를 사용 하는 암호화는 선택 사항입니다.Encryption with a customer-provided key (and the corresponding set of headers) is optional. 이전에 고객이 제공한 키를 사용 하 여 blob을 암호화 한 경우 읽기 작업을 성공적으로 완료 하려면 해당 헤더를 요청에 포함 해야 합니다.If a blob has previously been encrypted with a customer-provided key, then these headers must be included on the request to complete the read operation successfully.

요청 헤더Request header DescriptionDescription
x-ms-encryption-key 필수 요소.Required. B a s e 64로 인코딩된 AES-256 암호화 키입니다.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 선택 사항입니다.Optional. 암호화 키의 b a s e 64로 인코딩된 SHA256 해시입니다.The Base64-encoded SHA256 hash of the encryption key.
x-ms-encryption-algorithm: AES256 필수 요소.Required. 암호화에 사용할 알고리즘을 지정 합니다.Specifies the algorithm to use for encryption. 이 헤더의 값은 이어야 합니다 AES256 .The value of this header must be AES256.

요청 본문Request Body

없음None.

응답Response

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.The response includes an HTTP status code and a set of response headers.

상태 코드Status Code

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.A successful operation returns status code 200 (OK).

상태 코드에 대 한 자세한 내용은 상태 및 오류 코드를 참조 하세요.For information about status codes, see Status and Error Codes.

응답 헤더Response Headers

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다.The response for this operation includes the following headers. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다.The response may also include additional standard HTTP headers. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을따릅니다.All standard headers conform to the HTTP/1.1 protocol specification.

응답 헤더Response header DescriptionDescription
Last-Modified Blob을 마지막으로 수정한 날짜/시간입니다.The date/time that the blob was last modified. 날짜 형식은 RFC 1123을 따릅니다.The date format follows RFC 1123. 자세한 내용은 헤더의 Date-Time 값 표현을 참조 하십시오.For more information, see Representation of Date-Time Values in Headers.

blob의 메타데이터 또는 속성에 대한 업데이트를 포함하여 blob를 수정하는 모든 작업은 수행할 경우 blob의 마지막 수정 시간이 변경됩니다.Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last modified time of the blob.
x-ms-creation-time 2017-11-09 이상 버전Version 2017-11-09 and newer. Blob를 만든 날짜/시간입니다.The date/time at which the blob was created. 날짜 형식은 RFC 1123을 따릅니다.The date format follows RFC 1123. 자세한 내용은 헤더의 Date-Time 값 표현을 참조 하십시오.For more information, see Representation of Date-Time Values in Headers.
x-ms-meta-name:value 이 blob와 연결된 사용자 정의 메타데이터에 해당하는 이름-값 쌍의 집합입니다.A set of name-value pairs that correspond to the user-defined metadata associated with this blob.
x-ms-tag-count 2019-12-12 이상 버전Version 2019-12-12 or newer. Blob에 태그가 있는 경우는 blob에 저장 된 태그의 수를 반환 합니다.If the blob has any tags, returns the number of tags stored on the blob. Blob에 태그가 없는 경우이 헤더는 반환 되지 않습니다.This header is not returned if there are no tags on the blob.
x-ms-blob-type:<BlockBlob&#124;PageBlob&#124;AppendBlob> blob 유형입니다.The blob type.
x-ms-copy-completion-time:<datetime> 2012-02-12 이상 버전Version 2012-02-12 and newer. 이 blob가 대상 blob인 마지막으로 시도된 Copy Blob 작업의 완료 시간입니다.Conclusion time of the last attempted Copy Blob operation where this blob was the destination blob. 이 값은 완료, 중단 또는 실패한 복사 시도의 시간을 지정할 수 있습니다.This value can specify the time of a completed, aborted, or failed copy attempt. 복사가 보류 중이거나, 이 blob가 Copy Blob 작업에서 대상으로 지정되지 않은 경우 또는 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 blob가 수정된 경우 이 헤더가 표시되지 않습니다.This header does not appear if a copy is pending, if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status-description: <error string> 2012-02-12 버전 이상은 x-ms-copy-statusfailed 또는 pending인 경우에만 표시됩니다.Version 2012-02-12 and newer, only appears when x-ms-copy-status is failed or pending. 치명적이거나 치명적이지 않은 복사 작업 실패의 원인을 설명합니다.Describes cause of fatal or non-fatal copy operation failure. 이 Blob가 Copy Blob 작업의 대상이 아니거나 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 Blob가 수정된 경우 이 헤더가 표시되지 않습니다.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-id: <id> 2012-02-12 이상 버전Version 2012-02-12 and newer. 이 blob가 대상 blob인 마지막으로 시도된 Copy Blob 작업의 문자열 식별자입니다.String identifier for the last attempted Copy Blob operation where this blob was the destination blob. 이 Blob가 Copy Blob 작업의 대상이 아니거나 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 Blob가 수정된 경우 이 헤더가 표시되지 않습니다.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> 2012-02-12 이상 버전Version 2012-02-12 and newer. 이 blob가 대상 blob인 마지막으로 시도된 Copy Blob 작업에서 복사된 바이트 수 및 원본의 총 바이트 수를 포함합니다.Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this blob was the destination blob. 0에서 Content-Length 사이의 복사된 바이트 수를 표시할 수 있습니다.Can show between 0 and Content-Length bytes copied. 이 Blob가 Copy Blob 작업의 대상이 아니거나 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 Blob가 수정된 경우 이 헤더가 표시되지 않습니다.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-source: url 2012-02-12 이상 버전Version 2012-02-12 and newer. 이 blob가 대상 blob 인 마지막으로 시도 된 작업에서 사용 된 원본 blob을 지정 하는 최대 2 KiB의 URL입니다 Copy Blob .URL up to 2 KiB in length that specifies the source blob used in the last attempted Copy Blob operation where this blob was the destination blob. 이 Blob가 Copy Blob 작업의 대상이 아니거나 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 Blob가 수정된 경우 이 헤더가 표시되지 않습니다.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status: <pending &#124; success &#124; aborted &#124; failed> 2012-02-12 이상 버전Version 2012-02-12 and newer. x-ms-copy-id로 식별된 복사 작업의 상태입니다. 다음 값을 포함합니다.State of the copy operation identified by x-ms-copy-id, with these values:

- success: 복사가 완료 되었습니다.- success: Copy completed successfully.
- pending: 복사가 진행 중입니다.- pending: Copy is in progress. 간헐적으로 치명적이지 않은 오류가 발생하여 복사 진행을 방해하지만 복사 작업이 실패하지 않는 경우에는 x-ms-copy-status-description을 확인합니다.Check x-ms-copy-status-description if intermittent, non-fatal errors impede copy progress but don’t cause failure.
- aborted: 복사가에서 종료 되었습니다 Abort Copy Blob .- aborted: Copy was ended by Abort Copy Blob.
- failed: 복사 하지 못했습니다.- failed: Copy failed. 자세한 내용은 x-ms-copy-status-description을 참조하십시오.See x-ms-copy-status-description for failure details.

이 Blob가 Copy Blob 작업의 대상이 아니거나 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 Blob가 수정된 경우 이 헤더가 표시되지 않습니다.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a completed Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-incremental-copy: true 2016-05-31 이상 버전Version 2016-05-31 and newer. Blob이 증분 복사 blob 인 경우 포함 됩니다.Included if the blob is incremental copy blob.
x-ms-copy-destination-snapshot:<datetime> 2016-05-31 이상 버전Version 2016-05-31 and newer. Blob이 성공 인 경우 blob이 증분 복사 blob 또는 증분 복사 스냅숏의 경우 포함 됩니다 x-ms-copy-status .Included if the blob is incremental copy blob or incremental copy snapshot, if x-ms-copy-status is success. 이 blob에 대해 마지막으로 성공한 증분 복사 스냅숏의 스냅숏 시간입니다.Snapshot time of the last successful incremental copy snapshot for this blob.
x-ms-lease-duration: <infinite &#124; fixed> blob가 임대된 경우 해당 임대가 무한 또는 고정된 기간인지 여부를 지정합니다.When a blob is leased, specifies whether the lease is of infinite or fixed duration. 2012-02-12 버전 이상을 사용하는 요청에 포함됩니다.Included for requests using version 2012-02-12 and newer.
x-ms-lease-state: <available &#124; leased &#124; expired &#124; breaking &#124; broken> blob의 임대 상태입니다.Lease state of the blob. 2012-02-12 이상 버전을 사용 하 여 수행 된 요청에 대해 포함 됩니다.Included for requests made using version 2012-02-12 and newer.
x-ms-lease-status:<locked&#124; unlocked> blob의 임대 상태입니다.The lease status of the blob.
Content-Length Blob의 크기(바이트)입니다.The size of the blob in bytes. 페이지 blob의 경우 이 헤더는 blob에 저장된 x-ms-blob-content-length 헤더 값을 반환합니다.For a page blob, this header returns the value of the x-ms-blob-content-length header that is stored with the blob.
Content-Type Blob에 대해 지정된 콘텐츠 형식입니다.The content type specified for the blob. 콘텐츠 형식이 지정되지 않은 경우 기본 콘텐츠 형식은 application/octet-stream입니다.If no content type was specified, the default content type is application/octet-stream.
Etag ETag에는 조건에 따라 작업을 수행하는 데 사용할 수 있는 값이 포함됩니다.The ETag contains a value that you can use to perform operations conditionally. 자세한 내용은 Blob 서비스 작업에 대 한 조건부 헤더 지정 을 참조 하세요.See Specifying Conditional Headers for Blob Service Operations for more information. 요청 버전이 2011-08-18 이상이면 ETag 값이 따옴표로 표시됩니다.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Content-MD5 Content-MD5 헤더가 blob에 대해 설정된 경우 이 응답 헤더가 반환되어 클라이언트가 메시지 콘텐츠의 무결성을 확인할 수 있습니다.If the Content-MD5 header has been set for the blob, this response header is returned so that the client can check for message content integrity.

2012-02-12 버전 이상에서 Put BlobPut Blob 요청에 MD5 헤더가 포함되지 않은 경우에도 블록 blob의 MD5 값을 설정합니다.In version 2012-02-12 and newer, Put Blob sets a block blob’s MD5 value even when the Put Blob request doesn’t include an MD5 header.
Content-Encoding Content-Encoding 요청 헤더가 blob에 대해 이전에 설정된 경우 해당 값이 이 헤더에 반환됩니다.If the Content-Encoding request header has previously been set for the blob, that value is returned in this header.
Content-Language Content-Language 요청 헤더가 blob에 대해 이전에 설정된 경우 해당 값이 이 헤더에 반환됩니다.If the Content-Language request header has previously been set for the blob, that value is returned in this header.
Content-Disposition Content-Disposition 요청 헤더가 blob에 대해 이전에 설정된 경우 버전 2013-08-15 이상에 대한 요청에 대해 해당 값이 이 헤더에 반환됩니다.If the Content-Disposition request header has previously been set for the blob, that value is returned in this header, for requests against version 2013-08-15 and later.

Content-Disposition 응답 헤더 필드는 응답 페이로드를 처리하는 방법에 대한 추가 정보를 제공하고 추가 메타데이터를 연결하는 데도 사용할 수 있습니다.The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. 예를 들어 attachment로 설정된 경우 사용자 에이전트가 응답을 표시해서는 안 되며 대신 다른 이름으로 저장 대화 상자를 표시해야 함을 나타냅니다.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog.
Cache-Control Cache-Control 요청 헤더가 blob에 대해 이전에 설정된 경우 해당 값이 이 헤더에 반환됩니다.If the Cache-Control request header has previously been set for the blob, that value is returned in this header.
x-ms-blob-sequence-number 페이지 blob에 대한 현재 시퀀스 번호입니다.The current sequence number for a page blob.

블록 blob 또는 추가 blob에 대해서는이 헤더가 반환 되지 않습니다.This header is not returned for block blobs or append blobs.

이 헤더는 블록 blob의 경우 반환되지 않습니다.This header is not returned for block blobs.
x-ms-request-id 이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.This header uniquely identifies the request that was made and can be used for troubleshooting the request. 자세한 내용은 API 작업 문제 해결을 참조 하세요.For more information, see Troubleshooting API Operations.
x-ms-version 요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다.Indicates the version of the Blob service used to execute the request. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.This header is returned for requests made against version 2009-09-19 and later.

Blob 서비스의 2009-09-19 버전을 사용해서 컨테이너가 공용 액세스용으로 표시된 경우 지정된 버전이 없는 익명 요청에 대해서도 이 헤더가 반환됩니다.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Date 응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Accept-Ranges: bytes 서비스에서 일부 blob 콘텐츠에 대한 요청이 지원됨을 나타냅니다.Indicates that the service supports requests for partial blob content. 2013-08-15 이상 버전을 사용 하 여 수행 된 요청에 대해 포함 됩니다.Included for requests made using version 2013-08-15 and newer.
x-ms-blob-committed-block-count Blob에 있는 커밋된 블록 수입니다.The number of committed blocks present in the blob. 이 헤더는 추가 blob에 대해서만 반환 됩니다.This header is returned only for append blobs.
x-ms-server-encrypted: true/false 2015-12-11 이상 버전Version 2015-12-11 or newer. true지정 된 알고리즘을 사용 하 여 blob 데이터 및 응용 프로그램 메타 데이터를 완전히 암호화 하는 경우이 헤더의 값은로 설정 됩니다.The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. 그렇지 않으면이 값은로 설정 됩니다 false (blob이 암호화 되지 않은 경우 또는 blob/응용 프로그램 메타 데이터의 일부만 암호화 된 경우).Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).
x-ms-encryption-key-sha256 2019-02-02 이상 버전Version 2019-02-02 or newer. 이 헤더는 blob이 고객이 제공한 키로 암호화 된 경우 반환 됩니다.This header is returned if the blob is encrypted with a customer-provided key.
x-ms-encryption-scope 2019-02-02 이상 버전Version 2019-02-02 or newer. 이 헤더는 blob이 암호화 범위를 사용 하 여 암호화 된 경우 반환 됩니다.This header is returned if the blob is encrypted with an encryption scope.
x-ms-access-tier 2017-04-17 이상 버전Version 2017-04-17 or newer. Premium storage 계정의 페이지 blob 또는 blob storage 또는 범용 v2 계정에 대 한 블록 blob 계층입니다.The tier of page blob on a premium storage account or tier of block blob on blob storage or general purpose v2 account. 허용 되는 프리미엄 페이지 blob 계층 목록은 vm에 대 한 고성능 Premium Storage 및 managed disks를 참조 하세요.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. Blob storage 또는 범용 v2 계정의 경우 유효한 값은 Hot / Cool / Archive 입니다.For blob storage or general purpose v2 account, valid values are Hot/Cool/Archive. 표준 blob 계정 블록 blob 수준 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-access-tier-inferred: true 2017-04-17 이상 버전Version 2017-04-17 and newer. Premium storage 계정의 페이지 blob에만 해당 합니다.For page blobs on a premium storage account only. Blob에서 액세스 계층을 명시적으로 설정 하지 않으면 계층은 해당 콘텐츠 길이를 기준으로 유추 되 고이 헤더는 값으로 반환 됩니다 true .If the access tier is not explicitly set on the blob, the tier is inferred based on its content length and this header will be returned with true value. Blob Storage 또는 범용 v2 계정에 대 한 블록 blob의 경우 Blob에 액세스 계층 집합이 없으면 저장소 계정 속성에서 계층을 유추 합니다.For block blobs on Blob Storage or general purpose v2 account, if the blob does not have the access tier set then we infer the tier from the storage account properties. 이 헤더는 블록 blob 계층이 유추 되는 경우에만 설정 됩니다.This header is set only if the block blob tier is inferred
x-ms-archive-status 2017-04-17 이상 버전Version 2017-04-17 or newer. Blob storage 또는 범용 v2 계정의 경우 유효한 값은 rehydrate-pending-to-hot / rehydrate-pending-to-cool 입니다.For blob storage or general purpose v2 account, valid values are rehydrate-pending-to-hot/rehydrate-pending-to-cool. Blob이 (가) 진행 중이 고 완료 되지 않은 경우 리하이드레이션가 보류 중이 고 대상 계층에도이 헤더가 있음을 나타내는이 헤더가 반환 됩니다.If the blob is being rehydrated and is not complete then this header is returned indicating that rehydrate is pending and also tells the destination tier. 표준 blob 계정 블록 blob 수준 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-access-tier-change-time 2017-04-17 이상 버전Version 2017-04-17 or newer. 이렇게 하면 개체에서 계층이 마지막으로 변경 된 것입니다.This gives the last time tier was changed on the object. 이 헤더는 블록 blob의 계층이 설정 된 경우에만 반환 됩니다.This header is returned only if tier on block blob was ever set. 날짜 형식은 RFC 1123을 따릅니다.The date format follows RFC 1123. 자세한 내용은 헤더의 Date-Time 값 표현을 참조 하십시오.For more information, see Representation of Date-Time Values in Headers. 표준 blob 계정 블록 blob 수준 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-client-request-id 이 헤더를 사용 하 여 요청 및 해당 응답의 문제를 해결할 수 있습니다.This header can be used to troubleshoot requests and corresponding responses. 이 헤더의 값은 요청에 있는 경우 헤더의 값과 같으며 x-ms-client-request-id , 값은 최대 1024 표시 ASCII 문자입니다.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. x-ms-client-request-id요청에 헤더가 없는 경우이 헤더는 응답에 표시 되지 않습니다.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.
x-ms-rehydrate-priority 2019-12-12 이상 버전Version 2019-12-12 or newer. 개체가 리하이드레이션 pending 상태 이면 리하이드레이션의 우선 순위를 사용 하 여이 헤더를 반환 합니다.If an object is in rehydrate pending state then this header is returned with priority of rehydrate. 유효한 값은 High / Standard 입니다.Valid values are High/Standard. 표준 blob 계정 블록 blob 수준 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-or-{policy-id}_{rule-id} 버전 2019-12-12 이상, 블록 blob에 대해서만 반환 됩니다.Version 2019-12-12 or newer, returned only for block blobs. policy-id 저장소 계정에 대 한 개체 복제 정책의 식별자를 나타내는 guid 값입니다.policy-id is a guid value representing the identifier of an object replication policy on the storage account. rule-id blob 컨테이너에 대 한 정책 규칙의 식별자를 나타내는 guid 값입니다.rule-id is a guid value which represents the identifier of a policy rule on the blob container. 계정을 ObjectReplication 사용 하는 경우이 헤더의 값은 지정 된 정책 및 규칙 식별자가 있는 blob의 복제 상태 (또는)를 complete 나타냅니다 failed .If the account is ObjectReplication enabled, the value of this header represents the replication status of blob with the given policy and rule identifiers, either complete or failed.
x-ms-or-policy-id 버전 2019-12-12 이상, 블록 blob에 대해서만 반환 됩니다.Version 2019-12-12 or newer, returned only for block blobs. 계정을 사용 하는 경우 ObjectReplication 이 헤더의 값은 복제를 제어 하는 정책을 나타냅니다.If the account is ObjectReplication enabled, the value of this header represents the policy that governs the replication.
x-ms-last-access-time 2020-02-10 이상 버전Version 2020-02-10 or newer. 저장소 계정의 마지막 액세스 시간 추적 정책을 기반으로 blob 데이터에 마지막으로 액세스 한 시간을 나타냅니다.Indicates the last time when the blob's data was accessed based on the storage account's last access time tracking policy. 저장소 계정에 마지막 액세스 시간 추적 정책이 없거나 정책이 사용 하지 않도록 설정 된 경우 헤더가 반환 되지 않습니다.The header will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. 저장소 계정의 마지막 액세스 시간 추적 정책을 설정 하는 방법에 대 한 자세한 내용은 Blob SERVICE API를 참조 하세요.For information about setting the storage account's last access time tracking policy, see Blob Service API.

응답 본문Response Body

없음None.

샘플 응답Sample Response

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

권한 부여Authorization

컨테이너의 ACL(액세스 제어 목록)이 blob에 대한 익명 액세스를 허용하도록 설정된 경우 클라이언트가 이 작업을 호출할 수 있습니다.If the container's access control list (ACL) is set to allow anonymous access to the blob, any client may call this operation. 컨테이너가 전용 컨테이너인 경우 계정 소유자 및 blob 읽기 권한이 있는 공유 액세스 서명을 갖는 모든 사용자가 이 작업을 수행할 수 있습니다.If the container is private, this operation can be performed by the account owner and by anyone with a Shared Access Signature that has permission to read the blob.

설명Remarks

Copy Blob 작업이 완료되었는지 확인하려면 먼저 x-ms-copy-id 헤더 값이 Copy Blob에 대한 최초 호출로 제공된 복사 ID와 일치하는지 확인합니다.To determine if a Copy Blob operation has completed, first check that the x-ms-copy-id header value matches the copy ID provided by the original call to Copy Blob. 일치할 경우 다른 응용 프로그램이 복사를 중단하고 새 Copy Blob 작업을 시작하지 않은 것입니다.A match assures that another application did not abort the copy and start a new Copy Blob operation. 그런 후 x-ms-copy-status: success 헤더를 확인합니다.Then check for the x-ms-copy-status: success header. 하지만 Lease, Put PagePut Block 작업을 제외하고 blob에 대한 모든 쓰기 작업은 blob에서 모든 x-ms-copy-* 속성을 제거합니다.However, be aware that all write operations on a blob except Lease, Put Page and Put Block operations remove all x-ms-copy-* properties from the blob. 또한 이러한 속성은 2012-02-12 이전 버전을 사용하는 Copy Blob 작업에서도 복사되지 않습니다.These properties are also not copied by Copy Blob operations that use versions before 2012-02-12.

x-ms-copy-status-description에는 Copy Blob 오류에 대한 자세한 정보가 포함됩니다.x-ms-copy-status-description contains more information about the Copy Blob failure. 다음 표에서는 x-ms-copy-status-description 값 및 해당 의미를 보여줍니다.The following table shows x-ms-copy-status-description values and their meaning.

다음 표에서는 모든 x-ms-copy-status-description 값의 세 가지 필드에 대해 설명합니다.The following table describes the three fields of every x-ms-copy-status-description value.

구성 요소Component DescriptionDescription
HTTP 상태 코드HTTP status code 오류를 나타내는 표준 세 자리 정수입니다.Standard 3-digit integer specifying the failure.
오류 코드Error code Azure에서 <ErrorCode 요소에 제공 하는 오류를 설명 하는 키워드 > 입니다.Keyword describing error that is provided by Azure in the <ErrorCode> element. <ErrorCode > 요소가 표시 되지 않으면 http 사양의 3 자리 http 상태 코드와 연결 된 표준 오류 텍스트가 포함 된 키워드가 사용 됩니다.If no <ErrorCode> element appears, a keyword containing standard error text associated with the 3-digit HTTP status code in the HTTP specification is used. 일반적인 REST API 오류 코드를 참조 하세요.See Common REST API Error Codes.
정보Information 따옴표로 표시된 오류에 대한 자세한 설명입니다.Detailed description of failure, in quotes.

다음 표에서는 일반적인 오류 시나리오의 x-ms-copy-statusx-ms-copy-status-description 값에 대해 설명합니다.The following table describes the x-ms-copy-status and x-ms-copy-status-description values of common failure scenarios.

중요

여기에 표시된 설명 텍스트는 버전 변경이 없더라도 경고 없이 변경될 수 있으므로 이 텍스트와 정확히 일치하지 않을 수 있습니다.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

시나리오Scenario x-ms-copy-status 값x-ms-copy-status value x-ms-copy-status-description 값x-ms-copy-status-description value
복사 작업이 성공적으로 완료되었습니다.Copy operation completed successfully. 성공success 비어 있음empty
사용자가 복사 작업이 완료되기 전에 작업을 중단했습니다.User aborted copy operation before it completed. 중단됨aborted 비어 있음empty
복사 작업 중 원본 blob에서 읽기를 수행할 때 오류가 발생했지만 작업이 다시 시도됩니다.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. 보류 중pending 502 잘못된 게이트웨이 "원본을 읽을 때 다시 시도 가능한 오류가 발생했습니다.502 BadGateway "Encountered a retryable error when reading the source. 다시 시도합니다.Will retry. 실패 시간: <시간 > "Time of failure: <time>"
복사 작업의 대상 blob에 쓰는 중 오류가 발생했지만 작업이 다시 시도됩니다.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. 보류 중pending 500 InternalServerError "다시 시도 가능한 오류가 발생했습니다.500 InternalServerError "Encountered a retryable error. 다시 시도합니다.Will retry. 실패 시간: <시간 > "Time of failure: <time>"
복사 작업의 원본 blob에서 읽기를 수행할 때 복구할 수 없는 오류가 발생했습니다.An unrecoverable failure occurred when reading from the source blob of a copy operation. 실패failed 404 ResourceNotFound "원본을 읽을 때 복사가 실패했습니다."404 ResourceNotFound "Copy failed when reading the source." 참고: 이 기본 오류를 보고할 때 Azure는 ResourceNotFound <ErrorCode 요소에서를 반환 합니다 > .Note: When reporting this underlying error, Azure returns ResourceNotFound in the <ErrorCode> element. 응답에 <ErrorCode > 요소가 표시 되지 않으면와 같은 HTTP 상태의 표준 문자열 표현이 NotFound 표시 됩니다.If no <ErrorCode> element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
모든 복사 작업을 제한하는 제한 시간이 경과되었습니다.The timeout period limiting all copy operations elapsed. (현재 제한 시간은 2주입니다.)(Currently the timeout period is 2 weeks.) 실패failed 500 OperationCancelled "복사에 허용된 최대 시간을 초과했습니다."500 OperationCancelled "The copy exceeded the maximum allowed time."
원본에서 읽을 때 복사 작업이 너무 자주 실패했고 최소한의 성공 시도 비율을 충족하지 않았습니다.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (이 제한 시간은 품질 수준이 매우 낮은 원본이 실패하기 전에 2주 동안 다시 시도되지 않도록 방지합니다.)(This timeout prevents retrying a very poor source over 2 weeks before failing). 실패failed 500 OperationCancelled "원본을 읽을 때 복사가 실패했습니다."500 OperationCancelled "The copy failed when reading the source."

x-ms-last-access-time 저장소 계정의 마지막 액세스 시간 추적 정책을 기반으로 blob 데이터에 액세스 한 시간을 추적 합니다.x-ms-last-access-time tracks the time when the blob's data was accessed based on the storage account's last access time tracking policy. Blob의 메타 데이터에 액세스 하면 마지막 액세스 시간이 변경 되지 않습니다.Accessing a blob's metadata does not change its last access time.

참고 항목See also

Azure Storage에 대 한 요청 권한 부여 Authorize requests to Azure Storage
상태 및 오류 코드 Status and Error Codes
Blob 서비스 오류 코드Blob Service Error Codes