Colocar Blob do URL

Artigo
10/22/2024

A operação Put Blob From URL cria um novo blob de bloco onde o conteúdo do blob é lido a partir de uma URL especificada. Esta API está disponível a partir da versão 2020-04-08.

As atualizações parciais não são suportadas com o Put Blob From URL. O conteúdo de um blob existente é substituído pelo conteúdo do novo blob. Para executar atualizações parciais no conteúdo de um blob de bloco usando uma URL de origem, use a API Put Block From URL em conjunto com Put Block List.

O tamanho do blob de origem pode ser de até um comprimento máximo de 5.000 mebibytes (MiB).

Pedir

Você pode construir o Put Blob From URL da seguinte maneira. Recomendamos que você use HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento:

URI de solicitação de método PUT	Versão HTTP
`https://myaccount.blob.core.windows.net/mycontainer/myblob`	HTTP/1.1

Solicitação de serviço de armazenamento emulado

Quando você estiver fazendo uma solicitação no serviço de armazenamento emulado, especifique o nome do host do emulador e a porta do serviço de Blob como 127.0.0.1:10000, seguido pelo nome da conta de armazenamento emulada:

URI de solicitação de método PUT	Versão HTTP
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

O emulador de armazenamento suporta tamanhos de blob de até 2 gibibytes (GiB) apenas.

Para obter mais informações, consulte Usar o emulador Azurite para o desenvolvimento do Armazenamento do Azure local.

Parâmetros de URI

Os seguintes parâmetros adicionais podem ser especificados no URI da solicitação:

Parâmetro	Description
`timeout`	Opcional. O parâmetro `timeout` é expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações de serviço de Blob.

Cabeçalhos do pedido

Os cabeçalhos de solicitação obrigatórios e opcionais são descritos na tabela a seguir:

Cabeçalho do pedido	Description
`Authorization`	Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
`Date` ou `x-ms-date`	Obrigatório. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
`x-ms-version`	Obrigatório para todos os pedidos autorizados. Especifica a versão da operação a ser usada para essa solicitação. Para obter mais informações, consulte controle de versão para os serviços de Armazenamento do Azure.
`Content-Length`	Obrigatório. Especifica o número de bytes que estão sendo transmitidos no corpo da solicitação. O valor deste cabeçalho deve ser definido como 0. Quando o comprimento não é 0, a operação falha com o código de status 400 (Solicitação incorreta).
`x-ms-copy-source:name`	Obrigatório. Especifica a URL do blob de origem. O valor pode ser uma URL de até 2 kibibytes (KiB) de comprimento que especifica um blob. O valor deve ser codificado por URL como apareceria em um URI de solicitação. O blob de origem deve ser público ou autorizado por meio de uma assinatura de acesso compartilhado. Se o blob de origem for público, nenhuma autorização será necessária para executar a operação. Se o tamanho do blob de origem for maior que 5000 MiB, ou se a origem não retornar um valor de `Content-Length` válido, a solicitação falhará com o código de status 409 (Conflito). Aqui estão alguns exemplos de URLs de objeto de origem: - `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>`
`x-ms-copy-source-authorization: <scheme> <signature>`	Opcional. Especifica o esquema de autorização e a assinatura para a fonte de cópia. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. Nota: Apenas um esquema de portador é suportado para o Microsoft Entra. Observação: Se o objeto de origem estiver acessível publicamente ou se o objeto de origem estiver em uma conta de armazenamento e você estiver usando um token SAS que está sendo passado em `x-ms-copy-source:name`, esse cabeçalho não será necessário. Este cabeçalho é suportado nas versões 2020-10-02 e posteriores.
`x-ms-blob-type: BlockBlob`	Obrigatório. Especifica o tipo de blob a ser criado, que deve ser `BlockBlob`. Se o tipo de blob não estiver `BlockBlob`, a operação falhará com o código de status 400 (Solicitação incorreta).
`Content-Type`	Opcional. O tipo de conteúdo MIME do blob. O tipo padrão é `application/octet-stream`.
`Content-Encoding`	Opcional. Especifica quais codificações de conteúdo foram aplicadas ao blob. Esse valor é retornado ao cliente quando a operação Get Blob é executada no recurso de blob. Quando esse valor é retornado, o cliente pode usá-lo para decodificar o conteúdo do blob.
`Content-Language`	Opcional. Especifica as linguagens naturais usadas por este recurso.
`Cache-Control`	Opcional. O Armazenamento de Blobs armazena esse valor, mas não o usa ou modifica.
`x-ms-source-content-md5`	Opcional. Um hash MD5 do conteúdo de blob do URI. Esse hash é usado para verificar a integridade do blob durante o transporte dos dados do URI. Quando esse cabeçalho é especificado, o serviço de armazenamento compara o hash do conteúdo que chegou da fonte de cópia com esse valor de cabeçalho. Se esse cabeçalho for omitido, o Armazenamento de Blob gerará um hash MD5. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Solicitação incorreta).
`x-ms-content-crc64`	Opcional. Um hash CRC64 do conteúdo do blob. Esse hash é usado para verificar a integridade do blob durante o transporte. Quando esse cabeçalho é especificado, o serviço de armazenamento verifica o hash que chegou em relação ao que foi enviado. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Solicitação incorreta). Este cabeçalho é suportado na versão 02-02-2019 e posterior. Se os cabeçalhos Content-MD5 e x-ms-content-crc64 estiverem presentes, a solicitação falhará com um 400 (Solicitação incorreta).
`x-ms-blob-content-type`	Opcional. Define o tipo de conteúdo do blob.
`x-ms-blob-content-encoding`	Opcional. Define a codificação de conteúdo do blob.
`x-ms-blob-content-language`	Opcional. Define o idioma de conteúdo do blob.
`x-ms-blob-content-md5`	Opcional. Define o hash MD5 do blob.
`x-ms-blob-cache-control`	Opcional. Define o controle de cache do blob.
`x-ms-meta-name:value`	Opcional. Os pares nome-valor associados ao blob como metadados. Nota: A partir da versão 2009-09-19, os nomes de metadados devem aderir às regras de nomenclatura para identificadores C# .
`x-ms-encryption-scope`	Opcional. O escopo de criptografia a ser usado para criptografar o conteúdo da solicitação. Este cabeçalho é suportado na versão 2019-02-02 e posterior.
`x-ms-tags`	Opcional. Define as tags codificadas query-string-encoded especificadas no blob. Para obter mais informações, vá para a seção Observações. Suportado na versão 2019-12-12 e posterior.
`x-ms-copy-source-tag-option`	Opcional. Os valores possíveis são REPLACE ou COPY (diferencia maiúsculas de minúsculas). O valor padrão é REPLACE. Se COPY for especificado, as tags do blob de origem serão copiadas para o blob de destino. O blob de origem deve ser privado e a solicitação deve ter permissão para Obter Tags de Blob no blob de origem e Definir Tags de Blob no blob de destino. Isso incorre em uma chamada extra para a operação Obter Tags de Blob na conta de origem. REPLACE define marcas que são especificadas pelo cabeçalho `x-ms-tags` no blob de destino. Se REPLACE for usado e nenhuma tag for especificada por `x-ms-tags`, nenhuma tag será definida no blob de destino. Especificar COPY e `x-ms-tags` resulta em um 409 (conflito). Suportado na versão 2021-04-10 e posterior.
`x-ms-copy-source-blob-properties`	Opcional. Especifica o comportamento das propriedades do blob de origem da cópia. Se definido como `True`, as propriedades do blob de origem serão copiadas para o novo blob. O valor predefinido é `True`.
`x-ms-source-if-modified-since`	Opcional. Um valor `DateTime`. Especifique esse cabeçalho condicional para colocar o blob somente se o blob de origem tiver sido modificado desde a data/hora especificada. Se o blob de origem não tiver sido modificado, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição). Esse cabeçalho não pode ser especificado se a origem for um compartilhamento do Azure Files.
`x-ms-source-if-unmodified-since`	Opcional. Um valor `DateTime`. Especifique esse cabeçalho condicional para colocar o blob somente se o blob de origem não tiver sido modificado desde a data/hora especificada. Se o blob de origem tiver sido modificado, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição). Esse cabeçalho não pode ser especificado se a origem for um compartilhamento do Azure Files.
`x-ms-source-if-match`	Opcional. Um valor ETag. Especifique esse cabeçalho condicional para colocar o blob de origem somente se seu ETag corresponder ao valor especificado. Se os valores ETag não corresponderem, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição). Esse cabeçalho não pode ser especificado se a origem for um compartilhamento do Azure Files.
`x-ms-source-if-none-match`	Opcional. Um valor ETag. Especifique esse cabeçalho condicional para colocar o blob somente se seu ETag não corresponder ao valor especificado. Se os valores forem idênticos, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição). Esse cabeçalho não pode ser especificado se a origem for um compartilhamento do Azure Files.
`If-Modified-Since`	Opcional. Um valor `DateTime`. Especifique esse cabeçalho condicional para colocar o blob somente se o blob de destino tiver sido modificado desde a data/hora especificada. Se o blob de destino não tiver sido modificado, o Armazenamento de Blobs retornará o código de status 412 (Falha na pré-condição).
`If-Unmodified-Since`	Opcional. Um valor `DateTime`. Especifique esse cabeçalho condicional para colocar o blob somente se o blob de destino não tiver sido modificado desde a data/hora especificada. Se o blob de destino tiver sido modificado, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição).
`If-Match`	Opcional. Um valor ETag. Especifique um valor ETag para esse cabeçalho condicional para colocar o blob somente se o valor ETag especificado corresponder ao valor `ETag` para um blob de destino existente. Se o ETag para o blob de destino não corresponder ao ETag especificado para `If-Match`, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição).
`If-None-Match`	Opcional. Um valor ETag ou o caractere curinga (). Especifique um valor ETag para esse cabeçalho condicional para colocar o blob somente se o valor ETag especificado não corresponder ao valor ETag para o blob de destino. Especifique o caractere curinga () para executar a operação somente se o blob de destino não existir. Se a condição especificada não for atendida, o Armazenamento de Blob retornará o código de status 412 (Falha na pré-condição).
`x-ms-lease-id:<ID>`	Obrigatório se o blob tiver uma concessão ativa. Para executar essa operação em um blob com uma concessão ativa, especifique a ID de concessão válida para esse cabeçalho.
`x-ms-blob-content-disposition`	Opcional. Define o cabeçalho `Content-Disposition` do blob. Disponível para a versão 2013-08-15 e posterior. O campo de cabeçalho de resposta `Content-Disposition` transmite informações adicionais sobre como processar a carga útil de resposta e pode ser usado para anexar metadados adicionais. Por exemplo, se o cabeçalho estiver definido como `attachment`, isso indica que o user-agent não deve exibir a resposta. Em vez disso, ele deve exibir uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome de blob especificado. A resposta das operações Get Blob e Get Blob Properties inclui o cabeçalho `content-disposition`.
`Origin`	Opcional. Especifica a origem a partir da qual a solicitação é emitida. A presença desse cabeçalho resulta em cabeçalhos de compartilhamento de recursos entre origens (CORS) na resposta. Para obter mais informações, consulte suporte CORS para os serviços de Armazenamento do Azure.
`x-ms-client-request-id`	Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 kibibyte (KiB) que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações que o servidor recebe.
`x-ms-access-tier`	Opcional. Indica a camada a ser definida no blob. Os valores válidos para camadas de blob de bloco são `Hot`, `Cool`, `Cold`e `Archive`. Nota: `Cold` camada é suportada para a versão 2021-12-02 e posterior. `Hot`, `Cool`e `Archive` são suportados para a versão 2018-11-09 e posterior. Para obter mais informações sobre a hierarquização de blob de bloco, consulte Camadas de armazenamento quentes, frias e de arquivamento.
`x-ms-expiry-option`	Opcional. Versão 2023-08-03 e posterior. Especifica a opção de data de expiração para a solicitação. Para obter mais informações, consulte ExpiryOption. Esse cabeçalho é válido para contas com namespace hierárquico habilitado.
`x-ms-expiry-time`	Opcional. Versão 2023-08-03 e posterior. Especifica a hora em que o blob está definido para expirar. O formato da data de validade varia de acordo com `x-ms-expiry-option`. Para obter mais informações, consulte ExpiryOption. Esse cabeçalho é válido para contas com namespace hierárquico habilitado.

Esta operação também suporta o uso de cabeçalhos condicionais para gravar o blob somente se uma determinada condição for atendida. Para obter mais informações, consulte Especificar cabeçalhos condicionais para operações de armazenamento de Blob.

Cabeçalhos de solicitação (chaves de criptografia fornecidas pelo cliente)

Os cabeçalhos a seguir podem ser especificados na solicitação para criptografar um blob com uma chave fornecida pelo cliente. A criptografia com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional.

Cabeçalho do pedido	Description
`x-ms-encryption-key`	Obrigatório. A chave de criptografia AES-256 codificada em Base64.
`x-ms-encryption-key-sha256`	Obrigatório. O hash SHA256 codificado em Base64 da chave de criptografia.
`x-ms-encryption-algorithm: AES256`	Obrigatório. Especifica o algoritmo a ser usado para criptografia. O valor deste cabeçalho deve ser `AES256`.

Corpo do pedido

Nenhum.

Pedido de amostra

O exemplo a seguir mostra uma solicitação para criar um blob de bloco:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-04-08  
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  
x-ms-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Response

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Código de estado

Uma operação bem-sucedida retorna o código de status 201 (Criado).

Para obter mais informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho da resposta	Description
`ETag`	O ETag contém um valor que o cliente pode usar para executar operações de `PUT` condicional usando o cabeçalho de solicitação `If-Match`. O valor ETag está entre aspas.
`Last-Modified`	A data/hora em que o blob foi modificado pela última vez. O formato de data segue o RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. Qualquer operação de gravação no blob (incluindo atualizações nos metadados ou propriedades do blob) altera a hora da última modificação do blob.
`Content-MD5`	Retornado para um blob de bloco para que o cliente possa verificar a integridade do conteúdo da mensagem. O `Content-MD5` valor retornado é calculado pelo Armazenamento de Blob. Esse cabeçalho é retornado mesmo quando a solicitação não inclui cabeçalhos `Content-MD5` ou `x-ms-blob-content-md5`.
`x-ms-content-crc64`	Retornado para um blob de bloco para que o cliente possa verificar a integridade do conteúdo da mensagem. O `x-ms-content-crc64` valor retornado é calculado pelo Armazenamento de Blob. Este cabeçalho é sempre retornado.
`x-ms-request-id`	Identifica exclusivamente a solicitação que foi feita e você pode usá-la para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
`x-ms-version`	A versão do Armazenamento de Blob que foi usada para executar a solicitação.
`Date`	Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada.
`Access-Control-Allow-Origin`	Retornado se a solicitação incluir um cabeçalho `Origin` e o CORS estiver habilitado com uma regra correspondente. Esse cabeçalho retorna o valor do cabeçalho da solicitação de origem se houver uma correspondência.
`Access-Control-Expose-Headers`	Retornado se a solicitação incluir um cabeçalho `Origin` e o CORS estiver habilitado com uma regra correspondente. Retorna a lista de cabeçalhos de resposta que devem ser expostos ao cliente ou emissor da solicitação.
`Access-Control-Allow-Credentials`	Retornado se a solicitação incluir um cabeçalho `Origin` e o CORS estiver habilitado com uma regra de correspondência que não permite todas as origens. Este cabeçalho está definido como `true`.
`x-ms-request-server-encrypted: true/false`	O valor desse cabeçalho é definido como `true` se o conteúdo da solicitação for criptografado com êxito usando o algoritmo especificado. Caso contrário, o valor será definido como `false`.
`x-ms-encryption-key-sha256`	Retornado se a solicitação usou uma chave fornecida pelo cliente para criptografia, para que o cliente possa garantir que o conteúdo da solicitação seja criptografado com êxito usando a chave fornecida.
`x-ms-encryption-scope`	Retornado se a solicitação usou um escopo de criptografia, para que o cliente possa garantir que o conteúdo da solicitação seja criptografado com êxito usando o escopo de criptografia.
`x-ms-version-id: <DateTime>`	Retorna um valor `DateTime` opaco que identifica exclusivamente o blob. O valor desse cabeçalho indica a versão do blob e pode ser usado em solicitações subsequentes para acessar o blob.

Corpo da resposta

Nenhum.

Resposta da amostra

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ção

A autorização é necessária ao chamar qualquer operação de acesso a dados no Armazenamento do Azure. Você pode autorizar a operação Put Blob From URL conforme descrito abaixo.

Se uma solicitação especificar tags com o cabeçalho de solicitação , o chamador deverá atender aos requisitos de autorização da operação set Blob Tags.

Importante

A Microsoft recomenda o uso do Microsoft Entra ID com identidades gerenciadas para autorizar solicitações ao Armazenamento do Azure. O Microsoft Entra ID oferece segurança superior e facilidade de uso em comparação com a autorização de chave compartilhada.

O Armazenamento do Azure dá suporte ao uso da ID do Microsoft Entra para autorizar solicitações de dados de blob. Com o Microsoft Entra ID, você pode usar o controle de acesso baseado em função do Azure (Azure RBAC) para conceder permissões a uma entidade de segurança. A entidade de segurança pode ser um usuário, grupo, entidade de serviço de aplicativo ou identidade gerenciada do Azure. A entidade de segurança é autenticada pelo Microsoft Entra ID para retornar um token OAuth 2.0. O token pode ser usado para autorizar uma solicitação no serviço Blob.

Para saber mais sobre a autorização usando o Microsoft Entra ID, consulte Autorizar o acesso a blobs usando o Microsoft Entra ID.

Permissões

Abaixo estão listadas a ação RBAC necessária para que um usuário, grupo, identidade gerenciada ou entidade de serviço do Microsoft Entra chame a operação Put Blob From URL e a função interna menos privilegiada do RBAC do Azure que inclui essa ação:

ação do RBAC do Azure:
- Criar novo blob de bloco: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Criar blob de bloco novo ou substituir existente: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Função interna menos privilegiada:Contribuidor de Dados de Blob de Armazenamento

Para saber mais sobre como atribuir funções usando o RBAC do Azure, consulte Atribuir uma função do Azure para acesso a dados de blob.

Uma assinatura de acesso compartilhado (SAS) fornece acesso delegado seguro a recursos em uma conta de armazenamento. Com uma SAS, você tem controle granular sobre como um cliente pode acessar dados. Você pode especificar qual recurso o cliente pode acessar, quais permissões ele tem para esses recursos e por quanto tempo o SAS é válido.

A operação Put Blob From URL suporta três tipos de assinaturas de acesso compartilhado: delegação de usuário SAS, serviço SASe conta SAS.

Como prática recomendada de segurança, recomendamos que você use as credenciais do Microsoft Entra em vez da chave da conta de armazenamento, que pode ser comprometida mais facilmente. Se o design do seu aplicativo exigir assinaturas de acesso compartilhado, use as credenciais do Microsoft Entra para criar uma SAS de delegação de usuário, quando possível.

Quando o acesso à Chave Compartilhada não for permitido para a conta de armazenamento, um token SAS de serviço ou um token SAS de conta não será permitido em uma solicitação ao Armazenamento de Blobs. Para saber mais, consulte Entender como a desativação da Chave Compartilhada afeta os tokens SAS.

Delegação de usuários SAS

Uma SAS de delegação de usuário é protegida com credenciais do Microsoft Entra e também pelas permissões especificadas para a SAS.

Chamar a operação Put Blob From URL usando um token SAS delegado a um contêiner ou recurso de blob requer a seguinte permissão como parte do token SAS de delegação de usuário:

Operação	Permissão assinada
Colocar Blob do URL (criar novo blob de bloco)	Criar (c) ou Escrever (w)
Colocar Blob da URL (substituir blob de bloco existente)	Escrever (w)

Para saber mais sobre a SAS de delegação de usuário, consulte Criar uma SAS de delegação de usuário.

Serviço SAS

Uma SAS de serviço é protegida com a chave da conta de armazenamento. Um SAS de serviço delega acesso a um recurso em um único serviço de Armazenamento do Azure, como o armazenamento de blobs.

Chamar a operação Put Blob From URL usando um token SAS delegado a um contêiner ou recurso de blob requer a seguinte permissão como parte do token SAS de serviço.

Operação	Permissão assinada
Colocar Blob do URL (criar novo blob de bloco)	Criar (c) ou Escrever (w)
Colocar Blob da URL (substituir blob de bloco existente)	Escrever (w)

Para saber mais sobre o SAS de serviço, consulte Criar um serviço SAS.

Conta SAS

Uma conta SAS é protegida com a chave de conta de armazenamento. Uma SAS de conta delega acesso a recursos em um ou mais serviços de armazenamento. Todas as operações disponíveis através de um SAS de serviço ou delegação de usuário também estão disponíveis através de uma conta SAS.

A tabela a seguir indica o tipo de recurso assinado e as permissões assinadas a serem especificadas ao delegar acesso:

Operação	Serviço assinado	Tipo de recurso assinado	Permissão assinada
Colocar Blob do URL (criar novo blob de bloco)	Blob (b)	Objeto (o)	Criar (c) ou Escrever (w)
Colocar Blob da URL (substituir blob de bloco existente)	Blob (b)	Objeto (o)	Escrever (w)

Para saber mais sobre a conta SAS, consulte Criar uma conta SAS.

Observações

A operação Put Blob From URL é suportada a partir da versão 2020-04-08.

Na versão 2020-10-02 e posterior, a autorização do Microsoft Entra é suportada para a origem da operação de cópia.

O blob de origem pode ser de qualquer tipo, incluindo um blob de bloco, blob de acréscimo ou blob de página. O blob de destino, no entanto, deve ser um blob de bloco.

A operação Put Blob From URL sempre copia todo o blob de origem. Não há suporte para copiar um intervalo de bytes ou um conjunto de blocos. Para executar atualizações parciais, consulte Put Block From URL. O blob de destino pode ser um blob de bloco existente ou pode ser um novo blob criado pela operação.

Quando você está usando um blob de bloco como o objeto de origem, todo o conteúdo de blob confirmado é copiado. No entanto, a lista de bloqueios não é preservada e os blocos não confirmados não são copiados. O conteúdo do blob de destino é idêntico ao da origem, mas a lista de bloqueios confirmada não é preservada.

Coloque propriedades e metadados de Blob

Quando você cria um blob de bloco a partir de uma fonte de cópia, as propriedades de blob padrão são copiadas por padrão do blob de origem. Se os metadados do aplicativo forem especificados na solicitação, eles serão armazenados sem copiar os metadados do blob de origem. Para definir explicitamente quaisquer cabeçalhos de conteúdo HTTP, você pode especificar o cabeçalho correspondente na solicitação.

Content-Type
Content-Encoding
Content-Length
Cache-Control
Content-Disposition

O tamanho do blob de destino sempre corresponde ao do blob de origem. O cabeçalho Content-Length deve ser 0 na solicitação Put Blob From URL (porque não há corpo de solicitação) e a propriedade content length para o blob de destino é inferida a partir do tamanho da origem.

Colocar Blob de URL propriedades personalizadas

Put Blob From Url segue a mesma semântica que Put Blob para definir propriedades personalizadas associadas a cabeçalhos HTTP padrão. Para obter mais informações, consulte propriedades personalizadas de Blob

Tags de índice de Blob

Se as tags para o blob de destino forem fornecidas no cabeçalho do x-ms-tags, elas deverão ser codificadas na cadeia de caracteres de consulta. As chaves e os valores das tags devem estar em conformidade com os requisitos de nomenclatura e comprimento, conforme especificado em Set Blob Tags. Além disso, o cabeçalho x-ms-tags pode conter até 2 KiB de tags. Se forem necessárias mais tags, use a operação Set Blob Tags.

Se as tags não forem fornecidas no cabeçalho do x-ms-tags, elas não serão copiadas do blob de origem.

Escopos de criptografia e chaves fornecidas pelo cliente

A API Put Blob From URL suporta escopos de criptografia e chaves fornecidas pelo cliente, usando os cabeçalhos x-ms-encryption-scope e x-ms-encryption-key, respectivamente.

Se o cabeçalho x-ms-copy-source se referir ao mesmo blob de origem que o blob de destino no URI de solicitação, a operação Put Blob From URL executará uma regravação in-loco síncrona do blob. Isso permite reescrever um blob para usar uma chave de criptografia ou escopo de criptografia diferente.

Faturação

As solicitações de preços podem ser originadas de clientes que usam APIs de Armazenamento de Blob, diretamente por meio da API REST de Armazenamento de Blob ou de uma biblioteca de cliente do Armazenamento do Azure. Estes pedidos acumulam encargos por transação. O tipo de transação afeta a forma como a conta é cobrada. Por exemplo, as transações de leitura são acumuladas para uma categoria de faturamento diferente das transações de gravação. A tabela a seguir mostra a categoria de faturamento para solicitações de Put Blob From URL com base no tipo de conta de armazenamento:

Operação	Storage account type	Categoria de faturação
Colocar Blob a partir do URL (conta de destino¹)	Blob de bloco premium Padrão de uso geral v2 Padrão de uso geral v1	Operações de escrita
Colocar Blob do URL (conta de origem²)	Blob de bloco premium Padrão de uso geral v2 Padrão de uso geral v1	Operações de leitura

¹A conta de destino é cobrada por uma transação para iniciar a gravação.
²A conta de origem incorre em uma transação para cada solicitação de leitura para o objeto de origem.

Além disso, se as contas de origem e de destino residirem em regiões diferentes (por exemplo, Norte dos EUA e Sul dos EUA), a largura de banda usada para transferir a solicitação será cobrada na conta de armazenamento de origem como saída. A saída entre contas dentro da mesma região é gratuita.

Finalmente, a criação de um novo blob com um nome diferente dentro da mesma conta de armazenamento usa recursos de armazenamento adicionais, de modo que a operação resulta em uma cobrança contra o uso da capacidade da conta de armazenamento para esses recursos adicionais.

Para saber mais sobre os preços das categorias de cobrança especificadas, consulte de preços do Armazenamento de Blobs do Azure .

Consulte também

Autorizar solicitações ao Armazenamento do Azure Status e códigos de erro códigos de erro do serviço de Blob Definir tempos limite para operações de serviço de Blob

Partilhar via