查询边缘规格列表 - ListFlavors

功能介绍

查询边缘规格列表。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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”。取值范围： normal：正常商用 abandon：下线（即不显示） sellout：售罄 obt：公测 obt_sellout：公测售罄 promotion：推荐(等同normal，也是商用)
cond:network	String	网络约束支持网络特性，不配置时以控制台默认配置为准。
ecs:generation	String	边缘实例类型的代数。
ecs:performancetype	String	边缘实例规格的分类。取值范围： normal：通用型 cpuv1：计算I型 cpuv2：计算II型 highmem：内存优化型 gpu：GPU加速型 entry：通用入门型 saphana：大内存型 ultracpu：超高性能计算型 diskintensive：磁盘增强型 highio：超高I/O型 fpga：FPGA加速型
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

{
  "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"
    }
  } ]
}