Configuración de metadatos de ECS
Función
Esta API se utiliza para configurar metadatos de ECS.
Cuando se llama a esta API, todos los metadatos de este ECS se eliminarán, y el ECS usa el valor configurado en la solicitud.
Restricciones
Un ECS debe estar en estado activo, detenido, pausado o suspendido, que se especifica mediante OS-EXT-STS:vm_state.
URI
PUT /v2.1/{project_id}/servers/{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 ECS. |
Solicitud
Tabla 2 describe los parámetros de solicitud.
Parámetro |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
metadata |
Object |
Sí |
Especifica el par clave-valor de metadatos definido por el usuario. Para una clave de metadatos: Una clave contiene un máximo de 255 caracteres Unicode y no puede estar vacía. Una clave 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: Un valor contiene un máximo de 255 caracteres Unicode. |
Respuesta
Tabla 3 describe los parámetros de respuesta.
Ejemplo de la solicitud
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata
{ "metadata": { "key1": "value1", "key2": "value2" } }
Ejemplo de la respuesta
{ "metadata": { "key1": "value1", "key2": "value2" } }