Modificación de metadatos de ECS con una clave especificada
Función
Esta API se utiliza para modificar los metadatos de ECS con una clave especificada.
- 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.
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/{key}
Parámetro |
Obligatorio |
Descripción |
|---|---|---|
project_id |
Yes |
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 |
Yes |
Especifica el ID de ECS. |
key |
Yes |
Especifica la clave de metadatos de ECS. |
Solicitud
Tabla 2 describe los parámetros de solicitud.
Parámetro |
Obligatorio |
Type |
Descripción |
|---|---|---|---|
meta |
Yes |
Object |
Especifica el par de claves de metadatos definidos por el usuario. Para una clave de metadatos: Contiene un máximo de 255 caracteres Unicode y no se puede dejar en blanco. 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: Contiene un máximo de 255 caracteres Unicode. |
Respuesta
Ejemplo de la solicitud
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata/{key}
{
"meta":{
"key":"value"
}
}
Ejemplo de la respuesta
{
"meta":{
"key":"value"
}
}
