Struct OSS 

pub struct OSS { /* private fields */ }

OSS配置

Implementations

impl<'a> OSS

pub fn from_env() -> Self

pub fn open_debug(&self)

pub fn new<S: Into<String>>( key_id: S, key_secret: S, endpoint: S, bucket: S, ) -> Self

pub fn format_host<S: AsRef<str>>( &self, bucket: S, key: S, build: &RequestBuilder, ) -> String

pub fn build_request<S: AsRef<str>>( &self, key: S, build: RequestBuilder, ) -> Result<(String, HeaderMap), InvalidHeaderValue>

pub fn date(&self) -> String

impl OSS

pub fn get_object<S: AsRef<str>>( &self, key: S, build: RequestBuilder, ) -> Result<Vec<u8>, OssError>

获取对象

使用例子

use aliyun_oss_rust_sdk::oss::OSS;
use aliyun_oss_rust_sdk::request::RequestBuilder;
let oss = OSS::from_env();
let build = RequestBuilder::new();
let bytes = oss.get_object("/hello.txt", build).await.unwrap();
println!("file content: {}", String::from_utf8_lossy(bytes.as_slice()));

pub fn get_upload_object_policy( &self, build: PolicyBuilder, ) -> Result<PolicyResp, OssError>

获取上传对象的policy

使用例子

use aliyun_oss_rust_sdk::entity::PolicyBuilder;
use aliyun_oss_rust_sdk::oss::OSS;
let oss = OSS::from_env();
let policy_builder = PolicyBuilder::new()
            .with_expire(60 * 60)//1个小时过期
            .with_upload_dir("upload/mydir/")//上传目录
            .with_content_type("text/plain")//只允许上传文本.txt
           .with_max_upload_size(100 * 1024 * 1024);//只允许文件上传大小1G以内
let policy = oss.get_upload_object_policy(policy_builder).unwrap();
println!("policy: {:?}", policy);
//使用postman测试上传
//form-data的参数为OSSAccessKeyId、policy、signature、success_action_status、key、file
//key为上传的文件名包含路径、例如：upload/mydir/test.txt
//file为上传的文件，类型跟with_content_type一致

pub fn put_object_from_file<S: AsRef<str>>( &self, key: S, file_path: S, build: RequestBuilder, ) -> Result<(), OssError>

上传文件(本地文件)

使用例子

use aliyun_oss_rust_sdk::oss::OSS;
use aliyun_oss_rust_sdk::request::RequestBuilder;
let oss = OSS::from_env();
let builder = RequestBuilder::new()
    .with_expire(60);
let file_path = "./hello.txt";
oss.put_object_from_file("/hello.txt", file_path, builder).await.unwrap();

pub fn pub_object_from_buffer<S: AsRef<str>>( &self, key: S, buffer: &[u8], build: RequestBuilder, ) -> Result<(), OssError>

上传文件(内存)

使用例子

use aliyun_oss_rust_sdk::oss::OSS;
use aliyun_oss_rust_sdk::request::RequestBuilder;
let oss = OSS::from_env();
let builder = RequestBuilder::new()
    .with_expire(60);
let file_path = "./hello.txt";
let buffer = std::fs::read(file_path).unwrap();
oss.pub_object_from_buffer("/hello.txt", buffer.as_slice(), builder).await.unwrap();

pub fn delete_object<S: AsRef<str>>( &self, key: S, build: RequestBuilder, ) -> Result<(), OssError>

删除文件

使用例子

use aliyun_oss_rust_sdk::oss::OSS;
use aliyun_oss_rust_sdk::request::RequestBuilder;
let oss = OSS::from_env();
let builder = RequestBuilder::new()
   .with_expire(60);
oss.delete_object("/hello.txt", builder).await.unwrap();

pub fn get_object_metadata<S: AsRef<str>>( &self, key: S, build: RequestBuilder, ) -> Result<ObjectMetadata, OssError>

获取对象元数据

使用例子

use aliyun_oss_rust_sdk::oss::OSS;
use aliyun_oss_rust_sdk::request::RequestBuilder;
let oss = OSS::from_env();
let builder = RequestBuilder::new()
   .with_expire(60);
let metadata = oss.get_object_metadata("/hello.txt", builder).await.unwrap();
println!("{:?}", metadata);

Trait Implementations

impl API for OSS

fn format_oss_resource_str<S: AsRef<str>>(&self, bucket: S, key: S) -> String

fn key_urlencode<S: AsRef<str>>(&self, key: S) -> String

fn format_key<S: AsRef<str>>(&self, key: S) -> String

impl<'a> AuthAPI for OSS

fn sign<S: AsRef<str>>(&self, key: S, build: &RequestBuilder) -> String

fn oss_sign<S: AsRef<str>>(&self, object: S, build: &RequestBuilder) -> String

impl Clone for OSS

fn clone(&self) -> OSS

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OSS

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl OSSInfo for OSS

fn endpoint(&self) -> String

fn bucket(&self) -> String

fn key_id(&self) -> String

fn key_secret(&self) -> String

impl UrlApi for OSS

fn sign_download_url<S: AsRef<str>>( &self, key: S, build: &RequestBuilder, ) -> String

获取签名下载URL

fn sign_upload_url<S: AsRef<str>>( &self, key: S, build: &RequestBuilder, ) -> String

获取签名上传URL

fn sign_url<S: AsRef<str>>(&self, key: S, build: &RequestBuilder) -> String

impl Send for OSS

impl Sync for OSS