Partager via

Créer un conteneur d’objet blob avec .NET

  • Article

Les objets BLOB dans le stockage Azure sont organisés en conteneurs. Avant de pouvoir télécharger un objet BLOB, vous devez d’abord créer un conteneur. Cet article explique comment créer des conteneurs en utilisant la bibliothèque de client du Stockage Azure pour Java.

Prérequis

  • Cet article suppose que vous disposez déjà d'un projet configuré pour fonctionner avec la bibliothèque client Stockage Blob Azure pour Java. Pour en savoir plus sur la configuration de votre projet, notamment l’installation de package, l’ajout de directives import et l’autorisation d’un objet client, consultez Prise en main du Stockage Azure et Java.
  • Le mécanisme d’autorisation doit disposer des autorisations nécessaires à la création d’un conteneur d’objets blob. Pour en savoir plus, consultez les conseils d’autorisation pour l’opération d’API REST suivante :

À propos de la dénomination des conteneurs

Un nom de conteneur doit être un nom DNS valide, car il fait partie de l’URI unique utilisé pour adresser le conteneur ou ses objets BLOB. Suivez ces règles lorsque vous nommez un conteneur :

  • Les noms de conteneur doivent comprendre entre 3 et 63 caractères.
  • Les noms de conteneur doivent commencer par une lettre ou un chiffre, et peuvent comporter uniquement des lettres minuscules, des chiffres et des tirets (-).
  • Deux tirets consécutifs ne sont pas autorisés dans les noms de conteneurs.

L’URI d’une ressource de conteneur est mis en forme comme suit :

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

Créez un conteneur.

Pour créer un conteneur, utilisez l’une des méthodes suivantes de la classe BlobServiceClient :

Vous pouvez également créer un conteneur à l’aide de l’une des méthodes suivantes de la classe BlobContainerClient:

Les conteneurs sont créés immédiatement sous le compte de stockage. Il n’est pas possible d’imbriquer un conteneur sous un autre. Pour les méthodes create et createBlobContainer, une exception est levée s’il existe un conteneur du même nom.

L’exemple suivant crée un conteneur à partir d’un objet BlobServiceClient :

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

    return blobContainerClient;
}

Créer le conteneur racine

Un conteneur racine sert de conteneur par défaut pour votre compte de stockage. Chaque compte de stockage peut avoir un conteneur racine, qui doit être nommé $root. Le conteneur racine doit être créé ou supprimé de manière explicite.

Vous pouvez référencer un objet BLOB stocké dans le conteneur racine sans inclure le nom du conteneur racine. Le conteneur racine vous permet de référencer un objet BLOB au niveau supérieur de la hiérarchie du compte de stockage. Par exemple, vous pouvez référencer un blob qui réside dans le conteneur racine de la manière suivante :

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

L’exemple suivant crée un objet BlobContainerClient avec le nom de conteneur $root, puis crée le conteneur s’il n’existe pas déjà dans le compte de stockage :

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

Ressources

Pour en savoir plus sur la création d’un conteneur à l’aide de la bibliothèque cliente Stockage Blob Azure pour Java, consultez les ressources suivantes.

Opérations de l'API REST

Le Kit de développement logiciel (SDK) Azure pour Java contient des bibliothèques qui s'appuient sur l'API REST Azure, vous permettant d’interagir avec les opérations de l’API REST par le biais de paradigmes Java familiers. Les méthodes de bibliothèque cliente pour créer un conteneur utilisent l’opération d’API REST suivante :

Exemples de code

Ressources de bibliothèque cliente