Dela via

Skapa en blobcontainer med Java

  • Artikel

Blobar i Azure Storage är ordnade i containrar. Innan du kan ladda upp en blob måste du först skapa en container. Den här artikeln visar hur du skapar containrar med Azure Storage-klientbiblioteket för Java.

Förutsättningar

  • Den här artikeln förutsätter att du redan har ett projekt konfigurerat för att fungera med Azure Blob Storage-klientbiblioteket för Java. Mer information om hur du konfigurerar projektet, inklusive paketinstallation, tillägg import av direktiv och skapande av ett auktoriserat klientobjekt finns i Komma igång med Azure Storage och Java.
  • Auktoriseringsmekanismen måste ha behörighet att skapa en blobcontainer. Mer information finns i auktoriseringsvägledningen för följande REST API-åtgärd:

Om namngivning av containrar

Ett containernamn måste vara ett giltigt DNS-namn eftersom det utgör en del av den unika URI som används för att adressera containern eller dess blobar. Följ dessa regler när du namnger en container:

  • Containernamn kan vara mellan 3 och 63 tecken långa.
  • Containernamn måste börja med en bokstav eller siffra och får endast innehålla gemener, siffror och bindestreck (-).
  • På varandra följande bindestreckstecken tillåts inte i containernamn.

URI:n för en containerresurs är formaterad på följande sätt:

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

Skapa en container

Om du vill skapa en container anropar du någon av följande metoder från BlobServiceClient klassen:

Du kan också skapa en container med någon av följande metoder från BlobContainerClient klassen:

Containrar skapas omedelbart under lagringskontot. Det går inte att kapsla en container under en annan. create För metoderna och createBlobContainer genereras ett undantag om det redan finns en container med samma namn.

I följande exempel skapas en container från ett BlobServiceClient objekt:

public BlobContainerClient createContainer(BlobServiceClient blobServiceClient, String containerName) {
    // Create the container using the service client object
    BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer(containerName);

    return blobContainerClient;
}

Skapa rotcontainern

En rotcontainer fungerar som standardcontainer för ditt lagringskonto. Varje lagringskonto kan ha en rotcontainer som måste ha namnet $root. Rotcontainern måste skapas eller tas bort uttryckligen.

Du kan referera till en blob som lagras i rotcontainern utan att inkludera rotcontainerns namn. Med rotcontainern kan du referera till en blob på den översta nivån i lagringskontohierarkin. Du kan till exempel referera till en blob som finns i rotcontainern på följande sätt:

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

I följande exempel skapas ett nytt BlobContainerClient objekt med containernamnet $root och skapar sedan containern om den inte redan finns i lagringskontot:

public void createRootContainer(BlobServiceClient blobServiceClient) {
    // Creates a new BlobContainerClient object by appending the containerName to
    // the end of the URI
    BlobContainerClient blobContainerClient = blobServiceClient.getBlobContainerClient("$root");

    // If the container does not already exist, create it using the container client
    blobContainerClient.createIfNotExists();
}

Resurser

Mer information om hur du skapar en container med hjälp av Azure Blob Storage-klientbiblioteket för Java finns i följande resurser.

REST API-åtgärder

Azure SDK för Java innehåller bibliotek som bygger på Azure REST API, så att du kan interagera med REST API-åtgärder via välbekanta Java-paradigm. Klientbiblioteksmetoderna för att skapa en container använder följande REST API-åtgärd:

Kodexempel

Klientbiblioteksresurser