Struct InstanceQueryService 

pub struct InstanceQueryService<'a> { /* private fields */ }

实例查询服务

Implementations

impl<'a> InstanceQueryService<'a>

pub fn new(client: &'a TencentCloudClient) -> Self

创建新的实例查询服务

Examples found in repository

examples/instance_describe.rs (line 20)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 从环境变量读取密钥
    let secret_id = env::var("TENCENTCLOUD_SECRET_ID")
        .expect("请设置环境变量TENCENTCLOUD_SECRET_ID");
    let secret_key = env::var("TENCENTCLOUD_SECRET_KEY")
        .expect("请设置环境变量TENCENTCLOUD_SECRET_KEY");

    // 创建客户端
    let client = TencentCloudClient::new(secret_id, secret_key);
    
    // 创建实例查询服务
    let instance_query_service = InstanceQueryService::new(&client);
    
    // 设置区域
    let region = "ap-guangzhou";
    
    // 获取命令行参数
    let args: Vec<String> = env::args().collect();
    
    if args.len() > 1 {
        match args[1].as_str() {
            // 按ID查询实例
            "id" => {
                if args.len() < 3 {
                    println!("缺少实例ID参数，用法: cargo run --example instance_describe id <实例ID>");
                    return Ok(());
                }
                
                let instance_ids = args[2..].to_vec();
                println!("正在查询以下实例ID: {:?}", instance_ids);
                
                let request = DescribeInstancesRequest {
                    InstanceIds: Some(instance_ids),
                    Filters: None,
                    Offset: None,
                    Limit: None,
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按可用区查询实例
            "zone" => {
                if args.len() < 3 {
                    println!("缺少可用区参数，用法: cargo run --example instance_describe zone <可用区>");
                    return Ok(());
                }
                
                let zone = args[2].clone();
                println!("正在查询可用区 {} 的实例", zone);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: "zone".to_string(),
                    Values: vec![zone],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按实例名称查询实例
            "name" => {
                if args.len() < 3 {
                    println!("缺少实例名称参数，用法: cargo run --example instance_describe name <实例名称>");
                    return Ok(());
                }
                
                let name = args[2].clone();
                println!("正在查询名称为 {} 的实例", name);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: "instance-name".to_string(),
                    Values: vec![name],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按标签查询实例
            "tag" => {
                if args.len() < 4 {
                    println!("缺少标签参数，用法: cargo run --example instance_describe tag <标签键> <标签值>");
                    return Ok(());
                }
                
                let tag_key = args[2].clone();
                let tag_value = args[3].clone();
                println!("正在查询标签键值对为 {}:{} 的实例", tag_key, tag_value);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: format!("tag:{}", tag_key),
                    Values: vec![tag_value],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 查询所有实例
            "all" => {
                println!("正在查询所有实例");
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: None,
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按状态查询实例
            "state" => {
                if args.len() < 3 {
                    println!("缺少实例状态参数，用法: cargo run --example instance_describe state <状态>");
                    println!("支持的状态: PENDING, RUNNING, STOPPED, STOPPING, REBOOTING, STARTING, SHUTDOWN, TERMINATING");
                    return Ok(());
                }
                
                let state = args[2].clone();
                println!("正在查询状态为 {} 的实例", state);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: "instance-state".to_string(),
                    Values: vec![state],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            _ => {
                print_usage();
            }
        }
    } else {
        print_usage();
    }
    
    Ok(())
}

pub async fn describe_instances( &self, request: &DescribeInstancesRequest, region: &str, ) -> Result<DescribeInstancesResponseType>

查询实例列表

本接口 (DescribeInstances) 用于查询一个或多个实例的详细信息。

• 可以根据实例ID、实例名称或者实例计费模式等信息来查询实例的详细信息
• 如果参数为空，返回当前用户一定数量（Limit所指定的数量，默认为20）的实例
• 支持查询实例的最新操作（LatestOperation）以及最新操作状态(LatestOperationState)

Examples found in repository

examples/instance_describe.rs (line 47)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 从环境变量读取密钥
    let secret_id = env::var("TENCENTCLOUD_SECRET_ID")
        .expect("请设置环境变量TENCENTCLOUD_SECRET_ID");
    let secret_key = env::var("TENCENTCLOUD_SECRET_KEY")
        .expect("请设置环境变量TENCENTCLOUD_SECRET_KEY");

    // 创建客户端
    let client = TencentCloudClient::new(secret_id, secret_key);
    
    // 创建实例查询服务
    let instance_query_service = InstanceQueryService::new(&client);
    
    // 设置区域
    let region = "ap-guangzhou";
    
    // 获取命令行参数
    let args: Vec<String> = env::args().collect();
    
    if args.len() > 1 {
        match args[1].as_str() {
            // 按ID查询实例
            "id" => {
                if args.len() < 3 {
                    println!("缺少实例ID参数，用法: cargo run --example instance_describe id <实例ID>");
                    return Ok(());
                }
                
                let instance_ids = args[2..].to_vec();
                println!("正在查询以下实例ID: {:?}", instance_ids);
                
                let request = DescribeInstancesRequest {
                    InstanceIds: Some(instance_ids),
                    Filters: None,
                    Offset: None,
                    Limit: None,
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按可用区查询实例
            "zone" => {
                if args.len() < 3 {
                    println!("缺少可用区参数，用法: cargo run --example instance_describe zone <可用区>");
                    return Ok(());
                }
                
                let zone = args[2].clone();
                println!("正在查询可用区 {} 的实例", zone);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: "zone".to_string(),
                    Values: vec![zone],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按实例名称查询实例
            "name" => {
                if args.len() < 3 {
                    println!("缺少实例名称参数，用法: cargo run --example instance_describe name <实例名称>");
                    return Ok(());
                }
                
                let name = args[2].clone();
                println!("正在查询名称为 {} 的实例", name);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: "instance-name".to_string(),
                    Values: vec![name],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按标签查询实例
            "tag" => {
                if args.len() < 4 {
                    println!("缺少标签参数，用法: cargo run --example instance_describe tag <标签键> <标签值>");
                    return Ok(());
                }
                
                let tag_key = args[2].clone();
                let tag_value = args[3].clone();
                println!("正在查询标签键值对为 {}:{} 的实例", tag_key, tag_value);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: format!("tag:{}", tag_key),
                    Values: vec![tag_value],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 查询所有实例
            "all" => {
                println!("正在查询所有实例");
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: None,
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            // 按状态查询实例
            "state" => {
                if args.len() < 3 {
                    println!("缺少实例状态参数，用法: cargo run --example instance_describe state <状态>");
                    println!("支持的状态: PENDING, RUNNING, STOPPED, STOPPING, REBOOTING, STARTING, SHUTDOWN, TERMINATING");
                    return Ok(());
                }
                
                let state = args[2].clone();
                println!("正在查询状态为 {} 的实例", state);
                
                let mut filters = Vec::new();
                filters.push(Filter {
                    Name: "instance-state".to_string(),
                    Values: vec![state],
                });
                
                let request = DescribeInstancesRequest {
                    InstanceIds: None,
                    Filters: Some(filters),
                    Offset: None,
                    Limit: Some(20),
                };
                
                let response = instance_query_service.describe_instances(&request, region).await?;
                display_instances(&response.Response);
            },
            
            _ => {
                print_usage();
            }
        }
    } else {
        print_usage();
    }
    
    Ok(())
}

pub async fn describe_instances_status( &self, request: &DescribeInstancesStatusRequest, region: &str, ) -> Result<DescribeInstancesStatusResponseType>

查看实例状态列表

本接口 (DescribeInstancesStatus) 用于查询一个或多个实例的状态。

• 可以根据实例ID来查询实例的状态
• 如果参数为空，返回当前用户一定数量（Limit所指定的数量，默认为20）的实例状态

pub async fn describe_instances_modification( &self, request: &DescribeInstancesModificationRequest, region: &str, ) -> Result<DescribeInstancesModificationResponseType>

查询实例可调整配置

本接口 (DescribeInstancesModification) 用于查询实例可调整的机型配置。

pub async fn describe_instances_operation_limit( &self, request: &DescribeInstancesOperationLimitRequest, region: &str, ) -> Result<DescribeInstancesOperationLimitResponseType>

查询实例操作限制

本接口用于查询实例操作限制信息。

pub async fn describe_instance_family_configs( &self, request: &DescribeInstanceFamilyConfigsRequest, region: &str, ) -> Result<DescribeInstanceFamilyConfigsResponseType>

查询所支持的实例机型族信息

本接口 (DescribeInstanceFamilyConfigs) 查询当前用户和地域所支持的机型族信息。

pub async fn describe_instance_type_configs( &self, request: &DescribeInstanceTypeConfigsRequest, region: &str, ) -> Result<DescribeInstanceTypeConfigsResponseType>

查询实例机型列表

本接口 (DescribeInstanceTypeConfigs) 用于查询实例机型配置。

• 可以根据实例机型、实例族名称等信息来查询实例机型配置
• 如果参数为空，返回当前用户地域所支持的所有机型配置