linode · ezilber-akamai · Aug 15, 2025 · May 6, 2025 · Jun 23, 2025 · Jul 18, 2025
@@ -10,6 +10,7 @@
 from .lke import *
 from .lke_tier import *
 from .longview import *
+from .maintenance import *
 from .monitor import *
 from .monitor_api import *
 from .networking import *

@@ -201,7 +201,7 @@ def maintenance(self):
        """
        Returns a collection of Maintenance objects for any entity a user has permissions to view. Cancelled Maintenance objects are not returned.

-        API Documentation: https://techdocs.akamai.com/linode-api/reference/get-account-logins
+        API Documentation: https://techdocs.akamai.com/linode-api/reference/get-maintenance

        :returns: A list of Maintenance objects on this account.
        :rtype: List of Maintenance objects as MappedObjects

@@ -153,6 +153,7 @@ def instance_create(
                int,
            ]
        ] = None,
+        maintenance_policy: Optional[str] = None,
        **kwargs,
    ):
        """
@@ -296,6 +297,11 @@ def instance_create(
        :type interfaces: list[ConfigInterface] or list[dict[str, Any]]
        :param placement_group: A Placement Group to create this Linode under.
        :type placement_group: Union[InstancePlacementGroupAssignment, PlacementGroup, Dict[str, Any], int]
+        :param maintenance_policy: The slug of the maintenance policy to apply during maintenance.
+                                      If not provided, the default policy (linode/migrate) will be applied.
+                                      NOTE: This field is in beta and may only
+                            function if base_url is set to `https://api.linode.com/v4beta`.
+        :type maintenance_policy: str

        :returns: A new Instance object, or a tuple containing the new Instance and
                  the generated password.
@@ -327,6 +333,7 @@ def instance_create(
            "firewall_id": firewall,
            "backup_id": backup,
            "stackscript_id": stackscript,
+            "maintenance_policy": maintenance_policy,
            # Special cases
            "disk_encryption": (
                str(disk_encryption) if disk_encryption else None

@@ -0,0 +1,25 @@
+from linode_api4.groups import Group
+from linode_api4.objects import MappedObject
+
+
+class MaintenanceGroup(Group):
+    """
+    Collections related to Maintenance.
+    """
+
+    def maintenance_policies(self):
+        """
+        .. note:: This endpoint is in beta. This will only function if base_url is set to `https://api.linode.com/v4beta`.
+
+        Returns a collection of MaintenancePolicy objects representing
+        available maintenance policies that can be applied to Linodes
+
+        API Documentation: https://techdocs.akamai.com/linode-api/reference/get-policies
+
+        :returns: A list of Maintenance Policies that can be applied to Linodes
+        :rtype: List of MaintenancePolicy objects as MappedObjects
+        """
+
+        result = self.client.get("/maintenance/policies", model=self)
+
+        return [MappedObject(**r) for r in result["data"]]
@@ -19,6 +19,7 @@
    LinodeGroup,
    LKEGroup,
    LongviewGroup,
+    MaintenanceGroup,
    MetricsGroup,
    MonitorGroup,
    NetworkingGroup,
@@ -399,6 +400,10 @@ def __init__(
        #: :any:`NetworkingGroup` for more information
        self.networking = NetworkingGroup(self)

+        #: Access methods related to maintenance on your account - see
+        #: :any:`MaintenanceGroup` for more information
+        self.maintenance = MaintenanceGroup(self)
+
        #: Access methods related to support - see :any:`SupportGroup` for more
        #: information
        self.support = SupportGroup(self)

@@ -198,6 +198,9 @@ class AccountSettings(Base):
        ),
        "object_storage": Property(),
        "backups_enabled": Property(mutable=True),
+        "maintenance_policy": Property(
+            mutable=True
+        ),  # Note: This field is only available when using v4beta.
    }


@@ -220,12 +223,18 @@ class Event(Base):
        "user_id": Property(),
        "username": Property(),
        "entity": Property(),
-        "time_remaining": Property(),
+        "time_remaining": Property(),  # Deprecated
        "rate": Property(),
        "status": Property(),
        "duration": Property(),
        "secondary_entity": Property(),
        "message": Property(),
+        "maintenance_policy_set": Property(),  # Note: This field is only available when using v4beta.
+        "description": Property(),
+        "source": Property(),
+        "not_before": Property(is_datetime=True),
+        "start_time": Property(is_datetime=True),
+        "complete_time": Property(is_datetime=True),
    }

    @property

@@ -686,6 +686,9 @@ class Instance(Base):
        "disk_encryption": Property(),
        "lke_cluster_id": Property(),
        "capabilities": Property(unordered=True),
+        "maintenance_policy": Property(
+            mutable=True
+        ),  # Note: This field is only available when using v4beta.
    }

    @property

@@ -1,27 +1,31 @@
 {
-    "action": "ticket_create",
-    "created": "2018-01-01T00:01:01",
-    "duration": 300.56,
-    "entity": {
-      "id": 11111,
-      "label": "Problem booting my Linode",
-      "type": "ticket",
-      "url": "/v4/support/tickets/11111"
-    },
-    "id": 123,
-    "message": "None",
-    "percent_complete": null,
-    "rate": null,
-    "read": true,
-    "secondary_entity": {
-      "id": "linode/debian9",
-      "label": "linode1234",
-      "type": "linode",
-      "url": "/v4/linode/instances/1234"
-    },
-    "seen": true,
-    "status": null,
-    "time_remaining": null,
-    "username": "exampleUser"
-  }
-
+  "action": "ticket_create",
+  "created": "2025-03-25T12:00:00",
+  "duration": 300.56,
+  "entity": {
+    "id": 11111,
+    "label": "Problem booting my Linode",
+    "type": "ticket",
+    "url": "/v4/support/tickets/11111"
+  },
+  "id": 123,
+  "message": "Ticket created for user issue.",
+  "percent_complete": null,
+  "rate": null,
+  "read": true,
+  "secondary_entity": {
+    "id": "linode/debian9",
+    "label": "linode1234",
+    "type": "linode",
+    "url": "/v4/linode/instances/1234"
+  },
+  "seen": true,
+  "status": "completed",
+  "username": "exampleUser",
+  "maintenance_policy_set": "Tentative",
+  "description": "Scheduled maintenance",
+  "source": "user",
+  "not_before": "2025-03-25T12:00:00",
+  "start_time": "2025-03-25T12:30:00",
+  "complete_time": "2025-03-25T13:00:00"
+}
@@ -1,19 +1,41 @@
 {
-    "data": [
-      {
-        "entity": {
-          "id": 123,
-          "label": "demo-linode",
-          "type": "Linode",
-          "url": "https://api.linode.com/v4/linode/instances/{linodeId}"
-        },
-        "reason": "This maintenance will allow us to update the BIOS on the host's motherboard.",
-        "status": "started",
-        "type": "reboot",
-        "when": "2020-07-09T00:01:01"
-      }
-    ],
-    "page": 1,
-    "pages": 1,
-    "results": 1
-}
+  "pages": 1,
+  "page": 1,
+  "results": 2,
+  "data": [
+    {
+      "entity": {
+        "id": 1234,
+        "label": "Linode #1234",
+        "type": "linode",
+        "url": "/linodes/1234"
+      },
+      "reason": "Scheduled upgrade to faster NVMe hardware.",
+      "type": "linode_migrate",
+      "maintenance_policy_set": "linode/power_off_on",
+      "description": "Scheduled Maintenance",
+      "source": "platform",
+      "not_before": "2025-03-25T10:00:00Z",
+      "start_time": "2025-03-25T12:00:00Z",
+      "complete_time": "2025-03-25T14:00:00Z",
+      "status": "scheduled"
+    },
+    {
+      "entity": {
+        "id": 1234,
+        "label": "Linode #1234",
+        "type": "linode",
+        "url": "/linodes/1234"
+      },
+      "reason": "Pending migration of Linode #1234 to a new host.",
+      "type": "linode_migrate",
+      "maintenance_policy_set": "linode/migrate",
+      "description": "Emergency Maintenance",
+      "source": "user",
+      "not_before": "2025-03-26T15:00:00Z",
+      "start_time": "2025-03-26T15:00:00Z",
+      "complete_time": "2025-03-26T17:00:00Z",
+      "status": "in-progress"
+    }
+  ]
+}
@@ -3,5 +3,6 @@
  "managed": false,
  "network_helper": false,
  "object_storage": "active",
-  "backups_enabled": true
+  "backups_enabled": true,
+  "maintenance_policy": "linode/migrate"
 }
@@ -48,7 +48,8 @@
        "label": "test",
        "placement_group_type": "anti_affinity:local",
        "placement_group_policy": "strict"
-      }
+      },
+      "maintenance_policy" : "linode/migrate"
    },
    {
      "group": "test",
@@ -90,7 +91,8 @@
      "watchdog_enabled": false,
      "disk_encryption": "enabled",
      "lke_cluster_id": 18881,
-      "placement_group": null
+      "placement_group": null,
+      "maintenance_policy" : "linode/power_off_on"
    }
  ]
 }
@@ -0,0 +1,28 @@
+{
+  "data": [
+    {
+      "slug": "linode/migrate",
+      "label": "Migrate",
+      "description": "Migrates the Linode to a new host while it remains fully operational. Recommended for maximizing availability.",
+      "type": "migrate",
+      "notification_period_sec": 3600,
+      "is_default": true
+    },
+    {
+      "slug": "linode/power_off_on",
+      "label": "Power Off/Power On",
+      "description": "Powers off the Linode at the start of the maintenance event and reboots it once the maintenance finishes. Recommended for maximizing performance.",
+      "type": "power_off_on",
+      "notification_period_sec": 1800,
+      "is_default": false
+    },
+    {
+      "slug": "private/12345",
+      "label": "Critical Workload - Avoid Migration",
+      "description": "Custom policy designed to power off and perform maintenance during user-defined windows only.",
+      "type": "power_off_on",
+      "notification_period_sec": 7200,
+      "is_default": false
+    }
+  ]
+}
@@ -59,6 +59,31 @@ def test_get_account_settings(test_linode_client):
    assert "longview_subscription" in str(account_settings._raw_json)
    assert "backups_enabled" in str(account_settings._raw_json)
    assert "object_storage" in str(account_settings._raw_json)
+    assert "maintenance_policy" in str(account_settings._raw_json)
+
+
+def test_update_maintenance_policy(test_linode_client):
+    client = test_linode_client
+    settings = client.load(AccountSettings(client, ""), "")
+
+    original_policy = settings.maintenance_policy
+    new_policy = (
+        "linode/power_off_on"
+        if original_policy == "linode/migrate"
+        else "linode/migrate"
+    )
+
+    settings.maintenance_policy = new_policy
+    settings.save()
+
+    updated = client.load(AccountSettings(client, ""), "")
+    assert updated.maintenance_policy == new_policy
+
+    settings.maintenance_policy = original_policy
+    settings.save()
+
+    updated = client.load(AccountSettings(client, ""), "")
+    assert updated.maintenance_policy == original_policy


 @pytest.mark.smoke

@@ -877,3 +877,47 @@ def test_delete_interface_containing_vpc(

        # returns true when delete successful
        assert result
+
+
+def test_create_linode_with_maintenance_policy(test_linode_client):
+    client = test_linode_client
+    region = get_region(client, {"Linodes"}, site_type="core")
+    label = get_test_label()
+
+    policies = client.maintenance.maintenance_policies()
+    assert policies, "No maintenance policies returned from API"
+
+    non_default_policy = next((p for p in policies if not p.is_default), None)
+    assert non_default_policy, "No non-default maintenance policy available"
+
+    linode_instance, password = client.linode.instance_create(
+        "g6-nanode-1",
+        region,
+        image="linode/debian12",
+        label=label + "_with_policy",
+        maintenance_policy_id=non_default_policy.slug,
+    )
+
+    assert linode_instance.id is not None
+    assert linode_instance.label.startswith(label)
+    assert linode_instance.maintenance_policy == non_default_policy.slug
+
+    linode_instance.delete()
+
+
+def test_update_linode_maintenance_policy(create_linode, test_linode_client):
+    client = test_linode_client
+    linode = create_linode
+
+    policies = client.maintenance.maintenance_policies()
+    assert policies, "No maintenance policies returned from API"
+
+    non_default_policy = next((p for p in policies if not p.is_default), None)
+    assert non_default_policy, "No non-default maintenance policy found"
+
+    linode.maintenance_policy_id = non_default_policy.slug
+    result = linode.save()
+
+    linode.invalidate()
+    assert result
+    assert linode.maintenance_policy_id == non_default_policy.slug
-Original file line number
+Diff line change
@@ -10,6 +10,7 @@
     from .lke import *
     from .lke_tier import *
     from .longview import *
+    from .maintenance import *
                 Fixed
          
            Show fixed
            Hide fixed
        

                
  
            
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


  


    
    
      
  
    
    
              
          

              
                Dismissed
          
            Show dismissed
            Hide dismissed
        

                
  
            
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.
     from .monitor import *
     from .monitor_api import *
     from .networking import *
-          Expand Down