Ta bort och återställa en blob med JavaScript eller TypeScript

• .NET
• Java
• JavaScript
• Python
• Kör

Den här artikeln visar hur du tar bort blobar med Azure Storage-klientbiblioteket för JavaScript och hur du återställer mjuk borttagna blobar under kvarhållningsperioden.

Förutsättningar

• Exemplen i den här artikeln förutsätter att du redan har ett projekt konfigurerat för att fungera med Azure Blob Storage-klientbiblioteket för JavaScript. Mer information om hur du konfigurerar projektet, inklusive paketinstallation, import av moduler och skapande av ett auktoriserat klientobjekt för att arbeta med dataresurser finns i Kom igång med Azure Blob Storage och JavaScript.
• Auktoriseringsmekanismen måste ha behörighet att ta bort en blob eller återställa en mjuk borttagen blob. Mer information finns i auktoriseringsvägledningen för följande REST API-åtgärder:
  • Ta bort blob
  • Ta bort borttagningsblob

Ta bort en blob

Kommentar

När mjuk borttagning av blobar är aktiverat för ett lagringskonto kan du inte utföra en permanent borttagning med hjälp av klientbiblioteksmetoder. Med hjälp av metoderna i den här artikeln förblir en mjuk borttagen blob, blobversion eller ögonblicksbild tillgänglig tills kvarhållningsperioden upphör att gälla, då den tas bort permanent. Mer information om den underliggande REST API-åtgärden finns i Ta bort blob (REST API).

Om du vill ta bort en blob anropar du någon av följande metoder:

• BlobClient.delete
• BlobClient.deleteIfExists

Om bloben har några associerade ögonblicksbilder måste du ta bort alla dess ögonblicksbilder för att ta bort bloben. Följande kodexempel visar hur du tar bort en blob och dess ögonblicksbilder:

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

Återställa en borttagen blob

Mjuk borttagning av blobar skyddar en enskild blob, versioner, ögonblicksbilder och metadata från oavsiktliga borttagningar eller överskrivningar genom att spara borttagna data i systemet under en angiven tidsperiod. Under kvarhållningsperioden kan du återställa bloben till dess tillstånd när den togs bort. När kvarhållningsperioden har upphört att gälla tas bloben bort permanent. Mer information om mjuk borttagning av blobar finns i Mjuk borttagning för blobar.

Du kan använda Azure Storage-klientbiblioteken för att återställa en mjuk borttagen blob eller ögonblicksbild.

Återställa mjukt borttagna objekt när versionshantering är inaktiverat

Om du vill återställa mjukt borttagna blobar anropar du följande metod:

• BlobClient.undelete

Den här metoden återställer mjukt borttagna blobar och eventuella borttagna ögonblicksbilder som är associerade med den. Att anropa den här metoden för en blob som inte har tagits bort har ingen effekt.

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

Resurser

Mer information om hur du tar bort blobar och återställer borttagna blobar med hjälp av Azure Blob Storage-klientbiblioteket för JavaScript finns i följande resurser.

Kodexempel

• Visa JavaScript - och TypeScript-kodexempel från den här artikeln (GitHub)

REST API-åtgärder

Azure SDK för JavaScript innehåller bibliotek som bygger på Azure REST API, så att du kan interagera med REST API-åtgärder via välbekanta JavaScript-paradigm. Klientbiblioteksmetoderna för att ta bort blobar och återställa borttagna blobar använder följande REST API-åtgärder:

• Ta bort blob (REST API)
• Ta bort blob ( REST API)

Klientbiblioteksresurser

• Referensdokumentation för klientbibliotek
• Källkod för klientbibliotek
• Paket (npm)

Se även

• Mjuk borttagning för blobar
• Blobversionshantering

Relaterat innehåll

• Den här artikeln är en del av utvecklarguiden för Blob Storage för JavaScript/TypeScript. Mer information finns i den fullständiga listan över utvecklarguideartiklar i Skapa din JavaScript/TypeScript-app.