aliyun-openapi-core-rust-sdk

Aliyun OpenAPI POP core SDK for Rust.

Notes

You must know your AK(accessKeyId/accessKeySecret), and the aliyun product's endpoint and apiVersion.

For example, The ECS OpenAPI(https://help.aliyun.com/document_detail/25490.html), the API version is 2014-05-26.

And the endpoint list can be found at here, the center endpoint is ecs.aliyuncs.com. Add http protocol http or https, should be https://ecs.aliyuncs.com/.

Install

Run the following Cargo command in your project directory:

shell cargo add aliyun-openapi-core-rust-sdk

Or add the following line to your Cargo.toml:

toml aliyun-openapi-core-rust-sdk = "1.0.0"

Usage

The RPC style client:

```rust use std::env; use std::error::Error;

use aliyunopenapicorerustsdk::client::rpc::RPClient;

[tokio::main]

async fn main() -> Result<(), Box> { // create rpc style api client. let aliyunopenapiclient = RPClient::new( env::var("ACCESSKEYID")?, env::var("ACCESSKEYSECRET")?, "https://ecs.aliyuncs.com/", );

// call `DescribeRegions` with empty queries.
let response = aliyun_openapi_client
    .clone()
    .version("2014-05-26")
    .get("DescribeRegions")
    .text()
    .await?;
println!("DescribeRegions response: {response}");

// call `DescribeInstances` with queries.
let response = aliyun_openapi_client
    .version("2014-05-26")
    .get("DescribeInstances")
    .query([("RegionId", "cn-hangzhou")])
    .text()
    .await?;
println!("DescribeInstances response: {response}");

Ok(())

}

```

The ROA style client:

```rust use std::collections::HashMap; use std::env; use std::error::Error;

use aliyunopenapicorerustsdk::client::roa::ROAClient; use serde_json::json;

[tokio::main]

async fn main() -> Result<(), Box> { // create roa style api client. let aliyunopenapiclient = ROAClient::new( env::var("ACCESSKEYID")?, env::var("ACCESSKEYSECRET")?, "http://mt.aliyuncs.com", );

// create params.
let mut params = HashMap::new();
params.insert("SourceText", "你好");
params.insert("SourceLanguage", "zh");
params.insert("TargetLanguage", "en");
params.insert("FormatType", "text");
params.insert("Scene", "general");

// call `Translate` with json params.
let response = aliyun_openapi_client
    .version("2018-04-08")
    .post("/api/translate/web/general")
    .header([("Content-Type".to_string(), "application/json".to_string())])?
    .body(json!(params).to_string())?
    .text()
    .await?;

println!("Translate response: {response}");

Ok(())

} ```

Examples

Export AK info to env, then run cargo run --example <NAME>:

```sh export ACCESSKEYID= export ACCESSKEYSECRET=

ecs example

cargo run --example ecs

rds example

cargo run --example rds

slb example

cargo run --example slb

vpc example

cargo run --example vpc ```

License

The MIT License