Actualización de metadatos de ECS
Función
Esta API se utiliza para actualizar metadatos de ECS.
- Si los metadatos no contienen el campo de destino, el campo se agrega automáticamente.
- Si los metadatos contienen el campo de destino, el valor del campo se actualiza automáticamente.
- Si no se solicita el campo de los metadatos, el valor del campo permanece sin cambios.
Restricciones
Un ECS debe estar en estado activo, detenido, pausado o suspendido, que se especifica mediante OS-EXT-STS:vm_state.
URI
POST /v1/{project_id}/cloudservers/{server_id}/metadata
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. |
server_id |
Sí |
Especifica el ID de ECS. |
Solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
metadata |
Sí |
Object |
Especifica el par clave-valor de metadatos definido por el usuario. La estructura de datos puede estar vacía. Si el valor está vacío, los datos no se actualizan. Para una etiqueta de metadatos: Contiene un máximo de 255 caracteres Unicode y no se puede dejar en blanco. Una etiqueta puede contener letras mayúsculas (A-Z), minúsculas (a-z), dígitos (0-9), guiones (-) guiones bajos (_), dos puntos (:), y puntos (.). Para un valor de metadatos: Contiene un máximo de 255 caracteres Unicode. |
Respuesta
Parámetro |
Type |
Descripción |
---|---|---|
metadata |
Object |
Especifica el par clave-valor de metadatos definido por el usuario. |
Ejemplo de la solicitud
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata
{ "metadata": { "key": "value" } }
Ejemplo de la respuesta
{ "metadata":{ "key":"value" } }