Dela via

Vad är Azure SDK för Rust-lådor?

Med Azure SDK för Rust-lådor kan Rust-program komma åt Azure-tjänster. Dessa klientbibliotek ger en konsekvent, idiomatisk upplevelse, vilket gör det enklare att skapa säkra och skalbara molnlösningar med Rust och Azure.

Lådor | API-referensdokumentation | Källkod

Viktiga begrepp för Azure SDK för Rust-lådor

  • Idiomatisk rust: Byggd med metodtips och konventioner för Rust.
  • Async-stöd: Fullständigt asynkrona API:er med stöd för anslutningbar körning (som standard tokio).
  • Typsäkerhet: Använder Rusts typsystem för kompileringstidssäkerhet.
  • Trådsäkerhet: Alla klientinstansmetoder är trådsäkra och oberoende av varandra.
  • Minnessäkerhet: Nollkostnadsabstraktioner utan kostnader för skräpinsamling.
  • Modulär design: Använd bara de lådor du behöver.
  • Enhetlig konfiguration: Konfigurera tjänstklienter, loggning och återförsök med ClientOptions.
  • Konsekvent felhantering: Hantera fel konsekvent mellan tjänster med azure_core::Error.
  • Svarshantering: Få åtkomst till detaljerade HTTP-svarsdata med Response<T>.
  • Stöd för sidnumrering: Arbeta med sidnumrerade API:er med hjälp Pager<T> av för asynkrona strömmar.
  • Tidskrävande åtgärder: Vänta på tidskrävande åtgärder (LRO) med Poller<T>
  • Autentiseringsabstraktioner: Standardiserad hantering av autentiseringsuppgifter via TokenCredential.

Rust-vägledning

Designriktlinjerna för Azure SDK för Rust beskriver de grundläggande designprinciper och mönster som alla Azure SDK-lådor följer. Dessa riktlinjer säkerställer att SDK:er är konsekventa, intuitiva och idiomatiska för Rust, vilket gör det enklare för utvecklare att införa och använda Azure-tjänster. Genom att följa dessa standarder ger Azure SDK-lådorna en välbekant och förutsägbar upplevelse med tydliga mönster för autentisering, felhantering och klientkonfiguration som överensstämmer med det bredare Azure SDK-ekosystemet.

Skillnader mellan crates och REST API:er

Använd följande information för att förstå när du ska använda varje typ av åtkomst.

  • Azure SDK-lådor är den bästa metoden för att komma åt din Azure-tjänst. Dessa crates abstraherar bort den pannplåtskod som krävs för att hantera molnbaserade REST-begäranden för Azure-plattformen, till exempel autentisering, återförsök och loggning.
  • Azure REST-API:er är den bästa metoden om du är:
    • Arbeta med tjänster som inte har Tillgängliga Azure-lådor ännu. Migrera din kod för att använda Azure SDK-lådor när lådorna blir tillgängliga.
    • Vill du göra REST-anrop direkt eftersom du inte vill använda hela lådan för att använda ett enda REST-API eller om du vill ha djupare kontroll över HTTP-begäranden.

Rust-version

Azure SDK-lådorna är för närvarande i betaversion. Api:erna stabiliseras och lådorna är lämpliga för utveckling och testning, men vissa icke-bakåtkompatibla ändringar kan inträffa före 1.0-versionen. Dessa lådor stöder de vanligaste Azure-tjänsterna och vi lägger regelbundet till mer baserat på communityns feedback och efterfrågan.

Azure SDK för Rust-lådor

Använd indexet för Azure SDK för Rust-paket för att söka efter tillgängliga paket, deras dokumentation och källkod.

Nästa steg