DescribeElasticityAssurances_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:DescribeElasticityAssurances	Get	ElasticityAssurance acs:ecs:{#regionId}:{#accountId}:elasticityassurance/*	无	无

请求参数

字段名称	字段详情
RegionIdstring	弹性保障服务所属地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
ResourceGroupIdstring	资源组 ID。使用该参数过滤资源时，资源数量不能超过 1000 个。展开详情示例值:rg-bp67acfmxazb4p****参考取值来源: DescribeSnapshotGroups
Tagarray<object>	弹性保障服务绑定的标签键值对列表。子级条数 <= 20
MaxResultsinteger<int32>	分页查询时每页行数。展开详情示例值:10取值 <= 100
NextTokenstring	弹性保障服务查询起始标志。由上一次的请求结果中获取。示例值:caeba0bbb2be03f84eb48b699f0a4883
PrivatePoolOptions.Idsstring	弹性保障服务 ID 列表。取值可以由多个 ID 组成一个 JSON 数组，最多支持 100 个 ID，ID 之间用半角逗号（,）隔开。示例值:["eap-bp67acfmxazb4**", "eap-bp67acfmxazb5**"]
Platformstring	说明该参数已废弃。示例值:null
InstanceTypestring	实例规格。通过实例规格只可以查询还在生效中的弹性保障服务，已释放的服务只能通过`PrivatePoolOptions.Ids`查询。示例值:ecs.c6.large参考取值来源: DescribeInstanceTypes CreateInstance
ZoneIdstring	弹性保障服务所属地域下的可用区 ID。示例值:cn-hangzhou-h参考取值来源: DescribeZones
InstanceChargeTypestring	实例的计费方式。取值：PostPaid，目前仅支持按量付费。展开详情示例值:PostPaid参考取值来源: DescribeInstances
Statusstring	弹性保障服务的状态。取值范围：展开详情示例值:Active
PackageTypestring	弹性保障服务类型，取值范围：展开详情示例值:ElasticityAssurance

返回参数

字段名称	字段详情
NextTokenstring	弹性保障服务下一个查询起始标志。示例值:caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCountinteger<int32>	符合查询条件的记录条数。示例值:1
MaxResultsinteger<int32>	弹性保障服务每页显示行数。示例值:10
ElasticityAssuranceSetobject

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	MissingParameter.RegionId	The specified RegionId should not be null.	诊断
400	InvalidParameter.Name	The specified PrivatePoolOptions.Name is invalid.	诊断
400	InvalidParameter.PrivatePoolOptions.Ids	The specified PrivatePoolOptions.Ids is invalid.	诊断
400	DedicatedHostNotSupported	DedicatedHost is not supported for PrivatePool.	诊断
400	SpotNotSupported	Spot is not supported for PrivatePool.	诊断
400	ClassicNetworkNotSupported	Classic network is not supported for PrivatePool.	诊断
400	Invalid.InstanceId	Instance does not exist.	诊断
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	诊断
400	MissingParameter.PrivatePoolOptions.Id	The specified PrivatePoolOptions.Id should not be null.	诊断
400	Invalid.PrivatePoolOptions.Id	The PrivatePool does not exist.	诊断
400	Invalid.InstanceType	The InstanceType does not match the PrivatePool.	诊断
400	Invalid.InstanceChargeType	The InstanceChargeType does not match the PrivatePool.	诊断
400	Invalid.ZoneId	The ZoneId does not match the PrivatePool.	诊断
400	Invalid.PrivatePoolOptions.status	The PrivatePool has been used up.	诊断
400	InvalidPlatform.ValueNotSupported	The Platform does not match the PrivatePool.	诊断
400	InvalidAliUid	The PrivatePool does not belong to the user of the Instance.	诊断
400	MissingParameter.PackageType	The specified parameter "PackageType" can not be empty.	诊断
400	MissingParameter.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" can not be empty.	诊断
400	MissingParameter.InstanceCpuCoreCount	The specified parameter "InstanceCpuCoreCount" can not be empty.	诊断
400	MissingParameter.InstanceAmount	The specified parameter "InstanceAmount" can not be empty.	诊断
400	MissingParameter.InstanceCpuCoreCountOrInstanceAmount	The specified parameter "InstanceCpuCoreCount" and "InstanceAmount" must not be empty at the same time.	诊断
400	Invalid.TooManyPrivatePoolOptions.Ids	Too many PrivatePoolOptions.Ids in this request.	诊断
400	Invalid.TooManyZoneIds	Too many ZoneIds in the request.	诊断
400	Invalid.TooManyInstanceTypes	Too many InstanceTypes in the request.	诊断
400	Invalid.TooManyUnpaidPrivatePool	Too many PrivatePools create but still unpaid.	诊断
400	Invalid.InstanceCpuCoreCountOrInstanceAmount	Both InstanceCpuCoreCount and InstanceAmount are provided.	诊断
400	Invalid.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" exist invalid element Id.	诊断
400	Invalid.PackageType	The specified parameter "PackageType" is invalid.	诊断
400	Invalid.PrivatePool.Purchase	The PrivatePool has already paid.	诊断
400	Invalid.AssuranceTimes.NotSupported	The value of AssuranceTimes is not supported.	诊断
400	RepeatStartPrivatePool	PrivatePool has already been started.	诊断
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-02-19	新增请求参数PackageType 变更返回参数
	2024-10-30	变更返回参数
	2021-10-27	变更请求参数Status 变更返回参数

DescribeElasticityAssurances_云服务器 ECS_API文档

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例