Een blob verwijderen en herstellen met TypeScript
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 TypeScript 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:
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, maakt u een BlobClient en roept u een van de volgende methoden aan:
In het volgende voorbeeld wordt een blob verwijderd.
async function deleteBlob(
containerClient: ContainerClient,
blobName
): Promise<void> {
// Create blob client from container client
const blockBlobClient: BlockBlobClient =
await 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' // or 'only'
};
const blobDeleteResponse: BlobDeleteResponse = await blockBlobClient.delete(
options
);
if (!blobDeleteResponse.errorCode) {
console.log(`deleted blob ${blobName}`);
}
}
In het volgende voorbeeld wordt een blob verwijderd als deze bestaat.
async function deleteBlobIfItExists(
containerClient: ContainerClient,
blobName
): Promise<void> {
// Create blob client from container client
const blockBlobClient = await 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' // or 'only'
};
const blobDeleteIfExistsResponse: BlobDeleteIfExistsResponse =
await blockBlobClient.deleteIfExists(options);
if (!blobDeleteIfExistsResponse.errorCode) {
console.log(`deleted blob ${blobName}`);
}
}
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 retentieperiode 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 verwijderde blobs wilt herstellen, maakt u een BlobClient en roept u de volgende methode aan:
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.
async function undeleteBlob(
containerClient: ContainerClient,
blobName
): Promise<void> {
// Create blob client from container client
const blockBlobClient: BlockBlobClient =
await containerClient.getBlockBlobClient(blobName);
const options: BlobUndeleteOptions = {};
const blobUndeleteResponse: BlobUndeleteResponse =
await blockBlobClient.undelete(options);
if (!blobUndeleteResponse.errorCode) {
console.log(`undeleted blob ${blobName}`);
}
}
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.
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: