Rename an instance
Set or clear the display name an instance is shown by in the console and the API.
Last updated 18 November 2026View as Markdown
The name is a label in the console and the API, up to 64 characters; the machine is not changed. Without a name, the instance is shown by its id.
Prerequisites
- Permission for
ec2:ModifyInstanceAttribute. Without it the Name field is read-only in the console and the API answers403. - In the console, also
ec2:DescribeInstancesto open the instance's page (without it the page is not found).
Rename
- Open Compute, then Instances, and choose the instance.
- Choose Settings.
- Under General, for Name, enter the new name, or clear it.
- Choose Save. Saved appears next to the button, and the new name in the header.
dcloud ec2 instances rename i-3f9a2c07 --name web-02PUT /ec2/api/instances/i-3f9a2c07/name
{ "name": "web-02" }Send "name": null to clear the name.
Result
The answer is { id, name } with the new name; an instance that is not yours answers 404
"Instance not found". In Terraform, name on dcloud_instance changes it in
place.
Related
Did this page help you?