文档首页/ 云搜索服务 CSS/ API参考/ API V1/ 规格查询/ 查询规格详情 - ShowFlavorDetail
更新时间:2025-10-31 GMT+08:00
分享

查询规格详情 - ShowFlavorDetail

功能介绍

查询规格详细信息。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v1.0/{project_id}/flavors/{flavor_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID。获取方法请参见获取项目ID和名称

约束限制:

不涉及

取值范围:

获取方法请参见获取项目ID和名称。

默认取值:

不涉及

flavor_id

String

参数解释:

规格id。

约束限制:

不涉及

取值范围:

实例规格列表接口返回的id。

默认取值:

不涉及

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

str_id

String

参数解释

规格id。

取值范围

不涉及

name

String

参数解释

规格名称。

取值范围

不涉及

condOperationStatus

String

参数解释

此参数是Region级配置,某个AZ没有在condOperationAz参数中配置时默认使用此参数的取值。

取值范围

  • normal:正常商用。

  • sellout:售罄。

condOperationAz

String

参数解释

此参数是AZ级配置,某个AZ没有在此参数中配置时默认使用condOperationAz参数的取值。此参数的配置格式“az(xx)”。()内为某个AZ的flavor状态,()内必须要填有状态,不填为无效配置。状态的取值范围与condOperationStatus参数相同。

取值范围

不涉及

flavor_detail

Array of ShowFlavorDetailRspFlavorDetail objects

参数解释

规格属性信息。

取值范围

不涉及

表3 ShowFlavorDetailRspFlavorDetail

参数

参数类型

描述

name

String

参数解释

属性名称。

取值范围

  • cpu:规格CPU属性。

  • mem:规格内存属性。

  • diskrange:规格磁盘取值范围属性。

  • flavorTypeCn:中文规格分类属性。

  • flavorTypeEn:英文规格分类属性。

value

String

参数解释

属性值。

取值范围

不涉及

请求示例

查询规格详情请求示例。

GET https://{Endpoint}/v1.0/{project_id}/flavors/{flavor_id}

响应示例

状态码:200

请求已成功。

{
  "name" : "ess.spec-2u8g",
  "condOperationStatus" : "normal",
  "condOperationAz" : "cn-north-7a(sellout),cn-north-7b(normal),cn-north-7c(normal)",
  "str_id" : "b58dfcfb-5f73-4f05-8c06-5171b12fd618",
  "flavor_detail" : [ {
    "name" : "cpu",
    "value" : "2"
  }, {
    "name" : "diskrange",
    "value" : "40,800"
  }, {
    "name" : "flavorTypeCn",
    "value" : "通用计算型"
  }, {
    "name" : "flavorTypeEn",
    "value" : "General computing"
  }, {
    "name" : "mem",
    "value" : "8"
  } ]
}

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

403

请求被拒绝访问。

返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

错误码

请参见错误码

相关文档