---
title: 函数：get_device_utilization_rate
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0068.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0068.html
indexId: 3166a0f02a30dac679c4edfef938a243ef22f86b3b21d3f60c59c15590da15de71
---
# 函数：get_device_utilization_rate

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

查询Device上Cube、Vector、AI CPU等的利用率。


#### 函数原型

- C函数原型
  1 aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)

- python函数
  1 utilization_info, ret = acl.rt.get_device_utilization_rate(device_id)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| device\_id | int，Device设备号。 用户调用acl.rt.get\_device\_count接口获取可用的Device数量后，该Device ID的取值范围为[0, (可用的Device数量\-1)]。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| utilization\_info | dict，aclrtUtilizationInfo类型利用率信息字典，具体请参见17.43\-aclrtUtilizationInfo。 |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

- 昇腾虚拟化实例场景下，不支持调用本接口查询利用率，接口返回值无实际意义。
- 开启Profiling功能时，不支持调用本接口查询利用率，接口返回值无实际意义。
- 查询Device内存利用率为预留功能，当前版本不支持，若调用本接口查询内存利用率，查询到的利用率为-1。
- Atlas 训练系列产品上没有Vector，调用本接口查询Vector利用率时，查询到的利用率为-1。