Coloque BlobPut Blob

A Put Blob operação cria um novo bloco, página ou apêndice blob, ou atualiza o conteúdo de uma bolha de bloco existente.The Put Blob operation creates a new block, page, or append blob, or updates the content of an existing block blob.

A atualização de uma bolha de bloco existente substitui quaisquer metadados existentes na bolha.Updating an existing block blob overwrites any existing metadata on the blob. As atualizações parciais não são suportadas com Put Blob; o conteúdo da bolha existente é substituído com o conteúdo da nova bolha.Partial updates are not supported with Put Blob; the content of the existing blob is overwritten with the content of the new blob. Para realizar uma atualização parcial do conteúdo de uma bolha de bloco, utilize a operação 'Lista de Blocos' de colocação.To perform a partial update of the content of a block blob, use the Put Block List operation.

Note que só pode criar uma bolha de apêndice na versão 2015-02-21 e posteriormente.Note that you can create an append blob only in version 2015-02-21 and later.

Uma chamada para um Put Blob para criar uma bolha de página ou uma bolha de apêndice apenas inicializa a bolha.A call to a Put Blob to create a page blob or an append blob only initializes the blob. Para adicionar conteúdo a uma bolha de página, ligue para a operação Página Put.To add content to a page blob, call the Put Page operation. Para adicionar conteúdo a uma bolha de apêndice, ligue para a operação do Bloco de Apêndice.To add content to an append blob, call the Append Block operation.

PedirRequest

O Put Blob pedido pode ser construído da seguinte forma.The Put Blob request may be constructed as follows. HTTPS é recomendado.HTTPS is recommended. Substitua a minha conta pelo nome da sua conta de armazenamento:Replace myaccount with the name of your storage account:

PUT Método Request URIPUT Method Request URI Versão HTTPHTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1HTTP/1.1

Serviço de armazenamento emulsionado URIEmulated storage service URI

Ao fazer um pedido contra o serviço de armazenamento emulsionado, especifique o nome de anfitrião emulador e a porta de serviço Blob como 127.0.0.1:10000 , seguido do nome da conta de armazenamento emulada: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 Método Request URIPUT Method Request URI Versão HTTPHTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1HTTP/1.1

Note que o emulador de armazenamento só suporta tamanhos de bolhas até 2 GiB.Note that the storage emulator only supports blob sizes up to 2 GiB.

Para obter mais informações, consulte a utilização do Emulador de Armazenamento Azure para desenvolvimento e testes.For more information, see Using the Azure Storage Emulator for Development and Testing.

Parâmetros do URIURI Parameters

Os seguintes parâmetros adicionais podem ser especificados no pedido URI.The following additional parameters may be specified on the request URI.

ParâmetroParameter DescriçãoDescription
timeout Opcional.Optional. OThe

O parâmetro de tempo limite é expresso em segundos.timeout parameter is expressed in seconds. Para obter mais informações, consulte os intervalos de definição para operações de serviço de blob.For more information, see Setting Timeouts for Blob Service Operations.

Pedido cabeçalhos (todos os tipos de bolhas)Request Headers (All Blob Types)

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais para todos os tipos de bolhas.The following table describes required and optional request headers for all blob types.

Cabeçalho do pedidoRequest header DescriçãoDescription
Authorization Necessário.Required. Especifica o esquema de autorização, nome da conta e assinatura.Specifies the authorization scheme, account name, and signature. Para mais informações, consulte Os pedidos autorizados para o Armazenamento Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Necessário.Required. Especifica a Hora Universal Coordenada (UTC) do pedido.Specifies the Coordinated Universal Time (UTC) for the request. Para mais informações, consulte Os pedidos autorizados para o Armazenamento Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version Requerido para todos os pedidos autorizados.Required for all authorized requests. Especifica a versão da operação a utilizar para este pedido.Specifies the version of the operation to use for this request. Para obter mais informações, consulte a versão para os Serviços de Armazenamento Azure.For more information, see Versioning for the Azure Storage Services.
Content-Length Necessário.Required. A duração do pedido.The length of the request.

Para uma bolha de página ou uma bolha de apêndice, o valor deste cabeçalho deve ser definido para zero, uma vez que o Put Blob é utilizado apenas para inicializar a bolha.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. Para escrever conteúdo para uma bolha de página existente, ligue para Put Page.To write content to an existing page blob, call Put Page. Para escrever conteúdo a uma bolha de apêndice, ligue para o Append Block.To write content to an append blob, call Append Block.
Content-Type Opcional.Optional. O tipo de conteúdo MIME da bolha.The MIME content type of the blob. O tipo predefinido é application/octet-stream .The default type is application/octet-stream.
Content-Encoding Opcional.Optional. Especifica quais as codificações de conteúdo que foram aplicadas à bolha.Specifies which content encodings have been applied to the blob. Este valor é devolvido ao cliente quando a operação Get Blob é realizada no recurso blob.This value is returned to the client when the Get Blob operation is performed on the blob resource. O cliente pode usar este valor quando devolvido para descodificar o conteúdo da bolha.The client can use this value when returned to decode the blob content.
Content-Language Opcional.Optional. Especifica as línguas naturais utilizadas por este recurso.Specifies the natural languages used by this resource.
Content-MD5 Opcional.Optional. Um haxixe MD5 do conteúdo da bolha.An MD5 hash of the blob content. Este haxixe é utilizado para verificar a integridade da bolha durante o transporte.This hash is used to verify the integrity of the blob during transport. Quando este cabeçalho é especificado, o serviço de armazenamento verifica o haxixe que chegou com o que foi enviado.When this header is specified, the storage service checks the hash that has arrived with the one that was sent. Se os dois hashes não coincidirem, a operação falhará com o código de erro 400 (Mau Pedido).If the two hashes do not match, the operation will fail with error code 400 (Bad Request).

Quando omitido na versão 2012-02-12 e mais tarde, o serviço Blob gera um haxixe MD5.When omitted in version 2012-02-12 and later, the Blob service generates an MD5 hash.

Os resultados da Get Blob, Get Blob Propertiese List Blobs incluem o haxixe MD5.Results from Get Blob, Get Blob Properties, and List Blobs include the MD5 hash.
x-ms-content-crc64 Opcional.Optional. Um haxixe CRC64 do conteúdo da bolha.A CRC64 hash of the blob content. Este haxixe é utilizado para verificar a integridade da bolha durante o transporte.This hash is used to verify the integrity of the blob during transport. Quando este cabeçalho é especificado, o serviço de armazenamento verifica o haxixe que chegou com o que foi enviado.When this header is specified, the storage service checks the hash that has arrived with the one that was sent. Se os dois hashes não coincidirem, a operação falhará com o código de erro 400 (Mau Pedido).If the two hashes do not match, the operation will fail with error code 400 (Bad Request). Este cabeçalho é suportado nas versões 02-02-2019 ou posterior.This header is supported in versions 02-02-2019 or later.

Se estiverem presentes os cabeçalhos Content-MD5 e x-ms-content-crc64, o pedido falhará com um 400 (Mau Pedido).If both Content-MD5 and x-ms-content-crc64 headers are present, the request will fail with a 400 (Bad Request).
Cache-Control Opcional.Optional. O serviço Blob armazena este valor mas não o utiliza nem modifica.The Blob service stores this value but does not use or modify it.
x-ms-blob-content-type Opcional.Optional. Descreva o tipo de conteúdo da bolha.Set the blob’s content type.
x-ms-blob-content-encoding Opcional.Optional. Descodigem o conteúdo da bolha.Set the blob’s content encoding.
x-ms-blob-content-language Opcional.Optional. Descreva o conteúdo da bolha.Set the blob's content language.
x-ms-blob-content-md5 Opcional.Optional. Coloque o hash MD5 da bolha.Set the blob’s MD5 hash.
x-ms-blob-cache-control Opcional.Optional. Define o controlo de cache da bolha.Sets the blob's cache control.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Necessário.Required. Especifica o tipo de bolha para criar: bloco blob, blob de página ou bolha de apêndice.Specifies the type of blob to create: block blob, page blob, or append blob. O suporte para a criação de um apêndice blob só está disponível na versão 2015-02-21 e posteriormente.Support for creating an append blob is available only in version 2015-02-21 and later.
x-ms-meta-name:value Opcional.Optional. Pares de valor de nome associados à bolha como metadados.Name-value pairs associated with the blob as metadata.

Note que, a partir da versão 2009-09-19, os nomes dos metadados devem respeitar as regras de nomeação dos identificadores C#.Note that beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers.
x-ms-encryption-scope Opcional.Optional. Indica o âmbito de encriptação a utilizar para encriptar o conteúdo do pedido.Indicates the encryption scope to use to encrypt the request contents. Este cabeçalho é suportado nas versões 2019-02-02 ou posterior.This header is supported in versions 2019-02-02 or later.
x-ms-tags Opcional.Optional. Define as etiquetas codificadas de fio de consulta na bolha.Sets the given query-string encoded tags on the blob. Consulte os Comentários para obter informações adicionais.See the Remarks for additional information. Suportado na versão 2019-12-12 e mais recente.Supported in version 2019-12-12 and newer.
x-ms-lease-id:<ID> Necessário se a bolha tiver um arrendamento ativo.Required if the blob has an active lease. Para realizar esta operação numa bolha com um arrendamento ativo, especifique o ID de locação válido para este cabeçalho.To perform this operation on a blob with an active lease, specify the valid lease ID for this header.
x-ms-blob-content-disposition Opcional.Optional. Define o cabeçalho da Content-Disposition bolha.Sets the blob’s Content-Disposition header. Disponível para versões 2013-08-15 e posteriormente.Available for versions 2013-08-15 and later.

O Content-Disposition campo do cabeçalho de resposta transmite informações adicionais sobre como processar a carga útil de resposta, e também pode ser usado para anexar metadados adicionais.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. Por exemplo, se definido para attachment , indica que o agente de utilizador não deve apresentar a resposta, mas sim mostrar um diálogo Save As com um nome de ficheiro diferente do nome blob especificado.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.

A resposta das operações Get Blob e Get Blob Properties inclui o content-disposition cabeçalho.The response from the Get Blob and Get Blob Properties operations includes the content-disposition header.
Origin Opcional.Optional. Especifica a origem a partir da qual o pedido é emitido.Specifies the origin from which the request is issued. A presença deste cabeçalho resulta em cabeçalhos de partilha de recursos de origem cruzada na resposta.The presence of this header results in cross-origin resource sharing headers on the response. Consulte o suporte do CORS para os serviços de armazenamento para mais informações.See CORS Support for the Storage Services for details.
x-ms-client-request-id Opcional.Optional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é gravado nos registos de análise quando o registo de análise de armazenamento está ativado.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. Recomenda-se a utilização deste cabeçalho para correlacionar as atividades do lado do cliente com os pedidos recebidos pelo servidor.Using this header is highly recommended for correlating client-side activities with requests received by the server. Para obter mais informações, consulte sobre o registo de analíticos de armazenamento e registo de Azure: Utilização de Registos para rastrear pedidos de armazenamento.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.
x-ms-access-tier Opcional.Optional. Indica que o nível a ser colocado na bolha.Indicates the tier to be set on blob. Para bolhas de página numa conta de armazenamento premium apenas com a versão 2017-04-17 e mais recente.For page blobs on a premium storage account only with version 2017-04-17 and newer. Verifique o armazenamento premium de alto desempenho e os discos geridos para VMs para obter uma lista completa de camadas suportadas por blob de página.Check High-performance Premium Storage and managed disks for VMs for a full list of page blob supported tiers. Para blobs de blocos, suportados em blob armazenamento ou contas v2 de finalidade geral apenas com a versão 2018-11-09 e mais recentes.For block blobs, supported on blob storage or general purpose v2 accounts only with version 2018-11-09 and newer. Os valores válidos para os níveis de bloco blob são Hot / Cool / Archive .Valid values for block blob tiers are Hot/Cool/Archive. Para obter informações detalhadas sobre o nível do bloco blob consulte os níveis de armazenamento quente, fresco e de arquivo.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Esta operação também suporta a utilização de cabeçalhos condicional para escrever a bolha apenas se uma condição especificada for satisfeita.This operation also supports the use of conditional headers to write the blob only if a specified condition is met. Para obter mais informações, consulte especificar cabeçalhos condicional para operações de serviço de bolhas.For more information, see Specifying Conditional Headers for Blob Service Operations.

Pedido cabeçalhos (Apenas blobs de página)Request Headers (Page Blobs Only)

A tabela seguinte descreve os cabeçalhos de pedido aplicáveis apenas para operações em bolhas de página.The following table describes request headers applicable only for operations on page blobs.

Cabeçalho do pedidoRequest header DescriçãoDescription
x-ms-blob-content-length: bytes Necessário para bolhas de página.Required for page blobs. Este cabeçalho especifica o tamanho máximo para a bolha de página, até 8 TiB.This header specifies the maximum size for the page blob, up to 8 TiB. O tamanho da bolha da página deve estar alinhado com um limite de 512 byte.The page blob size must be aligned to a 512-byte boundary.

Se este cabeçalho for especificado para uma bolha de bloco ou uma bolha de apêndice, o código de estado do serviço Blob 400 (Mau Pedido).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> Opcional.Optional. Configurar apenas para bolhas de página.Set for page blobs only. O número da sequência é um valor controlado pelo utilizador que pode utilizar para rastrear pedidos.The sequence number is a user-controlled value that you can use to track requests. O valor do número de sequência deve estar entre 0 e 2^63 - 1.O valor predefinido é 0.The value of the sequence number must be between 0 and 2^63 - 1.The default value is 0.
x-ms-access-tier Versão 2017-04-17 e mais recente.Version 2017-04-17 and newer. Para bolhas de página apenas numa conta de armazenamento premium.For page blobs on a premium storage account only. Especifica o nível a definir na bolha.Specifies the tier to be set on the blob. Verifique o armazenamento premium de alto desempenho e os discos geridos para VMs para obter uma lista completa de níveis suportados.Check High-performance Premium Storage and managed disks for VMs for a full list of supported tiers.
x-ms-client-request-id Este cabeçalho pode ser usado para resolver pedidos e respostas correspondentes.This header can be used to troubleshoot requests and corresponding responses. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor for no máximo 1024 caracteres ASCII visíveis.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. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Pedido cabeçalhos (chaves de encriptação fornecidas pelo cliente)Request Headers (Customer-provided encryption keys)

Começando pela versão 2019-02-02, os seguintes cabeçalhos podem ser especificados no pedido de encriptação de uma bolha com uma chave fornecida pelo cliente.Beginning with version 2019-02-02, the following headers may be specified on the request to encrypt a blob with a customer-provided key. A encriptação com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional.Encryption with a customer-provided key (and the corresponding set of headers) is optional.

Cabeçalho do pedidoRequest header DescriçãoDescription
x-ms-encryption-key Necessário.Required. A chave de encriptação AES-256 codificada pela Base64.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 Necessário.Required. O hash SHA256 codificado pela Base64 da chave de encriptação.The Base64-encoded SHA256 hash of the encryption key.
x-ms-encryption-algorithm: AES256 Necessário.Required. Especifica o algoritmo a utilizar para encriptação.Specifies the algorithm to use for encryption. O valor deste cabeçalho deve ser AES256 .The value of this header must be AES256.

Corpo do PedidoRequest Body

Para uma bolha de bloco, o corpo de pedido contém o conteúdo da bolha.For a block blob, the request body contains the content of the blob.

Para uma bolha de página ou uma bolha de apêndice, o corpo do pedido está vazio.For a page blob or an append blob, the request body is empty.

Pedido de AmostraSample Request

O exemplo a seguir mostra um pedido para criar uma bolha de bloco: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  
  

Este pedido de amostra cria uma bolha de página e especifica o seu tamanho máximo como 1024 bytes.This sample request creates a page blob and specifies its maximum size as 1024 bytes. Note que deve ligar para a Página Put para adicionar conteúdo a uma bolha de página: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  

Este pedido de amostra cria uma bolha de apêndice.This sample request creates an append blob. Note que deve ligar para o Append Block para adicionar conteúdo à bolha do apêndice: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  
  

RespostaResponse

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.The response includes an HTTP status code and a set of response headers.

Código de EstadoStatus Code

Uma operação bem sucedida devolve o código de estado 201 (Criado).A successful operation returns status code 201 (Created).

Para obter informações sobre códigos de estado, consulte códigos de estado e de erro.For information about status codes, see Status and Error Codes.

Cabeçalhos de RespostaResponse Headers

A resposta para esta operação inclui os seguintes cabeçalhos.The response for this operation includes the following headers. A resposta também pode incluir cabeçalhos HTTP padrão adicionais.The response can also include additional standard HTTP headers. Todos os cabeçalhos standard estão em conformidade com a especificação do protocolo HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Cabeçalho de respostaResponse header DescriçãoDescription
ETag O ETag contém um valor que o cliente pode usar para executar PUT operações condicionais utilizando o cabeçalho de If-Match pedido.The ETag contains a value that the client can use to perform conditional PUT operations by using the If-Match request header. Se a versão de pedido for 2011-08-18 ou mais recente, o valor ETag estará em cotações.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Last-Modified A data/hora em que a bolha foi modificada pela última vez.The date/time that the blob was last modified. O formato de data segue o RFC 1123.The date format follows RFC 1123. Para obter mais informações, consulte a representação dos valores da data-hora em cabeçalhos.For more information, see Representation of Date-Time Values in Headers.

Qualquer operação de escrita na bolha (incluindo atualizações nos metadados ou propriedades da bolha) altera o último tempo modificado da bolha.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 Este cabeçalho é devolvido para uma bolha de bloco para que o cliente possa verificar a integridade do conteúdo da mensagem.This header is returned for a block blob so the client can check the integrity of message content. O Content-MD5 valor devolvido é calculado pelo serviço Blob.The Content-MD5 value returned is computed by the Blob service. Na versão 2012-02-12 e posteriormente, este cabeçalho é devolvido mesmo quando o pedido não inclui Content-MD5 ou x-ms-blob-content-md5 cabeçalhos.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 Este cabeçalho é devolvido para uma bolha de bloco para que o cliente possa verificar a integridade do conteúdo da mensagem.This header is returned for a block blob so the client can check the integrity of message content. O x-ms-content-crc64 valor devolvido é calculado pelo serviço Blob.The x-ms-content-crc64 value returned is computed by the Blob service. Este cabeceamento será sempre devolvido a partir da versão 2019-02-02.This header will always be returned starting from version 2019-02-02.
x-ms-request-id Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser usado para resolver problemas no pedido.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Para obter mais informações, consulte operações de API de resolução de problemas.For more information, see Troubleshooting API Operations.
x-ms-version Indica a versão do serviço Blob utilizado para executar o pedido.Indicates the version of the Blob service used to execute the request. Este cabeçalho é devolvido para pedidos feitos contra a versão 2009-09-19 e mais tarde.This header is returned for requests made against version 2009-09-19 and later.
Date Uma data/valor de hora UTC gerado pelo serviço que indica o momento em que a resposta foi iniciada.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Access-Control-Allow-Origin Devolvido se o pedido incluir um Origin cabeçalho e o CORS estiver ativado com uma regra de correspondência.Returned if the request includes an Origin header and CORS is enabled with a matching rule. Este cabeçalho devolve o valor do cabeçalho pedido de origem em caso de correspondência.This header returns the value of the origin request header in case of a match.
Access-Control-Expose-Headers Devolvido se o pedido incluir um Origin cabeçalho e o CORS estiver ativado com uma regra de correspondência.Returned if the request includes an Origin header and CORS is enabled with a matching rule. Devolve a lista de cabeçalhos de resposta que devem ser expostos ao cliente ou emitente do pedido.Returns the list of response headers that are to be exposed to the client or issuer of the request.
Access-Control-Allow-Credentials Devolvido se o pedido incluir um Origin cabeçalho e o CORS estiver ativado com uma regra correspondente que não permite todas as origens.Returned if the request includes an Origin header and CORS is enabled with a matching rule that does not allow all origins. Este cabeçalho será definido como verdadeiro.This header will be set to true.
x-ms-request-server-encrypted: true/false Versão 2015-12-11 ou mais recente.Version 2015-12-11 or newer. O valor deste cabeçalho é definido para true se o conteúdo do pedido for encriptado com sucesso usando o algoritmo especificado, e de outra false forma.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 Versão 2019-02-02 ou mais recente.Version 2019-02-02 or newer. Este cabeçalho é devolvido se o pedido utilizar uma chave fornecida pelo cliente para encriptação, para que o cliente possa garantir que o conteúdo do pedido seja encriptado com sucesso usando a chave fornecida.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 Versão 2019-02-02 ou mais recente.Version 2019-02-02 or newer. Este cabeçalho é devolvido se o pedido for utilizado num âmbito de encriptação, para que o cliente possa garantir que o conteúdo do pedido seja encriptado com sucesso utilizando o âmbito de encriptação.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> Versão 2019-12-12 e mais recente.Version 2019-12-12 and newer. Este cabeçalho devolve um valor opaco DateTime que identifica exclusivamente a bolha.This header returns an opaque DateTime value that uniquely identifies the blob. O valor deste cabeçalho indica a versão da bolha, podendo ser utilizado em pedidos subsequentes para aceder à bolha.The value of this header indicates the Version of the blob, and may be used in subsequent requests to access the blob.

Corpo de RespostaResponse Body

Nenhum.None.

Resposta de AmostraSample 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>  

AutorizaçãoAuthorization

Esta operação pode ser chamada pelo proprietário da conta e por qualquer cliente com uma assinatura de acesso partilhado que tenha permissão para escrever a esta bolha ou ao seu recipiente.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.

Se um pedido especificar etiquetas com o cabeçalho do x-ms-tags pedido, o autor da chamada deve cumprir os requisitos de autorização da operação set Blob Tags.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.

ObservaçõesRemarks

Quando criar uma bolha, tem de especificar se se trata de uma bolha de bloco, de um apêndice ou de uma bolha de página, especificando o valor do x-ms-blob-type cabeçalho.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. Uma vez criada uma bolha, o tipo de bolha não pode ser alterado a menos que seja eliminado e recriado.Once a blob has been created, the type of the blob cannot be changed unless it is deleted and re-created.

O tamanho máximo para uma bolha de bloco criada através Put Blob é 256 MiB para a versão 2016-05-31 e mais tarde, e 64 MiB para versões mais antigas.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. Se a sua bolha for maior do que 256 MiB para a versão 2016-05-31 e mais tarde, ou 64 MiB para versões mais antigas, deve carregá-la como um conjunto de blocos.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. Para mais informações, consulte o Put Block Put Block Listoperations e.For more information, see the Put Block and Put Block Listoperations. Não é necessário também ligar Put Blob se carregar a bolha como um conjunto de blocos.It's not necessary to also call Put Blob if you upload the blob as a set of blocks.

Se tentar carregar uma bolha de bloco superior a 256 MiB para a versão 2016-05-31 e posterior, e 64 MiB para versões mais antigas, ou uma bolha de página maior que 8 TiB, o código de estado de retorna do serviço 413 (Solicite Demasiado Grande).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). O serviço Blob também retorna informações adicionais sobre o erro na resposta, incluindo o tamanho máximo de bolha permitido nos bytes.The Blob service also returns additional information about the error in the response, including the maximum blob size permitted in bytes.

Para criar uma nova bolha de página, inicialize primeiro a bolha ligando e especificando o Put Blob seu tamanho máximo, até 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. Ao criar uma bolha de página, não inclua conteúdo no organismo de pedido.When creating a page blob, do not include content in the request body. Uma vez criada a bolha, ligue para a Página Put para adicionar conteúdo à bolha ou para modificá-la.Once the blob has been created, call Put Page to add content to the blob or to modify it.

Para criar uma nova bolha de apêndice, ligue Put Blob para criar uma bolha com um comprimento de conteúdo de bytes zero.To create a new append blob, call Put Blob to create a blob with a content-length of zero bytes. Assim que a bolha do apêndice for criada, ligue para o Append Block para adicionar conteúdo ao fim da bolha.Once the append blob is created, call Append Block to add content to the end of the blob.

Se ligar Put Blob para substituir uma bolha existente com o mesmo nome, quaisquer instantâneos associados à bolha original são mantidos.If you call Put Blob to overwrite an existing blob with the same name, any snapshots associated with the original blob are retained. Para remover as imagens associadas, ligue primeiro para eliminar blob e, em seguida, Put Blob para recriar a bolha.To remove associated snapshots, call Delete Blob first, then Put Blob to re-create the blob.

Uma bolha tem propriedades personalizadas (definidas através de cabeçalhos) que pode utilizar para armazenar valores associados aos cabeçalhos HTTP padrão.A blob has custom properties (set via headers) that you can use to store values associated with standard HTTP headers. Estes valores podem ser posteriormente lidos chamando Get Blob Properties,ou modificados chamando set Blob Properties.These values can subsequently be read by calling Get Blob Properties, or modified by calling Set Blob Properties. Os cabeçalhos de propriedade personalizados e o cabeçalho HTTP padrão correspondente estão listados na tabela seguinte:The custom property headers and corresponding standard HTTP header are listed in the following table:

Cabeçalho HTTPHTTP header Cabeçalho de propriedade blob personalizadoCustom 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

A semântica para definir estes valores de propriedade com a bolha da seguinte forma:The semantics for setting persisting these property values with the blob as follows:

  • Se o cliente especificar um cabeçalho de propriedade personalizado, como indicado pelo x-ms-blob prefixo, este valor é armazenado com a bolha.If the client specifies a custom property header, as indicated by the x-ms-blob prefix, this value is stored with the blob.

  • Se o cliente especificar um cabeçalho HTTP padrão, mas não o cabeçalho de propriedade personalizado, o valor é armazenado na propriedade personalizada correspondente associada à bolha, e é devolvido por uma chamada para 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. Por exemplo, se o cliente definir o Content-Type cabeçalho no pedido, esse valor é armazenado na propriedade da x-ms-blob-content-type bolha.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.

  • Se o cliente definir tanto o cabeçalho HTTP padrão como o cabeçalho de propriedade correspondente no mesmo pedido, o pedido PUT utiliza o valor fornecido para o cabeçalho HTTP padrão, mas o valor especificado para o cabeçalho de propriedade personalizado é persistido com a bolha e devolvido por pedidos GET subsequentes.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.

Se as etiquetas forem fornecidas no x-ms-tags cabeçalho, devem ser codificadas por cadeias de consulta.If tags are provided in the x-ms-tags header, they must be query-string encoded. As teclas e valores da etiqueta devem estar em conformidade com os requisitos de nomeação e comprimento especificados nas etiquetas de manchas definidas.Tag keys and values must conform to the naming and length requirements as specified in Set Blob Tags. Além disso, o x-ms-tags cabeçalho pode conter até 2kb de etiquetas.Further, the x-ms-tags header may contain up to 2kb of tags. Se forem necessárias mais etiquetas, utilize o funcionamento de Tags De Manchas definidas.If more tags are required, use the Set Blob Tags operation.

Se a bolha tiver um arrendamento ativo, o cliente deve especificar uma identificação de locação válida no pedido para substituir a bolha.If the blob has an active lease, the client must specify a valid lease ID on the request in order to overwrite the blob. Se o cliente não especificar um ID de locação ou especificar um ID de locação inválido, o código de estado do serviço Blob 412 (Pré-condição Falhada).If the client does not specify a lease ID, or specifies an invalid lease ID, the Blob service returns status code 412 (Precondition Failed). Se o cliente especificar um ID de locação mas a bolha não tiver um arrendamento ativo, o serviço Blob também devolve o código de estado 412 (Pré-condição Falhada).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). Se o cliente especificar um ID de locação numa bolha que ainda não existe, o serviço Blob devolverá o código de estado 412 (Pré-condição Falhado) para pedidos feitos contra a versão 2013-08-15 e posteriormente; para versões anteriores, o serviço Blob devolverá o código de estado 201 (Criado).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).

Se uma bolha existente com um arrendamento ativo for substituída por uma Put Blob operação, o arrendamento persiste na bolha atualizada, até que expire ou seja libertada.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.

Uma Put Blob operação é permitida 10 minutos por MiB para completar.A Put Blob operation is permitted 10 minutes per MiB to complete. Se a operação demorar mais de 10 minutos por MiB, em média, a operação terá um tempo limite.If the operation is taking longer than 10 minutes per MiB on average, the operation will timeout.

A sobreposição de uma bolha arquivada falhará e a sobreposição de uma hot / cool bolha herdará o nível da antiga bolha se não for fornecido o cabeçalho x-ms-nível de acesso.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.

Consulte tambémSee Also

Autorizar pedidos ao Azure Storage Authorize requests to Azure Storage
Códigos de Estado e erro Status and Error Codes
Códigos de erro de serviço blob Blob Service Error Codes
Definição de intervalos para operações de serviço de blobSetting Timeouts for Blob Service Operations