Struct TencentCloudClient

pub struct TencentCloudClient {
    pub secret_id: String,
    pub secret_key: String,
    pub token: Option<String>,
}

Tencent Cloud SDK Client

This client is used to send authenticated requests to Tencent Cloud APIs. It constructs the canonical request string, computes the TC3-HMAC-SHA256 signature, builds the necessary headers, and sends an HTTPS POST request. This version returns the response as a serde_json::Value, preserving Chinese characters.

Fields

secret_id: String

Your Tencent Cloud SecretId.

secret_key: String

Your Tencent Cloud SecretKey.

token: Option<String>

Optional token.

Implementations

impl TencentCloudClient

pub fn new(secret_id: &str, secret_key: &str, token: Option<&str>) -> Self

Creates a new TencentCloudClient.

Arguments

• secret_id - Your Tencent Cloud SecretId.
• secret_key - Your Tencent Cloud SecretKey.
• token - An optional token.

pub async fn request( &self, service: &str, host: &str, region: Option<&str>, version: &str, action: &str, payload: &str, ) -> Result<Value, Box<dyn Error>>

Asynchronous general request function.

This method constructs the canonical request, computes the TC3-HMAC-SHA256 signature, builds the Authorization header, and sends an HTTPS POST request.

Instead of returning plain text, this version parses the response as JSON and returns a serde_json::Value, which preserves Chinese characters.

Arguments

• service - The service name (e.g., “cvm”).
• host - The request host (e.g., “cvm.tencentcloudapi.com”).
• region - Optional region string.
• version - API version (e.g., “2017-03-12”).
• action - API action name (e.g., “DescribeInstances”).
• payload - The request body as a JSON string.

Returns

A Result containing the response parsed as serde_json::Value on success, or a boxed error on failure.