Créer un conteneur d’objets blob avec JavaScript ou TypeScript
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 à l’aide de la bibliothèque de client de Stockage Azure pour JavaScript.
Prérequis
- Les exemples de cet article supposent que vous disposez déjà d'un projet configuré pour fonctionner avec la bibliothèque client Azure Blob Storage pour JavaScript. Pour en savoir plus sur la configuration de votre projet, y compris l’installation du package, l’importation de modules et la création d’un objet client autorisé à utiliser les ressources de données, consultez Prise en main de Stockage Blob Azure et JavaScript.
- 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, appelez la méthode suivante à partir de la classe BlobServiceClient :
Vous pouvez également créer un conteneur à l’aide de l’une des méthodes suivantes à partir de la classe ContainerClient :
Les conteneurs sont créés immédiatement sous le compte de stockage. Il n’est pas possible d’imbriquer un conteneur sous un autre. Une exception est levée s’il existe un conteneur portant le même nom.
L’exemple suivant crée un conteneur de manière asynchrone à partir d’un objet BlobServiceClient
:
async function createContainer(blobServiceClient, containerName){
const containerClient = await blobServiceClient.createContainer(containerName);
return containerClient;
}
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 objet blob situé dans le conteneur racine de la façon suivante :
https://accountname.blob.core.windows.net/default.html
Pour créer le conteneur racine, appelez la méthode de création de votre choix et indiquez le nom du conteneur sous la forme $root.
Ressources
Pour en savoir plus sur la création d’un conteneur à l’aide de la bibliothèque de client Stockage Blob Azure pour JavaScript, consultez les ressources suivantes.
Exemples de code
- Consultez des exemples de code JavaScript et TypeScript de cet article (GitHub)
Opérations de l'API REST
Le Kit de développement logiciel (SDK) Azure pour JavaScript contient des bibliothèques qui s’appuient sur l’API REST Azure, vous permettant d’interagir avec des opérations de l’API REST par le biais de paradigmes JavaScript familiers. Les méthodes de bibliothèque cliente pour créer un conteneur utilisent l’opération d’API REST suivante :
- Create Container (API REST)
Ressources de bibliothèque cliente
- Documentation de référence sur la bibliothèque cliente
- Code source de la bibliothèque de client
- Package (npm)
Contenu connexe
- Cet article fait partie du guide du développeur Stockage Blob pour JavaScript/Typescript. Pour en savoir plus, consultez la liste complète des articles du guide du développeur sur Générer votre application JavaScript/Typescript.