tencent_cloud_sdk 0.0.3

Tencent Cloud API SDK for Rust
Documentation

腾讯云API SDK (Rust)

这是一个非官方的腾讯云API Rust SDK，提供了与腾讯云API进行交互的Rust实现。

目录

安装和环境配置

  1. 在Cargo.toml中添加依赖
  2. 设置环境变量
export TENCENTCLOUD_SECRET_ID="你的腾讯云SecretId"
export TENCENTCLOUD_SECRET_KEY="你的腾讯云SecretKey"

已实现功能

通用功能

  • ✅ 腾讯云API签名V3算法完整实现
  • ✅ HTTP客户端封装
  • ✅ 统一的错误处理

地域与可用区管理

  • ✅ 查询地域列表 (DescribeRegions)
  • ✅ 查询可用区列表 (DescribeZones)

云服务器实例管理

  • ✅ 创建实例 (RunInstances)

    • 支持按量计费和竞价实例
    • 支持自定义配置（实例类型、系统盘等）
    • 支持网络配置和安全组配置

  • ✅ 实例生命周期管理

    • 启动实例 (StartInstances)
    • 关闭实例 (StopInstances)
    • 重启实例 (RebootInstances)
    • 支持批量操作
    • 支持软/硬关机和重启

  • ✅ 查询实例 (DescribeInstances)

    • 支持按实例ID查询
    • 支持按可用区查询
    • 支持按实例名称查询
    • 支持按标签查询
    • 支持按实例状态查询

  • ✅ 退还实例 (TerminateInstances)

    • 支持批量退还
    • 支持按量计费和包年包月实例

使用方法

1. 查询地域和可用区

use tencent_cloud_sdk::{TencentCloudClient, services::region::RegionService};

// 创建客户端
let client = TencentCloudClient::new(secret_id, secret_key);

// 创建地域服务
let region_service = RegionService::new(&client);

// 查询地域列表 - 无需参数
let regions = region_service.describe_regions().await?;

// 查询可用区列表 - 需要地域参数
let zones = region_service.describe_zones("ap-guangzhou").await?;

2. 创建实例

use tencent_cloud_sdk::{
    TencentCloudClient,
    services::cvm::instance::{
        InstanceService, RunInstancesRequest, Placement, LoginSettings,
        SystemDisk, InstanceChargeType
    }
};

// 创建客户端和服务
let client = TencentCloudClient::new(secret_id, secret_key);
let instance_service = InstanceService::new(&client);

// 创建实例请求参数
let request = RunInstancesRequest {
    // 必填参数
    Placement: Some(Placement {
        Zone: Some("ap-guangzhou-6".to_string()),
        // 其他字段可选
        ProjectId: None,
        HostIds: None,
        HostIps: None,
        DedicatedClusterId: None,
    }),
    // Image: TencentOS
    ImageId: Some("img-6n21msk1".to_string()),
    
    // 可选参数
    InstanceChargeType: Some(InstanceChargeType::Spotpaid), // 竞价实例
    InstanceType: Some("S5.MEDIUM2".to_string()),
    SystemDisk: Some(SystemDisk {
        DiskType: Some("CLOUD_BSSD".to_string()),
        DiskSize: Some(20),
        DiskId: None,
    }),
    
    // 其他参数，按需设置
    InstanceCount: Some(1),
    LoginSettings: Some(LoginSettings {
        Password: Some("Password123".to_string()),
        KeyIds: None,
        KeepImageLogin: None,
    }),
    
    // 默认为None的参数可省略
    VirtualPrivateCloud: None,
    SecurityGroupIds: None,
    InstanceName: Some("test-instance".to_string()),
    // ... 更多参数
};

// 发送请求
let response = instance_service.run_instances(&request, "ap-guangzhou").await?;

3. 启动/关闭/重启实例

use tencent_cloud_sdk::{
    TencentCloudClient,
    services::cvm::instance_operation::{
        InstanceOperationService, StartInstancesRequest, StopInstancesRequest, RebootInstancesRequest
    }
};

// 创建客户端和服务
let client = TencentCloudClient::new(secret_id, secret_key);
let instance_operation_service = InstanceOperationService::new(&client);
let region = "ap-guangzhou";

// 启动实例
let start_request = StartInstancesRequest {
    InstanceIds: vec!["ins-xxxxxxxx".to_string()],
};
let start_response = instance_operation_service.start_instances(&start_request, region).await?;

// 关闭实例
let stop_request = StopInstancesRequest {
    InstanceIds: vec!["ins-xxxxxxxx".to_string()],
    StopType: Some("SOFT".to_string()),  // 软关机，可选SOFT/HARD/SOFT_FIRST
    StoppedMode: Some("KEEP_CHARGING".to_string()),  // 关机继续收费
    ForceStop: None,  // 已弃用参数
};
let stop_response = instance_operation_service.stop_instances(&stop_request, region).await?;

// 重启实例
let reboot_request = RebootInstancesRequest {
    InstanceIds: vec!["ins-xxxxxxxx".to_string()],
    StopType: Some("SOFT".to_string()),  // 软重启，可选SOFT/HARD/SOFT_FIRST
    ForceReboot: None,  // 已弃用参数
};
let reboot_response = instance_operation_service.reboot_instances(&reboot_request, region).await?;

4. 查询实例

use tencent_cloud_sdk::{
    TencentCloudClient,
    services::cvm::instance_query::{InstanceQueryService, DescribeInstancesRequest},
    services::cvm::instance::Filter
};

// 创建客户端和服务
let client = TencentCloudClient::new(secret_id, secret_key);
let instance_query_service = InstanceQueryService::new(&client);
let region = "ap-guangzhou";

// 按实例ID查询
let id_request = DescribeInstancesRequest {
    InstanceIds: Some(vec!["ins-xxxxxxxx".to_string()]),
    Filters: None,
    Offset: None,
    Limit: None,
};
let id_response = instance_query_service.describe_instances(&id_request, region).await?;

// 按可用区查询
let mut filters = Vec::new();
filters.push(Filter {
    Name: "zone".to_string(),
    Values: vec!["ap-guangzhou-6".to_string()],
});

let zone_request = DescribeInstancesRequest {
    InstanceIds: None,
    Filters: Some(filters),
    Offset: None,
    Limit: Some(20),
};
let zone_response = instance_query_service.describe_instances(&zone_request, region).await?;

// 按实例状态查询
let mut filters = Vec::new();
filters.push(Filter {
    Name: "instance-state".to_string(),
    Values: vec!["RUNNING".to_string()],
});

let state_request = DescribeInstancesRequest {
    InstanceIds: None,
    Filters: Some(filters),
    Offset: None,
    Limit: Some(20),
};
let state_response = instance_query_service.describe_instances(&state_request, region).await?;

5. 退还实例

use tencent_cloud_sdk::{
    TencentCloudClient,
    services::cvm::instance_operation::{InstanceOperationService, TerminateInstancesRequest}
};

// 创建客户端和服务
let client = TencentCloudClient::new(secret_id, secret_key);
let instance_operation_service = InstanceOperationService::new(&client);

// 创建退还实例请求
let request = TerminateInstancesRequest {
    // 必填参数 - 实例ID列表
    InstanceIds: vec!["ins-xxxxxxxx".to_string()],
    
    // 可选参数
    ReleasePrepaidDataDisks: Some(false), // 是否释放包年包月数据盘
};

// 发送请求
let response = instance_operation_service.terminate_instances(&request, "ap-guangzhou").await?;

6. 实例询价

use tencent_cloud_sdk::{
    TencentCloudClient,
    services::cvm::instance_price::{
        InstancePriceService, InquiryPriceRunInstancesRequest
    },
    services::cvm::instance::{
        Placement, SystemDisk, InstanceChargeType, InstanceChargePrepaid
    }
};

// 创建客户端和服务
let client = TencentCloudClient::new(secret_id, secret_key);
let instance_price_service = InstancePriceService::new(&client);

// 包年包月实例询价
let request = InquiryPriceRunInstancesRequest {
    Placement: Placement {
        Zone: Some("ap-guangzhou-4".to_string()),
        ProjectId: None,
        HostIds: None,
        HostIps: None,
        DedicatedClusterId: None,
    },
    ImageId: "img-eb30mz89".to_string(), // TencentOS Server 3.2
    InstanceType: "S5.MEDIUM2".to_string(), // 2核4G
    SystemDisk: Some(SystemDisk {
        DiskType: Some("CLOUD_PREMIUM".to_string()), // 高性能云硬盘
        DiskSize: Some(50),
        DiskId: None,
    }),
    InstanceChargeType: Some(InstanceChargeType::Prepaid),
    InstanceChargePrepaid: Some(InstanceChargePrepaid {
        Period: 1, // 购买1个月
        RenewFlag: Some("NOTIFY_AND_AUTO_RENEW".to_string()), // 到期自动续费
    }),
    // 其他参数可以根据需要设置
    DataDisks: None,
    InternetAccessible: None,
    InstanceCount: Some(1),
    LoginSettings: None,
    EnhancedService: None,
    VirtualPrivateCloud: None,
};

// 发送询价请求
let response = instance_price_service.inquiry_price_run_instances(&request, "ap-guangzhou").await?;

// 获取价格信息
let instance_price = response.Response.Price.InstancePrice;
println!("实例价格: {}", instance_price.DiscountPrice.unwrap_or(0.0));

// 如果有带宽价格信息
if let Some(bandwidth_price) = response.Response.Price.BandwidthPrice {
    println!("带宽价格: {}", bandwidth_price.DiscountPrice.unwrap_or(0.0));
}

许可证

MIT许可证