Modificación de ECS por lotes
Función
Esta API se utiliza para modificar los ECS en un lote.
Solo los nombres de ECS se pueden cambiar por lotes, y el número máximo es de 1000 a la vez.
URI
PUT /v1/{project_id}/cloudservers/server-name
Tabla 1 enumera los parámetros URI.
Parámetro |
Obligatorio |
Descripción |
---|---|---|
project_id |
Sí |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto. |
Solicitud.
Tabla 2 describe los parámetros de solicitud.
Parámetro |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
name |
String |
Sí |
Especifica el nombre modificado de los ECS. A continuación, se enumeran las siguientes reglas: Consta de un máximo de 64 caracteres, incluyendo letras mayúsculas, minúsculas, dígitos, guiones (-), guiones bajos (_) y puntos (.). Después de cambiar los nombres de ECS por lotes, el sistema no agrega automáticamente un sufijo digital a los nombres modificados. Por ejemplo, hay tres ECS, test_0001, test_0002 y test_0003. Después de que sus nombres se cambian para develop por lotes, sus nombres cambiados develop todos. |
dry_run |
Boolean |
No |
Especifica si se debe comprobar la solicitud y cambiar los nombres de ECS. true: indica que solo se envía la solicitud de cambio de nombre y los nombres de los ECS no se cambiarán. Los elementos de verificación incluyen parámetros obligatorios, formato de solicitud y restricciones de servicio. Si la comprobación falla, el sistema devuelve un error. Si el resultado de la comprobación es el esperado, el sistema responde correctamente. Consulte Respuestas (operación por lotes) false: indica que se envía la solicitud de cambio de nombre y los nombres de los ECS se cambiarán si el resultado de la comprobación es el esperado. El valor predeterminado es false. |
servers |
Array of objects |
Sí |
Especifica los identificadores de los ECS de destino. Para más detalles, consulte Tabla 3. |
Respuesta
Consulte Respuestas (operación por lotes)
Ejemplo de la solicitud
PUT https://{endpoint}/v1/{project_id}/cloudservers/server-name
{ "name": "new-server-name", "dry_run": false, "servers": [ { "id":"260a0917-f7df-4b25-93ac-950da6c6b5d6" }, { "id":"f6d8df1a-e257-48e2-b617-1dd92ced8c20" } ] }
Ejemplo de la respuesta
Consulte Respuestas (operación por lotes)
Valores devueltos
Códigos de error
Consulte Códigos de error