Merge branch 'dev' into proj/block-storage-volume-limit-increase

Author: lgarber-akamai

.github/workflows/e2e-test.yml

@@ -193,7 +193,7 @@ jobs:
           submodules: 'recursive'
 
       - name: Download test report
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: test-report-file
 

.github/workflows/labeler.yml

@@ -21,7 +21,7 @@ jobs:
         uses: actions/checkout@v6
       -
         name: Run Labeler
-        uses: crazy-max/ghaction-github-labeler@24d110aa46a59976b8a7f35518cb7f14f434c916
+        uses: crazy-max/ghaction-github-labeler@548a7c3603594ec17c819e1239f281a3b801ab4d
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           yaml-file: .github/labels.yml

linode_api4/objects/__init__.py

@@ -3,7 +3,7 @@
 from .dbase import DerivedBase
 from .serializable import JSONObject
 from .filtering import and_, or_
-from .region import Region
+from .region import Region, Capability
 from .image import Image
 from .linode import *
 from .linode_interfaces import *

linode_api4/objects/linode.py

@@ -1,6 +1,7 @@
 import copy
 import string
 import sys
+import warnings
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum
@@ -220,7 +221,7 @@ def resize(self, new_size):
 class Kernel(Base):
     """
     The primary component of every Linux system. The kernel interfaces
-    with the system’s hardware and it controls the operating system’s core functionality.
+    with the system’s hardware, and it controls the operating system’s core functionality.
 
     Your Compute Instance is capable of running one of three kinds of kernels:
 
@@ -240,6 +241,10 @@ class Kernel(Base):
           to compile the kernel from source than to download it from your package manager. For more
           information on custom compiled kernels, review our guides for Debian, Ubuntu, and CentOS.
 
+    .. note::
+        The ``xen`` property is deprecated and is no longer returned by the API.
+        It is maintained for backward compatibility only.
+
     API Documentation: https://techdocs.akamai.com/linode-api/reference/get-kernel
     """
 
@@ -259,6 +264,16 @@ class Kernel(Base):
         "pvops": Property(),
     }
 
+    def __getattribute__(self, name: str) -> object:
+        if name == "xen":
+            warnings.warn(
+                "The 'xen' property of Kernel is deprecated and is no longer "
+                "returned by the API. It is maintained for backward compatibility only.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+        return super().__getattribute__(name)
+
 
 class Type(Base):
     """

linode_api4/objects/monitor.py

@@ -116,6 +116,19 @@ class DashboardType(StrEnum):
     custom = "custom"
 
 
+class AlertStatus(StrEnum):
+    """
+    Enum for supported alert status values.
+    """
+
+    AlertDefinitionStatusProvisioning = "provisioning"
+    AlertDefinitionStatusEnabling = "enabling"
+    AlertDefinitionStatusDisabling = "disabling"
+    AlertDefinitionStatusEnabled = "enabled"
+    AlertDefinitionStatusDisabled = "disabled"
+    AlertDefinitionStatusFailed = "failed"
+
+
 @dataclass
 class Filter(JSONObject):
     """
@@ -428,6 +441,40 @@ class ChannelContent(JSONObject):
     # Other channel types like 'webhook', 'slack' could be added here as Optional fields.
 
 
+@dataclass
+class EmailDetails(JSONObject):
+    """
+    Represents email-specific details for an alert channel.
+    """
+
+    usernames: Optional[List[str]] = None
+    recipient_type: Optional[str] = None
+
+
+@dataclass
+class ChannelDetails(JSONObject):
+    """
+    Represents the details block for an AlertChannel, which varies by channel type.
+    """
+
+    email: Optional[EmailDetails] = None
+
+
+@dataclass
+class AlertInfo(JSONObject):
+    """
+    Represents a reference to alerts associated with an alert channel.
+    Fields:
+      - url: str - API URL to fetch the alerts for this channel
+      - type: str - Type identifier (e.g., 'alerts-definitions')
+      - alert_count: int - Number of alerts associated with this channel
+    """
+
+    url: str = ""
+    _type: str = field(default="", metadata={"json_key": "type"})
+    alert_count: int = 0
+
+
 class AlertChannel(Base):
     """
     Represents an alert channel used to deliver notifications when alerts
@@ -450,7 +497,8 @@ class AlertChannel(Base):
         "label": Property(),
         "type": Property(),
         "channel_type": Property(),
-        "alerts": Property(mutable=False, json_object=Alerts),
+        "details": Property(mutable=False, json_object=ChannelDetails),
+        "alerts": Property(mutable=False, json_object=AlertInfo),
         "content": Property(mutable=False, json_object=ChannelContent),
         "created": Property(is_datetime=True),
         "updated": Property(is_datetime=True),

linode_api4/objects/region.py

@@ -3,6 +3,68 @@
 
 from linode_api4.errors import UnexpectedResponseError
 from linode_api4.objects.base import Base, JSONObject, Property
+from linode_api4.objects.serializable import StrEnum
+
+
+class Capability(StrEnum):
+    """
+    An enum class that represents the capabilities that Linode offers
+    across different regions and services.
+
+    These capabilities indicate what services are available in each data center.
+    """
+
+    linodes = "Linodes"
+    nodebalancers = "NodeBalancers"
+    block_storage = "Block Storage"
+    object_storage = "Object Storage"
+    object_storage_regions = "Object Storage Access Key Regions"
+    object_storage_endpoint_types = "Object Storage Endpoint Types"
+    lke = "Kubernetes"
+    lke_ha_controlplanes = "LKE HA Control Planes"
+    lke_e = "Kubernetes Enterprise"
+    firewall = "Cloud Firewall"
+    gpu = "GPU Linodes"
+    vlans = "Vlans"
+    vpcs = "VPCs"
+    vpcs_extra = "VPCs Extra"
+    machine_images = "Machine Images"
+    dbaas = "Managed Databases"
+    dbaas_beta = "Managed Databases Beta"
+    bs_migrations = "Block Storage Migrations"
+    metadata = "Metadata"
+    premium_plans = "Premium Plans"
+    edge_plans = "Edge Plans"
+    distributed_plans = "Distributed Plans"
+    lke_control_plane_acl = "LKE Network Access Control List (IP ACL)"
+    aclb = "Akamai Cloud Load Balancer"
+    support_ticket_severity = "Support Ticket Severity"
+    backups = "Backups"
+    placement_group = "Placement Group"
+    disk_encryption = "Disk Encryption"
+    la_disk_encryption = "LA Disk Encryption"
+    akamai_ram_protection = "Akamai RAM Protection"
+    blockstorage_encryption = "Block Storage Encryption"
+    blockstorage_perf_b1 = "Block Storage Performance B1"
+    blockstorage_perf_b1_default = "Block Storage Performance B1 Default"
+    aclp = "Akamai Cloud Pulse"
+    aclp_logs = "Akamai Cloud Pulse Logs"
+    aclp_logs_lkee = "Akamai Cloud Pulse Logs LKE-E Audit"
+    aclp_logs_dc_lkee = "ACLP Logs Datacenter LKE-E"
+    smtp_enabled = "SMTP Enabled"
+    stackscripts = "StackScripts"
+    vpu = "NETINT Quadra T1U"
+    linode_interfaces = "Linode Interfaces"
+    maintenance_policy = "Maintenance Policy"
+    vpc_dual_stack = "VPC Dual Stack"
+    vpc_ipv6_stack = "VPC IPv6 Stack"
+    nlb = "Network LoadBalancer"
+    natgateway = "NAT Gateway"
+    lke_e_byovpc = "Kubernetes Enterprise BYO VPC"
+    lke_e_stacktype = "Kubernetes Enterprise Dual Stack"
+    ruleset = "Cloud Firewall Rule Set"
+    prefixlists = "Cloud Firewall Prefix Lists"
+    current_prefixlists = "Cloud Firewall Prefix List Current References"
 
 
 @dataclass

test/integration/models/account/test_account.py

@@ -1,7 +1,11 @@
 import time
 from datetime import datetime
 from test.integration.conftest import get_region
-from test.integration.helpers import get_test_label, retry_sending_request
+from test.integration.helpers import (
+    get_test_label,
+    retry_sending_request,
+    wait_for_condition,
+)
 
 import pytest
 
@@ -102,13 +106,18 @@ def test_latest_get_event(test_linode_client, e2e_test_firewall):
         firewall=e2e_test_firewall,
     )
 
-    events = client.load(Event, "")
+    def get_linode_status():
+        return linode.status == "running"
 
-    latest_events = events._raw_json.get("data")
+    # To ensure the Linode is running and the 'event' key has been populated
+    wait_for_condition(3, 100, get_linode_status)
+
+    events = client.load(Event, "")
+    latest_events = events._raw_json.get("data")[:15]
 
     linode.delete()
 
-    for event in latest_events[:15]:
+    for event in latest_events:
         if label == event["entity"]["label"]:
             break
     else:

test/integration/models/domain/test_domain.py

@@ -43,10 +43,10 @@ def test_clone(test_linode_client, test_domain):
     dom = "example.clone-" + timestamp + "-inttestsdk.org"
     domain.clone(dom)
 
-    ds = test_linode_client.domains()
-
     time.sleep(1)
 
+    ds = test_linode_client.domains()
+
     domains = [i.domain for i in ds]
 
     assert dom in domains

test/integration/models/linode/test_linode.py

@@ -611,6 +611,12 @@ def test_linode_initate_migration(test_linode_client, e2e_test_firewall):
         migration_type=MigrationType.COLD,
     )
 
+    def get_linode_status():
+        return linode.status == "offline"
+
+    # To verify that Linode's status changed before deletion (during migration status is set to 'offline')
+    wait_for_condition(5, 120, get_linode_status)
+
     res = linode.delete()
 
     assert res

test/integration/models/monitor/test_monitor.py

@@ -16,6 +16,7 @@
     MonitorService,
     MonitorServiceToken,
 )
+from linode_api4.objects.monitor import AlertStatus
 
 
 # List all dashboards
@@ -227,7 +228,8 @@ def wait_for_alert_ready(alert_id, service_type: str):
         interval = initial_timeout
         alert = client.load(AlertDefinition, alert_id, service_type)
         while (
-            getattr(alert, "status", None) == "in progress"
+            getattr(alert, "status", None)
+            != AlertStatus.AlertDefinitionStatusEnabled
             and (time.time() - start) < timeout
         ):
             time.sleep(interval)