Sdílet prostřednictvím


Začínáme se službou Azure Blob Storage a .NET

Tento článek ukazuje, jak se připojit ke službě Azure Blob Storage pomocí klientské knihovny služby Azure Blob Storage pro .NET. 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á knihovna Azure Blob Storage pro .NET.

Ukázky | referenčního | kódu knihovny api (Balíček zdrojového kódu | knihovny NuGet) | – zpětnou vazbu

Požadavky

Nastavení projektu

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

Z adresáře projektu nainstalujte balíčky pro klientské knihovny Azure Blob Storage a Azure Identity pomocí dotnet add package příkazu. Balíček Azure.Identity je potřeba pro připojení bez hesla ke službám Azure.

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

Na začátek souboru kódu přidejte tyto using direktivy:

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

Informace o klientské knihovně objektů blob:

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 ho použít k provozu s účtem úložiště a jeho kontejnery. 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ů 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í microsoft doporučuje Microsoft Entra ID se spravovanými identitami autorizovat požadavky na data objektů blob. Další informace naleznete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Pokud chcete autorizovat s ID Microsoft Entra, budete muset použít objekt zabezpečení. Typ požadovaného objektu zabezpečení závisí na tom, kde vaše aplikace běží. Tuto tabulku použijte jako vodítko.

Kde aplikace běží Objekt zabezpečení Pokyny
Místní počítač (vývoj a testování) Instanční objekt 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) Instanční objekt 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 autorizovaný pomocí DefaultAzureCredential:

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

Pokud přesně víte, jaký typ přihlašovacích údajů použijete k ověřování uživatelů, můžete token OAuth získat pomocí jiných tříd v klientské knihovně identit Azure pro .NET. Tyto třídy jsou odvozeny z TokenCredential třídy.

Další informace o každém z těchto mechanismů autorizace najdete v tématu Autorizace přístupu k datům ve službě Azure Storage.

Sestavte 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 otěchtoch materiálech 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 .NET:

Průvodce Popis
Připojení dat k objektům blob Zjistěte, jak vytvořit doplňovací objekt blob a pak k němu připojit data.
Konfigurace zásad opakování Implementujte zásady opakování pro klientské operace.
Kopírování objektů blob Zkopírujte objekt blob z jednoho umístění do druhého.
Vytvoření kontejneru Vytvořte kontejnery.
Vytvoření SAS delegování uživatele Vytvořte SAS delegování uživatele pro kontejner nebo objekt blob.
Vytváření a správa zapůjčení objektů 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í objektů blob Odstraňte objekty blob a pokud je povolené obnovitelné odstranění, obnovte odstraněné objekty blob.
Odstranění a obnovení kontejnerů Odstraňte kontejnery a pokud je povolené obnovitelné odstranění, obnovte odstraněné kontejnery.
Stažení objektů blob Stáhněte objekty blob pomocí řetězců, datových proudů a cest k souborům.
Vyhledání objektů blob pomocí značek Nastavte a načtěte značky a použijte značky k vyhledání objektů blob.
Výpis objektů blob Výpis objektů blob různými způsoby
Výpis kontejnerů Vypište kontejnery v účtu a různé možnosti, které můžete přizpůsobit výpis.
Správa vlastností a metadat Získejte a nastavte vlastnosti a metadata pro objekty blob.
Správa vlastností a metadat Získejte a nastavte vlastnosti a metadata pro kontejnery.
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 objekt blob bloku.
Nahrání objektů blob Naučte se nahrávat objekty blob pomocí řetězců, datových proudů, cest k souborům a dalších metod.