Odstranění a obnovení objektu blob pomocí JavaScriptu nebo TypeScriptu

• .NET
• Java
• JavaScript
• Python
• Přejít

Tento článek ukazuje, jak odstranit objekty blob pomocí klientské knihovny služby Azure Storage pro JavaScript a jak obnovit obnovitelné odstraněné objekty blob během doby uchovávání.

Požadavky

• Příklady v tomto článku předpokládají, že už máte projekt nastavený tak, aby fungoval s klientskou knihovnou Azure Blob Storage pro JavaScript. Další informace o nastavení projektu, včetně instalace balíčku, importu modulů a vytvoření autorizovaného klientského objektu pro práci s datovými prostředky, najdete v tématu Začínáme se službou Azure Blob Storage a JavaScriptem.
• Autorizační mechanismus musí mít oprávnění k odstranění objektu blob nebo obnovení obnovitelně odstraněného objektu blob. Další informace najdete v pokynech k autorizaci pro následující operace rozhraní REST API:
  • Odstranění objektu blob
  • Odstranění objektu blob

Odstranění objektu blob

Poznámka:

Pokud je pro účet úložiště povolené obnovitelné odstranění objektů blob, nemůžete trvalé odstranění provést pomocí metod klientské knihovny. Pomocí metod v tomto článku zůstane obnovitelně odstraněný objekt blob, verze objektu blob nebo snímek k dispozici, dokud nevyprší doba uchovávání, kdy se trvale odstraní. Další informace o základní operaci rozhraní REST API najdete v tématu Odstranění objektu blob (REST API).

Pokud chcete odstranit objekt blob, zavolejte jednu z následujících metod:

• BlobClient.delete
• BlobClient.deleteIfExists

Pokud objekt blob obsahuje nějaké přidružené snímky, musíte odstranit všechny jeho snímky, abyste objekt blob odstranili. Následující příklad kódu ukazuje, jak odstranit objekt blob a jeho snímky:

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

Obnovení odstraněného objektu blob

Obnovitelné odstranění objektu blob chrání jednotlivý blob a jeho verze, snímky a metadata před náhodným odstraněním nebo přepsáním tak, že odstraněná data se po určitou dobu uchovají v systému. Během doby uchovávání můžete blob obnovit do stavu v době jeho odstranění. Po vypršení doby uchovávání se objekt blob trvale odstraní. Další informace o obnovitelném odstranění objektů blob najdete v tématu Obnovitelné odstranění objektů blob.

Klientské knihovny Azure Storage můžete použít k obnovení obnovitelně odstraněného objektu blob nebo snímku.

Obnovení obnovitelně odstraněných objektů při zakázání správy verzí

Pokud chcete obnovit obnovitelné odstraněné objekty blob, zavolejte následující metodu:

• BlobClient.undelete

Tato metoda obnoví obnovitelně odstraněné objekty blob a všechny odstraněné snímky, které jsou k němu přidružené. Volání této metody pro objekt blob, který nebyl odstraněn, nemá žádný vliv.

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

Zdroje informací

Další informace o tom, jak odstranit objekty blob a obnovit odstraněné objekty blob pomocí klientské knihovny služby Azure Blob Storage pro JavaScript, najdete v následujících zdrojích informací.

Ukázky kódu

• Zobrazení ukázek kódu JavaScriptu a TypeScriptu z tohoto článku (GitHub)

Operace rozhraní REST API

Sada Azure SDK pro JavaScript obsahuje knihovny, které jsou postavené na rozhraní Azure REST API a umožňují interakci s operacemi rozhraní REST API prostřednictvím známých paradigmat JavaScriptu. Metody klientské knihovny pro odstranění objektů blob a obnovení odstraněných objektů blob používají následující operace rozhraní REST API:

• Odstranění objektu blob (REST API)
• Zrušení odstranění objektu blob (REST API)

Prostředky klientské knihovny

• Referenční dokumentace ke klientské knihovně
• Zdrojový kód klientské knihovny
• Balíček (npm)

Viz také

• Obnovitelné odstranění objektů blob
• Správa verzí objektů blob

Související obsah

• Tento článek je součástí příručky pro vývojáře služby Blob Storage pro JavaScript nebo TypeScript. Další informace najdete v úplném seznamu článků příručky pro vývojáře v tématu Sestavení aplikace JavaScript/TypeScript.