Criar um contêiner de blob com JavaScript ou TypeScript

  • Artigo

Os blobs no Armazenamento do Azure são organizados em contêineres. Antes de carregar um blob, é necessário primeiro criar um contêiner. Este artigo mostra como criar contêineres com a biblioteca de clientes do Armazenamento do Azure para JavaScript.

Pré-requisitos

  • Os exemplos neste artigo pressupõem que você já tenha um projeto configurado para trabalhar com a biblioteca de clientes do Armazenamento de Blobs do Azure para JavaScript. Para saber mais sobre a configuração do seu projeto, incluindo a instalação de pacotes, a importação de módulos e a criação de um objeto cliente autorizado para trabalhar com recursos de dados, confira Introdução ao Armazenamento de Blobs do Azure e o JavaScript.
  • O mecanismo de autorização deve ter permissões para criar um contêiner de blob. Para saber mais, consulte as diretrizes de autorização para as seguintes operações de API REST:

Sobre a nomenclatura de contêiner

Um nome de contêiner deve ser um nome DNS válido, pois ele faz parte do URI exclusivo usado para endereçar o contêiner ou seus blobs. Siga estas regras ao nomear um contêiner:

  • O comprimento dos nomes do contêiner pode ser entre 3 e 63  aracteres.
  • Os nomes de contêiner devem começar com uma letra ou número e podem conter apenas letras minúsculas, números e o caractere traço (-).
  • Caracteres de traço consecutivos não são permitidos em nomes de contêineres.

O URI de um recurso de contêiner é formatado da seguinte maneira:

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

Criar um contêiner

Para criar um contêiner, chame o seguinte método da classe BlobServiceClient:

Você também pode criar um contêiner usando um dos seguintes métodos da classe ContainerClient:

Os contêineres são criados imediatamente sob a conta de armazenamento. Não é possível aninhar um contêiner sob outro. Uma exceção será lançada se já existir um contêiner com o mesmo nome.

O seguinte exemplo cria um contêiner de maneira assíncrona um objeto BlobServiceClient:

async function createContainer(blobServiceClient, containerName){
  
  const containerClient = await blobServiceClient.createContainer(containerName);

  return containerClient;
}

Criar o contêiner raiz

Um contêiner raiz funciona como um contêiner padrão para sua conta de armazenamento. Cada conta de armazenamento pode ter um contêiner raiz, que deve ser nomeado $root. O contêiner raiz deve ser explicitamente criado ou excluído.

Você pode fazer referência a um blob armazenado no contêiner raiz sem incluir o nome do contêiner raiz. O contêiner raiz permite que você consulte um blob no nível superior da hierarquia da conta de armazenamento. Por exemplo, você pode fazer referência a um blob no contêiner raiz da seguinte maneira:

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

Para criar o contêiner raiz, chame qualquer método create e especifique o nome do contêiner como $root.

Recursos

Para saber mais sobre como criar um contêiner usando a biblioteca de clientes do Armazenamento de Blobs do Azure para JavaScript, consulte os recursos a seguir.

Exemplos de código

Operações da API REST

O SDK do Azure para JavaScript contém bibliotecas que se baseiam na API REST do Azure, permitindo a interação com as operações de API REST por meio de paradigmas conhecidos do JavaScript. Os métodos da biblioteca de clientes para criar um contêiner usam a seguinte operação de API REST:

Recursos da biblioteca de clientes

Conteúdo relacionado

  • Este artigo faz parte do guia para desenvolvedores do Armazenamento de Blobs para JavaScript/Typescript. Para saber mais, confira a lista completa de artigos do guia do desenvolvedor em Criar seu aplicativo JavaScript/Typescript.