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 das instâncias 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, 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 execução prolongada: aguarde a finalização de uma operação de longa duração (LRO) usando 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.

Crates do SDK do Azure para Rust

Utilize o índice de crates do SDK do Azure para Rust para localizar os crates disponíveis, a documentação correspondente e o código-fonte.

Próximas etapas

  • Last updated on