ListPreferredEcsTypes - 查询推荐的ECS实例规格

查询 E-HPC 推荐的 ECS 实例规格。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ehpc:ListPreferredEcsTypesget
*全部资源
*

请求参数

名称类型必填描述示例值
ZoneIdstring

可用区 ID。

cn-hangzhou-b
SpotStrategystring

ECS 实例竞价策略。取值范围:

  • NoSpot:正常按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。
NoSpot
InstanceChargeTypestring

ECS 实例的付费类型。取值范围:

  • PostPaid:按量付费。
  • PrePaid:包年包月。
PostPaid

返回参数

名称类型描述示例值
object
SupportSpotInstanceboolean

是否支持竞价实例。

true
RequestIdstring

请求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368
Seriesarray<object>

推荐的 ECS 实例列表,每个系列包含 E-HPC 集群各种节点对应的推荐规格。

SeriesInfoobject
SeriesNamestring

实例系列名称。可能值:

  • SeriesHighCompute。
  • SeriesHighMem。
  • SeriesGPU。
  • SeriesAll。
SeriesAll
SeriesIdstring

ECS 实例系列 ID。可能值:

  • HighCompute:高计算。
  • HighMem:高存储。
  • GPU:GPU。
  • All:代表全部可选项。
All
Rolesobject

E-HPC 集群各类节点推荐的规格信息。

Managerarray

管控节点推荐使用的 ECS 规格列表。

InstanceTypeIdstring

管控节点推荐使用的 ECS 规格列表。

[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
Computearray

计算节点推荐使用的 ECS 规格列表。

InstanceTypeIdstring

计算节点推荐使用的 ECS 规格列表。

[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
Loginarray

登录节点推荐使用的 ECS 规格列表。

InstanceTypeIdstring

登录节点推荐使用的 ECS 规格列表。

[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]

示例

正常返回示例

JSON格式

{
  "SupportSpotInstance": true,
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "Series": {
    "SeriesInfo": [
      {
        "SeriesName": "SeriesAll",
        "SeriesId": "All",
        "Roles": {
          "Manager": {
            "InstanceTypeId": [
              "[ \"ecs.sn1ne.2xlarge\", \"ecs.sn1ne.4xlarge\", \"ecs.n1.tiny\" ]"
            ]
          },
          "Compute": {
            "InstanceTypeId": [
              "[ \"ecs.sn1ne.2xlarge\", \"ecs.sn1ne.4xlarge\", \"ecs.n1.tiny\" ]"
            ]
          },
          "Login": {
            "InstanceTypeId": [
              "[ \"ecs.sn1ne.2xlarge\", \"ecs.sn1ne.4xlarge\", \"ecs.n1.tiny\" ]"
            ]
          }
        }
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidParamsThe specified parameter %s is invalid.指定的参数 %s 无效。
406EcsErrorAn error occurred while calling the ECS API operation.ECS API调用出错. %s
406DbErrorA database service error occurred.数据库请求失败
407NotAuthorizedYou are not authorized by RAM for this request.此请求未获得RAM授权
500UnknownErrorAn unknown error occurred.未知错误
503ServiceUnavailableThe request has failed due to a temporary failure of the server请求失败,服务暂时不可用

访问错误中心查看更多错误码。