O que são os crates do SDK do Azure para Rust?

O SDK do Azure para caixas Rust permite que os aplicativos Rust acessem os serviços do Azure. Essas bibliotecas de cliente fornecem uma experiência consistente e idiomática, facilitando a criação de soluções de nuvem seguras e escalá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 caixas Rust

  • Rust idiomático: Desenvolvido de acordo com as melhores práticas e convenções da linguagem Rust.
  • Suporte assíncrono: APIs totalmente assíncronas com suporte para ambientes de execução intercambiáveis (com tokio por predefinição).
  • Segurança de tipo: Usa o sistema de tipo 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 as caixas que você precisa.
  • Configuração unificada: Configure clientes de serviço, registo e novas tentativas com ClientOptions.
  • Tratamento consistente de erros: lide com os erros de forma consistente em todos os serviços com azure_core::Error.
  • Tratamento de respostas: Aceda a dados detalhados da resposta HTTP com Response<T>.
  • Suporte de 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 padronizado de credenciais via TokenCredential.

Orientações sobre Rust

As diretrizes de design do SDK do Azure para Rust descrevem os principais princípios e padrões de design que todas as caixas do SDK do Azure seguem. Essas diretrizes garantem que os SDKs sejam consistentes, intuitivos e idiomáticas para o Rust, facilitando a adoção e o uso dos serviços do Azure pelos desenvolvedores. Ao aderir a esses padrões, as caixas 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.

  • As crates do SDK do Azure são a forma preferencial de aceder ao seu serviço do Azure. Estas crates abstraem o código repetitivo necessário para gerir pedidos REST da plataforma Azure na cloud, como autenticação, novas tentativas e registo.
  • As APIs REST do Azure são o método preferencial se você estiver:
    • Trabalhar com serviços que ainda não têm pacotes do Azure disponíveis. Migre o seu código para utilizar crates do SDK do Azure quando estas estiverem disponíveis.
    • Querer fazer chamadas REST diretamente porque você não quer usar a caixa inteira para usar uma única API REST ou quer um controle mais profundo sobre as solicitações HTTP.

Versão Rust

As caixas SDK do Azure suportam os serviços de Azure mais usados e adicionamos regularmente mais com base no feedback da comunidade e na procura.

SDK do Azure para crates de Rust

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

Próximos passos