DescribeAvailableResource
Check resource availability by region, zone, or type to confirm inventory status before creating or modifying instances on Alibaba Cloud MCP Server.
Instructions
查询可用区的资源库存状态。您可以在某一可用区创建实例(RunInstances)或者修改实例规格(ModifyInstanceSpec)时查询该可用区的资源库存状态。
Input Schema
Name | Required | Description | Default |
---|---|---|---|
Cores | No | 实例规格的vCPU内核数目。取值参见[实例规格族](~~25378~~)。 当DestinationResource取值为InstanceType时,Cores才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:2 | |
DataDiskCategory | No | 数据盘类型。取值范围: - cloud:普通云盘。 - cloud_efficiency:高效云盘。 - cloud_ssd:SSD云盘。 - ephemeral_ssd:本地SSD盘。 - cloud_essd:ESSD云盘。 - cloud_auto:ESSD AutoPL云盘。 <props="china"> - cloud_essd_entry:ESSD Entry云盘。 </props> 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cloud_ssd | |
DedicatedHostId | No | 专有宿主机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:dh-bp165p6xk2tlw61e**** | |
DestinationResource | Yes | 要查询的资源类型。取值范围: - Zone:可用区。 - IoOptimized:I/O优化。 - InstanceType:实例规格。 - Network:网络类型。 - ddh:专有宿主机。 - SystemDisk:系统盘。 - DataDisk:数据盘。 >当DestinationResource取值为`SystemDisk`时,由于系统盘受实例规格限制,此时必须传入InstanceType。 参数DestinationResource的取值方式请参见本文中的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:InstanceType | |
InstanceChargeType | No | 资源的计费方式。更多信息,请参见[计费概述](~~25398~~)。取值范围: - PrePaid:包年包月。 - PostPaid:按量付费。 默认值:PostPaid。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PrePaid | |
InstanceType | No | 实例规格。更多信息,请参见[实例规格族](~~25378~~),您也可以调用[DescribeInstanceTypes](~~25620~~)接口获得最新的规格表。 参数InstanceType的取值方式请参见本文开头的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large | |
IoOptimized | No | 是否为I/O优化实例。取值范围: - none:非I/O优化实例。 - optimized:I/O优化实例。 默认值:optimized。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:optimized | |
Memory | No | 实例规格的内存大小,单位为GiB。取值参见[实例规格族](~~25378~~)。 当DestinationResource取值为InstanceType时,Memory才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: number,参数示例:8.0 | |
NetworkCategory | No | 网络类型。取值范围: - vpc:专有网络。 - classic:经典网络。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc | |
RegionId | Yes | 目标地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
ResourceType | No | 资源类型。取值范围: - instance:ECS实例。 - disk:云盘。 - reservedinstance:预留实例券。 - ddh:专有宿主机。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance | |
Scope | No | 预留实例券的范围。取值范围: - Region:地域级别。 - Zone:可用区级别。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Region | |
SpotDuration | No | 抢占式实例的保留时长,单位为小时。 默认值:1。取值范围: - 1:创建后阿里云会保证实例运行1小时不会被自动释放;超过1小时后,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。 - 0:创建后,阿里云不保证实例运行1小时,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。 实例回收前5分钟阿里云会通过ECS系统事件向您发送通知。抢占式实例按秒计费,建议您结合具体任务执行耗时来选择合适的保留时长。 > 当`InstanceChargeType`取值为`PostPaid`,并且`SpotStrategy`值为`SpotWithPriceLimit`或`SpotAsPriceGo`时该参数生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
SpotStrategy | No | 按量付费实例的竞价策略。取值范围: - NoSpot:正常按量付费实例。 - SpotWithPriceLimit:设置上限价格的抢占式实例。 - SpotAsPriceGo:系统自动出价,最高按量付费价格。 默认值:NoSpot。 当参数`InstanceChargeType`取值为`PostPaid`时,参数`SpotStrategy`才有效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:NoSpot | |
SystemDiskCategory | No | 系统盘类型。取值范围: - cloud:普通云盘。 - cloud_efficiency:高效云盘。 - cloud_ssd:SSD云盘。 - ephemeral_ssd:本地SSD盘。 - cloud_essd:ESSD云盘。 - cloud_auto:ESSD AutoPL云盘。 <props="china"> - cloud_essd_entry:ESSD Entry云盘。 </props> 默认值:cloud_efficiency。 > 参数ResourceType取值为instance、DestinationResource取值为DataDisk时,参数SystemDiskCategory是必选参数。如果未传递参数值,则以默认值生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cloud_ssd | |
ZoneId | No | 可用区ID。 默认值:无。返回该地域(`RegionId`)下所有可用区符合查询条件的资源。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-e |
Input Schema (JSON Schema)
You must be authenticated.
Other Tools from Alibaba Cloud MCP Server
- DeleteInstances
- DescribeAccountAttributes
- DescribeAvailableResource
- DescribeImages
- DescribeInstances
- DescribeRegions
- DescribeSecurityGroups
- DescribeVpcs
- DescribeVSwitches
- DescribeZones
- GetCpuloadavg15mData
- GetCpuloadavg5mData
- GetCpuLoadavgData
- GetCpuUsageData
- GetDiskTotalData
- GetDiskUsageData
- GetDiskUsedData
- GetMemUsageData
- GetMemUsedData
- RebootInstances
- ReplaceSystemDisk
- ResetPassword
- RunCommand
- RunInstances
- StartInstances
- StopInstances
Related Tools
- @aliyun/alibabacloud-ecs-mcp-server
- @aliyun/alibabacloud-ecs-mcp-server
- @RafalWilinski/aws-mcp
- @aliyun/alibabacloud-ecs-mcp-server
- @aliyun/alibabacloud-ecs-mcp-server