查询边缘规格列表 - ListFlavors
功能介绍
查询边缘规格列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
GET /v1/cloudservers/flavors
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        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  | 
      
        查询条件,边缘规格站点列表,站点之间用“,”分隔。  | 
     
请求参数
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        X-Auth-Token  | 
      
        是  | 
      
        String  | 
      
        用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。  | 
     
响应参数
状态码:200
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        count  | 
      
        Integer  | 
      
        边缘实例规格数量。  | 
     
| 
        flavors  | 
      
        Array of Flavor objects  | 
      
        规格列表。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        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是否给所有租户使用。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        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  | 
     
错误码
请参见错误码。