Updating ECS Metadata
Function
This API is used to update ECS metadata.
- If the metadata does not contain the target field, the field is automatically added.
- If the metadata contains the target field, the field value is automatically updated.
- If the field in the metadata is not requested, the field value remains unchanged.
Constraints
An ECS must be in active, stopped, paused, or suspended state, which is specified by OS-EXT-STS:vm_state.
URI
POST /v2.1/{project_id}/servers/{server_id}/metadata
Parameter | Mandatory | Description |
|---|---|---|
project_id | Yes | Specifies the project ID. For details about how to obtain the ID, see Obtenção de um ID de projeto. |
server_id | Yes | Specifies the ECS ID. |
Request
Parameter | Mandatory | Type | Description |
|---|---|---|---|
metadata | Yes | Object | Specifies the user-defined metadata key-value pair. For a metadata key: It contains a maximum of 255 Unicode characters and cannot be left blank. A key can contain uppercase letters (A-Z), lowercase letters (a-z), digits (0-9), hyphens (-), underscores (_), colons (:), and periods (.). For a metadata value: A value contains a maximum of 255 Unicode characters. |
Response
Example Request
POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata {
"metadata": {
"key": "value"
}
} Example Response
{
"metadata":{
"key":"value"
}
} 
