You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DescribeSpotAdvice

最近更新时间：2023.11.20 10:48:37

首次发布时间：2023.05.09 08:20:32

我的收藏

调用 DescribeSpotAdvice 接口查询抢占式实例近30天的实例平均释放率、平均折扣率等信息。

说明

实例类型及vCPU数、内存等指标数据请参见实例规格介绍。

请求参数

名称类型是否必选
示例值
描述
ActionString是DescribeSpotAdvice要执行的操作，取值：DescribeSpotAdvice。
VersionString是2020-04-01API的版本，取值：2020-04-01。
ZoneIdString否cn-beijing-a实例规格所在的可用区ID，您可以调用DescribeZones查询一个地域下的可用区信息。
InstanceTypeFamilyString否ecs.g2i实例规格族。

InstanceTypeIds.N

String

否

InstanceTypeIds.1=ecs.r2a.xlarge&InstanceTypeIds.2=ecs.g2a.xlarge

实例规格。

  • 参数 - N：表示实例规格的序号，取值范围：1～10。

  • 多个实例规格之间用&分隔。

说明

如果同时传入了InstanceTypeFamily和InstanceTypeIds.N，则生效InstanceTypeIds.N。

Cpus

Integer

否

8

实例规格的vCPU数量。

如果同时传入了Cpus和MinCpus，则生效Cpus。

MinCpus

Integer

否

2

实例规格的vCPU数量的最小值。

  • 您可以传入该值进行模糊查询，例如MinCpus传入2，表示查询该可用区下vCPU数量 ≥ 2的抢占式实例。
  • 如果同时传入了Cpus和MinCpus，则生效Cpus。

MemorySize

Integer

否

32

实例规格的内存大小，单位：MiB。

如果同时传入了MemorySize和MinMemorySize，则生效MemorySize。

MinMemorySize

Integer

否

8

实例规格的内存大小的最小值，单位：MiB。

  • 您可以传入该值进行模糊查询，例如MinMemorySize传入8，表示查询该可用区下内存容量 ≥ 8MiB的抢占式实例。
  • 如果同时传入了MemorySize和MinMemorySize，则生效MemorySize。

Gpu.ProductName

String

否

Tesla A30

GPU计算卡的类型，取值：

  • Tesla A10

  • Tesla A30

  • Tesla A100

  • Tesla A800

  • Tesla V100

  • Tesla T4

说明

  • 默认值：无，即查询所有类型。
  • 传入不存在的GPU计算卡类型时，返回为空。
  • 各实例GPU计算卡的详细信息，请参见GPU实例规格清单。
Gpu.CountInteger否2GPU实例对应的GPU数量。GPU实例相关信息请参见GPU实例规格清单。

NextToken

String

否

-

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

MaxResults

Integer

否

10

分页查询时设置的每页行数：

  • 最大值：1000

  • 最小值：1

  • 默认值：100

返回数据

名称
类型
示例值
描述
AvailableSpotResources
Array of Struct
-
近30天抢占式实例的释放率、折扣率等信息组成的数组。
NextToken
String
bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******
本次调用返回的查询凭证值，返回为空表示该页为末页。

请求示例

GET /?Action=DescribeSpotAdvice&Version=2020-04-01&ZoneId=cn-beijing-a&InstanceTypeIds.1=ecs.r2a.xlarge HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230426113431A57961174C490267****",
        "Action": "DescribeSpotAdvice",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing-a"
    },
    "Result": {
        "AvailableSpotResources": [
            {
                "AverageSpotDiscount": 40,
                "InstanceType": "ecs.r2a.xlarge",
                "InterruptionRateRange": "0-3%",
                "InterruptionRate": 0,
                "ZoneId": "cn-beijing-a"
            }
        ],
        "NextToken": "bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******"
    }
}

错误码

HttpCode错误码错误信息描述
400InvalidArgumentThe specified argument is invalid.指定的参数不合法。
400LimitExceeded.MaximumInstanceTypeIdsYou've reached the limit on the number of InstanceTypeIds that you can set.指定的InstanceTypeIds数量超过最大限制。

500

InternalError

An internal error has occurred.

内部错误，请重试。如果多次尝试失败，请提交工单。