Update a Linode

put

https://api.linode.com/{apiVersion}/linode/instances/{linodeId}

Updates a Linode.

📘
Updating tags?
If you include the tags object in this operation to modify the Linode's tags, you need to include existing tags to maintain them. You can run the List tagged objects operation to view your Linode, based on its label and store its current tags.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

Identity and access permissions. Your user needs a role with these permissions. Learn more.
- Permissions: update_linode
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: linodes:read_write

CLI

linode-cli linodes update 7833080 \
  --label linode123 \
  --backups.schedule.day "Saturday" \
  --backups.schedule.window "W22" \
  --alerts.cpu 180 \
  --alerts.network_in 10 \
  --alerts.network_out 10 \
  --alerts.transfer_quota 80 \
  --alerts.io 10000

Learn more

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

linodeId

integer

required

ID of the Linode to look up.

Body Params

alerts

object

backups

object

Information about this Linode's backups status. For information about available backups, run List backups.

group

string

deprecated

Deprecated, Filterable The group label for this Linode.

label

string

length between 3 and 64

Filterable Provides a name for the Linode. If not provided, the API generates one for it. Linode labels have the following constraints:

It needs to begin and end with an alphanumeric character.
It can only consist of alphanumeric characters, hyphens (-), underscores (_), or periods (.).
It can't contain two consecutive hyphens (--), underscores (__) or periods (..).

maintenance_policy

string

enum

The maintenance policy configured by the user for this Linode. Review maintenance policy documentation for more details.

Allowed:

200The updated Linode.

defaultSee Errors for the range of possible error response codes.