Een blob verwijderen en herstellen met JavaScript of TypeScript

• .NET
• Java
• JavaScript
• Python
• Go

In dit artikel wordt beschreven hoe u blobs verwijdert met de Azure Storage-clientbibliotheek voor JavaScript en hoe u voorlopig verwijderde blobs tijdens de bewaarperiode herstelt.

Vereisten

• In de voorbeelden in dit artikel wordt ervan uitgegaan dat u al een project hebt ingesteld voor gebruik met de Azure Blob Storage-clientbibliotheek voor JavaScript. Zie Aan de slag met Azure Blob Storage en JavaScript voor meer informatie over het instellen van uw project, inclusief pakketinstallatie, het importeren van modules en het maken van een geautoriseerd clientobject voor gebruik met gegevensbronnen.
• Het autorisatiemechanisme moet machtigingen hebben om een blob te verwijderen of om een voorlopig verwijderde blob te herstellen. Zie de autorisatierichtlijnen voor de volgende REST API-bewerkingen voor meer informatie:
  • Blob verwijderen
  • Blob verwijderen ongedaan maken

Een blob verwijderen

Notitie

Wanneer voorlopig verwijderen van blobs is ingeschakeld voor een opslagaccount, kunt u geen permanente verwijdering uitvoeren met behulp van clientbibliotheekmethoden. Met behulp van de methoden in dit artikel blijft een voorlopig verwijderde blob, blobversie of momentopname beschikbaar totdat de bewaarperiode verloopt, waarna deze definitief wordt verwijderd. Zie Blob (REST API) verwijderen voor meer informatie over de onderliggende REST API-bewerking.

Als u een blob wilt verwijderen, roept u een van de volgende methoden aan:

• BlobClient.delete
• BlobClient.deleteIfExists

Als de blob gekoppelde momentopnamen heeft, moet u alle momentopnamen verwijderen om de blob te verwijderen. In het volgende codevoorbeeld ziet u hoe u een blob en de bijbehorende momentopnamen verwijdert:

JavaScript

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);
}

TypeScript

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);
}

Een verwijderde blob herstellen

Met voorlopig verwijderen van blobs wordt een afzonderlijke blob en zijn versies, momentopnamen en metagegevens beschermd tegen onbedoeld verwijderen of overschrijven door de verwijderde gegevens gedurende een opgegeven periode in het systeem te behouden. Tijdens de retentieperiode kunt u de blob herstellen naar de status die deze had bij het verwijderen. Nadat de bewaarperiode is verlopen, wordt de blob definitief verwijderd. Zie Voorlopig verwijderen voor blobs voor meer informatie over voorlopig verwijderen van blobs.

U kunt de Azure Storage-clientbibliotheken gebruiken om een voorlopig verwijderde blob of momentopname te herstellen.

Voorlopig verwijderde objecten herstellen wanneer versiebeheer is uitgeschakeld

Als u voorlopig verwijderde blobs wilt herstellen, roept u de volgende methode aan:

• BlobClient.undelete

Met deze methode worden voorlopig verwijderde blobs en eventuele verwijderde momentopnamen hersteld die eraan zijn gekoppeld. Het aanroepen van deze methode voor een blob die niet is verwijderd, heeft geen effect.

JavaScript

async function undeleteBlob(containerClient, blobName){

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

  await blockBlobClient.undelete();
}

TypeScript

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);
}

Resources

Zie de volgende resources voor meer informatie over het verwijderen van blobs en het herstellen van verwijderde blobs met behulp van de Azure Blob Storage-clientbibliotheek voor JavaScript.

Codevoorbeelden

• Voorbeelden van JavaScript- en TypeScript-code weergeven uit dit artikel (GitHub)

REST API-bewerkingen

De Azure SDK voor JavaScript bevat bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende JavaScript-paradigma's. De clientbibliotheekmethoden voor het verwijderen van blobs en het herstellen van verwijderde blobs gebruiken de volgende REST API-bewerkingen:

• Blob verwijderen (REST API)
• Blob ongedaan maken (REST API)

Clientbibliotheekbronnen

• Referentiedocumentatie voor clientbibliotheek
• Broncode van clientbibliotheek
• Package (npm)

Zie ook

• Voorlopig verwijderen voor blobs
• Blob-versiebeheer

Gerelateerde inhoud

• Dit artikel maakt deel uit van de ontwikkelaarshandleiding voor Blob Storage voor JavaScript/Typescript. Zie de volledige lijst met artikelen over ontwikkelaarshandleidingen in Uw JavaScript-/Typescript-app bouwen voor meer informatie.