Blob 배치Put Blob

Put Blob작업은 새 블록, 페이지 또는 추가 blob을 만들거나 기존 블록 blob의 콘텐츠를 업데이트 합니다.The Put Blob operation creates a new block, page, or append blob, or updates the content of an existing block blob.

기존 블록 Blob을 업데이트하면 blob에 있는 기존 메타데이터를 덮어씁니다.Updating an existing block blob overwrites any existing metadata on the blob. Put Blob에서는 부분 업데이트가 지원 되지 않습니다. 기존 blob의 내용을 새 blob의 콘텐츠로 덮어씁니다.Partial updates are not supported with Put Blob; the content of the existing blob is overwritten with the content of the new blob. 블록 blob의 콘텐츠 부분 업데이트를 수행 하려면 블록 목록 배치 작업을 사용 합니다.To perform a partial update of the content of a block blob, use the Put Block List operation.

버전 2015-02-21 이상 에서만 추가 blob을 만들 수 있습니다.Note that you can create an append blob only in version 2015-02-21 and later.

Put Blob페이지 blob 또는 추가 blob을 만들기 위해에 대 한 호출은 blob만 초기화 합니다.A call to a Put Blob to create a page blob or an append blob only initializes the blob. 페이지 blob에 콘텐츠를 추가 하려면 페이지 배치 작업을 호출 합니다.To add content to a page blob, call the Put Page operation. 추가 blob에 콘텐츠를 추가 하려면 블록 추가 작업을 호출 합니다.To add content to an append blob, call the Append Block operation.

요청Request

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

PUT 메서드 요청 URIPUT Method Request URI HTTP 버전HTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob 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:

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

저장소 에뮬레이터는 최대 2 GiB blob 크기만 지원 합니다.Note that the storage emulator only supports blob sizes up to 2 GiB.

자세한 내용은 개발 및 테스트에 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
timeout 선택 사항입니다.Optional. ComponentThe

timeout 매개 변수는 초 단위로 표시 됩니다.timeout parameter is expressed in seconds. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.For more information, see Setting Timeouts for Blob Service Operations.

요청 헤더 (모든 Blob 형식)Request Headers (All Blob Types)

다음 표에서는 모든 blob 유형에 대 한 필수 및 선택적 요청 헤더에 대해 설명 합니다.The following table describes required and optional request headers for all blob types.

요청 헤더Request header 설명Description
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. 이 요청에 사용할 작업의 버전을 지정합니다.Specifies the version of the operation to use for this request. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.For more information, see Versioning for the Azure Storage Services.
Content-Length 필수 요소.Required. 요청의 길이입니다.The length of the request.

페이지 blob 또는 추가 blob의 경우 Put blob 은 blob을 초기화 하는 데만 사용 되므로이 헤더의 값은 0으로 설정 해야 합니다.For a page blob or an append blob, the value of this header must be set to zero, as Put Blob is used only to initialize the blob. 기존 페이지 blob에 콘텐츠를 쓰려면 Put 페이지를 호출 합니다.To write content to an existing page blob, call Put Page. 추가 blob에 콘텐츠를 쓰려면 추가 블록을 호출 합니다.To write content to an append blob, call Append Block.
Content-Type 선택 사항입니다.Optional. blob의 MIME 콘텐츠 형식입니다.The MIME content type of the blob. 기본 형식은 application/octet-stream입니다.The default type is application/octet-stream.
Content-Encoding 선택 사항입니다.Optional. blob에 적용된 콘텐츠 인코딩을 지정합니다.Specifies which content encodings have been applied to the blob. Blob 리소스에 대해 Blob 가져오기 작업을 수행 하면이 값이 클라이언트에 반환 됩니다.This value is returned to the client when the Get Blob operation is performed on the blob resource. 클라이언트는 blob 콘텐츠를 디코딩하기 위해 반환된 경우 이 값을 사용할 수 있습니다.The client can use this value when returned to decode the blob content.
Content-Language 선택 사항입니다.Optional. 이 리소스에서 사용되는 자연어를 지정합니다.Specifies the natural languages used by this resource.
Content-MD5 선택 사항입니다.Optional. blob 콘텐츠의 MD5 해시입니다.An MD5 hash of the blob content. 이 해시는 전송 중 blob의 무결성을 확인하는 데 사용됩니다.This hash is used to verify the integrity of the blob during transport. 이 헤더가 지정된 경우 저장소 서비스가 도착한 해시와 전송된 해시를 확인합니다.When this header is specified, the storage service checks the hash that has arrived with the one that was sent. 두 해시가 일치하지 않으면 작업이 실패하고 오류 코드 400(잘못된 요청)이 표시됩니다.If the two hashes do not match, the operation will fail with error code 400 (Bad Request).

2012-02-12 버전 이상에서 생략된 경우 Blob 서비스는 MD5 해시를 생성합니다.When omitted in version 2012-02-12 and later, the Blob service generates an MD5 hash.

Blob 가져오기, blob 속성 가져오기BLOB 나열 의 결과는 MD5 해시를 포함 합니다.Results from Get Blob, Get Blob Properties, and List Blobs include the MD5 hash.
x-ms-content-crc64 선택 사항입니다.Optional. Blob 콘텐츠의 CRC64 해시입니다.A CRC64 hash of the blob content. 이 해시는 전송 중 blob의 무결성을 확인하는 데 사용됩니다.This hash is used to verify the integrity of the blob during transport. 이 헤더가 지정된 경우 저장소 서비스가 도착한 해시와 전송된 해시를 확인합니다.When this header is specified, the storage service checks the hash that has arrived with the one that was sent. 두 해시가 일치하지 않으면 작업이 실패하고 오류 코드 400(잘못된 요청)이 표시됩니다.If the two hashes do not match, the operation will fail with error code 400 (Bad Request). 이 헤더는 버전 02-02-2019 이상에서 지원 됩니다.This header is supported in versions 02-02-2019 or later.

콘텐츠나 crc64 헤더가 모두 있는 경우 요청이 실패 하 고 400 (잘못 된 요청)이 표시 됩니다.If both Content-MD5 and x-ms-content-crc64 headers are present, the request will fail with a 400 (Bad Request).
Cache-Control 선택 사항입니다.Optional. Blob 서비스가 이 값을 저장하지만 이를 사용하거나 수정하지 않습니다.The Blob service stores this value but does not use or modify it.
x-ms-blob-content-type 선택 사항입니다.Optional. blob의 콘텐츠 형식을 설정합니다.Set the blob’s content type.
x-ms-blob-content-encoding 선택 사항입니다.Optional. blob의 콘텐츠 인코딩을 설정합니다.Set the blob’s content encoding.
x-ms-blob-content-language 선택 사항입니다.Optional. blob의 콘텐츠 언어를 설정합니다.Set the blob's content language.
x-ms-blob-content-md5 선택 사항입니다.Optional. blob의 MD5 해시를 설정합니다.Set the blob’s MD5 hash.
x-ms-blob-cache-control 선택 사항입니다.Optional. blob의 캐시 제어를 설정합니다.Sets the blob's cache control.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> 필수 요소.Required. 만들 blob 유형 (블록 blob, 페이지 blob 또는 추가 blob)을 지정 합니다.Specifies the type of blob to create: block blob, page blob, or append blob. 추가 blob 만들기에 대 한 지원은 버전 2015-02-21 이상 에서만 사용할 수 있습니다.Support for creating an append blob is available only in version 2015-02-21 and later.
x-ms-meta-name:value 선택 사항입니다.Optional. blob과 메타데이터로 연결된 이름-값 쌍입니다.Name-value pairs associated with the blob as metadata.

버전 2009-09-19부터 메타 데이터 이름은 c # 식별자에 대 한 명명 규칙을 따라야 합니다.Note that beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers.
x-ms-encryption-scope 선택 사항입니다.Optional. 요청 콘텐츠를 암호화 하는 데 사용할 암호화 범위를 나타냅니다.Indicates the encryption scope to use to encrypt the request contents. 이 헤더는 버전 2019-02-02 이상에서 지원 됩니다.This header is supported in versions 2019-02-02 or later.
x-ms-tags 선택 사항입니다.Optional. 지정 된 쿼리 문자열 인코딩된 태그를 blob에 설정 합니다.Sets the given query-string encoded tags on the blob. 자세한 내용은 설명 부분을 참조 하십시오.See the Remarks for additional information. 버전 2019-12-12 이상에서 지원 됩니다.Supported in version 2019-12-12 and newer.
x-ms-lease-id:<ID> blob에 활성 임대가 포함된 경우 필수입니다.Required if the blob has an active lease. 활성 임대가 포함된 blob에서 이 작업을 수행하려면 이 헤더에 대해 유효한 임대 ID를 지정합니다.To perform this operation on a blob with an active lease, specify the valid lease ID for this header.
x-ms-blob-content-disposition 선택 사항입니다.Optional. blob의 Content-Disposition 헤더를 설정합니다.Sets the blob’s Content-Disposition header. 2013-08-15 이상 버전에서 사용할 수 있습니다.Available for versions 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로 설정되는 경우 사용자 에이전트가 응답을 표시하지 않는 대신 지정된 blob 이름이 아닌 파일 이름으로 다른 이름으로 저장 대화 상자를 표시해야 함을 나타냅니다.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the blob name specified.

Blob 가져오기blob 속성 가져오기 작업의 응답에는 헤더가 포함 됩니다 content-disposition .The response from the Get Blob and Get Blob Properties operations includes the content-disposition header.
Origin 선택 사항입니다.Optional. 요청을 실행한 원본을 지정합니다.Specifies the origin from which the request is issued. 이 헤더가 있으면 응답에 크로스-원본 자원 공유 헤더가 생성됩니다.The presence of this header results in cross-origin resource sharing headers on the response. 자세한 내용은 저장소 서비스에 대 한 CORS 지원 을 참조 하세요.See CORS Support for the Storage Services for details.
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.
x-ms-access-tier 선택 사항입니다.Optional. Blob에 설정할 계층을 나타냅니다.Indicates the tier to be set on blob. Premium storage 계정의 페이지 blob의 경우 2017-04-17 이상 버전 에서만 사용 합니다.For page blobs on a premium storage account only with version 2017-04-17 and newer. 페이지 blob 지원 계층의 전체 목록은 vm에 대 한 고성능 Premium Storage 및 managed disks 를 확인 하세요.Check High-performance Premium Storage and managed disks for VMs for a full list of page blob supported tiers. 블록 blob의 경우 blob storage 또는 범용 v2 계정에 대해 지원 되는 버전 2018-11-09 이상 에서만 지원 됩니다.For block blobs, supported on blob storage or general purpose v2 accounts only with version 2018-11-09 and newer. 블록 blob 계층에 유효한 값은 Hot / Cool / Archive 입니다.Valid values for block blob tiers are Hot/Cool/Archive. 블록 blob 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

이 작업은 또한 지정된 조건이 충족될 경우에만 blob을 기록하는 조건부 헤더 사용을 지원합니다.This operation also supports the use of conditional headers to write the blob only if a specified condition is met. 자세한 내용은 Blob 서비스 작업의 조건부 헤더 지정을 참조하세요.For more information, see Specifying Conditional Headers for Blob Service Operations.

요청 헤더(페이지 blob만 해당)Request Headers (Page Blobs Only)

다음 표에서는 페이지 blob에 대한 작업에 적용할 수 있는 요청 헤더에 대해 설명합니다.The following table describes request headers applicable only for operations on page blobs.

요청 헤더Request header 설명Description
x-ms-blob-content-length: bytes 페이지 blob의 경우 필수입니다.Required for page blobs. 이 헤더는 최대 8 TiB 페이지 blob의 최대 크기를 지정 합니다.This header specifies the maximum size for the page blob, up to 8 TiB. 페이지 blob 크기는 512바이트 경계로 정렬되어야 합니다.The page blob size must be aligned to a 512-byte boundary.

블록 blob 또는 추가 blob에 대해이 헤더가 지정 된 경우 Blob service는 상태 코드 400 (잘못 된 요청)을 반환 합니다.If this header is specified for a block blob or an append blob, the Blob service returns status code 400 (Bad Request).
x-ms-blob-sequence-number: <num> 선택 사항입니다.Optional. 페이지 blob에 대해서만 설정됩니다.Set for page blobs only. 시퀀스 번호는 요청 추적을 위해 사용할 수 있는 사용자 제어 값입니다.The sequence number is a user-controlled value that you can use to track requests. 시퀀스 번호 값은 0에서 2^63 - 1 사이여야 합니다. 기본값은 0입니다.The value of the sequence number must be between 0 and 2^63 - 1.The default value is 0.
x-ms-access-tier 2017-04-17 이상 버전Version 2017-04-17 and newer. Premium storage 계정의 페이지 blob에만 해당 합니다.For page blobs on a premium storage account only. Blob에 설정할 계층을 지정 합니다.Specifies the tier to be set on the blob. 지원 되는 계층의 전체 목록은 vm에 대 한 고성능 Premium Storage 및 managed disks 를 확인 하세요.Check High-performance Premium Storage and managed disks for VMs for a full list of supported 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.

요청 헤더 (고객이 제공한 암호화 키)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 encrypt a blob with a customer-provided key. 고객이 제공한 키 (및 해당 헤더 집합)를 사용 하는 암호화는 선택 사항입니다.Encryption with a customer-provided key (and the corresponding set of headers) is optional.

요청 헤더Request header 설명Description
x-ms-encryption-key 필수 요소.Required. B a s e 64로 인코딩된 AES-256 암호화 키입니다.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 필수 요소.Required. 암호화 키의 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

블록 blob의 경우 요청 본문에는 blob 콘텐츠가 포함됩니다.For a block blob, the request body contains the content of the blob.

페이지 blob 또는 추가 blob의 경우 요청 본문은 비어 있습니다.For a page blob or an append blob, the request body is empty.

샘플 요청Sample Request

다음 예에서는 블록 Blob을 만드는 요청을 보여줍니다.The following example shows a request to create a block blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world  
  

이 예제 요청은 페이지 Blob을 만들고 해당 최대 크기를 1024바이트로 지정합니다.This sample request creates a page blob and specifies its maximum size as 1024 bytes. 페이지 blob에 콘텐츠를 추가 하려면 Put 페이지 를 호출 해야 합니다.Note that you must call Put Page to add content to a page blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0  

이 샘플 요청은 추가 blob을 만듭니다.This sample request creates an append blob. 추가 블록 을 호출 하 여 추가 blob에 콘텐츠를 추가 해야 합니다.Note that you must call Append Block to add content to the append blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0  
  

응답Response

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

상태 코드Status Code

작업에 성공하면 상태 코드 201(만들어짐)이 반환됩니다.A successful operation returns status code 201 (Created).

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

응답 헤더Response Headers

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

응답 헤더Response header DescriptionDescription
ETag ETag에는 클라이언트가 PUT 요청 헤더를 사용하여 조건부 If-Match 작업을 수행하는 데 사용할 수 있는 값이 포함됩니다.The ETag contains a value that the client can use to perform conditional PUT operations by using the If-Match request header. 요청 버전이 2011-08-18 이상이면 ETag 값이 따옴표로 표시됩니다.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Last-Modified Blob을 마지막으로 수정한 날짜/시간입니다.The date/time that the blob was last modified. 날짜 형식은 RFC 1123을 따릅니다.The date format follows RFC 1123. 자세한 내용은 헤더의 날짜-시간 값 표현을 참조 하십시오.For more information, see Representation of Date-Time Values in Headers.

blob의 메타 데이터 또는 속성에 대한 업데이트를 포함하여 blob에 대해 쓰기 작업을 수행할 때마다 blob의 마지막 수정 시간이 변경됩니다.Any write operation on the blob (including updates on the blob's metadata or properties) changes the last modified time of the blob.
Content-MD5 이 헤더는 클라이언트가 메시지 콘텐츠의 무결성을 확인할 수 있도록 블록 blob에 대해 반환됩니다.This header is returned for a block blob so the client can check the integrity of message content. 반환된 Content-MD5 값은 Blob 서비스에서 계산됩니다.The Content-MD5 value returned is computed by the Blob service. 2012-02-12 버전 이상에서는 요청에 Content-MD5 또는 x-ms-blob-content-md5 헤더가 포함되지 않더라도 이 헤더가 반환됩니다.In version 2012-02-12 and later, this header is returned even when the request does not include Content-MD5 or x-ms-blob-content-md5 headers.
x-ms-content-crc64 이 헤더는 클라이언트가 메시지 콘텐츠의 무결성을 확인할 수 있도록 블록 blob에 대해 반환됩니다.This header is returned for a block blob so the client can check the integrity of message content. 반환된 x-ms-content-crc64 값은 Blob 서비스에서 계산됩니다.The x-ms-content-crc64 value returned is computed by the Blob service. 이 헤더는 항상 버전 2019-02-02부터 반환 됩니다.This header will always be returned starting from version 2019-02-02.
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.
Date 응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Access-Control-Allow-Origin 요청에 Origin 헤더가 포함되고 CORS가 일치 규칙과 함께 설정된 경우 반환됩니다.Returned if the request includes an Origin header and CORS is enabled with a matching rule. 일치할 경우 이 헤더는 원본 요청 헤더의 값을 반환합니다.This header returns the value of the origin request header in case of a match.
Access-Control-Expose-Headers 요청에 Origin 헤더가 포함되고 CORS가 일치 규칙과 함께 설정된 경우 반환됩니다.Returned if the request includes an Origin header and CORS is enabled with a matching rule. 클라이언트 또는 요청 실행자에 노출될 응답 헤더의 목록을 반환합니다.Returns the list of response headers that are to be exposed to the client or issuer of the request.
Access-Control-Allow-Credentials 요청에 Origin 헤더가 포함되고 CORS가 모든 원본을 허용하지 않는 일치 규칙과 함께 설정된 경우 반환됩니다.Returned if the request includes an Origin header and CORS is enabled with a matching rule that does not allow all origins. 이 헤더는 true로 설정됩니다.This header will be set to true.
x-ms-request-server-encrypted: true/false 2015-12-11 이상 버전Version 2015-12-11 or newer. true지정 된 알고리즘을 사용 하 여 요청의 내용이 성공적으로 암호화 되 면이 헤더의 값이로 설정 되 고, 그렇지 않으면로 설정 됩니다 false .The value of this header is set to true if the contents of the request are successfully encrypted using the specified algorithm, and false otherwise.
x-ms-encryption-key-sha256 2019-02-02 이상 버전Version 2019-02-02 or newer. 요청에서 암호화에 고객이 제공한 키를 사용 하 여 요청의 콘텐츠가 제공 된 키를 사용 하 여 성공적으로 암호화 되었는지 확인할 수 있는 경우이 헤더가 반환 됩니다.This header is returned if the request used a customer-provided key for encryption, so the client can ensure the contents of the request are successfully encrypted using the provided key.
x-ms-encryption-scope 2019-02-02 이상 버전Version 2019-02-02 or newer. 요청에서 암호화 범위를 사용 하 여 요청의 콘텐츠가 암호화 범위를 사용 하 여 성공적으로 암호화 되었는지 확인할 수 있도록 요청에서 암호화 범위를 사용 하는 경우이 헤더가 반환 됩니다.This header is returned if the request used an encryption scope, so the client can ensure the contents of the request are successfully encrypted using the encryption scope.
x-ms-version-id: <DateTime> 2019-12-12 이상 버전Version 2019-12-12 and newer. 이 헤더는 DateTime blob을 고유 하 게 식별 하는 불투명 값을 반환 합니다.This header returns an opaque DateTime value that uniquely identifies the blob. 이 헤더의 값은 blob의 버전을 나타내며 blob에 액세스 하는 후속 요청에 사용 될 수 있습니다.The value of this header indicates the Version of the blob, and may be used in subsequent requests to access the blob.

응답 본문Response Body

없음None.

샘플 응답Sample Response

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>  

권한 부여Authorization

이 작업은 계정 소유자 및 이 blob 또는 해당 컨테이너에 쓸 수 있는 권한이 있는 공유 액세스 서명을 가진 모든 클라이언트가 호출할 수 있습니다.This operation can be called by the account owner and by any client with a shared access signature that has permission to write to this blob or its container.

요청에서 요청 헤더를 사용 하 여 태그를 지정 하는 경우 x-ms-tags 호출자는 Blob 태그 설정 작업의 권한 부여 요구 사항을 충족 해야 합니다.If a request specifies tags with the x-ms-tags request header, the caller must meet the authorization requirements of the Set Blob Tags operation.

설명Remarks

Blob을 만들 때 헤더의 값을 지정 하 여 blob이 블록 blob, 추가 blob 또는 페이지 blob 인지 여부를 지정 해야 합니다 x-ms-blob-type .When you create a blob, you must specify whether it is a block blob, append blob, or page blob by specifying the value of the x-ms-blob-type header. Blob을 만든 후에는 삭제하고 다시 만들지 않는 한 blob 유형을 변경할 수 없습니다.Once a blob has been created, the type of the blob cannot be changed unless it is deleted and re-created.

를 통해 만든 블록 blob의 최대 크기는 Put Blob 2016-05-31 이상 버전의 경우 256 mib이 고 이전 버전의 경우 64 mib입니다.The maximum size for a block blob created via Put Blob is 256 MiB for version 2016-05-31 and later, and 64 MiB for older versions. Blob이 2016-05-31 이상 버전의 경우 256 MiB 보다 크거나 이전 버전의 경우 64 MiB 인 경우 해당 blob을 블록 집합으로 업로드 해야 합니다.If your blob is larger than 256 MiB for version 2016-05-31 and later, or 64 MiB for older versions, you must upload it as a set of blocks. 자세한 내용은 Put BlockPut Block Listoperations를 참조하세요.For more information, see the Put Block and Put Block Listoperations. Put BlobBlob을 블록 집합으로 업로드 하는 경우에도를 호출할 필요가 없습니다.It's not necessary to also call Put Blob if you upload the blob as a set of blocks.

버전 2016-05-31 이상에 대해 256 MiB 보다 큰 블록 blob을 업로드 하려고 시도 하 고 이전 버전의 경우 64 MiB 또는 8 TiB 보다 큰 페이지 blob을 업로드 하려고 하면 서비스에서 상태 코드 413 (요청 엔터티 너무 큼)을 반환 합니다.If you attempt to upload a block blob that is larger than 256 MiB for version 2016-05-31 and later, and 64 MiB for older versions, or a page blob larger than 8 TiB, the service returns status code 413 (Request Entity Too Large). 또한 Blob 서비스에서 허용된 최대 blob 크기(바이트)가 포함된 추가 오류 정보가 응답으로 반환됩니다.The Blob service also returns additional information about the error in the response, including the maximum blob size permitted in bytes.

새 페이지 blob을 만들려면 먼저를 호출 하 여 blob을 초기화 하 Put Blob 고 최대 크기를 최대 8 TiB 지정 합니다.To create a new page blob, first initialize the blob by calling Put Blob and specify its maximum size, up to 8 TiB. 페이지 Blob을 만들 때 요청 본문에 콘텐츠를 포함하지 마세요.When creating a page blob, do not include content in the request body. Blob을 만든 후에는 Put 페이지 를 호출 하 여 blob에 콘텐츠를 추가 하거나 수정 합니다.Once the blob has been created, call Put Page to add content to the blob or to modify it.

새 추가 blob을 만들려면를 호출 Put Blob 하 여 콘텐츠 길이가 0 바이트인 blob을 만듭니다.To create a new append blob, call Put Blob to create a blob with a content-length of zero bytes. 추가 blob을 만든 후에는 추가 블록 을 호출 하 여 blob의 끝에 콘텐츠를 추가 합니다.Once the append blob is created, call Append Block to add content to the end of the blob.

기존 Blob을 동일한 이름으로 덮어쓰기 위해 Put Blob를 호출해도 원래 blob과 연결된 모든 스냅숏은 보존됩니다.If you call Put Blob to overwrite an existing blob with the same name, any snapshots associated with the original blob are retained. 연결 된 스냅숏을 제거 하려면 먼저 Blob 삭제 를 호출한 다음 Put Blob blob을 다시 만듭니다.To remove associated snapshots, call Delete Blob first, then Put Blob to re-create the blob.

blob에는 표준 HTTP 헤더와 연결된 값을 저장하는 데 사용할 수 있는 사용자 지정 속성(헤더를 통해 설정)이 있습니다.A blob has custom properties (set via headers) that you can use to store values associated with standard HTTP headers. 이러한 값은 나중에 Blob 속성 가져오기를 호출 하 여 읽거나 blob 속성 설정을 호출 하 여 수정할 수 있습니다.These values can subsequently be read by calling Get Blob Properties, or modified by calling Set Blob Properties. 사용자 지정 속성 헤더 및 해당 표준 HTTP 헤더는 다음 표에 나열되어 있습니다.The custom property headers and corresponding standard HTTP header are listed in the following table:

HTTP 헤더HTTP header 사용자 지정 blob 속성 헤더Custom blob property header
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

blob에 이러한 속성 값을 유지하는 설정에 대한 의미 체계는 다음과 같습니다.The semantics for setting persisting these property values with the blob as follows:

  • x-ms-blob 접두사에 표시된 대로 클라이언트가 사용자 지정 속성 헤더를 지정할 경우 이 값이 blob에 저장됩니다.If the client specifies a custom property header, as indicated by the x-ms-blob prefix, this value is stored with the blob.

  • 클라이언트가 표준 HTTP 헤더를 지정하지만 사용자 지정 속성 헤더는 지정하지 않을 경우, blob과 연결된 해당 사용자 지정 속성에 값이 저장되고 Get Blob Properties에 대한 호출로 값이 반환됩니다.If the client specifies a standard HTTP header, but not the custom property header, the value is stored in the corresponding custom property associated with the blob, and is returned by a call to Get Blob Properties. 예를 들어 클라이언트가 요청에 Content-Type 헤더를 설정하면 그 값이 blob의 x-ms-blob-content-type 속성에 저장됩니다.For example, if the client sets the Content-Type header on the request, that value is stored in the blob's x-ms-blob-content-type property.

  • 클라이언트가 표준 HTTP 헤더와 해당 속성 헤더를 동일한 요청에 설정하면 PUT 요청에서 표준 HTTP 헤더에 대해 제공된 값이 사용되지만 사용자 지정 속성 헤더에 대해 지정된 값이 blob에 유지되어 이후 GET 요청으로 반환됩니다.If the client sets both the standard HTTP header and the corresponding property header on the same request, the PUT request uses the value provided for the standard HTTP header, but the value specified for the custom property header is persisted with the blob and returned by subsequent GET requests.

헤더에 태그를 제공 하는 경우 x-ms-tags 쿼리 문자열로 인코딩해야 합니다.If tags are provided in the x-ms-tags header, they must be query-string encoded. 태그 키 및 값은 Set Blob 태그에 지정 된 대로 명명 및 길이 요구 사항을 준수 해야 합니다.Tag keys and values must conform to the naming and length requirements as specified in Set Blob Tags. 또한 헤더에는 x-ms-tags 최대 2kb의 태그가 포함 될 수 있습니다.Further, the x-ms-tags header may contain up to 2kb of tags. 추가 태그가 필요한 경우 Blob 태그 설정 작업을 사용 합니다.If more tags are required, use the Set Blob Tags operation.

blob에 활성 임대가 포함된 경우 클라이언트가 Blob을 덮어쓰려면 요청에 유효한 임대 ID를 지정해야 합니다.If the blob has an active lease, the client must specify a valid lease ID on the request in order to overwrite the blob. 클라이언트가 임대 ID를 지정하지 않거나 잘못된 임대 ID를 지정할 경우 Blob service가 상태 코드 412(전제 조건 실패)를 반환합니다.If the client does not specify a lease ID, or specifies an invalid lease ID, the Blob service returns status code 412 (Precondition Failed). 클라이언트가 임대 ID를 지정하지만 blob에 활성 임대가 없는 경우에도 Blob 서비스가 상태 코드 412(전제 조건 실패)를 반환합니다.If the client specifies a lease ID but the blob does not have an active lease, the Blob service also returns status code 412 (Precondition Failed). 클라이언트가 아직 존재하지 않는 blob에 대한 임대 ID를 지정하는 경우, Blob 서비스는 2013-08-15 이상 버전에 대해 수행된 요청의 경우 상태 코드 412(전제 조건 실패)를 반환하고 이전 버전의 경우 상태 코드 201(만들어짐)을 반환합니다.If the client specifies a lease ID on a blob that does not yet exist, the Blob service will return status code 412 (Precondition Failed) for requests made against version 2013-08-15 and later; for prior versions the Blob service will return status code 201 (Created).

Put Blob 작업으로 활성 임대가 포함된 기존 Blob을 덮어쓴 경우에는 임대가 만료되거나 해제될 때까지 업데이트된 blob에 지속됩니다.If an existing blob with an active lease is overwritten by a Put Blob operation, the lease persists on the updated blob, until it expires or is released.

Put Blob작업은 완료 하는 데 MiB 당 10 분이 허용 됩니다.A Put Blob operation is permitted 10 minutes per MiB to complete. 작업이 평균 MiB 당 10 분 이상 소요 되는 경우 작업이 시간 초과 됩니다.If the operation is taking longer than 10 minutes per MiB on average, the operation will timeout.

보관 된 blob을 덮어쓰는 작업이 실패 하 고 blob을 덮어쓰는 것은 hot / cool x-ms 액세스 계층 헤더가 제공 되지 않은 경우 이전 blob의 계층을 상속 합니다.Overwriting an archived blob will fail and overwriting a hot/cool blob will inherit the tier from the old blob if x-ms-access-tier header is not provided.

참고 항목See Also

Azure Storage에 대 한 요청 권한 부여 Authorize requests to Azure Storage
상태 및 오류 코드 Status and Error Codes
Blob 서비스 오류 코드 Blob Service Error Codes
Blob 서비스 작업에 대한 제한 시간 설정Setting Timeouts for Blob Service Operations