Modificación de un usuario
Descripción
Esta API es utilizada por un administrador de empresa para modificar un usuario.
SLA
Tasa de éxito de solicitudes: > 99.99%
Retardo de solicitud TP99: 34 ms
Depuración
Puede depurar esta API en Explorador de API.
Prototipo
Método de solicitud |
PUT |
---|---|
Dirección de solicitud |
/v1/usg/dcs/corp/member/{account} |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
account |
Sí |
String |
Path |
Cuenta de usuario.
|
accountType |
No |
Integer |
Query |
Tipo de cuenta.
|
X-Access-Token |
Sí |
String |
Header |
Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación. |
X-Request-Id |
No |
String |
Header |
ID de solicitud, que se utiliza para el seguimiento y la localización de fallos. Se recomienda utilizar un UUID. Si este parámetro no se incluye, se genera automáticamente un ID de solicitud. |
Accept-Language |
No |
String |
Header |
Idioma. Valores zh-CN para el chino (predeterminado) y en-US para el inglés. |
country |
No |
String |
Body |
País o región a la que pertenece el número de móvil. Valor predeterminado: chinaPR. maxLength: 255 minLength: 0 |
deptCode |
No |
String |
Body |
ID de departamento. Si este parámetro no se incluye, el departamento root se utiliza de forma predeterminada. Valor predeterminado: 1. maxLength: 32 minLength: 0 |
desc |
No |
String |
Body |
Observaciones. maxLength: 128 minLength: 0 |
|
No |
String |
Body |
Dirección de correo electrónico. maxLength: 255 minLength: 0 |
englishName |
No |
String |
Body |
Nombre en inglés del usuario. maxLength: 64 minLength: 0 |
hidePhone |
No |
Boolean |
Body |
Si se debe ocultar el número de móvil. Valor predeterminado: false. |
name |
No |
String |
Body |
Nombre del usuario. maxLength: 64 minLength: 1 |
phone |
No |
String |
Body |
Número de teléfono móvil, que debe contener el código del país. Por ejemplo, un número de teléfono móvil en China continental es +86xxxxxxxxxxx. Este parámetro se combina con el parámetro country. El número de móvil solo puede contener números. Se debe especificar el número de teléfono móvil o la dirección de correo electrónico. maxLength: 32 minLength: 0 |
signature |
No |
String |
Body |
Firma. maxLength: 512 minLength: 0 |
sortLevel |
No |
Integer |
Body |
Número de secuencia en el directorio corporativo. Un valor menor indica una posición más alta en el directorio corporativo. Valor predeterminado: 10000. maximum: 10000 minimum: 1 |
status |
No |
Integer |
Body |
Estado de usuario.
Valor predeterminado: 0. |
title |
No |
String |
Body |
Título del trabajo. maxLength: 32 minLength: 0 |
vmrId |
No |
String |
Body |
ID de la sala de reuniones en la nube. Si este parámetro no se incluye, el ID de la sala de reuniones en la nube se generará automáticamente. maxLength: 32 minLength: 0 |
Códigos de estado
Código de estado de HTTP |
Descripción |
---|---|
200 |
Operación exitosa. |
400 |
Parámetros no válidos |
401 |
La autenticación no se realiza o falla. |
403 |
Permisos insuficientes. |
500 |
Excepción del servidor. |
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
activeTime |
Long |
Tiempo de activación (marca de tiempo UTC). |
adminType |
Integer |
Tipo de administrador.
|
corp |
CorpBasicInfoDTO object |
Datos de registro de empresa, que se devuelven solo cuando los usuarios consultan los datos personales de sí mismos. |
country |
String |
País o región a la que pertenece el número de móvil del usuario. |
deptCode |
String |
Código de departamento. |
deptName |
String |
Nombre del departamento. |
deptNamePath |
String |
Ruta del nombre del departamento. |
desc |
String |
Observaciones. |
devType |
QueryDeviceInfoResultDTO object |
Tipo del dispositivo asociado. |
|
String |
Dirección de correo electrónico. |
englishName |
String |
Nombre inglés. |
function |
UserFunctionDTO object |
Indicador de función de usuario. |
hidePhone |
Boolean |
Si se debe ocultar el número de móvil. |
id |
String |
ID de usuario. |
license |
Integer |
Licencia.
|
name |
String |
Nombre del usuario. |
phone |
String |
Número móvil. |
signature |
String |
Firma. |
sipNum |
String |
Número de SIP. |
sortLevel |
Integer |
Número de secuencia en el directorio corporativo. Un valor menor indica una posición más alta en el directorio corporativo. |
status |
Integer |
Estado de usuario.
|
thirdAccount |
String |
ID de usuario de terceros. |
title |
String |
Título del trabajo. |
userAccount |
String |
Cuenta de Huawei Cloud Meeting. |
userType |
Integer |
Tipo de usuario. 2 miembro de la empresa. |
visionAccount |
String |
Cuenta de TV inteligente única. |
vmrList |
Array of UserVmrDTO objects |
Lista de salas de reuniones en la nube. |
Solicitud de ejemplo
PUT /v1/usg/dcs/corp/member/3e48b79b660e403cb5e0208f7be83961?accountType=0 Connection: keep-alive Content-Type: application/json X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9 Content-Length: 173 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "country": "chinaPR", "deptCode": "1", "desc": "modDesc", "email": "modEmail@huawei.com", "englishName": "modEnglishName", "hidePhone": true, "name": "modName", "phone": "123456789", "signature": "modSignature", "sortLevel": 1, "status": 1, "title": "modTitle", "vmrId": "" }
Ejemplo de respuesta
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: 26701eb8f982b175b70776316d46e33e { "activeTime": 1601221696783, "adminType": 2, "corp": null, "country": "chinaPR", "deptCode": "1", "deptName": "Root Department", "deptNamePath": "Root Department", "desc": "modDesc", "devType": { "deviceSize": null, "model": null, "purchaseChannel": null }, "email": "modEmail@huawei.com", "englishName": "modEnglishName", "function": { "enableRoom": true }, "hidePhone": true, "id": "f521bebcbb27422cb3241c4cb19942c5", "license": 0, "name": "modName", "phone": "+86123456789", "signature": "modSignature", "sipNum": "+8657198480", "sortLevel": 1, "status": 1, "thirdAccount": "thirdAccount", "title": "modTitle", "userAccount": "3e48b79b660e403cb5e0208f7be83961", "userType": 2, "visionAccount": null, "vmrList": [ { "id": "2c908bc76f61a5f2016f61bbfdf5039b", "status": "0", "vmrId": "912992631", "vmrName": "name's cloud meeting room", "vmrPkgId": null, "vmrPkgLength": null, "vmrPkgName": null, "vmrPkgParties": null } ] }
Códigos de error
Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en el Centro de errores de la API de Huawei Cloud.
Ejemplo de comando cURL
curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9' -d '{"country": "chinaPR","deptCode": "1","desc": "modDesc","email": "modEmail@huawei.com","englishName": "modEnglishName","hidePhone": true,"name": "modName","phone": "123456789","signature": "modSignature","sortLevel": 1,"status": 1,"title": "modTitle","vmrId": ""}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/member/3e48b79b660e403cb5e0208f7be83961?accountType=0