O que são os crates do SDK do Azure para 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.

Crates | Documentação de referência da API | Código-fonte

Principais conceitos do SDK do Azure para crates do Rust

  • Rust idiomático: desenvolvido com práticas recomendadas e convenções do Rust.
  • Suporte assíncrono: APIs totalmente assíncronas com suporte a runtime conectável (usando tokio por padrão).
  • 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 seguros para threads e independentes entre si.
  • 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, registro em log e novas tentativas 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> para fluxos assíncronos.
  • Operações de longa duração: Aguarde a operação de longa duração (LRO) 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 crates 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. Essas bibliotecas encapsulam o código repetitivo necessário para gerenciar solicitações REST da plataforma de nuvem Azure, como autenticação, novas tentativas e registro em logs.
  • 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 oferecem suporte aos serviços do Azure mais comumente usados, e adicionamos novos serviços regularmente com base no feedback da comunidade e na demanda.

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

  • Last updated on