Az Azure Blob Storage és a .NET használatának első lépései

Cikk
10/18/2023

Ez a cikk bemutatja, hogyan csatlakozhat az Azure Blob Storage-hoz az Azure Blob Storage .NET-hez készült ügyfélkódtárával. A csatlakozás után a kód a Blob Storage szolgáltatás tárolóira, blobokra és funkcióira is képes.

API-referencia kódtár forráskódcsomagja | (NuGet) | -minták | Visszajelzés küldése |

Előfeltételek

Azure-előfizetés – hozzon létre egyet ingyenesen
Azure Storage-fiók – tárfiók létrehozása
Az operációs rendszer aktuális .NET SDK-ja . Mindenképpen szerezze be az SDK-t, és ne a futtatókörnyezetet.

A projekt beállítása

Ez a szakasz végigvezeti egy projekt előkészítésén az Azure Blob Storage .NET-hez készült ügyfélkódtárával való együttműködésre.

A projektkönyvtárból telepítse az Azure Blob Storage- és Az Azure Identity-ügyfélkódtárak csomagjait a dotnet add package paranccsal. Az Azure.Identity-csomagra az Azure-szolgáltatásokhoz való jelszó nélküli kapcsolatokhoz van szükség.

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

Adja hozzá ezeket az using utasításokat a kódfájl elejéhez.

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

Blob ügyféloldali kódtár adatai:

Azure.Storage.Blobs: A szolgáltatáson, tárolókon és blobokon való működéshez használható elsődleges osztályokat (ügyfélobjektumokat) tartalmazza.
Azure.Storage.Blobs.Specializált: Olyan osztályokat tartalmaz, amelyekkel egy blobtípusra, például blokkblobokra jellemző műveleteket hajthat végre.
Azure.Storage.Blobs.Models: Minden más segédprogramosztály, struktúra és enumerálási típus.

Hozzáférés engedélyezése és csatlakozás a Blob Storage-hoz

Ha egy alkalmazást a Blob Storage-hoz szeretne csatlakoztatni, hozza létre a BlobServiceClient osztály egy példányát. Ez az objektum a kiindulási pont az adaterőforrások tárfiók szintjén való használatához. Használhatja a tárfiókon és annak tárolóin való működéshez. A szolgáltatásügyfél használatával tárolóügyfeleket vagy blobügyfeleket is létrehozhat, attól függően, hogy milyen erőforrással kell dolgoznia.

Az ügyfélobjektumok létrehozásáról és kezeléséről további információt az adaterőforrásokat kezelő ügyfélobjektumok létrehozása és kezelése című témakörben talál.

Az objektumokat BlobServiceClient Microsoft Entra engedélyezési jogkivonat, fiókhozzáférési kulcs vagy közös hozzáférésű jogosultságkód (SAS) használatával engedélyezheti.

Ha többet szeretne megtudni ezekről az engedélyezési mechanizmusokról, olvassa el az Adatokhoz való hozzáférés engedélyezése az Azure Storage-ban című témakört.

A Microsoft Entra-azonosítóval való engedélyezéshez biztonsági tagot kell használnia. A szükséges biztonsági tag típusa attól függ, hogy az alkalmazás hol fut. Használja ezt a táblázatot útmutatóként.

Az alkalmazás futtatásának helye	Rendszerbiztonsági tag	Útmutató
Helyi gép (fejlesztés és tesztelés)	Service principal	Az alkalmazás regisztrálásához, a Microsoft Entra-csoport beállításához, a szerepkörök hozzárendeléséhez és a környezeti változók konfigurálásához lásd : Hozzáférés engedélyezése fejlesztői szolgáltatásnevek használatával
Helyi gép (fejlesztés és tesztelés)	Felhasználói azonosító	A Microsoft Entra-csoport beállításáról, a szerepkörök hozzárendeléséről és az Azure-ba való bejelentkezésről további információt a hozzáférés engedélyezése fejlesztői hitelesítő adatokkal című témakörben talál .
Az Azure-ban üzemeltetve	Managed identity	A felügyelt identitás engedélyezéséről és a szerepkörök hozzárendeléséről további információt az Azure által üzemeltetett alkalmazások hozzáférésének engedélyezése felügyelt identitással című témakörben talál .
Az Azure-on kívül üzemeltetett (például helyszíni alkalmazások)	Service principal	Az alkalmazás regisztrálásához, szerepkörök hozzárendeléséhez és környezeti változók konfigurálásához lásd : Hozzáférés engedélyezése helyszíni alkalmazásokból egy alkalmazásszolgáltatás-egyszerű használatával

Hozzáférés engedélyezése a DefaultAzureCredential használatával

A Blob Storage-hoz való hozzáférés és csatlakozás engedélyezésének egyszerű és biztonságos módja egy OAuth-jogkivonat beszerzése DefaultAzureCredential-példány létrehozásával. Ezt követően a hitelesítő adatok használatával létrehozhat egy BlobServiceClient objektumot.

Az alábbi példa létrehoz egy BlobServiceClient , a következővel DefaultAzureCredentialengedélyezett objektumot:

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

    return client;
}

Ha pontosan tudja, hogy milyen hitelesítő adattípust fog használni a felhasználók hitelesítéséhez, az OAuth-jogkivonatot a .NET-hez készült Azure Identity ügyfélkódtár más osztályai segítségével szerezheti be. Ezek az osztályok a TokenCredential osztályból származnak.

Hozzon létre egy Uri-t a blobszolgáltatás végpontja és az SAS-jogkivonat használatával. Ezután hozzon létre egy BlobServiceClientet az Uri használatával.

public static void GetBlobServiceClientSAS(ref BlobServiceClient blobServiceClient,
    string accountName, string sasToken)
{
    string blobUri = "https://" + accountName + ".blob.core.windows.net";

    blobServiceClient = new BlobServiceClient
    (new Uri($"{blobUri}?{sasToken}"), null);
}

Az SAS-jogkivonatok létrehozásával és kezelésével kapcsolatos további információkért tekintse meg az alábbi cikkeket:

Hozzon létre egy StorageSharedKeyCredential azonosítót a tárfiók nevével és a fiókkulcsával. Ezután használja ezt az objektumot egy BlobServiceClient inicializálásához.

public static void GetBlobServiceClient(ref BlobServiceClient blobServiceClient,
    string accountName, string accountKey)
{
    Azure.Storage.StorageSharedKeyCredential sharedKeyCredential =
        new StorageSharedKeyCredential(accountName, accountKey);

    string blobUri = "https://" + accountName + ".blob.core.windows.net";

    blobServiceClient = new BlobServiceClient
        (new Uri(blobUri), sharedKeyCredential);
}

BlobServiceClientet kapcsolati sztring is létrehozhat.

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);

A fiókkulcsok beszerzéséről és a kulcsok megfelelő kezelésére és védelmére vonatkozó ajánlott eljárásokról további információt a tárfiók hozzáférési kulcsainak kezelése című témakörben talál.

Fontos

A fiók hozzáférési kulcsát körültekintően kell használni. Ha a fiók hozzáférési kulcsa elveszett vagy véletlenül nem biztonságos helyre került, a szolgáltatás sebezhetővé válhat. Bárki, aki rendelkezik a hozzáférési kulccsal, engedélyezheti a tárfiókra irányuló kérelmeket, és hatékonyan hozzáférhet az összes adathoz. DefaultAzureCredential továbbfejlesztett biztonsági funkciókat és előnyöket biztosít, és az Azure-szolgáltatásokhoz való engedélyezés kezelésének ajánlott megközelítése.

Ha többet szeretne megtudni ezekről az engedélyezési mechanizmusokról, olvassa el az Adatokhoz való hozzáférés engedélyezése az Azure Storage-ban című témakört.

Az alkalmazás összeállítása

Amikor az Azure Blob Storage-ban adaterőforrásokat tartalmazó alkalmazásokat hoz létre, a kód elsősorban három erőforrástípussal dolgozik: tárfiókokkal, tárolókkal és blobokkal. Ha többet szeretne megtudni ezekről az erőforrástípusokról, az egymáshoz való viszonyukról és az alkalmazások erőforrásokkal való interakciójáról, olvassa el a Blob Storage-adaterőforrásokkal való interakciót ismertető témakört.

Az alábbi útmutatók bemutatják, hogyan használhatja az adaterőforrásokat, és hogyan hajthat végre konkrét műveleteket a .NET-hez készült Azure Storage-ügyfélkódtár használatával:

Útmutató	Leírás
Tároló létrehozása	Tárolók létrehozása.
Tárolók törlése és visszaállítása	Tárolók törlése, és ha engedélyezve van a helyreállítható törlés, állítsa vissza a törölt tárolókat.
Tárolók listázása	Egy fiók tárolóinak listázása és a lista testreszabásához elérhető különféle lehetőségek.
Tulajdonságok és metaadatok kezelése	Tárolók tulajdonságainak és metaadatainak lekérése és beállítása.
Tárolóbérletek létrehozása és kezelése	Tároló zárolásának létrehozása és kezelése.
Blobbérletek létrehozása és kezelése	Blob zárolásának létrehozása és kezelése.
Adatok hozzáfűzése blobokhoz	Megtudhatja, hogyan hozhat létre hozzáfűző blobot, majd fűzhet hozzá adatokat az adott blobhoz.
Blobok feltöltése	Megtudhatja, hogyan tölthet fel blobokat sztringek, streamek, fájlelérési utak és egyéb módszerek használatával.
Blobok letöltése	Töltse le a blobokat sztringek, streamek és fájlelérési utak használatával.
Blobok másolása	Blob másolása egyik helyről a másikra.
Blobok listázása	Blobok listázása különböző módokon.
Törlés és visszaállítás	Blobok törlése, és ha engedélyezve van a helyreállítható törlés, állítsa vissza a törölt blobokat.
Blobok keresése címkékkel	Címkék beállítása és lekérése, valamint címkék használata a blobok kereséséhez.
Tulajdonságok és metaadatok kezelése	Blobok tulajdonságainak és metaadatainak lekérése és beállítása.
Blob hozzáférési szintjének beállítása vagy módosítása	Blokkblob hozzáférési szintjének beállítása vagy módosítása.

Share via