文档首页/ 华为云会议 Meeting/ 服务端API参考/ 企业管理/ 接口参考/ 企业管理员查询企业内资源及业务权限
更新时间:2024-04-29 GMT+08:00

企业管理员查询企业内资源及业务权限

描述

企业管理员通过该接口查询企业内资源及业务权限,包括查询已使用的资源情况。

调试

您可以在API Explorer中调试该接口。

接口原型

表1 接口原型

请求方法

GET

请求地址

/v1/usg/dcs/corp/resource

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

X-Access-Token

String

Header

授权令牌。获取“执行App ID鉴权”响应的accessToken。

X-Request-Id

String

Header

请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。

Accept-Language

String

Header

语言参数,默认为中文zh-CN,英文为en-US。

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

表4 响应参数

参数

类型

描述

confCallCount

ResDetailDTO object

会议并发方数。

confLength

Integer

会议时长。

enableAiMinutes

Boolean

是否开启Ai会议纪要。

enableHybridCloud

Boolean

企业是否开启混合云模式。

enablePstn

Boolean

在创建企业的时候设置的pstn权限开关。

enableSMS

Boolean

企业是否通过短信形式发送会议通知。

enableCloudDisk

Boolean

是否开启云盘。

enableUc

Boolean

是否开启UC功能。

hwVisionCount

ResDetailDTO object

智慧屏终端接入账号数量。

ideaHubCount

ResDetailDTO object

IdeaHub终端接入账号数量。

liveCount

ResDetailDTO object

直播端口数量。

recordCapability

ResDetailDTO object

录播存储空间 (单位:G)。

roomCount

ResDetailDTO object

电子白板(SmartRooms)接入账号数量。

singleConfCallCount

Integer

单会议并发呼叫数。

te1080pHardCount

ResDetailDTO object

1080P硬终端接入账号数量。

te720pHardCount

ResDetailDTO object

720P硬终端接入账号数量。

teSoftCount

ResDetailDTO object

软终端账户数量。

thirdPartyHardCount

ResDetailDTO object

第三方硬终端接入账号数量。

vmr

Array of QueryVmrPkgResResultDTO objects

查询云会议室套餐包分配数量结果。

表5 ResDetailDTO数据结构

参数

类型

描述

expiredCount

Integer

到期数量。

expiringCount

Integer

即将到期数量,到期时间在30天内。

sumCount

Integer

总数。

trialCount

Integer

赠送数量

usedCount

Integer

已使用数(录播存储空间、会议并发、推流并发方数暂无法查询)。

表6 QueryVmrPkgResResultDTO 数据结构

参数

类型

描述

vmrName

String

云会议室套餐包名称。

vmrPkgCount

Integer

该云会议室套餐分配的总数。

vmrPkgId

String

云会议室套餐包id。

vmrPkgParties

Integer

云会议室套餐方数。

vmrPkgUsedCount

Integer

该套餐对应的云会议室已分配数量。

请求消息示例

GET /v1/usg/dcs/corp/resource
Connection: keep-alive
X-Access-Token: stbdOWTjFFPAoDfJaWFGWnOTtepUlEsfhQSC
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 

响应消息示例

HTTP/1.1 200 
Date: Tue, 17 Dec 2019 09:32:47 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 539e8b710378987ffc5eb844b5e5c290

{
    "te1080pHardCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 2,
        "usedCount": 1
    },
    "te720pHardCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 5,
        "usedCount": 0
    },
    "teSoftCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 30,
        "usedCount": 21
    },
    "roomCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 0,
        "usedCount": 0
    },
    "recordCapability": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 8,
        "usedCount": 0
    },
    "confCallCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 6,
        "usedCount": 0
    },
    "liveCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 1,
        "usedCount": 0
    },
    "thirdPartyHardCount": {
        "expiredCount": 0,  
        "expiringCount": 0,
        "trialCount": 0,
        "sumCount": 0,
        "usedCount": 0
    },
    "vmr": [
        {
            "vmrPkgId": "ff808081680d5b8601682b3436070030",
            "vmrName": "运营VMR专用_25",
            "vmrPkgParties": 25,
            "vmrPkgCount": 1,
            "vmrPkgUsedCount": 1
        }
    ],
    "enablePstn": false,
    "enableSMS": true
}

错误码

当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心

CURL命令示例

curl -k -i -X GET -H 'X-Access-Token: stbdOWTjFFPAoDfJaWFGWnOTtepUlEsfhQSC' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/resource