WIP

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,66 @@ class MigrationType:
     WARM = "warm"
 
 
+@dataclass
+class LinodeInterfaceDefaultRoute(JSONObject):
+    ipv4: bool = False
+
+
+@dataclass
+class LinodeInterfaceVPCIPv4Address(JSONObject):
+    address: str = ""
+    primary: bool = False
+
+
+@dataclass
+class LinodeInterfaceVPCIPv4Range(JSONObject):
+    range: str = ""
+
+
+@dataclass
+class LinodeInterfaceVPCIPv4(JSONObject):
+    addresses: List[LinodeInterfaceVPCIPv4Address] = field(default_factory=list)
+    ranges: List[LinodeInterfaceVPCIPv4Range] = field(default_factory=list)
+
+
+@dataclass
+class LinodeInterfaceVPC(JSONObject):
+    vpc_id: int = 0
+    vpc_subnet: int = 0
+
+    ipv4: Optional[LinodeInterfaceVPCIPv4] = None
+
+
+@dataclass
+class LinodeInterfacePublic(JSONObject):
+    vpc_id: int = 0
+    vpc_subnet: int = 0
+
+    ipv4: Optional[LinodeInterfaceVPCIPv4] = None
+
+
+class LinodeInterface(Base):
+    """
+    A Linode's network interface.
+
+    API Documentation: Not yet available.
+    """
+
+    api_endpoint = "/linode/instances/{linode_id}/interfaces/{id}"
+    derived_url_path = "interfaces"
+    parent_id_name = "linode_id"
+
+    properties = {
+        "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),
+        "vpc": Property(json_object=LinodeInterfaceVPC),
+    }
+
+
 class Instance(Base):
     """
     A Linode Instance.

test/fixtures/linode_instances_124_interfaces_123.json

@@ -0,0 +1,53 @@
+{
+  "created": "2025-01-01T00:01:01",
+  "default_route": {
+    "ipv4": true,
+    "ipv6": true
+  },
+  "id": 1234,
+  "mac_address": "22:00:AB:CD:EF:01",
+  "public": {
+    "ipv4": {
+      "addresses": [
+        {
+          "address": "172.30.0.5O",
+          "primary": true
+        }
+      ],
+      "shared": [
+        {
+          "address": "172.30.0.51",
+          "linode_id": 12345
+        }
+      ]
+    },
+    "ipv6": {
+      "ranges": [
+        {
+          "range": "2600:3cO9:e001:59::/64",
+          "route_target": "2600:3cO9::ff:feab:cdef"
+        },
+        {
+          "range": "2600:3cO9:e001:5a::/64",
+          "route_target": "2600:3cO9::ff:feab:cdef"
+        }
+      ],
+      "shared": [
+        {
+          "range": "2600:3cO9:e001:2a::/64",
+          "route_target": null
+        }
+      ],
+      "slaac": [
+        {
+          "address": "2600:3cO9::ff:feab:cdef",
+          "prefix": 64
+        }
+      ]
+    }
+  },
+  "updated": "2025-01-01T00:01:01",
+  "version": 1,
+  "vlan": null,
+  "vpc": null
+}