syneto_api 0.2.45__tar.gz → 0.2.47__tar.gz

{syneto_api-0.2.45 → syneto_api-0.2.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: syneto-api
-Version: 0.2.45
+Version: 0.2.47
 Summary: Syneto Client API library
 Home-page: https://github.com/SynetoNet/syneto-api
 License: Proprietary
@@ -11,6 +11,9 @@ Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Requires-Dist: aiodns (>=3,<4)
 Requires-Dist: aiohttp (>=3.7,<4.0)
 Requires-Dist: cchardet (>=2.1,<3.0)

{syneto_api-0.2.45 → syneto_api-0.2.47}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "syneto_api"
-version = "0.2.45"
+version = "0.2.47"
 description = "Syneto Client API library"
 authors = ["Your Name <you@example.com>"]
 license = "Proprietary"

{syneto_api-0.2.45 → syneto_api-0.2.47}/setup.py

@@ -21,13 +21,13 @@ install_requires = \
 
 setup_kwargs = {
     'name': 'syneto-api',
-    'version': '0.2.45',
+    'version': '0.2.47',
     'description': 'Syneto Client API library',
     'long_description': '# Syneto API\n\nSyneto Client API library: authentication, storage, virtualization and protection\n\n# Installation\n\n```\n$ pip install syneto-api\n```\n\n# Basic Usage\n\n```\nfrom syneto_api import Authentication, Virtualization, Storage, Protection\n\nauth_api = Authentication(url_base="https://syneto-instance-ip-address/api/auth", insecure_ssl=True)\nresponse = auth_api.login(username="admin", password="admin")\njwt = response[\'jwt\']\n\nvirt_api = Virtualization(url_base="https://syneto-instance-ip-address/api/virtualization", insecure_ssl=True)\nvirt_api.set_auth_jwt(jwt)\nprint(virt_api.get_vms())\n\nstorage_api = Storage(url_base="https://syneto-instance-ip-address/api/storage", insecure_ssl=True)\nstorage_api.set_auth_jwt(jwt)\nprint(storage_api.get_pools())\n```\n\n# Environment Variables\n\nFor conveninence, the base urls for the api endpoints are also accepted as environment variables, please see below.\n\n```\nAUTH_SERVICE=https://syneto-instance-ip-address/api/auth\nVIRTUALIZATION_SERVICE=https://syneto-instance-ip-address/api/virtualization\nSTORAGE_SERVICE=https://syneto-instance-ip-address/api/storage\nPROTECTION_SERVICE=https://syneto-instance-ip-address/api/protection\n```\n\nIf you are using self-signed SSL certificates, set the following env. so that the http request library does not perform ssl verification. \n\n```\nALLOW_INSECURE_SSL=True\n```\n',
     'author': 'Your Name',
     'author_email': 'you@example.com',
-    'maintainer': None,
-    'maintainer_email': None,
+    'maintainer': 'None',
+    'maintainer_email': 'None',
     'url': 'https://github.com/SynetoNet/syneto-api',
     'package_dir': package_dir,
     'packages': packages,

{syneto_api-0.2.45 → syneto_api-0.2.47}/src/syneto_api/__init__.py

@@ -5,3 +5,4 @@ from .storage_api import Storage
 from .protection_api import Protection
 from .jobs_api import Jobs
 from .central_api import Central
+from .node_api import Node

{syneto_api-0.2.45 → syneto_api-0.2.47}/src/syneto_api/api_client.py

@@ -7,7 +7,7 @@ import logging
 import traceback
 import urllib.parse
 import concurrent.futures as futures
-from tenacity import Retrying, AsyncRetrying, RetryError, stop_after_delay
+from tenacity import Retrying, AsyncRetrying, RetryError, stop_after_delay, retry_if_not_exception_type
 
 from .settings import get_env_flag
 from .keyring import KeyRing
@@ -104,7 +104,9 @@ class APIClientBase:
     ):
         try:
             logger.debug(f"Calling {method} {url} with aiohttp lib")
-            async for attempt in AsyncRetrying(stop=stop_after_delay(self.timeout), reraise=True):
+            async for attempt in AsyncRetrying(
+                stop=stop_after_delay(self.timeout), retry=retry_if_not_exception_type(APIException), reraise=True
+            ):
                 with attempt:
                     return await asyncio.wait_for(
                         self._unsafe_async_request(
@@ -194,7 +196,9 @@ class APIClientBase:
     ):
         try:
             logger.debug(f"Calling {method} {url} with requests lib")
-            for attempt in Retrying(stop=stop_after_delay(self.timeout), reraise=True):
+            for attempt in Retrying(
+                stop=stop_after_delay(self.timeout), retry=retry_if_not_exception_type(APIException), reraise=True
+            ):
                 with attempt:
                     return self._unsafe_sync_request(
                         method, url, body, success_codes, error_subject, on_response_callback

syneto_api-0.2.47/src/syneto_api/node_api.py

@@ -0,0 +1,74 @@
+import os
+from .api_client import APIClientBase
+
+
+class Node(APIClientBase):
+    def __init__(self, url_base=None, **kwargs):
+        super().__init__(url_base or os.environ.get("PROTECTION_SERVICE", ""), **kwargs)
+
+    def get_installed_version(self):
+        return self.get_request("/software/installed")
+
+    def get_available_upgrade_versions(self):
+        return self.get_request("/software/available")
+
+    def check_available_updates(self):
+        return self.post_request("/software/available")
+
+    def get_update_job(self):
+        return self.get_request("/software/update")
+
+    def start_update_job(self, upgrade_branch: str, upgrade_channel: str, enable_hotfix_channels: bool = False, enable_dev_channels: bool = False):
+        body = {
+            "upgradeBranch": upgrade_branch,
+            "upgradeChannel": upgrade_channel,
+            "enableHotfixChannels": enable_hotfix_channels,
+            "enableDevChannels": enable_dev_channels,
+        }
+        return self.post_request("/software/update", body=body)
+
+    def update_job_acknowledge(self):
+        return self.put_request("/software/update/acknowledge")
+
+    def get_system_details(self):
+        return self.get_request("/system")
+
+    def get_system_health(self):
+        return self.get_request("/health")
+
+    def get_time(self):
+        return self.get_request("/time")
+
+    def set_time(self, date:str, timezone:str, require_reboot: bool, ntp: dict):
+        body = {
+            "date": date,
+            "timezone": timezone,
+            "requireReboot": require_reboot,
+            "ntp": ntp,
+        }
+        return self.post_request("/time", body=body)
+
+    def get_available_timezones(self):
+        return self.get_request("/time/timezones")
+
+    def sync_clock_with_ntp(self, require_reboot: bool = False):
+        body = {
+            "requireReboot": require_reboot,
+        }
+        return self.put_request("/time/ntp/sync-clock", body=body)
+
+    def reboot_host(self):
+        return self.put_request("/reboot")
+
+    def poweroff_host(self):
+        return self.put_request("/poweroff")
+
+    def add_user_event(self, _type: str, client_time: str, order: int, properties: dict):
+        body = {
+            "type": _type,
+            "clientTime": client_time,
+            "order": order,
+            "properties": properties,
+        }
+        return self.post_request("/bond/user-events", body=body)
+

{syneto_api-0.2.45 → syneto_api-0.2.47}/src/syneto_api/storage_api.py

@@ -80,9 +80,17 @@ class Storage(APIClientBase):
             "/volumes/{volume_id}/snapshots", volume_id=volume_id, query_args={"snapshot_name": snapshot_name}
         )
 
+    def get_volume_changes(self, volume_id: str, snapshot_name: str):
+        return self.post_request(
+            "/volumes/{volume_id}/changes",
+            volume_id=volume_id,
+            body={"volume_id": volume_id, "snapshot_name": snapshot_name},
+        )
+
     def get_volume_snapshot(self, volume_id: str, snapshot_name: str):
         return self.get_request(
-            "/volumes/{volume_id}/snapshots/{snapshot_name}", volume_id=volume_id, snapshot_name=snapshot_name
+            "/volumes/{volume_id}/snapshots/{snapshot_name}",
+            volume_id=volume_id,
         )
 
     def remove_volume_snapshot(self, volume_id: str, snapshot_name: str):

{syneto_api-0.2.45 → syneto_api-0.2.47}/src/syneto_api/virt_api.py

@@ -34,6 +34,9 @@ class Virtualization(APIClientBase):
         snapshots = self.get_request("/vmware/vms/{vm_syn_id}/snapshots", vm_syn_id=vm_syn_id)
         return next((snap for snap in snapshots if snap["name"] == snapshot_name), None)
 
+    def get_vm_snapshots(self, vm_syn_id: str):
+        return self.get_request("/vmware/vms/{vm_syn_id}/snapshots", vm_syn_id=vm_syn_id)
+
     def create_vm_snapshot(
         self, vm_syn_id: str, snapshot_name: str, quiesce: bool = True, dumpmem: bool = False,
     ):
@@ -80,3 +83,21 @@ class Virtualization(APIClientBase):
             "/vmware/datastores",
             query_args={"datastore_syn_id": syn_id if syn_id else "", "datastore_mountpoint": mountpoint},
         )
+
+    def get_virtual_machine_cbt_info(self, vm_syn_id: str):
+        return self.get_request("/vmware/vms/{vm_syn_id}/cbt", vm_syn_id=vm_syn_id)
+
+    def enable_virtual_machine_cbt(self, vm_syn_id: str):
+        return self.put_request(
+            "/vmware/vms/{vm_syn_id}/cbt",
+            vm_syn_id=vm_syn_id,
+            query_args={"action": "enable_cbt"},
+            body={},
+            success_codes=[200, 409, 500],
+        )
+
+    def get_vm_snapshot_by_ref(self, vm_syn_id: str, snapshot_ref: str):
+        return self.get_request(
+            "/vmware/vms/{vm_syn_id}/snapshots/{snapshot_ref}", vm_syn_id=vm_syn_id, snapshot_ref=snapshot_ref
+        )
+