Modificación de una Terminal
Descripción
Esta API es utilizada por un administrador de empresa para modificar una terminal.
SLA
Tasa de éxito de solicitudes: > 99.99%
Retardo de solicitud TP99: 39 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/device/{sn} |
|
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
|---|---|---|---|---|
|
sn |
Sí |
String |
Path |
Terminal SN. El valor solo puede contener números, letras y guiones bajos (_). maxLength: 30 minLength: 1 |
|
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. El valor predeterminado es el departamento root. Valor predeterminado: 1. maxLength: 32 minLength: 0 |
|
description |
No |
String |
Body |
Descripción del terminal. maxLength: 128 minLength: 0 |
|
|
No |
String |
Body |
Formato de dirección de correo electrónico unificado. maxLength: 255 minLength: 0 |
|
name |
No |
String |
Body |
Nombre de terminal. Se recomienda establecer este parámetro en una ubicación específica. maxLength: 64 minLength: 0 |
|
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. maxLength: 32 minLength: 0
NOTA:
Se debe especificar el número de teléfono móvil o la dirección de correo electrónico. |
|
prjCodeMode |
No |
Integer |
Body |
Modo de generación de código de proyección.
|
|
status |
No |
Integer |
Body |
Estado de terminal.
|
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
Ninguno
Solicitud de ejemplo
PUT /v1/usg/dcs/corp/device/asdasfscasd
Connection: keep-alive
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
Content-Type: application/json
Content-Length: 198
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
{
"name": "test",
"deptCode": "1",
"email": "test@huawei.com",
"country": "chinaPR",
"description": "test",
"status": 0
}
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: 88007a3bf4d6478e530b09589582f26f
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: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' -d '{"model": "TE20","name": "test","deptCode": "1","email": "test@huawei.com","country": "chinaPR","description": "test","status": 0}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device/asdasfscasd
