https://github.com/noxf/oss-rust-sdk
Aliyun OSS SDK for Rust
https://github.com/noxf/oss-rust-sdk
aliyun-oss oss rust sdk
Last synced: about 2 months ago
JSON representation
Aliyun OSS SDK for Rust
- Host: GitHub
- URL: https://github.com/noxf/oss-rust-sdk
- Owner: NoXF
- Created: 2018-12-05T11:18:53.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-08-28T07:58:19.000Z (over 1 year ago)
- Last Synced: 2025-04-06T06:13:59.217Z (about 2 months ago)
- Topics: aliyun-oss, oss, rust, sdk
- Language: Rust
- Size: 104 KB
- Stars: 93
- Watchers: 4
- Forks: 29
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# OSS-Rust-SDK
[](https://crates.io/crates/oss-rust-sdk)
It's an unofficial Rust port for https://github.com/aliyun/aliyun-oss-cpp-sdk, just implement core APIs of https://help.aliyun.com/document_detail/31977.html, everyone is welcome to submit a PR to implement which interface you need.
# Getting Started
## List your_Buckets
```rust
use oss_rust_sdk::prelude::*;
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let list_buckets = oss_instance.list_bucket(None).unwrap();
let id = list_buckets.id();
let your_Buckets = list_buckets.buckets();
let your_Bucket_names: Vec<&str> = your_Buckets.iter().map(|obj| obj.name()).collect();
```
## Get Object
```rust
use oss_rust_sdk::prelude::*;
use std::collections::HashMap;
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
/// if have extra header
let mut extra_header = HashMap::new();
extra_header.insert("content-type", "text/plain");
/// if have oss_sub_resource
let mut oss_sub_resource = HashMap::new();
oss_sub_resource.insert("acl", None);
oss_sub_resource.insert("response-content-type", Some("ContentType"));
let result = oss_instance.get_object("object", extar_header, oss_sub_resource);
/// or you may just get object
/// let result = oss_instance.get_object("object", None, None);
assert_eq!(result.is_ok(), true);
let buffer = result.unwrap();
```
## Get Object async
```rust
use oss_rust_sdk::oss::OSS;
use oss_rust_sdk::async_object::*;
use tokio::runtime::Runtime;
fn async_get_object_demo() {
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let mut rt = Runtime::new().expect("failed to start runtime");
rt.block_on(async move {
let _ = oss_instance.get_object("objectName", None::>, None).await.unwrap();
println!("buffer = {:?}", String::from_utf8(result.unwrap()));
});
}
or
async fn async_get_object_demo() -> Reuslt {
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let buf = oss_instance.async_get_object("objectName", None, None).await?;
String::from_utf8(buf)?
}
```
## Put Object by file
```rust
use oss_rust_sdk::prelude::*;
let filename = "filename";
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let result = oss_instance.put_object_from_file(filename, "object", None, None);
assert_eq!(result.is_ok(), true)
```
## Put Ojbect by buffer
```rust
let buffer = "some thing you want put to oss";
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let result = oss_instance.put_object_from_buffer(buffer.as_bytes(), "object", None, None);
assert_eq!(result.is_ok(), true)
```
## Pub Object Async
```rust
use oss_rust_sdk::oss::OSS;
use oss_rust_sdk::async_object::*;
let buffer = "test async put object from buffer";
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let mut headers = HashMap::new();
headers.insert("content-type", "text/plain");
oss_instance.put_object(buffer.as_bytes(),"your_object_name", headers,None).await?;
```
## Copy Object
```rust
use oss_rust_sdk::prelude::*;
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let result = oss_instance.copy_object_from_object("src_object", "dest_object", None, None);
assert_eq!(result.is_ok(), true)
```
## Delete Ojbect
```rust
use oss_rust_sdk::prelude::*;
let oss_instance = OSS::new("your_AccessKeyId", "your_AccessKeySecret", "your_Endpoint", "your_Bucket");
let result = oss_instance.delete_object("object");
assert_eq!(result.is_ok(), true)
```
You can use `oss_instance.set_bucket("your_Bucket")` to change specific bucket after create the oss instance.
## License
- Apache License 2.0.