# 查询边缘规格列表 - ListFlavors #### 功能介绍 查询边缘规格列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEC/doc?api=ListFlavors)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iec/iec_05_0600.html)。 #### URI GET /v1/cloudservers/flavors 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 规格列表。 | 表4Flavor | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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是否给所有租户使用。 | 表5OsExtraSpecs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-iec/ErrorCode.html)。