Cambio de contraseña
Función
Esta API se utiliza para cambiar la contraseña de una instancia de DCS.
URI
PUT /v2/{project_id}/instances/{instance_id}/password
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
instance_id |
Sí |
String |
ID de instancia. |
|
project_id |
Sí |
String |
ID del proyecto. |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
old_password |
No |
String |
Contraseña anterior. |
|
new_password |
No |
String |
Nueva contraseña. |
Parámetros de respuesta
Código de estado: 200
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
lock_time |
String |
Duración del bloqueo. Si la autenticación de contraseña falla y la cuenta está bloqueada, el valor de este parámetro no es null. |
|
result |
String |
Resultado del cambio de contraseña:
Valores de enumeración:
|
|
lock_time_left |
String |
Tiempo restante antes de desbloquear la cuenta. Cuando la cuenta está bloqueada, el valor de este parámetro no es null. |
|
retry_times_left |
String |
Número de intentos de contraseña restantes. Si la autenticación de contraseña falla, se devuelve una respuesta y no es null. |
|
message |
String |
Descripción del resultado de modificación. |
Código de estado: 400
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
error_msg |
String |
Mensaje de error. Máximo: 1024 |
|
error_code |
String |
Código de error. Máximo: 9 |
|
error_ext_msg |
String |
Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024 |
Código de estado: 500
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
error_msg |
String |
Mensaje de error. Máximo: 1024 |
|
error_code |
String |
Código de error. Máximo: 9 |
|
error_ext_msg |
String |
Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024 |
Solicitudes de ejemplo
PUT https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/password
{
"old_password" : "XXXXXX",
"new_password" : "XXXXXX"
}
Ejemplo de respuestas
Código de estado: 200
La contraseña se ha cambiado.
{
"lock_time" : "0",
"result" : "success",
"lock_time_left" : "0",
"retry_times_left" : "5",
"message" : "Modify DCSInstance password success."
}
Códigos de estado
|
Código de estado |
Descripción |
|---|---|
|
200 |
La contraseña se ha cambiado. |
|
400 |
Solicitud no válida. |
|
500 |
Error interno del servicio. |
Códigos de error
Consulte Códigos de error.