# 查看租户资源用量信息 - ShowResourceUsage #### 功能介绍 查询租户一次性和包周期（包年/包月）资源用量信息。 ![](https://support.huaweicloud.com/api-metastudio/public_sys-resources/note_3.0-zh-cn.png) 按需套餐包用量本接口无法查询，需要调用CBC接口查询，详见[按需套餐包用量查询](https://cbc.huaweicloud.com/bm/support/api-apidt/CBCInterface_0001239.html)和[查询资源包信息](https://cbc.huaweicloud.com/bm/support/api-apidt/CBCInterface_0000511.html)。 各种资源的计费方式请参考[计费说明](https://support.huaweicloud.com/productdesc-metastudio/metastudio_01_0006.html)。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-metastudio/metastudio_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-metastudio/metastudio_02_0071.html)。 #### URI GET /v1/{project_id}/tenants/resources-usage 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-metastudio/metastudio_02_0006.html)。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resource | 否 | String | 资源类型。可填多个，用","分隔。详见[资源类型](https://support.huaweicloud.com/api-metastudio/metastudio_02_0042.html)。 | | business | 否 | String | 业务类型。可填多个，用","分隔。 - VOICE_CLONE：声音制作 - SYNTHETICS_SOUND：声音合成 - ASSET_MANAGER：资产管理 - MODELING_2D：形象制作 - LIVE_2D：分身数字人视频直播 - VIDEO_2D：分身数字人视频制作 - CHAT_2D：分身数字人智能交互 - BUSINESS_CARD_2D：分身数字人名片 - PICTURE_2D：照片数字人视频 - MODELING_3D：3D照片建模 - VDS_3D：3D视觉驱动 - TTSA_3D：3D语音驱动 - FLEXUS_2D：FLEXUS版本资源 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 否 | String | 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取。 响应消息头中X-Subject-Token的值。 | | Authorization | 否 | String | 使用AK/SK方式认证时必选，携带的鉴权信息。 | | X-Sdk-Date | 否 | String | 使用AK/SK方式认证时必选，请求的发生时间。 格式为(YYYYMMDD'T'HHMMSS'Z')。 | | X-Project-Id | 否 | String | 使用AK/SK方式认证时必选，携带项目ID信息。 | #### 响应参数 **状态码：200** 表4响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-Request-Id | String | 请求ID。 | 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resources | Array of [ResourceUsageInfo] objects | 资源用量列表 | 表6ResourceUsageInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resource_type | String | 资源类型。详见[资源类型](https://support.huaweicloud.com/api-metastudio/metastudio_02_0042.html)。 | | business_type | String | 业务类型。 - VOICE_CLONE：声音制作 - SYNTHETICS_SOUND：声音合成 - ASSET_MANAGER：资产管理 - MODELING_2D：形象制作 - LIVE_2D：分身数字人视频直播 - VIDEO_2D：分身数字人视频制作 - CHAT_2D：分身数字人智能交互 - BUSINESS_CARD_2D：分身数字人名片 - PICTURE_2D：照片数字人视频 - MODELING_3D：3D照片建模 - VDS_3D：3D视觉驱动 - TTSA_3D：3D语音驱动 - FLEXUS_2D：FLEXUS版本资源 | | sub_resource_type | String | 子资源类型。当前只有flexus套餐包存在该字段 - voice_clone_flexus: 语音克隆Flexus版 - modeling_count_2d_model_flexus: 分身数字人形象制作Flexus版 - video_time_flexus_2d_model: 分身数字人Flexus版本视频制作 | | is_sub_resource | Boolean | 是否子资源。子资源描述的是子资源的数量和单位 **默认取值：** false | | charging_mode | String | 计费类型。 - PERIODIC: 包周期 - ONE_TIME：一次性 - ON_DEMAND：按需 | | resource_source | String | 资源来源。 - PURCHASED: 购买 - SP_ALLOCATED：SP分配 - ADMIN_ALLOCATED：系统管理员分配 | | amount | Float | 总量 **取值范围：** 0\~1000000 | | usage | Float | 使用量 **取值范围：** 0\~1000000 | | unit | String | 单位。 - NUM：个数(形象/声音) - MIN：分钟（视频制作） - HOUR：小时 （直播） - CHANNEL：路（直播/交互） - GB：GB(资产管理) - MILLION_WORDS：百万字 - TEN_THOUSAND_WORDS：万字 - TIME：次 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | #### 请求示例 ``` GET https://{endpoint}/v1/f488337c31c8e4622f1590735b134c65/tenants/resources-usage ``` #### 响应示例 **状态码：200** 查看租户信息 ``` { "resources" : [ { "resource_type" : "video", "charging_mode" : "ONE_TIME", "amount" : 6000, "usage" : 100.5, "unit" : "MIN" } ] } ``` **状态码：400** 请求传参异常，包含错误码及对应描述。 ``` { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查看租户信息 | | 400 | 请求传参异常，包含错误码及对应描述。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-metastudio/ErrorCode.html)。