js7-client-python 2.0.1__py3-none-any.whl

js7/client/action/inventory/store_configuration_action.py

@@ -0,0 +1,79 @@
+from typing import Any, Dict, Optional
+
+from ....model.public.client.common.configurations import Configuration
+from ....model.public.client.common.audit_log import AuditLog
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    AuditParams as AuditParams_V_2_8_2,
+    ConfigurationObject as ConfigurationObject_V_2_8_2,
+    CommonConfigurationType as ConfigurationType_V_2_8_2,
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def store_configuration_action(
+    *, 
+    context: Context,
+    configuration: Configuration,
+    payload: Optional[Dict[str, Any]],
+    no_invalid: bool,
+    audit_log: Optional[AuditLog]
+) -> bool:
+    
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(
+            configuration=configuration, 
+            payload=payload,
+            no_invalid=no_invalid,
+            audit_log=audit_log,
+        )
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="inventory/store", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+        payload=request_data,
+        options=None,
+    ))
+    
+    if isinstance(result, ConfigurationObject_V_2_8_2):
+        if result.valid is False:
+            raise ValueError(f"Configuration is invalid: {result.invalid_msg}")
+        return True
+
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(
+    *, 
+    configuration: Configuration, 
+    payload: Optional[Dict[str, Any]],
+    no_invalid: bool,
+    audit_log: Optional[AuditLog]
+) -> ConfigurationObject_V_2_8_2:
+
+    # Validate: payload
+    if configuration.object_type.value != "FOLDER" and not payload:
+        raise ValueError("'payload' is required.")
+
+    # Build: Audit log
+    res_audit_log = AuditParams_V_2_8_2(
+        ticket_link=audit_log.ticket_link,
+        comment=audit_log.comment,
+        time_spent=audit_log.time_spent
+    ) if audit_log else None
+            
+    # Result
+    return ConfigurationObject_V_2_8_2(
+        path=configuration.path,
+        object_type=ConfigurationType_V_2_8_2(configuration.object_type.value), # Raises ValueError() if invalid.
+        configuration=payload,
+        audit_log=res_audit_log,
+        valid=no_invalid,
+    )

js7/client/action/inventory/store_git_credentials_action.py

@@ -0,0 +1,99 @@
+from typing import Optional
+
+from ...context import Context
+from ....model.public.client.common.audit_log import AuditLog
+from ....model.public.client.common.git_credentials import GitCredentials
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    AuditParams as AuditParams_V_2_8_2,
+    AddCredentialsFilter as AddCredentialsFilter_V_2_8_2,
+    GitCredentials as GitCredentials_V_2_8_2,
+    OK as OK_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def store_git_credentials_action(
+    *, 
+    context: Context, 
+    credentials: GitCredentials,
+    audit_log: Optional[AuditLog]
+) -> bool:
+    
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(
+            credentials=credentials,
+            audit_log=audit_log
+        )
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="inventory/repository/git/credentials/add", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+        payload=request_data,
+        options=None,
+    ))
+    
+    if isinstance(result, OK_V_2_8_2):
+        return bool(result.ok)
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(
+    *, 
+    credentials: GitCredentials,
+    audit_log: Optional[AuditLog]
+) -> AddCredentialsFilter_V_2_8_2:
+    
+    # Validate: git_account
+    if not credentials.git_account:
+        raise ValueError("'git_account' is required.")
+    
+    # Validate: username
+    if not credentials.username:
+        raise ValueError("'username' is required.")
+    
+    # Validate: email
+    if not credentials.email:
+        raise ValueError("'email' is required.")
+    
+    # Validate: password, personal_access_token and key_file_path
+    auth_methods = [credentials.password, credentials.personal_access_token, credentials.keyfile_path]
+    if sum(value is not None for value in auth_methods) != 1:
+        raise ValueError(
+            "Exactly one authentication method must be provided: "
+            "'password', 'personal_access_token', or 'keyfile_path'."
+        )
+    
+    # Validate: git_server
+    if not credentials.git_server:
+        raise ValueError("'git_server' is required.")
+    
+    # Build: Audit Log
+    res_audit_log = AuditParams_V_2_8_2(
+        ticket_link=audit_log.ticket_link,
+        comment=audit_log.comment,
+        time_spent=audit_log.time_spent
+    ) if audit_log else None
+
+    # Result
+    return AddCredentialsFilter_V_2_8_2(
+        audit_log=res_audit_log,
+        credentials=[
+            GitCredentials_V_2_8_2(
+                email=credentials.email,
+                git_account=credentials.git_account,
+                git_server=credentials.git_server,
+                keyfile_path=credentials.keyfile_path,
+                password=credentials.password,
+                personal_access_token=credentials.personal_access_token,
+                username=credentials.username
+            )
+        ]
+    )

js7/client/action/inventory/store_repository_configuration_action.py

@@ -0,0 +1,124 @@
+from typing import List, Literal, Optional, Union
+
+from ...context import Context
+from ....model.public.client.common.audit_log import AuditLog
+from ....model.public.client.common.configurations import DraftConfiguration, DeployConfiguration, ReleaseConfiguration
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    AuditParams as AuditParams_V_2_8_2, 
+    OK as OK_V_2_8_2,
+    CommonConfigurationType as ConfigurationType_V_2_8_2,
+    PublishConfiguration as Configuration_V_2_8_2,
+    CopyToFilter as CopyToFilter_V_2_8_2,
+    Configurations as Configurations_V_2_8_2,
+    Config as Config_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def store_repository_configuration_action(
+    *,
+    context: Context,
+    controller_id: str,
+    category: Literal["LOCAL", "ROLLOUT"], 
+    configurations: List[Union[DraftConfiguration, DeployConfiguration, ReleaseConfiguration]],
+    audit_log: Optional[AuditLog]
+) -> bool:
+
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(
+            controller_id=controller_id,
+            category=category,
+            configurations=configurations,
+            audit_log=audit_log
+        )
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="inventory/repository/store", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+        payload=request_data,
+        options=None,
+    ))
+    
+    if isinstance(result, OK_V_2_8_2):
+        return bool(result.ok)
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(
+    *,
+    controller_id: str,
+    category: Literal["LOCAL", "ROLLOUT"], 
+    configurations: List[Union[DraftConfiguration, DeployConfiguration, ReleaseConfiguration]],
+    audit_log: Optional[AuditLog]
+) -> CopyToFilter_V_2_8_2:
+    
+    # Validate: controller_id
+    if not controller_id:
+        raise ValueError("'controller_id' is required.")
+    
+    # Validate: category
+    if category not in ("LOCAL", "ROLLOUT"):
+        raise ValueError("'category' must be one of 'LOCAL' or 'ROLLOUT'.")
+    
+    # Validates configurations
+    if not configurations:
+        raise ValueError("At least one configuration in 'configurations' is required.")
+    
+    # Build: Configuration
+    res_configuration = Configurations_V_2_8_2(
+        draft_configurations=[
+            Config_V_2_8_2(configuration=Configuration_V_2_8_2(
+                commit_id=None,
+                object_type=ConfigurationType_V_2_8_2(c.object_type.value),
+                path=c.path,
+                recursive=c.recursive
+            ))
+            for c in configurations
+            if isinstance(c, DraftConfiguration)
+        ],
+        
+        deploy_configurations=[
+            Config_V_2_8_2(configuration=Configuration_V_2_8_2(
+                commit_id=c.commit_id,
+                object_type=ConfigurationType_V_2_8_2(c.object_type.value),
+                path=c.path,
+                recursive=c.recursive
+            ))
+            for c in configurations
+            if isinstance(c, DeployConfiguration)
+        ],
+        
+        released_configurations=[
+            Config_V_2_8_2(configuration=Configuration_V_2_8_2(
+                commit_id=None,
+                object_type=ConfigurationType_V_2_8_2(c.object_type.value),
+                path=c.path,
+                recursive=c.recursive
+            ))
+            for c in configurations
+            if isinstance(c, ReleaseConfiguration)
+        ]
+    )
+
+    # Build: Audit Log
+    res_audit_log = AuditParams_V_2_8_2(
+        ticket_link=audit_log.ticket_link,
+        comment=audit_log.comment,
+        time_spent=audit_log.time_spent
+    ) if audit_log else None
+
+    # Result
+    return CopyToFilter_V_2_8_2(
+        controller_id=controller_id,
+        local=res_configuration if category == "LOCAL" else None,
+        rollout=res_configuration if category == "ROLLOUT" else None,
+        audit_log=res_audit_log,
+    )

js7/client/action/inventory/update_repository_configuration_action.py

@@ -0,0 +1,85 @@
+from typing import List, Literal, Optional
+
+from ...context import Context
+from ....model.public.client.common.audit_log import AuditLog
+from ....model.public.client.common.configurations import Configuration
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    AuditParams as AuditParams_V_2_8_2, 
+    OK as OK_V_2_8_2,
+    CommonConfigurationType as ConfigurationType_V_2_8_2,
+    Category as Category_V_2_8_2,
+    PublishConfiguration as Configuration_V_2_8_2,
+    UpdateFromFilter as UpdateFromFilter_V_2_8_2,
+    Config as Config_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def update_repository_configuration_action(
+    *, 
+    context: Context, 
+    configurations: List[Configuration],
+    category: Literal["LOCAL", "ROLLOUT"],
+    audit_log: Optional[AuditLog]
+) -> bool:
+
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(configurations=configurations, category=category, audit_log=audit_log)
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="inventory/repository/update", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+        payload=request_data,
+        options=None,
+    ))
+    
+    if isinstance(result, OK_V_2_8_2):
+        return bool(result.ok)
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(
+    *, 
+    configurations: List[Configuration],
+    category: Literal["LOCAL", "ROLLOUT"],
+    audit_log: Optional[AuditLog]
+) -> UpdateFromFilter_V_2_8_2:
+    
+    # Validates configurations
+    if not configurations:
+        raise ValueError("At least one configuration in 'Configurations' is required.")
+    
+    # Validate: category
+    if category not in ("LOCAL", "ROLLOUT"):
+        raise ValueError("'category' must be one of 'LOCAL' or 'ROLLOUT'.")
+    
+    # Build: Configurations
+    res_configurations = [
+        Config_V_2_8_2(configuration=Configuration_V_2_8_2(
+            object_type=ConfigurationType_V_2_8_2(c.object_type.value), # Raises ValueError() if invalid.
+            path=c.path
+        ))
+        for c in configurations
+    ]
+
+    # Build: Audit Log
+    res_audit_log = AuditParams_V_2_8_2(
+        ticket_link=audit_log.ticket_link,
+        comment=audit_log.comment,
+        time_spent=audit_log.time_spent
+    ) if audit_log else None
+
+    # Result
+    return UpdateFromFilter_V_2_8_2(
+        configurations=res_configurations,
+        category=Category_V_2_8_2(category), # Raises ValueError() if invalid.
+        audit_log=res_audit_log,
+    )

js7/client/action/inventory/validate_configuration_action.py

@@ -0,0 +1,58 @@
+import json
+from pathlib import Path
+from typing import Any, Dict, Union
+
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.public.client.enum.object_types import ObjectType
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    Validate as Validate_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def validate_configuration_action(
+    *, 
+    context: Context, 
+    object_type: ObjectType,
+    file: Union[Path, str, Dict[str, Any]]
+) -> bool:
+    
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(file)
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+        
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="inventory/validate", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+        payload=request_data,
+        options={ "object_type": object_type },
+    ))
+    
+    if isinstance(result, Validate_V_2_8_2):
+        if result.valid is True:
+            return True
+
+        if result.invalid_msg:
+            raise ValueError(result.invalid_msg.split(".executable.script ", 1)[1])
+        
+        return False
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(file: Union[Path, str, Dict[str, Any]]) -> Dict[str, Any]:
+    if isinstance(file, Path):
+        with open(file, encoding="utf-8") as f:
+            return json.load(f)
+        
+    if isinstance(file, str):
+        with open(Path(file), encoding="utf-8") as f:
+            return json.load(f)
+        
+    return file

js7/client/action/joc/get_components_versions_action.py

@@ -0,0 +1,57 @@
+from typing import Any, Dict, List, Optional
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    VersionsFilter as VersionsFilter_V_2_8_2,
+    VersionResponse as VersionResponse_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def get_components_versions_action(
+    *, 
+    context: Context,
+    controller_ids: Optional[List[str]],
+    agent_ids: Optional[List[str]]
+) -> Dict[str, Any]:
+    
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(
+            controller_ids=controller_ids,
+            agent_ids=agent_ids
+        )
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="joc/versions", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+        payload=request_data,
+        options=None
+    ))
+    
+    if isinstance(result, VersionResponse_V_2_8_2):
+        return result.model_dump(mode="json")
+
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(
+    *,
+    controller_ids: Optional[List[str]],
+    agent_ids: Optional[List[str]]
+) -> VersionsFilter_V_2_8_2:
+    
+    # Validate: Any of controller_ids or agent_ids
+    if not (controller_ids and agent_ids):
+        raise ValueError("At least one of 'controller_ids' or 'agent_ids' is required.")
+    
+    # Result
+    return VersionsFilter_V_2_8_2(
+        controller_ids=controller_ids,
+        agent_ids=agent_ids
+    )

js7/client/action/joc/get_license_info_action.py

@@ -0,0 +1,22 @@
+from typing import Any, Dict, Tuple
+
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    Js7LicenseInfo as Js7LicenseInfo_V_2_8_2
+)
+
+
+def get_license_info_action(*, context: Context) -> Tuple[bool, Dict[str, Any]]:
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="joc/license", call=EndpointCall(
+        http_service=context.http_service,
+        payload=None,
+        access_token=context.auth_provider.login(),
+        options=None
+    ))
+    
+    if isinstance(result, Js7LicenseInfo_V_2_8_2):
+        return bool(result.valid), result.model_dump(mode="json")
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")

js7/client/action/joc/get_settings_action.py

@@ -0,0 +1,19 @@
+from typing import Any, Dict
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import Configuration200 as Configuration200_V_2_8_2
+
+
+def get_settings_action(*, context: Context) -> Dict[str, Any]:        
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="settings", call=EndpointCall(
+        http_service=context.http_service,
+        payload=None,
+        access_token=context.auth_provider.login(),
+        options=None
+    ))
+    
+    if isinstance(result, Configuration200_V_2_8_2):
+        return result.model_dump(mode="json")
+
+    raise ValueError("JOC returned no version information.")

js7/client/action/joc/get_version_action.py

@@ -0,0 +1,17 @@
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import Version as Version_V_2_8_2
+
+
+def get_version_action(*, context: Context) -> str:        
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="joc/version", call=EndpointCall(
+        http_service=context.http_service,
+        access_token=context.auth_provider.login(),
+    ))
+    
+    if isinstance(result, Version_V_2_8_2):
+        if result.version:
+            return result.version
+
+    raise ValueError("JOC returned no version information.")

js7/client/action/joc/restart_proxies_action.py

@@ -0,0 +1,50 @@
+from typing import Optional
+
+from ...context import Context
+from ....model.public.client.common.audit_log import AuditLog
+from ....model.private.api.endpoint import EndpointCall
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    AuditParams as AuditParams_V_2_8_2,
+    OK as OK_V_2_8_2,
+    ClusterRestart as ClusterRestart_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def restart_proxies_action(*, context: Context, audit_log: Optional[AuditLog]) -> bool:
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(audit_log=audit_log)
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="joc/proxies/restart", call=EndpointCall(
+        http_service=context.http_service,
+        payload=request_data,
+        access_token=context.auth_provider.login(),
+        options=None
+    ))
+    
+    if isinstance(result, OK_V_2_8_2):
+        return bool(result.ok)
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(*, audit_log: Optional[AuditLog]) -> ClusterRestart_V_2_8_2:
+    
+    # Build: audit_log 
+    res_audit_log = AuditParams_V_2_8_2(
+        ticket_link=audit_log.ticket_link,
+        comment=audit_log.comment,
+        time_spent=audit_log.time_spent
+    ) if audit_log else None
+    
+    # Result
+    return ClusterRestart_V_2_8_2(
+        type=None,
+        audit_log=res_audit_log
+    )

js7/client/action/joc/restart_service_action.py

@@ -0,0 +1,74 @@
+from typing import Literal, Optional
+
+from ...context import Context
+from ....model.private.api.endpoint import EndpointCall
+from ....model.public.client.common.audit_log import AuditLog
+from ....model.private.http.joc.joc_v_2_8_2 import (
+    AuditParams as AuditParams_V_2_8_2,
+    ClusterRestart as ClusterRestart_V_2_8_2,
+    ClusterServices as ClusterServices_V_2_8_2,
+    ClusterResponse as ClusterResponse_V_2_8_2
+)
+
+from ....util.check_matching_version import check_matching_version
+
+
+def restart_service_action(
+    *, 
+    context: Context,
+    service_type: Literal["cleanup", "cluster", "dailyplan", "history", "lognotification", "monitor"],
+    audit_log: Optional[AuditLog]
+) -> bool:
+
+    if check_matching_version(min="2.6.5", max="2.8.3", check=context.version):
+        request_data = _build_v_2_8_2_request(service_type=service_type, audit_log=audit_log)
+    else:
+        raise RuntimeError(f"Version {context.version} is not compatible with building the request.")
+    
+    # Calls the dispatcher for the matching JOC version
+    result = context.joc_api.dispatch(endpoint_id="joc/cluster/restart", call=EndpointCall(
+        http_service=context.http_service,
+        payload=request_data,
+        access_token=context.auth_provider.login(),
+        options=None
+    ))
+    
+    if isinstance(result, ClusterResponse_V_2_8_2):
+        if not result.state:
+            return False
+        
+        if result.state.value in ["ERROR", "MISSING_CONFIGURATION", "MISSING_HANDLERS", "MISSING_LICENSE", "UNCOMPLETED"]:
+            raise Exception(f"Restart of service: {service_type} failed with state: {result.state.value}.")
+        
+        return True
+    
+    raise RuntimeError(f"Unexpected response type: {type(result).__name__}")
+
+#---------------------#
+# Build 2.8.2 request #
+#---------------------#
+def _build_v_2_8_2_request(
+    *, 
+    service_type: Literal["cleanup", "cluster", "dailyplan", "history", "lognotification", "monitor"], 
+    audit_log: Optional[AuditLog]
+) -> ClusterRestart_V_2_8_2:
+    
+    # Validate: service_type
+    svc_types = ["cleanup", "cluster", "dailyplan", "history", "lognotification", "monitor"]
+    if not service_type:
+        raise ValueError("'service_type' is required")
+    if service_type not in svc_types:
+        raise ValueError(f"Unsupported 'service_type': {service_type}. Supported values are: {svc_types}")
+    
+    # Build: audit_log 
+    res_audit_log = AuditParams_V_2_8_2(
+        ticket_link=audit_log.ticket_link,
+        comment=audit_log.comment,
+        time_spent=audit_log.time_spent
+    ) if audit_log else None
+    
+    # Result
+    return ClusterRestart_V_2_8_2(
+        type=ClusterServices_V_2_8_2(service_type), # Raises ValueError if invalid.
+        audit_log=res_audit_log
+    )