SDK do Azure Blob Storage para Rust

Biblioteca cliente para o Azure Blob Storage — a solução de armazenamento de objetos da Microsoft na nuvem.

Os exemplos abaixo exigem um conjunto de crates compatíveis revisados e a substituição de cada placeholder de recurso. Não use dados de produção para gravações de demonstração.

Instalação

cargo add azure_storage_blob@=1.1.0 azure_identity@=1.0.0 azure_core@=1.1.0

Variáveis de Ambiente

export AZURE_STORAGE_ACCOUNT_NAME="<storage-account-name>"
# Endpoint: https://<account>.blob.core.windows.net/

Autenticação

use azure_identity::DeveloperToolsCredential;
use azure_core::http::Url;
use azure_storage_blob::clients::{BlobClient, BlobClientOptions};

let credential = DeveloperToolsCredential::new(None)?;
let blob_client = BlobClient::new(
    Url::parse("https://<account>.blob.core.windows.net/container-name/blob-name")?,
    Some(credential),
    Some(BlobClientOptions::default()),
)?;

Tipos de Cliente

Operações Principais

Upload de Blob

use azure_core::http::RequestContent;
use azure_storage_blob::models::BlobClientUploadOptions;

let data = b"hello world";
blob_client
    .upload(
        RequestContent::from(data.to_vec()),
        Some(BlobClientUploadOptions::if_not_exists()), // fail rather than overwrite an existing blob
    )
    .await?;

Download de Blob

let response = blob_client.download(None).await?;
// Check the approved size before fetching; use download_into with a bounded buffer for large data.
let content = response.body.collect().await?;
// Process authorized bytes; do not log the payload.

Obter Propriedades do Blob

let properties = blob_client.get_properties(None).await?;
// Read the version-specific response header trait; properties is a response, not a content_length field.
// Do not infer a body/size limit from successful metadata access alone.

Excluir Blob

blob_client.delete(None).await?;

Operações de Contêiner

use azure_storage_blob::clients::BlobContainerClient;
use futures::TryStreamExt;

let container_client = BlobContainerClient::new(
    Url::parse("https://<account>.blob.core.windows.net/container-name")?,
    Some(credential),
    None,
)?;

// Create container
container_client.create(None).await?;

// List blobs
let mut pager = container_client.list_blobs(None)?;
while let Some(page) = pager.try_next().await? {
    let listing = page.into_model()?;
    // Process this listing page; apply an explicit maximum-page budget.
}

Melhores Práticas

1. Use autenticação do Entra ID — DeveloperToolsCredential para desenvolvimento, ManagedIdentityCredential para produção
2. Revise o comportamento de sobrescrita — a API de upload revisada usa opções; if_not_exists impede substituições não intencionais
3. Use RequestContent::from() — para encapsular dados de upload
4. Manipule operações assíncronas — use o runtime tokio
5. Verifique as permissões RBAC — garanta a função "Colaborador de Dados do Blob de Armazenamento"

Permissões RBAC

Para autenticação do Entra ID, atribua uma destas funções:

• Storage Blob Data Reader — somente leitura
• Storage Blob Data Contributor — leitura/escrita
• Storage Blob Data Owner — acesso a dados de blob e gerenciamento de propriedade/ACL compatível; não concede autoridade geral de atribuição de função RBAC do Azure

A API de exemplo segue o BlobClient 1.1.0; versões anteriores usavam assinaturas de construtor/upload diferentes. Use as versões de crate Azure compatíveis do projeto em vez de misturá-las.

O conjunto de exemplos revisado usa azure_storage_blob 1.1.0 e crates de credenciais/núcleo Azure compatíveis. Registre e confirme o Cargo.lock; a revisão de código-fonte/API não é um teste de compilador ou de serviço ativo.

Links de Referência

Quando Usar

Use quando um aplicativo Rust faz upload/download de um blob Azure especificado, lê suas propriedades ou gerencia um contêiner autorizado.

Limitações

…