更新时间:2023-12-29 GMT+08:00

SP管理员修改企业

描述

修改企业,若任一参数为null或者不携带则不修改。

调试

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

接口原型

表1 接口原型

请求方法

PUT

请求地址

/v1/usg/dcs/sp/corp/{id}

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

id

String

Path

企业id。

X-Access-Token

String

Header

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

X-Request-Id

String

Header

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

Accept-Language

String

Header

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

adminInfo

ModAdminDTO object

Body

待修改的管理员信息。

basicInfo

ModCorpBasicDTO object

Body

待修改的企业基本信息。

groupId

String

Body

媒体接入(包括SBC和MCU)分组id,可通过“SP管理员查询资源信息”接口查询获取。

propertyInfo

Array of OrgPropertyDTO objects

Body

可配置项信息。

表3 ModAdminDTO 数据结构

参数

是否必须

类型

位置

描述

country

String

Body

联系电话所属的国家,如果国家为中国大陆则country参数取值为chinaPR,国家和国家码的对应关系如下。

手机号所属的国家

email

String

Body

邮箱。

name

String

Body

名称。

phone

String

Body

手机号,必须加上国家码,例如中国大陆手机+86xxxxxxx,当填写手机号时“country”参数必填。

表4 ModCorpBasicDTO 数据结构

参数

是否必须

类型

位置

描述

address

String

Body

地址。

country

String

Body

手机号所属的国家

description

String

Body

备注。

email

String

Body

邮箱地址,格式必须满足(^$|^[\w-+]+(.[\w-+]+)@[\w-]+(.[\w-]+)(.[\w-]{1,})$)。

fax

String

Body

传真号码,格式必须满足(^$|^[+]?[0-9]+$)。

name

String

Body

企业名称,格式必须满足^[^#%&'+;<>="'??\....../]*$。

phone

String

Body

手机号,必须加上国家码,例如中国大陆手机+86xxxxxxx,当填写手机号时“country”参数必填,手机格式必须满足(^$|^[+]?[0-9]+$)。

状态码

表5 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

请求消息示例

PUT /v1/usg/dcs/sp/corp/818803911
Connection: keep-alive
Content-Type: application/json
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
Content-Length: 173
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "adminInfo": {
        "country": "chinaPR",
        "email": "******",
        "name": "zhangsan@corp",
        "phone": "+86191****9092"
    },
    "basicInfo": {
        "country": "chinaPR",
        "description": "description",
        "email": "******",
        "fax": "+123456789",
        "name": "华为技术有限公司",
        "phone": "+86191****9092"
    },
    "groupId": "297e87ec7713734b01771458c2d80000",
}

响应消息示例

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 143
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 26701eb8f982b175b70776316d46e345

错误码

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

CURL命令示例

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' -d '{"adminInfo": {"country": "chinaPR","email": "******","name": "zhangsan@corp","phone": "+86191****9092"},"basicInfo": {"country": "chinaPR","description": "description","email": "******","fax": "+123456789","name": "华为技术有限公司","phone": "+86191****9092"}"groupId": "297e87ec7713734b01771458c2d80000"}' 
https://api.meeting.huaweicloud.com/v1/usg/dcs/sp/corp/818803911