Teilen über

Erstellen eines Blobcontainers mit Java

  • Artikel

Blobs in Azure Storage sind in Containern organisiert. Bevor Sie ein Blob hochladen können, müssen Sie zunächst einen Container erstellen. In diesem Artikel wird gezeigt, wie Container mit der Azure Storage-Clientbibliothek für Java erstellt werden.

Voraussetzungen

  • In diesem Artikel wird davon ausgegangen, dass Sie bereits ein Projekt für die Arbeit mit der Azure Blob Storage-Clientbibliothek für Java eingerichtet haben. Informationen zum Einrichten Ihres Projekts, einschließlich der Paketinstallation, dem Hinzufügen von import-Anweisungen und dem Erstellen eines autorisierten Clientobjekts, finden Sie unter Erste Schritte mit Azure Storage und Java.
  • Der Autorisierungsmechanismus muss über Berechtigungen zum Erstellen eines Blobcontainers verfügen. Weitere Informationen finden Sie im Autorisierungsleitfaden für die folgenden REST-API-Vorgänge:

Informationen zur Containerbenennung

Ein Containername muss ein gültiger DNS-Name sein, da er Teil des eindeutigen URI ist, der für die Adressierung des Containers oder seiner Blobs verwendet wird. Befolgen Sie diese Regeln, wenn Sie einen Container benennen:

  • Containernamen können zwischen 3 und 63 Zeichen lang sein.
  • Containernamen müssen mit einem Buchstaben oder einer Zahl beginnen und dürfen nur Kleinbuchstaben, Zahlen und Bindestriche (-) enthalten.
  • Aufeinanderfolgende Bindestriche sind in Containernamen nicht zulässig.

Der URI für eine Containerressource ist wie folgt formatiert:

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

Container erstellen

Um einen Container zu erstellen, rufen Sie eine der folgenden Methoden in der BlobServiceClient-Klasse auf:

Sie können einen Container auch mit einer der folgenden Methoden in der BlobContainerClient-Klasse erstellen:

Container werden direkt unterhalb des Speicherkontos erstellt. Es ist nicht möglich, einen Container unter einem anderen Container zu schachteln. Für die Methoden create und createBlobContainer wird eine Ausnahme ausgelöst, wenn bereits ein gleichnamiger Container vorhanden ist.

Im folgenden Beispiel wird ein Container aus einem BlobServiceClient-Objekt erstellt:

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

    return blobContainerClient;
}

Erstellen des Stammcontainers

Ein Stammcontainer dient als Standardcontainer für Ihr Speicherkonto. Jedes Speicherkonto kann über einen Stammcontainer verfügen, der den Namen $root tragen muss. Der Stammcontainer muss explizit erstellt oder gelöscht werden.

Sie können auf ein Blob verweisen, das im Stammcontainer gespeichert ist, ohne den Namen des Stammcontainers einzubeziehen. Der Stammcontainer ermöglicht das Verweisen auf ein Blob auf der obersten Ebene der Speicherkontohierarchie. Beispielsweise können Sie wie folgt auf ein Blob verweisen, das sich im Stammcontainer befindet:

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

Im folgenden Beispiel wird ein neues BlobContainerClient-Objekt mit dem Containernamen „$root“ erstellt. Dann wird der Container erstellt, falls er nicht bereits im Speicherkonto vorhanden ist:

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();
}

Ressourcen

Weitere Informationen zum Erstellen eines Containers mithilfe der Azure Blob Storage-Clientbibliothek für Java finden Sie in den folgenden Ressourcen.

REST-API-Vorgänge

Das SDK für Java enthält Bibliotheken, die auf der zugrunde liegenden Azure-REST-API basieren, und ermöglicht Ihnen dadurch die Interaktion mit REST-API-Vorgängen über vertraute Java-Paradigmen. Die Clientbibliotheksmethoden zum Erstellen eines Containers verwenden den folgenden REST-API-Vorgang:

Codebeispiele

Ressourcen zur Clientbibliothek