Creación de un contenedor de blobs con JavaScript
Los blobs de Azure Storage se organizan en contenedores. Antes de poder cargar un blob, primero debe crear un contenedor. En este artículo se muestra cómo crear contenedores con la biblioteca cliente de Azure Storage para JavaScript.
Requisitos previos
- Los ejemplos de este artículo asumen que ya tiene un proyecto configurado para trabajar con la librería cliente Azure Blob Storage para JavaScript. Para obtener más información sobre la configuración del proyecto, incluida la instalación de paquetes, la importación de módulos y la creación de un objeto cliente autorizado para trabajar con recursos de datos, consulte Introducción a Azure Blob Storage y JavaScript.
- El mecanismo de autorización debe tener permisos para trabajar con un contenedor de blobs. Para obtener más información, consulte la guía de autorización para la siguiente operación de la API de REST:
Acerca de la nomenclatura de contenedores
Un nombre de contenedor debe ser un nombre DNS válido, ya que forma parte del URI único que se usa para direccionar el contenedor o sus blobs. Siga estas reglas al asignar un nombre a un contenedor:
- Los nombres de contenedor pueden tener entre 3 y 63 caracteres.
- Los nombres de contenedor deben comenzar por una letra o un número, y solo pueden contener letras en minúscula, números y el carácter de guión (-).
- Los guiones consecutivos no están permitidos en los nombres de contenedores.
El URI de un recurso contenedor tiene el siguiente formato:
https://my-account-name.blob.core.windows.net/my-container-name
Crear un contenedor
Para crear un contenedor, cree un objeto BlobServiceClient o un objeto ContainerClient y, a continuación, use uno de los métodos "create" siguientes:
Los contenedores se crean inmediatamente debajo de la cuenta de almacenamiento. No es posible anidar un contenedor debajo de otro. Se genera una excepción si ya existe un contenedor con el mismo nombre.
En el ejemplo siguiente se crea un contenedor de forma asincrónica a partir de BlobServiceClient:
async function createContainer(blobServiceClient, containerName){
// anonymous access at container level
const options = {
access: 'container'
};
// creating client also creates container
const containerClient = await blobServiceClient.createContainer(containerName, options);
console.log(`container ${containerName} created`);
// do something with container
// ...
return containerClient;
}
Descripción del contenedor raíz
Un contenedor raíz con el nombre específico $root permite hacer referencia a un blob en el nivel superior de la jerarquía de la cuenta de almacenamiento. Por ejemplo, puede hacer referencia a un blob sin usar un nombre de contenedor en el URI:
https://myaccount.blob.core.windows.net/default.html
El contenedor raíz debe crearse o eliminarse explícitamente. No se crea de forma predeterminada como parte de la creación del servicio. El mismo código que se muestra en la sección anterior puede crear la raíz. $root es el nombre del contenedor.
Recursos
Para más información sobre cómo crear un contenedor con la biblioteca cliente de Azure Blob Storage para JavaScript, consulte los recursos siguientes.
Operaciones de API REST
El SDK de Azure para JavaScript contiene bibliotecas que se crean a partir de la API REST de Azure, lo que le permite interactuar con las operaciones de API REST a través de paradigmas conocidos de JavaScript. Los métodos de la biblioteca cliente para crear un contenedor usan esta operación de API REST:
- Create Container (API REST)