进阶接口:查询ECS新购可用的资源实践

本文涉及的产品
轻量应用服务器 4vCPU 16GiB,适用于搭建游戏自建服
轻量应用服务器 2vCPU 1GiB,适用于搭建电商独立站
轻量应用服务器 2vCPU 4GiB,适用于搭建容器环境
简介: 云服务器ECS到底哪些资源是可以使用并创建成功的呢?针对这个问题,我们来说说如何高效查询可用的资源列表。

  • 在某一地域有哪些可用区
  • 在某一可用区有哪些可用网络类型
  • 在某一可用区有哪些可用IO优化资源
  • 在某一可用区有哪些可用实例规格
  • 在某一可用区有哪些可用系统盘类型
  • 在某一可用区有哪些可用数据盘类型
  • 进阶实践——联合查询

背景

ECS服务器有哪些资源是可售卖的?如何更好的选择所需的资源?怎么查询可用的目标资源列表?怎么通过API(像ECS售卖页面一样)玩转可用资源的花样选择?

说明

接口 :DescribeAvailableResource
您可以通过DescribeAvailableResource指定不同目标资源( DestinationResource )查询不同类型的资源列表,再指定其他条件细化资源条件。目标资源( DestinationResource) 的各个可选取值有不同的逻辑与(&&)要求。在下列顺序列表中,排在越后面的参数其逻辑与(&&)苛刻程度越高。
顺序:(Zone)> IoOptimized > InstanceType > SystemDisk > DataDisk
取值示例:
若参数 DestinationResource 取值为 InstanceType,则必须传入参数 IoOptimized。
若参数 DestinationResource 取值为 SystemDisk,则必须传入参数 IoOptimized 和 InstanceType。
若参数 DestinationResource 取值为 DataDisk,则必须传入参数 IoOptimized、InstanceType 和 SystemDiskCategory。

除了您现在看到的这文章,您还可以前往:
针对ECS创建场景查询可用资源


事例

sdk使用

aliyun-java-sdk-ecs版本在4.6.3及以上。

    public DescribeAvailableResourceResponse doAction(DescribeAvailableResourceRequest describe) {
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", product_accessKey, product_accessSecret);
        IAcsClient client = new DefaultAcsClient(profile);
        try {
            DescribeAvailableResourceResponse response = client.getAcsResponse(describe);
            System.out.println(JSON.toJSONString(response));
            return response;

        } catch (ClientException e) {
            e.printStackTrace();
        }
        return null;
    }
AI 代码解读

查询之前先确认所需资源的付费类型

image.png

查询可用区资源

    public void doDescribeAvailableZones() {
        DescribeAvailableResourceRequest describe = new DescribeAvailableResourceRequest();
        describe.setDestinationResource("Zone");
        describe.setRegionId("cn-hangzhou");
        // InstanceChargeType 默认为PostPaid
        // PrePaid:预付费,即 包年包月 ;
        // PostPaid:后付费,即 按量付费
        describe.setInstanceChargeType("PostPaid");
        // 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
        // NoSpot:正常按量付费实例 ;
        // SpotWithPriceLimit:设置上限价格的竞价实例 ;
        // SpotAsPriceGo:系统自动出价,最高按量付费价格
        describe.setSpotStrategy("NoSpot");
        DescribeAvailableResourceResponse response = doAction(describe);
        if (null != response && CollectionUtils.isNotEmpty(response.getAvailableZones())) {
            List<AvailableZone> availableZones = response.getAvailableZones();
            List<String> list = new ArrayList<String>(availableZones.size());
            for (AvailableZone availableZone : availableZones) {
                if (availableZone.getStatus().equals("Available")) {
                    list.add(availableZone.getZoneId());
                }
            }
        }
    }
AI 代码解读

返回结果

{
    "availableZones": [
        {
            "availableResources": [],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-e"
        },
        {
            "availableResources": [],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-b"
        },
        {
            "availableResources": [],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-d"
        }
    ],
    "requestId": "0789B955-A173-4513-ADE4-80B7B4A4C921"
}
AI 代码解读

查询可用网络类型资源

    public void doDescribeAvailableNetworks() {
        DescribeAvailableResourceRequest describe = new DescribeAvailableResourceRequest();
        describe.setDestinationResource("Network");
        describe.setRegionId("cn-hangzhou");
        //不传就是查所有可用区
        describe.setZoneId("cn-hangzhou-e");
        // InstanceChargeType 默认为PostPaid
        // PrePaid:预付费,即 包年包月 ;
        // PostPaid:后付费,即 按量付费
        describe.setInstanceChargeType("PostPaid");
        // 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
        // NoSpot:正常按量付费实例 ;
        // SpotWithPriceLimit:设置上限价格的竞价实例 ;
        // SpotAsPriceGo:系统自动出价,最高按量付费价格
        describe.setSpotStrategy("NoSpot");
        doAction(describe);
    }
AI 代码解读

返回结果

{
    "availableZones": [
        {
            "availableResources": [
                {
                    "supportedResources": [
                        {
                            "status": "Available",
                            "value": "classic"
                        },
                        {
                            "status": "Available",
                            "value": "vpc"
                        }
                    ],
                    "type": "Network"
                }
            ],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-e"
        }
    ],
    "requestId": "7A56347F-8D2E-440A-884B-1EF66654C7A8"
}
AI 代码解读

查询可用IO优化资源

没有指定付费类型,InstanceChargeType默认就是PostPaid,SpotStrategy默认为NoSpot

    public void doDescribeAvailableIoOptimizeds() {
        DescribeAvailableResourceRequest describe = new DescribeAvailableResourceRequest();
        describe.setDestinationResource("IoOptimized");
        describe.setRegionId("cn-hangzhou");
        //不传就是查所有可用区
        describe.setZoneId("cn-hangzhou-b");
        //不是必填值,根据自己需要的网络类型过滤更准确
        //describe.setNetworkCategory("Classic");
        doAction(describe);
    }
AI 代码解读

返回结果

{
    "availableZones": [
        {
            "availableResources": [
                {
                    "supportedResources": [
                        {
                            "status": "Available",
                            "value": "none"
                        },
                        {
                            "status": "Available",
                            "value": "optimized"
                        }
                    ],
                    "type": "IoOptimized"
                }
            ],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-b"
        }
    ],
    "requestId": "AA6CF750-E6D8-4696-BA0E-D3B7F66D127F"
}
AI 代码解读

image.png
过滤条件导致没有可用资源时返回
image.png

查询可用实例规格资源

若参数 DestinationResource 取值为 InstanceType,则必须传入参数 IoOptimized

    public void doDescribeAvailableInstanceTypes() {
        DescribeAvailableResourceRequest describe = new DescribeAvailableResourceRequest();
        describe.setDestinationResource("InstanceType");
        describe.setRegionId("cn-hangzhou");
        //不传就是查所有可用区
        describe.setZoneId("cn-hangzhou-d");
        // InstanceChargeType 默认为PostPaid
        // PrePaid:预付费,即 包年包月 ;
        // PostPaid:后付费,即 按量付费
        describe.setInstanceChargeType("PostPaid");
        // 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
        // NoSpot:正常按量付费实例 ;
        // SpotWithPriceLimit:设置上限价格的竞价实例 ;
        // SpotAsPriceGo:系统自动出价,最高按量付费价格
        describe.setSpotStrategy("NoSpot");
        //必填值 none:非 I/O 优化实例 ; optimized:I/O 优化实例
        describe.setIoOptimized("optimized");

        //不是必填值,根据自己需要的网络类型过滤更准确 Vpc:专有网络 ; Classic:经典网络
        describe.setNetworkCategory("Vpc");
        doAction(describe);
    }
AI 代码解读

返回结果 statusSoldOut为实例规格售罄

{
    "availableZones": [
        {
            "availableResources": [
                {
                    "supportedResources": [
                        {
                            "status": "Available",
                            "value": "ecs.gn4-c8g1.4xlarge"
                        },
                        {
                            "status": "Available",
                            "value": "ecs.gn4-c4g1.2xlarge"
                        },
                        {
                            "status": "Available",
                            "value": "ecs.gn4.8xlarge"
                        },
                        {
                            "status": "SoldOut",
                            "value": "ecs.gn4.14xlarge"
                        },
                        {
                            "status": "Available",
                            "value": "ecs.gn4-c4g1.xlarge"
                        },
                        {
                            "status": "Available",
                            "value": "ecs.gn4-c8g1.2xlarge"
                        }
                    ],
                    "type": "InstanceType"
                }
            ],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-d"
        }
    ],
    "requestId": "888B31FC-269B-4024-BFDA-263C57C67B31"
}
AI 代码解读

IoOptimized没有传入,则报错:
Code: Invalid.Param
Message: The input parameter DestinationResource that is mandatory for processing this request is not supplied.

查询可用系统盘资源

若参数 DestinationResource 取值为 SystemDisk,则必须传入参数 IoOptimizedInstanceType

    public void doDescribeAvailableSystemDisks() {

        DescribeAvailableResourceRequest describe = new DescribeAvailableResourceRequest();
        describe.setDestinationResource("SystemDisk");
        describe.setRegionId("cn-hangzhou");
        //不传就是查所有可用区
        describe.setZoneId("cn-hangzhou-d");
        // InstanceChargeType 默认为PostPaid
        // PrePaid:预付费,即 包年包月 ;
        // PostPaid:后付费,即 按量付费
        describe.setInstanceChargeType("PostPaid");
        // 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
        // NoSpot:正常按量付费实例 ;
        // SpotWithPriceLimit:设置上限价格的竞价实例 ;
        // SpotAsPriceGo:系统自动出价,最高按量付费价格
        describe.setSpotStrategy("NoSpot");
        //必填值 none:非 I/O 优化实例 ; optimized:I/O 优化实例
        describe.setIoOptimized("optimized");
        //必填值 实例规格
        describe.setInstanceType("ecs.gn4-c8g1.2xlarge");

        //不是必填值,根据自己需要的网络类型过滤更准确 Vpc:专有网络 ; Classic:经典网络
        describe.setNetworkCategory("Vpc");
        doAction(describe);

    }
AI 代码解读

返回结果

{
    "availableZones": [
        {
            "availableResources": [
                {
                    "supportedResources": [
                        {
                            "max": 500,
                            "min": 20,
                            "status": "Available",
                            "unit": "GB",
                            "value": "cloud_efficiency"
                        },
                        {
                            "max": 500,
                            "min": 20,
                            "status": "Available",
                            "unit": "GB",
                            "value": "cloud_ssd"
                        }
                    ],
                    "type": "SystemDisk"
                }
            ],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-d"
        }
    ],
    "requestId": "4063AA6A-01E1-46F0-9DB8-A74AF5FE98E6"
}
AI 代码解读

查询可用数据盘资源

若参数 DestinationResource 取值为 DataDisk,则必须传入参数 IoOptimizedInstanceTypeSystemDiskCategory
延用上面的代码

    public void doDescribeAvailableDataDisks() {

        DescribeAvailableResourceRequest describe = new DescribeAvailableResourceRequest();
        describe.setDestinationResource("DataDisk");
        describe.setRegionId("cn-hangzhou");
        //不传就是查所有可用区
        describe.setZoneId("cn-hangzhou-d");
        // InstanceChargeType 默认为PostPaid
        // PrePaid:预付费,即 包年包月 ;
        // PostPaid:后付费,即 按量付费
        describe.setInstanceChargeType("PostPaid");
        // 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
        // NoSpot:正常按量付费实例 ;
        // SpotWithPriceLimit:设置上限价格的竞价实例 ;
        // SpotAsPriceGo:系统自动出价,最高按量付费价格
        describe.setSpotStrategy("NoSpot");
        //必填值 none:非 I/O 优化实例 ; optimized:I/O 优化实例
        describe.setIoOptimized("optimized");
        //必填值 实例规格
        describe.setInstanceType("ecs.gn4-c8g1.2xlarge");
        //必填值 系统盘类型
        describe.setSystemDiskCategory("cloud_ssd");

        //不是必填值,根据自己需要的网络类型过滤更准确 Vpc:专有网络 ; Classic:经典网络
        describe.setNetworkCategory("Vpc");
        doAction(describe);

    }
AI 代码解读

返回结果

{
    "availableZones": [
        {
            "availableResources": [
                {
                    "supportedResources": [
                        {
                            "max": 32768,
                            "min": 20,
                            "status": "Available",
                            "unit": "GB",
                            "value": "cloud_ssd"
                        },
                        {
                            "max": 2000,
                            "min": 5,
                            "status": "Available",
                            "unit": "GB",
                            "value": "cloud"
                        },
                        {
                            "max": 32768,
                            "min": 20,
                            "status": "Available",
                            "unit": "GB",
                            "value": "cloud_efficiency"
                        }
                    ],
                    "type": "DataDisk"
                }
            ],
            "regionId": "cn-hangzhou",
            "status": "Available",
            "zoneId": "cn-hangzhou-d"
        }
    ],
    "requestId": "8A43A1D2-0065-4050-AA40-C614FF94A336"
}
AI 代码解读

进阶实践——联合查询

     public final static String IOOPTIMIED = "IoOptimized";
    public final static String INSTANCETYPE = "InstanceType";
    public final static String SYSTEMDISK = "SystemDisk";
    public final static String DATADISK = "DataDisk";
    public final static String ZONE =  "Zone";
    public final static String NETWORK =  "Network";

    public DescribeAvailableResourceRequest doCommonRequest(DescribeAvailableResourceRequest describe) {
        if (null == describe) {
            describe = new DescribeAvailableResourceRequest();
        }
        describe.setRegionId("cn-hangzhou");
        // InstanceChargeType 默认为PostPaid
        // PrePaid:预付费,即 包年包月 ;
        // PostPaid:后付费,即 按量付费
        describe.setInstanceChargeType("PostPaid");
        // 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
        // NoSpot:正常按量付费实例 ;
        // SpotWithPriceLimit:设置上限价格的竞价实例 ;
        // SpotAsPriceGo:系统自动出价,最高按量付费价格
        describe.setSpotStrategy("NoSpot");
        return describe;
    }

    public List<String> getResources(String destinationResource, DescribeAvailableResourceRequest describe) {
        describe = doCommonRequest(describe);
        if(!ZONE.equals(destinationResource)) {
            List<String> zones =  getResources(ZONE,describe);
            //取所需的可用区,这里取第一个值; 不传就是查所有可用区
            describe.setZoneId(zones.get(0));
        }
        if(!ZONE.equals(destinationResource) && !NETWORK.equals(destinationResource)){
            List<String> networks =  getResources(NETWORK,describe);
            //不是必填值,根据自己需要的网络类型过滤更准确 Vpc:专有网络 ; Classic:经典网络
            describe.setNetworkCategory(networks.get(0));
        }
        if (INSTANCETYPE.equals(destinationResource)) {
            List<String> ioOpts = getResources(IOOPTIMIED, describe);
            //取所需的IO优化资源,这里取第一个值
            describe.setIoOptimized(ioOpts.get(0));
        }
        if (SYSTEMDISK.equals(destinationResource)) {
            List<String> types = getResources(INSTANCETYPE, describe);
            //取所需的实例规格资源,这里取第一个值
            describe.setInstanceType(types.get(0));
        }
        if (DATADISK.equals(destinationResource)) {
            List<String> systemDisks = getResources(SYSTEMDISK, describe);
            //取所需的系统盘资源,这里取第一个值
            describe.setSystemDiskCategory(systemDisks.get(0));
        }
        describe.setDestinationResource(destinationResource);
        return getResponse(describe, destinationResource);
    }

    public List<String> getResponse(DescribeAvailableResourceRequest describe, String destinationResource) {
        DescribeAvailableResourceResponse response = doAction(describe);
        if (null != response && CollectionUtils.isNotEmpty(response.getAvailableZones())) {
            List<String> zones = new ArrayList<String>();
            for (AvailableZone availableZone : response.getAvailableZones()) {
                if(ZONE.equals(destinationResource)){
                    if (availableZone.getStatus().equals("Available")) {
                        zones.add(availableZone.getZoneId());
                    }
                }
                if (CollectionUtils.isNotEmpty(availableZone.getAvailableResources())) {
                    for (AvailableResource resource : availableZone.getAvailableResources()) {
                        if (resource.getType().equals(destinationResource)) {
                            if (CollectionUtils.isNotEmpty(resource.getSupportedResources())) {
                                List<String> types = new ArrayList<String>();
                                for (SupportedResource supportResource : resource.getSupportedResources()) {
                                    //只取可用资源,SoldOut为售罄
                                    if (supportResource.getStatus().equals("Available")) {
                                        types.add(supportResource.getValue());
                                    }
                                }
                                return types;
                            }
                        }
                    }
                }
            }
            if(CollectionUtils.isNotEmpty(zones)){
                return zones;
            }
        }
        return null;
    }

    //查询所需目标类型资源的值
    public void doDescribeResources(String destinationResource) {
        List<String> values = getResources(destinationResource, null);
    }
AI 代码解读
相关实践学习
快速体验PolarDB开源数据库
本实验环境已内置PostgreSQL数据库以及PolarDB开源数据库:PolarDB PostgreSQL版和PolarDB分布式版,支持一键拉起使用,方便各位开发者学习使用。
7天玩转云服务器
云服务器ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,可降低 IT 成本,提升运维效率。本课程手把手带你了解ECS、掌握基本操作、动手实操快照管理、镜像管理等。了解产品详情:&nbsp;https://www.aliyun.com/product/ecs
目录
打赏
0
0
0
0
225
分享
相关文章
深度学习在资源利用率优化中的应用:让服务器更聪明
深度学习在资源利用率优化中的应用:让服务器更聪明
106 6
2025年阿里云弹性裸金属服务器架构解析与资源配置方案
🚀 核心特性与技术创新:提供100%物理机性能输出,支持NVIDIA A100/V100 GPU直通,无虚拟化层损耗。网络与存储优化,400万PPS吞吐量,ESSD云盘IOPS达100万,RDMA延迟<5μs。全球部署覆盖华北、华东、华南及海外节点,支持跨地域负载均衡。典型应用场景包括AI训练、科学计算等,支持分布式训练和并行计算框架。弹性裸金属服务器+OSS存储+高速网络综合部署,满足高性能计算需求。
使用ACK Edge统一管理多地域的ECS资源
使用ACK Edge统一管理多地域的ECS资源
使用ACK Edge统一管理多地域的ECS资源
本文介绍如何使用ACK Edge来管理分布在多个地域的ECS资源。
|
3月前
|
服务器系统资源不足怎么办
服务器系统资源不足怎么办
104 4
【阿里云】控制台使用指南:从创建ECS到系统诊断测评
本文介绍了如何通过阿里云获取ECS云服务器并进行操作系统配置与组件安装,以实现高效的资源管理和系统监控。阿里云凭借强大的基础设施和丰富的服务成为用户首选。文中详细描述了获取ECS、RAM授权、开通操作系统控制台及组件安装的步骤,并展示了如何利用控制台实时监控性能指标、诊断系统问题及优化性能。特别针对idle进程进行了深入分析,提出了优化建议。最后,建议定期进行系统健康检查,并希望阿里云能推出更友好的低成本套餐,满足学生等群体的需求。
63 17
【阿里云】控制台使用指南:从创建ECS到系统诊断测评
玩转云服务器——阿里云操作系统控制台体验测评
在云服务器日益普及的背景下,运维人员对操作系统管理工具的要求不断提高。我们需要一款既能直观展示系统状态,又能智能诊断问题,提供专业指导的控制台。阿里云操作系统管理平台正是基于API、SDK、CLI等多种管理方式,致力于提升操作效率,为用户带来全新的系统运维体验。阿里云操作系统控制台凭借便捷易用的设计和高效的管理功能,成为云服务器运维的强力助手。本次测评基于真实体验截图,对其整体表现进行了深入探索。
54 33
阿里云幻兽帕鲁联机服务器搭建全攻略,速来抄作业!2025新版教程
阿里云提供2025年最新幻兽帕鲁服务器申请购买及一键开服教程。4核16G配置支持8人,70元/月;8核32G配置支持20人,160元/月。选择配置、地域、操作系统后,点击【一键购买及部署】,约3分钟完成创建。本地安装STEAM客户端并登录,进入游戏选择多人模式,输入服务器IP和端口(8211),即可开始游戏。详细教程及更多问题解答请参考阿里云幻兽帕鲁游戏专区。
53 20
阿里云操作系统控制台——解决服务器磁盘I/O故障
阿里云操作系统控制台——解决服务器磁盘I/O故障
34 12
阿里云操作系统控制台——ECS操作与性能优化
本文详细介绍如何操作阿里云服务器ECS,从开通到组件安装及内存诊断。首先,通过选择操作系统(如Alibaba Cloud Linux 3)并开通服务,创建RAM用户并授予权限。接着,安装所需组件,支持节点或集群安装。最后,利用内存全景诊断功能,输入实例ID或Pod名称发起诊断并解析结果。这一流程帮助用户高效搭建计算环境,提升技术能力,确保业务稳定运行,并提出优化建议以改善用户体验。
60 8

相关产品

  • 云服务器 ECS