Microsoft Azure expose its technologies via REST API. These APIs are easily consumable from any language (good) but are weakly typed. With this library and its related crate you can exploit the power of Microsoft Azure from Rust in a idiomatic way.
NOTE: This repository is under heavy development and is likely to break over time. The current releases will probabily contain bugs. As usual open issues if you find any.
Although I am a Microsoft employee, this is not a Microsoft endorsed project. It's simply a pet project of mine: I love Rust (who doesn't? :smirk:) and Microsoft Azure technologies so I thought to close the gap between them. It's also a good project for learning Rust. This library relies heavily on Hyper. As the time of writing master Hyper does not support Tokio yet: this SDK will than be blocking. I plan to switch to futures as soon as possible.
AZURE_STORAGE_ACCOUNT=<account>
AZURE_STORAGE_KEY=<key>
cargo test --features=test_e2e
You can find examples in the test section and in the main.rs file. Here is a sample however:
```rust extern crate azuresdkfor_rust; extern crate chrono;
extern crate mime;
use azuresdkforrust::azure::core::lease::{LeaseState, LeaseStatus}; use azuresdkforrust::azure::storage::client::Client; use azuresdkforrust::azure::storage::blob::{Blob, BlobType, PUTOPTIONSDEFAULT}; use azuresdkforrust::azure::storage::container::{Container, PublicAccess, LISTCONTAINEROPTIONS_DEFAULT};
use chrono::UTC;
use mime::Mime;
fn main() { let azurestorageaccount = &"azurestorageaccount"; let azurestoragekey= &"azurestoragekey";
// create the client struct. The third argument, if false, forces to use // http instead of https. It's useful if you have trouble compiling // hyper with openSSL activated. let client = Client::new(azurestorageaccount, azurestoragekey, false);
// This call will list your containers. let containers = Container::list(&client, &LISTCONTAINEROPTIONS_DEFAULT).unwrap(); println!("{:?}", containers);
let container_name = "rust"; // This call will create a new Azure Container called "wow" // with public blob access (see https://msdn.microsoft.com/en-us/library/azure/dd179468.aspx) // if it doesn't exist already.
let cont = containers.iter().find(|x| x.name == containername); if let None = cont { Container::create(&client, containername, PublicAccess::Blob).unwrap(); }
// this code will upload a file to the container just created. { use std::fs::metadata; use std::fs::File;
let file_name: &'static str = "C:\\temp\\from_rust.txt";
let container_name: &'static str = "wow";
let metadata = metadata(file_name).unwrap();
let mut file = File::open(file_name).unwrap();
let new_blob = Blob {
name: "from_rust.txt".to_owned(),
container_name: container_name.to_owned(),
snapshot_time: None,
last_modified: UTC::now(),
etag: "".to_owned(),
content_length: metadata.len(),
content_type: "application/octet-stream".parse::<Mime>().unwrap(),
content_encoding: None,
content_language: None,
content_md5: None,
cache_control: None,
x_ms_blob_sequence_number: None,
blob_type: BlobType::BlockBlob,
lease_status: LeaseStatus::Unlocked,
lease_state: LeaseState::Available,
lease_duration: None,
copy_id: None,
copy_status: None,
copy_source: None,
copy_progress: None,
copy_completion: None,
copy_status_description: None,
};
new_blob.put(&client,
&PUT_OPTIONS_DEFAULT,
Some((&mut file, metadata.len())))
.unwrap();
}
// This code will look for the "todelete" container and // remove from Azure. let mut todelete = containers.itermut().find(|x| x.name == "todelete").unwrap(); todelete.delete(&client).unwrap(); println!("{:?} deleted!", todelete); } ```
Right now the key framework is in place (authentication, enumerations, parsing and so on). If you want to contribute please do! Methods are added daily so please check the CHANGELOG.md for updates on the progress. Also note that the project is in early stages so the APIs are bound to change at any moment. I will strive to keep things steady but since I'm new to Rust I'm sure I'll have to correct some serious mistake before too long :smile:. I generally build for the latest nightly and leave to Travis to check the retrocompatibility.
If you want to contribute please do! No formality required! :wink:
| Method | URL | | ---- | --- | | Create container | https://msdn.microsoft.com/en-us/library/azure/dd179468.aspx | | List containers | https://msdn.microsoft.com/en-us/library/azure/dd179352.aspx | | Delete container | https://msdn.microsoft.com/en-us/library/azure/dd179408.aspx |
| Method | URL | | ---- | --- | | List blobs | https://msdn.microsoft.com/en-us/library/azure/dd135734.aspx | | Get blob | https://msdn.microsoft.com/en-us/library/azure/dd179440.aspx | | Put blob | https://msdn.microsoft.com/en-us/library/azure/dd179451.aspx | | Put blob page | https://msdn.microsoft.com/en-us/library/azure/dd179451.aspx | | Clear blob page | https://msdn.microsoft.com/en-us/library/azure/dd179451.aspx | | Put block | https://msdn.microsoft.com/en-us/library/azure/dd135726.aspx | | Lease blob | https://msdn.microsoft.com/library/azure/ee691972.aspx |
| Method | URL | | ---- | --- | | Send Event | https://msdn.microsoft.com/en-us/library/azure/dn790664.aspx |
| Method | URL | | ---- | --- | | Create table | https://docs.microsoft.com/en-us/rest/api/storageservices/create-table | | Query tables | https://docs.microsoft.com/en-us/rest/api/storageservices/query-tables | | Query entities | https://docs.microsoft.com/en-us/rest/api/storageservices/query-entities | | Insert entity | https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity | | Update entity | https://docs.microsoft.com/en-us/rest/api/storageservices/update-entity2 | | Delete entity | https://docs.microsoft.com/en-us/rest/api/storageservices/delete-entity1 |
Azure tables entities can be manipulated in batches. The entities are serialized in JSON.
| Method | URL | | ---- | --- | | Create database | https://docs.microsoft.com/en-us/rest/api/documentdb/create-a-database | | List database | https://docs.microsoft.com/en-us/rest/api/documentdb/list-databases | | Get database | https://docs.microsoft.com/en-us/rest/api/documentdb/get-a-database | | Delete database | https://docs.microsoft.com/en-us/rest/api/documentdb/delete-a-database1 |
This project is published under Apache license, version 2.0.