ListPreferredEcsTypes - 查询推荐的ECS实例规格 - 弹性高性能计算E-HPC

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

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ehpc:ListPreferredEcsTypes

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ZoneId	string	是	可用区 ID。	cn-hangzhou-b
SpotStrategy	string	否	ECS 实例竞价策略。取值范围： NoSpot：正常按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。	NoSpot
InstanceChargeType	string	否	ECS 实例的付费类型。取值范围： PostPaid：按量付费。 PrePaid：包年包月。	PostPaid

返回参数

名称	类型	描述	示例值
	object
SupportSpotInstance	boolean	是否支持竞价实例。	true
RequestId	string	请求 ID。	04F0F334-1335-436C-A1D7-6C044FE73368
Series	object
SeriesInfo	array<object>	推荐的 ECS 实例列表，每个系列包含 E-HPC 集群各种节点对应的推荐规格。
	array<object>
SeriesName	string	实例系列名称。可能值： SeriesHighCompute。 SeriesHighMem。 SeriesGPU。 SeriesAll。	SeriesAll
SeriesId	string	ECS 实例系列 ID。可能值： HighCompute：高计算。 HighMem：高存储。 GPU：GPU。 All：代表全部可选项。	All
Roles	object	E-HPC 集群各类节点推荐的规格信息。
Manager	object
InstanceTypeId	array	管控节点推荐使用的 ECS 规格列表。
	string	管控节点推荐使用的 ECS 规格列表。	[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
Compute	object
InstanceTypeId	array	计算节点推荐使用的 ECS 规格列表。
	string	计算节点推荐使用的 ECS 规格列表。	[ "ecs.sn1ne.2xlarge", "ecs.sn1ne.4xlarge", "ecs.n1.tiny" ]
Login	object
InstanceTypeId	array	登录节点推荐使用的 ECS 规格列表。
	string	登录节点推荐使用的 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	错误码	错误信息	描述
400	InvalidParams	The specified parameter %s is invalid.	指定的参数 %s 无效。
500	UnknownError	An unknown error occurred.	未知错误
503	ServiceUnavailable	The request has failed due to a temporary failure of the server	请求失败，服务暂时不可用
406	EcsError	An error occurred while calling the ECS API operation.	ECS API调用出错. %s
406	DbError	A database service error occurred.	数据库请求失败
407	NotAuthorized	You are not authorized by RAM for this request.	此请求未获得RAM授权

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

变更历史

更多信息，参考变更详情。