Copiar um blob de um URL de objeto de origem com JavaScript
Este artigo mostra como copiar um blob de uma URL de objeto de origem usando a biblioteca de cliente do Armazenamento do Azure para JavaScript. Você pode copiar um blob de uma fonte dentro da mesma conta de armazenamento, de uma fonte em uma conta de armazenamento diferente ou de qualquer objeto acessível recuperado via solicitação HTTP GET em uma determinada URL.
Os métodos de biblioteca de cliente abordados neste artigo usam as operações Put Blob From URL e Put Block From URL REST API. Esses métodos são preferidos para cenários de cópia em que você deseja mover dados para uma conta de armazenamento e ter uma URL para o objeto de origem. Para operações de cópia em que você deseja agendamento assíncrono, consulte Copiar um blob com agendamento assíncrono usando JavaScript.
Pré-requisitos
- Os exemplos neste artigo pressupõem que você já tenha um projeto configurado para trabalhar com a biblioteca de cliente do Armazenamento de Blobs do Azure para JavaScript. Para saber mais sobre como configurar seu projeto, incluindo instalação de pacotes, importação de módulos e criação de um objeto de cliente autorizado para trabalhar com recursos de dados, consulte Introdução ao Armazenamento de Blobs do Azure e JavaScript.
- O mecanismo de autorização deve ter permissões para executar uma operação de cópia. Para saber mais, consulte as diretrizes de autorização para a seguinte operação da API REST:
Sobre a cópia de blobs de uma URL de objeto de origem
A Put Blob From URL operação cria um novo blob de bloco onde o conteúdo do blob é lido de uma determinada URL. A operação é concluída de forma síncrona.
A fonte pode ser qualquer objeto recuperável através de uma solicitação HTTP GET padrão na URL fornecida. Isso inclui blobs de bloco, blobs de acréscimo, blobs de página, instantâneos de blob, versões de blob ou qualquer objeto acessível dentro ou fora do Azure.
Quando o objeto de origem é um blob de bloco, 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.
O destino é sempre um blob de bloco, um blob de bloco existente ou um novo blob de bloco criado pela operação. O conteúdo de um blob existente é substituído pelo conteúdo do novo blob.
A Put Blob From URL operação 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 no conteúdo de um blob de bloqueio usando uma URL de origem, use a API Put Block From URL junto com Put Block List.
Para saber mais sobre a operação, incluindo limitações de tamanho de Put Blob From URL blob e considerações de cobrança, consulte Colocar Blob a partir de observações de URL.
Copiar um blob de uma URL de objeto de origem
Esta seção fornece uma visão geral dos métodos fornecidos pela biblioteca de cliente do Armazenamento do Azure para JavaScript para executar uma operação de cópia de uma URL de objeto de origem.
O método a seguir encapsula a operação Put Blob From URL REST API e cria um novo blob de bloco onde o conteúdo do blob é lido de uma determinada URL:
Esses métodos são preferidos para cenários em que você deseja mover dados para uma conta de armazenamento e ter uma URL para o objeto de origem.
Para objetos grandes, você pode optar por trabalhar com blocos individuais. O método a seguir encapsula a operação Put Block From URL REST API. Esse método cria um novo bloco a ser confirmado como parte de um blob onde o conteúdo é lido de uma URL de origem:
Copiar um blob de uma fonte no Azure
Se estiver a copiar um blob de uma origem no Azure, o acesso ao blob de origem pode ser autorizado através do Microsoft Entra ID, de uma assinatura de acesso partilhado (SAS) ou de uma chave de conta.
O exemplo a seguir mostra um cenário para copiar de um blob de origem no Azure:
async function copyFromSourceInAzure(sourceBlob, destinationBlob) {
// Get the source blob URL and create the destination blob
await destinationBlob.syncUploadFromURL(sourceBlob.url);
}
O método syncUploadFromURL também pode aceitar um parâmetro BlockBlobSyncUploadFromURLOptions para especificar outras opções para a operação.
Copiar um blob de uma fonte fora do Azure
Você pode executar uma operação de cópia em qualquer objeto de origem que possa ser recuperado por meio da solicitação HTTP GET em uma determinada URL, incluindo objetos acessíveis fora do Azure. O exemplo a seguir mostra um cenário para copiar um blob de uma URL de objeto de origem acessível.
async function copyFromExternalSource(sourceUrl, destinationBlob) {
// Create the destination blob from the source URL
await destinationBlob.syncUploadFromURL(sourceUrl);
}
Recursos
Para saber mais sobre como copiar blobs usando a biblioteca de cliente do Armazenamento de Blobs do Azure para JavaScript, consulte os recursos a seguir.
Amostras de código
- Veja exemplos de código JavaScript e TypeScript deste artigo (GitHub)
Operações da API REST
O SDK do Azure para JavaScript contém bibliotecas que se baseiam na API REST do Azure, permitindo que você interaja com operações da API REST por meio de paradigmas JavaScript familiares. Os métodos de biblioteca de cliente abordados neste artigo usam as seguintes operações de API REST:
- Colocar Blob da URL (API REST)
- Colocar bloco de URL (API REST)
Recursos da biblioteca do cliente
Conteúdos relacionados
- Este artigo faz parte do guia do desenvolvedor do Blob Storage para JavaScript/TypeScript. Para saber mais, consulte a lista completa de artigos do guia do desenvolvedor em Crie seu aplicativo JavaScript/TypeScript.