Actualización de un token
Descripción
Esta API se utiliza para actualizar el período de validez de un token.
SLA
Tasa de éxito de solicitudes: > 99.99%
Retardo de solicitud TP99: 97 ms
Depuración
Puede depurar esta API en Explorador de API.
Prototipo
Método de solicitud |
PUT |
---|---|
Dirección de solicitud |
/v1/usg/acs/token |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
X-Access-Token |
Sí |
String |
Header |
Autenticación de tokens. |
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. |
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 |
---|---|---|
accessToken |
String |
Token de acceso. |
clientType |
Integer |
Tipo de cuenta utilizada para iniciar sesión.
|
createTime |
Long |
Marca de tiempo cuando se crea el token, en milisegundos. |
daysPwdAvailable |
Integer |
Período de validez de la contraseña. |
delayDelete |
Boolean |
Si se retrasa la eliminación del token. |
expireTime |
Long |
Marca de tiempo cuando el token caduca, en segundos. |
firstLogin |
Boolean |
Si el inicio de sesión es el primer inicio de sesión.
NOTA:
Si inicia sesión en el sistema por primera vez, el sistema le pedirá que cambie la contraseña inicial. Valor predeterminado: false. |
forceLoginInd |
Integer |
Si el inicio de sesión apropiativo está habilitado.
|
proxyToken |
ProxyTokenDTO object |
Información de autenticación de proxy. |
pwdExpired |
Boolean |
Si la contraseña ha caducado. Valor predeterminado: false. |
refreshCreateTime |
Long |
Marca de tiempo cuando se crea un token de actualización, en milisegundos. |
refreshExpireTime |
Long |
Marca de tiempo cuando el token de actualización expira, en segundos. |
refreshToken |
String |
Actualice el token. |
refreshValidPeriod |
Long |
Período de validez del token de actualización, en segundos. |
tokenIp |
String |
Dirección IP del usuario. |
tokenType |
Integer |
Tipo de token.
|
user |
UserInfo object |
Detalles de autenticación de usuario. |
validPeriod |
Long |
Período de validez del token, en segundos. |
Solicitud de ejemplo
PUT /v1/usg/acs/token Connection: keep-alive X-Access-Token: stbo3vX1pyduWpSFsjMCmR93mJkfQGnohjvQ Content-Type: application/json Content-Length: 88 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
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: 714 Connection: keep-alive X-Request-Id: f90fbd8714328398fcbedddde0f1303c { "accessToken": "stbo3vX1pyduWpSFsjMCmR93mJkfQGnohjvQ", "clientType": 72, "createTime": 1599102826754, "daysPwdAvailable": -18172, "delayDelete": false, "expireTime": 1577979513, "firstLogin": true, "forceLoginInd": null, "proxyToken": null, "pwdExpired": false, "refreshCreateTime": 1599102826754, "refreshExpireTime": 1601694826, "refreshToken": "stbdkkBy2XkfsiPh4cP9xev0oGL5EmiQxP1a", "refreshValidPeriod": 2592000, "tokenIp": "10.8.0.90", "tokenType": 0, "user": { "adminType": 2, "alias1": null, "appId": null, "cloudUserId": "76aaaba8a12f4c0a8a43192...", "companyDomain": null, "companyId": "f5968fc4f9c14d50905e8e66672dabc6", "corpType": 0, "freeUser": false, "grayUser": false, "headPictureUrl": null, "isBindPhone": null, "name": "xxxx_name", "nameEn": null, "numberHA1": "1ead5e5ce44849bc2718d5c....", "paidAccount": null, "paidPassword": null, "password": null, "realm": "huaweicloud.com", "serviceAccount": "sip:xxxx@huaweicloud.com", "spId": "666bd8558e4646e1a7e1a0c99cf898e8", "status": 0, "thirdAccount": "62fe180o133fd...", "tr069Account": "X3M537A6IX4SC...", "ucloginAccount": "z8b2vo875ioh54r29ad5e3552vb3gm8np2j167...", "userId": "0d5202707123429d876....", "userType": 2, "visionAccount": null, "weLinkUser": false }, "validPeriod": 84616 }
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 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:stbo3vX1pyduWpSFsjMCmR93mJkfQGnohjvQ' 'https://api.meeting.huaweicloud.com/v1/usg/acs/token'