{"id":3334,"date":"2025-02-19T10:19:05","date_gmt":"2025-02-19T18:19:05","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/azure-sdk\/?p=3334"},"modified":"2025-02-27T10:32:49","modified_gmt":"2025-02-27T18:32:49","slug":"rust-in-time-announcing-the-azure-sdk-for-rust-beta","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/azure-sdk\/rust-in-time-announcing-the-azure-sdk-for-rust-beta\/","title":{"rendered":"Rust in time! Announcing the Azure SDK for Rust Beta. \ud83c\udf89"},"content":{"rendered":"

We’re thrilled to announce the first beta releases for the Official Azure SDK for Rust! \ud83c\udf89 These releases include libraries for Identity, Key Vault secrets & keys, Event Hubs, and Cosmos DB. These libraries are designed to provide a seamless and idiomatic experience for Rust developers working with Azure services.<\/p>\n

Why Rust? \ud83e\udd80<\/h2>\n

We decided to create an official Azure SDK for Rust due to the growing interest in the Rust programming language, both externally and within Microsoft. Rust is known for its performance, reliability, and memory safety, making it an excellent choice for systems programming and applications that require high performance and low-level control.<\/p>\n

Rust’s strong type system and ownership model help prevent common programming errors such as null pointer dereferencing and buffer overflows, leading to more secure and stable code. Additionally, Rust’s modern syntax and tooling make it a pleasure to work with, attracting a vibrant and enthusiastic developer community.<\/p>\n

By providing an official Azure SDK for Rust, we aim to empower Rust developers to build robust and efficient applications with Azure, using the full potential of the Rust language. Imagine building high-performance applications with the confidence that your code is secure and reliable. That’s the power of Rust!<\/p>\n

Beta libraries \ud83d\udcda<\/h2>\n

The following libraries are included in this beta release:<\/p>\n\n\n\n\n\n\n\n\n\n
Service<\/th>\nCrates \ud83d\udce6<\/th>\nSource Code<\/th>\n<\/tr>\n<\/thead>\n
Identity<\/td>\nazure_identity<\/code><\/a><\/td>\nGitHub<\/a><\/td>\n<\/tr>\n
Key Vault secrets<\/td>\nazure_security_keyvault_secrets<\/code><\/a><\/td>\nGitHub<\/a><\/td>\n<\/tr>\n
Key Vault keys<\/td>\nazure_security_keyvault_keys<\/code><\/a><\/td>\nGitHub<\/a><\/td>\n<\/tr>\n
Event Hubs<\/td>\nazure_messaging_eventhubs<\/code><\/a><\/td>\nGitHub<\/a><\/td>\n<\/tr>\n
Cosmos DB<\/td>\nazure_data_cosmos<\/code><\/a><\/td>\nGitHub<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Get started \ud83d\ude80<\/h2>\n

To get started with the Azure SDK for Rust, follow these steps:<\/p>\n

1. Add dependencies<\/h3>\n

Add the desired Azure SDK crates to your project using the cargo add<\/code> command. For example, to use the Identity and Key Vault Secrets libraries, run the following command:<\/p>\n

cargo add azure_identity azure_security_keyvault_secrets tokio --features tokio\/full<\/code><\/pre>\n
2. Import the libraries<\/h3>\n
In your Rust code, import the necessary modules from the Azure SDK crates. For example:<\/p>\n
use azure_identity::DefaultAzureCredential;\nuse azure_security_keyvault_secrets::{\n    models::SecretSetParameters, ResourceExt as _, SecretClient,\n};<\/code><\/pre>\n
3. Create a new secret client<\/h3>\n
First, create a new secret client using the DefaultAzureCredential<\/code>:<\/p>\n
#[tokio::main]\nasync fn main() -> Result<(), Box<dyn std::error::Error>> {\n    \/\/ Create a credential using DefaultAzureCredential\n    let credential = DefaultAzureCredential::new()?;\n    \/\/ Initialize the SecretClient with the Key Vault URL and credential\n    let client = SecretClient::new(\n        \"https:\/\/your-key-vault-name.vault.azure.net\/\",\n        credential.clone(),\n        None,\n    )?;\n\n    \/\/ Additional code will go here...\n\n    Ok(())\n}<\/code><\/pre>\n
4. Create a new secret<\/h3>\n
Next, create a new secret using the secret client:<\/p>\n
\/\/ Previous code above...\n    \/\/ Set parameters for the new secret\n     let secret_set_parameters = SecretSetParameters {\n        value: Some(\"secret-value\".into()),\n        ..Default::default()\n    };\n\n    \/\/ Create the new secret in Key Vault\n    let secret = client\n        .set_secret(\"secret-name\", secret_set_parameters.try_into()?, None)\n        .await?\n        .into_body()\n        .await?;<\/code><\/pre>\n
5. Retrieve a secret<\/h3>\n
Finally, retrieve a secret using the secret client:<\/p>\n
\/\/ Previous code above...\n    \/\/ Get the version of the created secret\n    let version = secret.resource_id()?.version.unwrap_or_default();\n\n    \/\/ Retrieve the secret from Key Vault\n    let secret = client\n        .get_secret(\"secret-name\", version.as_ref(), None)\n        .await?\n        .into_body()\n        .await?;\n    \/\/ Print the value of the retrieved secret\n    println!(\"{:?}\", secret.value);<\/code><\/pre>\n
For more detailed documentation, code samples, and installation instructions, visit our GitHub repository<\/a>.<\/p>\n
Future plans \ud83d\udd2e<\/h2>\n
Our team is committed to expanding the Azure SDK for Rust by adding more Azure service libraries and refining these announced libraries. We aim to stabilize these libraries and provide a robust, reliable, and user-friendly experience for Rust developers.<\/p>\n
We also plan on a few changes that should simplify usage without sacrificing versatility:  <\/p>\n