Blobtároló létrehozása .NET-tel

  • Cikk

Az Azure Storage-beli blobok tárolókba vannak rendezve. Mielőtt feltölthet egy blobot, először létre kell hoznia egy tárolót. Ez a cikk bemutatja, hogyan hozhat létre tárolókat a .NET-hez készült Azure Storage ügyfélkódtárral.

Előfeltételek

  • Ez a cikk feltételezi, hogy már van beállítva egy projekt, amely a .NET Azure Blob Storage ügyfélkódtárával működik. A projekt beállításáról, beleértve a csomagtelepítést, az irányelvek hozzáadását using és az engedélyezett ügyfélobjektumok létrehozását, olvassa el az Első lépések a Azure Blob Storage és a .NET használatával című témakört.
  • Az engedélyezési mechanizmusnak engedélyekkel kell rendelkeznie egy blobtároló létrehozásához. További információért tekintse meg az alábbi REST API-művelet engedélyezési útmutatóját:

Tudnivalók a tároló elnevezéséről

A tároló nevének érvényes DNS-névnek kell lennie, mivel a tároló vagy a blobok címzéséhez használt egyedi URI részét képezi. Tároló elnevezésekor kövesse az alábbi szabályokat:

  • A tárolónevek hossza 3 és 63 karakter között lehet.
  • A tárolóneveknek betűvel vagy számmal kell kezdődniük, és csak kisbetűket, számokat és kötőjelet (-) tartalmazhatnak.
  • Az egymást követő kötőjelkarakterek nem használhatók a tárolónevekben.

A tárolóerőforrás URI-ja a következőképpen van formázva:

https://my-account-name.blob.core.windows.net/my-container-name

Tároló létrehozása

Tároló létrehozásához hívja meg a osztály alábbi metódusainak egyikét BlobServiceClient :

Tárolót a osztály alábbi metódusainak BlobContainerClient egyikével is létrehozhat:

Ezek a metódusok kivételt jeleznek, ha már létezik ilyen nevű tároló.

A tárolók közvetlenül a tárfiók alatt jönnek létre. Az egyik tárolót nem lehet egymás alá ágyazni.

Az alábbi példa egy BlobServiceClient objektumot használ egy tároló aszinkron létrehozásához:

//-------------------------------------------------
// Create a container
//-------------------------------------------------
private static async Task<BlobContainerClient> CreateSampleContainerAsync(BlobServiceClient blobServiceClient)
{
    // Name the sample container based on new GUID to ensure uniqueness.
    // The container name must be lowercase.
    string containerName = "container-" + Guid.NewGuid();

    try
    {
        // Create the container
        BlobContainerClient container = await blobServiceClient.CreateBlobContainerAsync(containerName);

        if (await container.ExistsAsync())
        {
            Console.WriteLine("Created container {0}", container.Name);
            return container;
        }
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine("HTTP error code {0}: {1}",
                            e.Status, e.ErrorCode);
        Console.WriteLine(e.Message);
    }

    return null;
}

A gyökértároló létrehozása

A gyökértároló a tárfiók alapértelmezett tárolójaként szolgál. Minden tárfiók rendelkezhet egy gyökértárolóval, amelyet $root kell nevezni. A gyökértárolót explicit módon létre kell hozni vagy törölni kell.

A gyökértárolóban tárolt blobra a gyökértároló nevének megadása nélkül hivatkozhat. A gyökértárolóval a tárfiók-hierarchia legfelső szintjén hivatkozhat egy blobra. Hivatkozhat például egy blobra, amely a gyökértárolóban található a következő módon:

https://myaccount.blob.core.windows.net/default.html

Az alábbi példa szinkron módon hozza létre a gyökértárolót:

//-------------------------------------------------
// Create root container
//-------------------------------------------------
private static void CreateRootContainer(BlobServiceClient blobServiceClient)
{
    try
    {
        // Create the root container or handle the exception if it already exists
        BlobContainerClient container =  blobServiceClient.CreateBlobContainer("$root");

        if (container.Exists())
        {
            Console.WriteLine("Created root container.");
        }
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine("HTTP error code {0}: {1}",
                            e.Status, e.ErrorCode);
        Console.WriteLine(e.Message);
    }
}

Források

A tárolók .NET-hez készült Azure Blob Storage-ügyfélkódtár használatával történő létrehozásáról az alábbi forrásokban olvashat bővebben.

REST API-műveletek

A .NET-hez készült Azure SDK olyan kódtárakat tartalmaz, amelyek az Azure REST API-ra épülnek, lehetővé téve a REST API-műveletek használatát a jól ismert .NET-paradigmákon keresztül. A tárolók létrehozásához használt ügyfélkódtár-metódusok a következő REST API-műveletet használják:

Ügyfélkódtár erőforrásai