Introdução ao Armazenamento de Blobs do Azure e ao JavaScript ou TypeScript

Este artigo mostra como se conectar ao Armazenamento de Blobs do Azure usando a biblioteca cliente do Armazenamento de Blobs do Azure para JavaScript. Depois de conectado, use os guias do desenvolvedor para saber como seu código pode operar em contêineres, blobs e recursos do serviço de Armazenamento de Blobs.

Se você estiver procurando começar com um exemplo completo, confira o início rápido da biblioteca de clientes para JavaScript ou TypeScript.

Referência de API | Pacote (npm) | Código-fonte da biblioteca | Amostras | Enviar comentários

Pré-requisitos

• Assinatura do Azure - criar uma gratuitamente
• Conta de armazenamento do Azure – criar uma conta de armazenamento
• Node.js LTS
• TypeScript, se aplicável
• Para aplicativos cliente (navegador), você precisa de ferramentas de agrupamento.

Configurar o seu projeto

Esta seção explica como preparar um projeto para funcionar com a biblioteca de clientes do Armazenamento de Blobs do Azure para JavaScript.

Abra um prompt de comando e navegue até a pasta do seu projeto. Altere <project-directory> para o nome da pasta:

cd <project-directory>

Se você ainda não tiver um arquivo package.json no diretório, inicialize o projeto para criar o arquivo:

npm init -y

No diretório do projeto, instale pacotes para as bibliotecas de cliente do Armazenamento de Blobs do Azure e do Azure Identity usando os comandos npm install ou yarn add. O pacote @azure/identity é necessário para conexões sem senha com os serviços do Azure.

npm install @azure/storage-blob @azure/identity

npm install typescript @azure/storage-blob @azure/identity

Autorizar o acesso e se conectar ao Armazenamento de Blobs

Para conectar um aplicativo ao Armazenamento de Blobs, crie uma instância da classe BlobServiceClient. Esse objeto é seu ponto de partida para interagir com os recursos de dados no nível da conta de armazenamento. Você pode usá-lo para operar na conta de armazenamento e nos respectivos contêineres. Você também pode usar o cliente de serviço para criar clientes de contêiner ou clientes de blob, dependendo do recurso com o qual você precisa trabalhar.

Para saber mais sobre como criar e gerenciar objetos clientes, inclusive as melhores práticas, confira Criar e gerenciar objetos de cliente que interagem com recursos de dados.

Autorize um objeto BlobServiceClient usando um token de autorização do Microsoft Entra, uma chave de acesso de conta ou uma SAS (assinatura de acesso compartilhado). Para otimizar a segurança, a Microsoft recomenda o uso do Microsoft Entra ID com identidades gerenciadas para autorizar solicitações contra dados de blob. Para obter mais informações, consulte Autorizar o acesso a blobs usando o Microsoft Entra ID.

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

const accountName = "<account-name>";
const sasToken = "<sas-token>";
const accountURL = `https://${accountName}.blob.core.windows.net?${sasToken}`;
const blobServiceClient = new BlobServiceClient(accountURL);

const credential = new StorageSharedKeyCredential(accountName, accountKey);
const blobServiceClient = new BlobServiceClient(
  `https://${accountName}.blob.core.windows.net`,
  credential
);

const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString);

Compilar o aplicativo

À medida que você cria aplicativos para trabalhar com recursos de dados no Armazenamento de Blobs do Azure, seu código interage principalmente com três tipos de recursos: contas de armazenamento, contêineres e blobs. Para saber mais sobre esses tipos de recursos, como eles se relacionam entre si e como os aplicativos interagem com os recursos, confira Entender como os aplicativos interagem com os recursos de dados do Armazenamento de Blobs.

Os guias a seguir mostram como acessar dados e executar ações específicas usando a biblioteca de clientes do Armazenamento do Microsoft Azure para JavaScript: