Compartilhar via


O que são o SDK do Azure para caixas do Rust?

Os crates do SDK do Azure para Rust permitem que os aplicativos Rust acessem os serviços do Azure. Essas bibliotecas de clientes fornecem uma experiência consistente e idiomática, facilitando a criação de soluções de nuvem seguras e escalonáveis com o Rust e o Azure.

Caixas | Documentação | Código-fonte

Principais conceitos do SDK do Azure para crates do Rust

  • Ferrugem Idiomática: criada com as melhores práticas e convenções do Rust.
  • Suporte assíncrono: APIs totalmente assíncronas com suporte de runtime pluggable (padrão para tokio).
  • Segurança de tipo: usa o sistema de tipos do Rust para segurança em tempo de compilação.
  • Segurança de thread: todos os métodos de instância do cliente são thread-safe e independentes uns dos outros.
  • Segurança de memória: abstrações de custo zero sem sobrecarga de coleta de lixo.
  • Design modular: use apenas os crates necessários.
  • Configuração unificada: configurar clientes de serviço, registrar em log e tentar novamente com ClientOptions.
  • Tratamento consistente de erros: manipular erros consistentemente entre serviços com azure_core::Error.
  • Tratamento de resposta: acessar dados detalhados de resposta HTTP com Response<T>.
  • Suporte à paginação: trabalhe com APIs paginadas usando Pager<T> fluxos assíncronos.
  • Operações de execução longa: Aguarde por LRO (operação de execução prolongada) com Poller<T>
  • Abstrações de autenticação: gerenciamento de credenciais padronizadas por meio de TokenCredential.

Diretrizes do Rust

As diretrizes de design do SDK do Azure para Rust descrevem os principais princípios e padrões de design que todos os crates do SDK do Azure seguem. Essas diretrizes garantem que os SDKs sejam consistentes, intuitivos e idiomas para o Rust, facilitando a adoção e o uso dos serviços do Azure pelos desenvolvedores. Ao aderir a esses padrões, os crates do SDK do Azure fornecem uma experiência familiar e previsível, com padrões claros para autenticação, tratamento de erros e configuração de cliente que se alinham com o ecossistema mais amplo do SDK do Azure.

Diferenças entre caixas e APIs REST

Use as informações a seguir para entender quando usar cada tipo de acesso.

  • Os crates do SDK do Azure são o método preferencial para acessar seu serviço do Azure. Esses crates abstraem o código clichê necessário para gerenciar solicitações REST da plataforma do Azure baseadas em nuvem, como autenticação, repetições e registro em log.
  • As APIs REST do Azure são o método preferencial se você for:
    • Trabalhando com serviços que ainda não têm crates do Azure disponíveis. Migre seu código para usar os crates do SDK do Azure quando os crates estiverem disponíveis.
    • Desejando fazer chamadas REST diretamente porque você não deseja usar o crate inteiro para usar uma única API REST ou deseja um controle mais profundo sobre as solicitações HTTP.

Versão do Rust

Os crates do SDK do Azure estão atualmente em beta. Enquanto as APIs estão se estabilizando e os crates são adequados para desenvolvimento e teste, algumas alterações significativas podem ocorrer antes da versão 1.0. Esses crates dão suporte aos serviços do Azure mais usados e adicionamos regularmente mais com base nos comentários e na demanda da comunidade .

SDK do Azure para crates do Rust

Use o índice do SDK do Azure para crates do Rust para encontrar os crates disponíveis, a documentação e o código fonte.

Próximas etapas