Sdílet prostřednictvím

Začínáme se službou Azure Blob Storage a JavaScriptem nebo TypeScriptem

V tomto článku se dozvíte, jak se připojit ke službě Azure Blob Storage pomocí klientské knihovny služby Azure Blob Storage pro JavaScript. Po připojení se pomocí příruček pro vývojáře dozvíte, jak váš kód funguje s kontejnery, objekty blob a funkcemi služby Blob Storage.

Pokud chcete začít s úplným příkladem, podívejte se na rychlý start klientské knihovny pro JavaScript nebo TypeScript.

Referenční informace k | rozhraní APIBalíček (npm) | Zdrojový kód | knihovnyVzorky | Váš názor

Požadavky

Nastavení projektu

Tato část vás provede přípravou projektu pro práci s klientskou knihovnou Azure Blob Storage pro JavaScript.

Otevřete příkazový řádek a přejděte do složky projektu. Změňte <project-directory> název složky:

cd <project-directory>

Pokud nemáte soubor package.json ve svém adresáři, inicializujte projekt a vytvořte soubor.

npm init -y

Z adresáře projektu nainstalujte balíčky pro klientské knihovny Azure Blob Storage a Azure Identity pomocí npm install příkazů nebo yarn add příkazů. Balíček @azure/identity je potřeba pro připojení bez hesla ke službám Azure.

npm install @azure/storage-blob @azure/identity

Autorizace přístupu a připojení ke službě Blob Storage

Pokud chcete připojit aplikaci ke službě Blob Storage, vytvořte instanci třídy BlobServiceClient . Tento objekt je vaším výchozím bodem pro interakci s datovými prostředky na úrovni účtu úložiště. Můžete jej použít ke správě účtu úložiště a jeho kontejnerů. Klienta služby můžete také použít k vytvoření klientů kontejnerů nebo klientů objektů blob v závislosti na prostředku, se kterým potřebujete pracovat.

Další informace o vytváření a správě klientských objektů, včetně osvědčených postupů, najdete v tématu Vytváření a správa klientských objektů, které pracují s datovými prostředky.

Objekt můžete autorizovat BlobServiceClient pomocí autorizačního tokenu Microsoft Entra, přístupového klíče účtu nebo sdíleného přístupového podpisu (SAS). Pro zajištění optimálního zabezpečení společnost Microsoft doporučuje používat Microsoft Entra ID společně se spravovanými identitami k autorizaci požadavků na data objektů blob. Další informace naleznete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Pokud chcete autorizovat pomocí ID Microsoft Entra, musíte použít bezpečnostní principál. Jaký typ objektu zabezpečení potřebujete, závisí na tom, kde vaše aplikace běží. Jako vodítko použijte následující tabulku:

Kde aplikace běží Bezpečnostní hlavní prvek Pokyny
Místní počítač (vývoj a testování) Hlavní služba Informace o registraci aplikace, nastavení skupiny Microsoft Entra, přiřazení rolí a konfigurace proměnných prostředí najdete v tématu Autorizace přístupu pomocí instančních objektů pro vývojáře.
Místní počítač (vývoj a testování) Identita uživatele Informace o nastavení skupiny Microsoft Entra, přiřazení rolí a přihlášení k Azure najdete v tématu Autorizace přístupu pomocí přihlašovacích údajů pro vývojáře.
Hostované v Azure Spravovaná identita Informace o povolení spravované identity a přiřazování rolí najdete v tématu Autorizace přístupu z aplikací hostovaných v Azure pomocí spravované identity.
Hostované mimo Azure (například místní aplikace) Hlavní služba Informace o registraci aplikace, přiřazení rolí a konfiguraci proměnných prostředí najdete v tématu Autorizace přístupu z místních aplikací pomocí instančního objektu aplikace.

Autorizace přístupu pomocí DefaultAzureCredential

Snadným a bezpečným způsobem autorizace přístupu a připojení ke službě Blob Storage je získání tokenu OAuth vytvořením instance DefaultAzureCredential . Tyto přihlašovací údaje pak můžete použít k vytvoření objektu BlobServiceClient .

Následující příklad vytvoří BlobServiceClient objekt pomocí DefaultAzureCredential:

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

Tento příklad kódu lze použít pro projekty JavaScriptu nebo TypeScriptu.

Vytvořte aplikaci

Při vytváření aplikací pro práci s datovými prostředky ve službě Azure Blob Storage váš kód primárně komunikuje se třemi typy prostředků: účty úložiště, kontejnery a objekty blob. Další informace o těchto typech prostředků, jejich vzájemných vztazích a o tom, jak aplikace interagují s prostředky, najdete v tématu Vysvětlení způsobu interakce aplikací s datovými prostředky Blob Storage.

Následující příručky ukazují, jak získat přístup k datům a provádět konkrétní akce pomocí klientské knihovny Azure Storage pro JavaScript:

Průvodce Popis
Konfigurujte zásady opakování Implementujte zásady opakování pro klientské operace.
Kopírování objektů blob Zkopírujte blob z jednoho umístění do druhého.
Vytvoření kontejneru Vytvořte kontejnery blob.
Vytvořit pověření uživatele SAS Vytvořte uživatelské delegování SAS pro kontejner nebo objekt blob.
Vytváření a správa pronájmu blobů Vytvořte a spravujte zámek objektu blob.
Vytváření a správa zapůjčení kontejnerů Vytvořte a spravujte zámek kontejneru.
Odstranění a obnovení Odstraňte objekty blob a obnovte měkce odstraněné objekty blob.
Odstranění a obnovení kontejnerů Odstraňte kontejnery a obnovte kontejnery, které byly měkce odstraněny.
Stažení blobů Stáhněte objekty blob pomocí textových řetězců, datových proudů a cest k souborům.
Vyhledání objektů blob pomocí značek Nastavte a načtěte tagy a použijte je k vyhledání blobů.
Seznam blobů Zobrazte bloby různými způsoby.
Výpis kontejnerů Vypište kontejnery v účtu a různé možnosti přizpůsobení výpisu.
Správa vlastností a metadat (objektů blob) Získejte a nastavte vlastnosti a metadata pro objekty blob.
Správa vlastností a metadat (kontejnerů) Získejte a nastavte vlastnosti a metadata u kontejnerů.
Ladění výkonu pro přenosy dat Optimalizujte výkon operací přenosu dat.
Nastavení nebo změna úrovně přístupu objektu blob Nastavte nebo změňte úroveň přístupu pro blokový blob.
Nahrání blobů Naučte se nahrávat blobs pomocí řetězců, streamů, cest k souborům a dalších metod.
  • Last updated on