Excluir e restaurar um blob com JavaScript ou TypeScript

Este artigo mostra como excluir blobs com a biblioteca de cliente do Armazenamento do Azure para JavaScript e como restaurar blobs excluídos por software durante o período de retenção.

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 excluir um blob ou para restaurar um blob excluído suavemente. Para saber mais, consulte as diretrizes de autorização para as seguintes operações de API REST:
  • Excluir Blob
  • Recuperar Blob

Eliminar um blob

Para excluir um blob, chame um dos seguintes métodos:

• BlobClient.delete
• BlobClient.deleteIfExists

Se o blob tiver instantâneos associados, você deverá excluir todos os seus instantâneos para excluir o blob. O exemplo de código a seguir mostra como excluir um blob e seus instantâneos:

async function deleteBlob(containerClient, blobName){

  // include: Delete the base blob and all of its snapshots
  // only: Delete only the blob's snapshots and not the blob itself
  const options = {
    deleteSnapshots: 'include'
  }

  // Create blob client from container client
  const blockBlobClient = containerClient.getBlockBlobClient(blobName);

  await blockBlobClient.delete(options);
}

async function deleteBlob(
  containerClient: ContainerClient,
  blobName
): Promise<void> {

  // Create blob client from container client
  const blockBlobClient: BlockBlobClient = containerClient.getBlockBlobClient(blobName);

  // include: Delete the base blob and all of its snapshots
  // only: Delete only the blob's snapshots and not the blob itself
  const options: BlobDeleteOptions = {
    deleteSnapshots: 'include'
  };
  const blobDeleteResponse: BlobDeleteResponse = 
    await blockBlobClient.delete(options);
}

Restaurar um blob excluído

A eliminação recuperável de blobs protege um blob individual e as respetivas versões, instantâneos e metadados contra eliminações ou substituições acidentais, mantendo os dados eliminados no sistema durante um período de tempo especificado. Durante o período de retenção, pode restaurar o blob para o estado em que estava no momento da eliminação. Depois que o período de retenção expirar, o blob será excluído permanentemente. Para obter mais informações sobre exclusão suave de blob, consulte Exclusão suave para blobs.

Você pode usar as bibliotecas de cliente do Armazenamento do Azure para restaurar um blob ou instantâneo excluído por software.

Restaurar objetos excluídos por software quando o controle de versão estiver desativado

Para restaurar blobs excluídos por software, chame o seguinte método:

• BlobClient.undelete

Esse método restaura blobs excluídos suavemente e quaisquer instantâneos excluídos associados a ele. Chamar esse método para um blob que não foi excluído não tem efeito.

async function undeleteBlob(containerClient, blobName){

  // Create blob client from container client
  const blockBlobClient = containerClient.getBlockBlobClient(blobName);

  await blockBlobClient.undelete();
}

async function undeleteBlob(
  containerClient: ContainerClient,
  blobName
): Promise<void> {

  // Create blob client from container client
  const blockBlobClient: BlockBlobClient = containerClient.getBlockBlobClient(blobName);

  const options: BlobUndeleteOptions = {};
  const blobUndeleteResponse: BlobUndeleteResponse =
    await blockBlobClient.undelete(options);
}

Recursos

Para saber mais sobre como excluir blobs e restaurar blobs excluídos 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 da biblioteca de cliente para excluir blobs e restaurar blobs excluídos usam as seguintes operações da API REST:

• Excluir Blob (API REST)
• Recuperar Blob (API REST)

Recursos da biblioteca do cliente

• Documentação de referência da biblioteca cliente
• Código fonte da biblioteca cliente
• Pacote (npm)

Consulte também

• Exclusão suave para blobs
• Controle de versão de Blob

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.