文档首页/ 弹性云服务器 ECS/ API参考/ API/ 智能购买组管理/ 查询智能购买组详情
更新时间：2023-07-06 GMT+08:00
查看PDF
分享

查询智能购买组详情

功能介绍

查询指定智能购买组的详细信息。

调试

您可以在API Explorer中调试该接口。

URI

GET /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

domain_id

是

租户域ID。

auto_launch_group_id

是

智能购买组ID。

请求消息

无

响应消息

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

auto_launch_group

Object

智能购买组详细信息，详情请参见表3。
表3 auto_launch_group参数信息

参数

参数类型

描述

name

String

智能购买组名称。

type

String

请求类型。

  • request：一次性。仅在启动时交付实例集群，调度失败后不再重试。
  • maintain：持续供应。在启动时尝试交付实例集群，并监控容量，未达到目标容量则尝试继续创建ECS实例。

status

string

智能购买组的运行状态。

  • SUBMITTED：已提交
  • ACTIVE：运行中
  • DELETING：删除中
  • DELETED：已删除

task_state

string

智能购买组的任务状态。

  • HANDLING：购买中
  • FULFILLED：智能购买组已满配
  • ERROR：智能购买组异常

target_capacity

Integer

智能购买组目标容量。

实例数量或者CPU个数目标容量大于等于stable_capacity。竞价实例的容量为满配容量减去stable_capacity。

stable_capacity

Integer

按需实例目标容量。

目标容量指实例数量或CPU个数，必须小于等于target_capacity，智能购买组中可以没有按需实例。

current_capacity

Integer

当前已经购买成功的总算力。

current_stable_capacity

Integer

当前已经购买成功的按需算力。

excess_fulfilled_capacity_behavior

String

超过目标容量或目标容量减少时的实例中断行为。

  • terminate：释放
  • noTermination：不释放

instances_behavior_with_expiration

String

请求到期时正在运行实例的中断行为。

  • terminate：释放
  • noTermination：不释放

valid_since

String

请求开始时间，格式为yyyy-MM-ddTHH:mm:ssZ。

valid_until

String

请求结束时间，格式为yyyy-MM-ddTHH:mm:ssZ。

region_specs

Object

智能购买组在各个区域的配置，详情请参见表4。

allocation_strategy

String

实例分配策略。

  • lowest_price：价格最低策略，智能购买组购买的所有实例的价格总和最低。
  • prioritized：优先级策略，按照规格设定的优先级创建实例。
  • capacity_optimized：容量最优化策略，智能购买组购买的实例按照大规格优先进行购买。

spot_price

Double

用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格，可以使用该价格。

created_at

String

智能购买组创建时间。
表4 region_specs参数信息

参数

参数类型

描述

region_id

String

区域ID。

expect_target_capacity

Integer

区域内期望的总算力容量。

expect_stable_capacity

Integer

区域内期望的稳定算力容量。

launch_template_config

Object

启动模板配置，详情请参见表5。
表5 launch_template_config参数信息

参数

参数类型

描述

launch_template

Object

实例的启动模板，详情请参见表6。

overrides

Array of objects

实例的详细信息，详情请参见表7。
表6 launch_template参数信息

参数

参数类型

描述

launch_template_id

String

实例的启动模板ID，唯一标识一个启动模板。

version

String

启动模板版本号。
表7 override参数信息

参数

参数类型

描述

availability_zone_id

String

可用区ID

flavor_id

String

实例规格ID

spot_price

Double

用户愿意为竞价实例每小时支付的最高价格。

priority

Integer

优先级。数值越小，优先级越高，优先购买。

weighted_capacity

Double

实例规格的权重。

请求示例

查询指定的智能购买组详情信息。

GET https://{endpoint}/v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}

响应示例

{
  "auto_launch_group": {
    "name": "test",
    "type": "maintain",
    "status": "ACTIVE",
    "task_state": "FULFILLED",
    "target_capacity": 10,
    "stable_capacity": 5,
    "current_capacity": 10,
    "current_stable_capacity": 5,
    "excess_fulfilled_capacity_behavior": "terminate",
    "instances_behavior_with_expiration": "terminate",
    "valid_since": "2022-11-04T15:58:13Z",
    "valid_until": "2022-11-06T15:58:13Z",
    "region_specs": [
      {
        "region_id": "region1",
        "expect_target_capacity": 10,
        "expect_stable_capacity": 5,
        "launch_template_config": {
          "launch_template": {
            "launch_template_id": "c516c350-7091-4490-9338-47ddb90360f2",
            "version": "1.0"
          },
          "overrides": [
            {
              "availability_zone_id": "az1",
              "flavor_id": "s3.large.2",
              "spot_price": 2.0,
              "priority": 4,
              "weighted_capacity": 6
            },
            {
              "availability_zone_id": "az2",
              "flavor_id": "s3.large.2",
              "spot_price": 2.0,
              "priority": 4,
              "weighted_capacity": 12
            }
          ]
        }
      }
    ],
    "allocation_strategy": "lowest_price",
    "spot_price": 0.5,
    "created_at": "2022-11-03T15:58:13Z"
  }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 智能购买组管理

相关文档