更新时间:2024-01-02 GMT+08:00
分享

查询边缘规格列表

功能介绍

查询边缘规格列表。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/cloudservers/flavors

表1 Query参数

参数

是否必选

参数类型

描述

area

String

边缘规格所在大区。

大小写通用,皆支持。 支持多个查询,中间使用“,”分隔。

city

String

边缘规格所在城市。

大小写通用,皆支持。 支持多个查询,中间使用“,”分隔。

id

String

查询条件,规格的ID。

limit

Integer

查询返回边缘实例规格列表当前页面的数量 。 取值范围:0~1000。

name

String

查询条件,规格的名称。

offset

Integer

页码。 当前页面数,默认为1。 取值大于等于0,取值为0时返回第1页。

operator

String

边缘规格支持运营商。

大小写通用,皆支持。 支持多个查询,中间使用“,”分隔。

province

String

边缘规格所在省份。

大小写通用,皆支持。 支持多个查询,中间使用“,”分隔。

site_ids

String

查询条件,边缘规格站点列表,站点之间用“,”分隔。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

count

Integer

边缘实例规格数量。

flavors

Array of Flavor objects

规格列表。

表4 Flavor

参数

参数类型

描述

id

String

边缘实例规格的ID。

name

String

边缘实例规格的名称。

disk

String

边缘实例规格对应要求系统盘大小。

当前未使用该参数,缺省值为0。

ram

Integer

边缘实例规格对应的内存大小,单位为MB。

vcpus

String

边缘实例规格对应的CPU核数。

os_extra_specs

OsExtraSpecs object

规格扩展字段。

os_flavor_access_is_public

Boolean

扩展属性,flavor是否给所有租户使用。

表5 OsExtraSpecs

参数

参数类型

描述

cond:operation:status

String

此参数是Region级配置,某个AZ没有在cond:operation:az参数中配置时默认使用此参数的取值。不配置或无此参数时等同于“normal”。

cond:network

String

网络约束

支持网络特性,不配置时以控制台默认配置为准。

ecs:generation

String

边缘实例类型的代数。

ecs:performancetype

String

边缘实例规格的分类。

ecs:virtualization_env_types

String

虚拟化类型。

info:cpu:name

String

此参数是规格的CPU详细信息。

info:gpu:name

String

此参数是规格的GPU详细信息。

pci_passthrough:alias

String

P1型本地直通GPU的型号和数量,参数值可设置为“nvidia-p100:1”,表示使用该规格创建的边缘实例将占用1张NVIDIA P100显卡。

pci_passthrough:enable_gpu

String

显卡是否直通。 值为“true”,表示GPU直通。

pci_passthrough:gpu_specs

String

G1型和G2型边缘实例应用的技术,包括GPU虚拟化和GPU直通。

resource_type

String

资源类型,resource_type是为了区分边缘实例的物理主机类型。

请求示例

GET https://{endpoint}/v1/cloudservers/flavors?area=north

响应示例

状态码: 200

OK

{
  "count" : 1,
  "flavors" : [ {
    "id" : "d0272146-f6d8-4e3c-a1dc-196ec4a2f848",
    "name" : "c3.large",
    "vcpus" : "c3.large",
    "ram" : 2048,
    "disk" : "100",
    "os_flavor_access_is_public" : "true",
    "os_extra_specs" : {
      "ecs:performancetype" : "cpuv1",
      "resource_type" : "IOoptimizedC3_2",
      "ecs:generation" : "c3",
      "ecs:virtualization_env_types" : "FusionCompute",
      "pci_passthrough:enable_gpu" : true,
      "pci_passthrough:gpu_specs" : "m60_1q:virt:1",
      "pci_passthrough:alias" : "nvidia-p100:1",
      "cond:operation:status" : "normal",
      "info:cpu:name" : "Intel SkyLake 6151 3.0GHz / Intel Cascade Lake 6278 2.6GHz",
      "info:gpu:name" : "1 * NVIDIA Quadro RTX5000 / 1 * 16G"
    }
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档