Alibaba Cloud MCP Server

Official

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

NameRequiredDescriptionDefault
CoresNo实例规格的vCPU内核数目。取值参见[实例规格族](~~25378~~)。 当DestinationResource取值为InstanceType时,Cores才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:2
DataDiskCategoryNo数据盘类型。取值范围: - 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
DedicatedHostIdNo专有宿主机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:dh-bp165p6xk2tlw61e****
DestinationResourceYes要查询的资源类型。取值范围: - Zone:可用区。 - IoOptimized:I/O优化。 - InstanceType:实例规格。 - Network:网络类型。 - ddh:专有宿主机。 - SystemDisk:系统盘。 - DataDisk:数据盘。 >当DestinationResource取值为`SystemDisk`时,由于系统盘受实例规格限制,此时必须传入InstanceType。 参数DestinationResource的取值方式请参见本文中的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:InstanceType
InstanceChargeTypeNo资源的计费方式。更多信息,请参见[计费概述](~~25398~~)。取值范围: - PrePaid:包年包月。 - PostPaid:按量付费。 默认值:PostPaid。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PrePaid
InstanceTypeNo实例规格。更多信息,请参见[实例规格族](~~25378~~),您也可以调用[DescribeInstanceTypes](~~25620~~)接口获得最新的规格表。 参数InstanceType的取值方式请参见本文开头的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large
IoOptimizedNo是否为I/O优化实例。取值范围: - none:非I/O优化实例。 - optimized:I/O优化实例。 默认值:optimized。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:optimized
MemoryNo实例规格的内存大小,单位为GiB。取值参见[实例规格族](~~25378~~)。 当DestinationResource取值为InstanceType时,Memory才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: number,参数示例:8.0
NetworkCategoryNo网络类型。取值范围: - vpc:专有网络。 - classic:经典网络。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc
RegionIdYes目标地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou
ResourceTypeNo资源类型。取值范围: - instance:ECS实例。 - disk:云盘。 - reservedinstance:预留实例券。 - ddh:专有宿主机。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance
ScopeNo预留实例券的范围。取值范围: - Region:地域级别。 - Zone:可用区级别。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Region
SpotDurationNo抢占式实例的保留时长,单位为小时。 默认值:1。取值范围: - 1:创建后阿里云会保证实例运行1小时不会被自动释放;超过1小时后,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。 - 0:创建后,阿里云不保证实例运行1小时,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。 实例回收前5分钟阿里云会通过ECS系统事件向您发送通知。抢占式实例按秒计费,建议您结合具体任务执行耗时来选择合适的保留时长。 > 当`InstanceChargeType`取值为`PostPaid`,并且`SpotStrategy`值为`SpotWithPriceLimit`或`SpotAsPriceGo`时该参数生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1
SpotStrategyNo按量付费实例的竞价策略。取值范围: - NoSpot:正常按量付费实例。 - SpotWithPriceLimit:设置上限价格的抢占式实例。 - SpotAsPriceGo:系统自动出价,最高按量付费价格。 默认值:NoSpot。 当参数`InstanceChargeType`取值为`PostPaid`时,参数`SpotStrategy`才有效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:NoSpot
SystemDiskCategoryNo系统盘类型。取值范围: - 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
ZoneIdNo可用区ID。 默认值:无。返回该地域(`RegionId`)下所有可用区符合查询条件的资源。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-e

Input Schema (JSON Schema)

{ "properties": { "Cores": { "default": null, "description": "实例规格的vCPU内核数目。取值参见[实例规格族](~~25378~~)。\n\n当DestinationResource取值为InstanceType时,Cores才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:2", "title": "Cores", "type": "integer" }, "DataDiskCategory": { "default": null, "description": "数据盘类型。取值范围: \n \n- cloud:普通云盘。\n- cloud_efficiency:高效云盘。\n- cloud_ssd:SSD云盘。\n- ephemeral_ssd:本地SSD盘。\n- cloud_essd:ESSD云盘。\n- cloud_auto:ESSD AutoPL云盘。\n<props=\"china\">\n- cloud_essd_entry:ESSD Entry云盘。\n</props> 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cloud_ssd", "title": "Datadiskcategory", "type": "string" }, "DedicatedHostId": { "default": null, "description": "专有宿主机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:dh-bp165p6xk2tlw61e****", "title": "Dedicatedhostid", "type": "string" }, "DestinationResource": { "description": "要查询的资源类型。取值范围: \n \n- Zone:可用区。\n- IoOptimized:I/O优化。\n- InstanceType:实例规格。\n- Network:网络类型。\n- ddh:专有宿主机。\n- SystemDisk:系统盘。\n- DataDisk:数据盘。\n\n>当DestinationResource取值为`SystemDisk`时,由于系统盘受实例规格限制,此时必须传入InstanceType。\n\n参数DestinationResource的取值方式请参见本文中的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:InstanceType", "title": "Destinationresource", "type": "string" }, "InstanceChargeType": { "default": null, "description": "资源的计费方式。更多信息,请参见[计费概述](~~25398~~)。取值范围: \n \n- PrePaid:包年包月。 \n- PostPaid:按量付费。\n\n默认值:PostPaid。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PrePaid", "title": "Instancechargetype", "type": "string" }, "InstanceType": { "default": null, "description": "实例规格。更多信息,请参见[实例规格族](~~25378~~),您也可以调用[DescribeInstanceTypes](~~25620~~)接口获得最新的规格表。\n\n参数InstanceType的取值方式请参见本文开头的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large", "title": "Instancetype", "type": "string" }, "IoOptimized": { "default": null, "description": "是否为I/O优化实例。取值范围: \n \n- none:非I/O优化实例。\n- optimized:I/O优化实例。\n\n\n默认值:optimized。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:optimized", "title": "Iooptimized", "type": "string" }, "Memory": { "default": null, "description": "实例规格的内存大小,单位为GiB。取值参见[实例规格族](~~25378~~)。\n\n当DestinationResource取值为InstanceType时,Memory才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: number,参数示例:8.0", "title": "Memory", "type": "number" }, "NetworkCategory": { "default": null, "description": "网络类型。取值范围: \n \n- vpc:专有网络。\n- classic:经典网络。\n 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc", "title": "Networkcategory", "type": "string" }, "RegionId": { "description": "目标地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou", "title": "Regionid", "type": "string" }, "ResourceType": { "default": null, "description": "资源类型。取值范围:\n\n- instance:ECS实例。\n- disk:云盘。\n- reservedinstance:预留实例券。\n- ddh:专有宿主机。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance", "title": "Resourcetype", "type": "string" }, "Scope": { "default": null, "description": "预留实例券的范围。取值范围:\n \n- Region:地域级别。\n- Zone:可用区级别。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Region", "title": "Scope", "type": "string" }, "SpotDuration": { "default": null, "description": "抢占式实例的保留时长,单位为小时。 默认值:1。取值范围:\n- 1:创建后阿里云会保证实例运行1小时不会被自动释放;超过1小时后,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。\n- 0:创建后,阿里云不保证实例运行1小时,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。\n\n实例回收前5分钟阿里云会通过ECS系统事件向您发送通知。抢占式实例按秒计费,建议您结合具体任务执行耗时来选择合适的保留时长。\n\n> 当`InstanceChargeType`取值为`PostPaid`,并且`SpotStrategy`值为`SpotWithPriceLimit`或`SpotAsPriceGo`时该参数生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1", "title": "Spotduration", "type": "integer" }, "SpotStrategy": { "default": null, "description": "按量付费实例的竞价策略。取值范围: \n \n- NoSpot:正常按量付费实例。\n- SpotWithPriceLimit:设置上限价格的抢占式实例。\n- SpotAsPriceGo:系统自动出价,最高按量付费价格。\n\n默认值:NoSpot。\n\n当参数`InstanceChargeType`取值为`PostPaid`时,参数`SpotStrategy`才有效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:NoSpot", "title": "Spotstrategy", "type": "string" }, "SystemDiskCategory": { "default": null, "description": "系统盘类型。取值范围: \n \n- cloud:普通云盘。\n- cloud_efficiency:高效云盘。\n- cloud_ssd:SSD云盘。\n- ephemeral_ssd:本地SSD盘。\n- cloud_essd:ESSD云盘。\n- cloud_auto:ESSD AutoPL云盘。\n<props=\"china\">\n- cloud_essd_entry:ESSD Entry云盘。\n</props>\n\n默认值:cloud_efficiency。\n\n> 参数ResourceType取值为instance、DestinationResource取值为DataDisk时,参数SystemDiskCategory是必选参数。如果未传递参数值,则以默认值生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cloud_ssd", "title": "Systemdiskcategory", "type": "string" }, "ZoneId": { "default": null, "description": "可用区ID。\n\n默认值:无。返回该地域(`RegionId`)下所有可用区符合查询条件的资源。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-e", "title": "Zoneid", "type": "string" } }, "required": [ "RegionId", "DestinationResource" ], "title": "DescribeAvailableResourceArguments", "type": "object" }
ID: bu90ty06t2