progress

Author: lgarber-akamai

linode_api4/objects/linode.py

@@ -1,6 +1,6 @@
 import string
 import sys
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum
 from os import urandom
@@ -653,6 +653,13 @@ class MigrationType:
     WARM = "warm"
 
 
+@dataclass
+class UpgradeInterfacesResult(JSONObject):
+    dry_run: bool = False
+    config_id: int = 0
+    interfaces: List[ConfigInterface] = field(default_factory=list)
+
+
 class Instance(Base):
     """
     A Linode Instance.
@@ -1846,6 +1853,27 @@ def stats_for(self, dt):
             model=self,
         )
 
+    def upgrade_interfaces(
+        self,
+        config: Union[Config, int],
+        dry_run: bool = False,
+    ) -> UpgradeInterfacesResult:
+        """
+        Automatically upgrades all legacy config interfaces of a single configuration profile to Linode interfaces.
+
+        API Documentation: Not yet available.
+        """
+        params = {"config_id": config, dry_run: dry_run}
+
+        result = self._client.post(
+            "{}/upgrade-interfaces".format(Instance.api_endpoint),
+            model=self,
+            data=_flatten_request_body_recursive(drop_null_keys(params)),
+        )
+
+        # TODO: Inject LinodeInterface objects here
+        return UpgradeInterfacesResult.from_json(result)
+
 
 class UserDefinedFieldType(Enum):
     text = 1

linode_api4/objects/linode_interfaces.py

@@ -2,6 +2,7 @@
 from typing import List, Optional
 
 from linode_api4.objects.base import Base, Property
+from linode_api4.objects.networking import Firewall
 from linode_api4.objects.serializable import JSONObject
 
 
@@ -169,13 +170,39 @@ class LinodeInterface(Base):
     parent_id_name = "linode_id"
 
     properties = {
+        "linode_id": Property(identifier=True),
         "id": Property(identifier=True),
         "mac_address": Property(),
         "created": Property(is_datetime=True),
         "updated": Property(is_datetime=True),
         "version": Property(),
-        "default_route": Property(json_object=LinodeInterfaceDefaultRoute),
-        "public": Property(json_object=LinodeInterfacePublic),
-        "vlan": Property(json_object=LinodeInterfaceVLAN),
-        "vpc": Property(json_object=LinodeInterfaceVPC),
+        "default_route": Property(
+            mutable=True, json_object=LinodeInterfaceDefaultRoute
+        ),
+        "public": Property(mutable=True, json_object=LinodeInterfacePublic),
+        "vlan": Property(mutable=True, json_object=LinodeInterfaceVLAN),
+        "vpc": Property(mutable=True, json_object=LinodeInterfaceVPC),
     }
+
+    def firewalls(self, *filters) -> List[Firewall]:
+        """
+        Retrieves a list of Firewalls for this Linode Interface.
+
+        :param filters: Any number of filters to apply to this query.
+                        See :doc:`Filtering Collections</linode_api4/objects/filtering>`
+                        for more details on filtering.
+
+        :returns: A List of Firewalls for this Linode Interface.
+        :rtype: List[Firewall]
+
+        NOTE: Caching is disabled on this method and each call will make
+        an additional Linode API request.
+        """
+
+        return self._client._get_and_filter(
+            Firewall,
+            *filters,
+            endpoint="{}/firewalls".format(LinodeInterface.api_endpoint).format(
+                **vars(self)
+            ),
+        )