twc-cli 2.9.2__tar.gz → 2.10.0__tar.gz

{twc_cli-2.9.2 → twc_cli-2.10.0}/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 В этом файле описаны все значимые изменения в Timeweb Cloud CLI. В выпусках мы придерживается правил [семантического версионирования](https://semver.org/lang/ru/).
 
+# Версия 2.10.0 (2025.03.24)
+
+## Добавлено
+
+- Добавлена поддержка региона `de-1` (зона `fra-1`) для облачных серверов.
+- Добавлены новые опции к команде `twc database create`:
+    - для создания пользователя СУБД: `--user-login`, `--user-password`, `--user-host`, `--user-privileges`, `--user-desc`;
+    - для создания первой базы данных: `--db-name`, `--db-desc`;
+    - для настроек сети в класетере СУБД: `--network-id`, `--private-ip`, `--public-ip`, `--no-public-ip`;
+    - для настройки автоматических бэкапов кластера: `--enable-backups`, `--backup-keep`, `--backup-start-date`, `--backup-interval`, `--backup-day-of-week`.
+- Добавлена новая команда `twc database list-types` для вывода доступных к созданию управляемых баз данных.
+- Добавлена новая команда `twc database backup schedule` позволяющая настроить параметры автоматического резервного копирования кластера.
+- Добавлены новые команды для управления пользователями в кластерах СУБД: `twc database user list`, `twc database user get`, `twc database user create`, `twc database user remove`.
+- Добавлены новые команды для управления базами данных в кластерах СУБД: `twc database instance list`, `twc database instance create`, `twc database instance remove`.
+
+## Изменено
+
+- Опция `--network` команды `twc server create` объявлена устаревшей  и скрыта, добавлена эквивалентная опция `--network-id`.
+- Опции `--login` и `--password` команды `twc database create` объявлены устаревшими и скрыты, вместо них теперь нужно использовать `--user-login` и `--user-password`.
+
 # Версия 2.9.2 (2025.03.10)
 
 ## Исправлено

{twc_cli-2.9.2 → twc_cli-2.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: twc-cli
-Version: 2.9.2
+Version: 2.10.0
 Summary: Timeweb Cloud Command Line Interface.
 Home-page: https://github.com/timeweb-cloud/twc
 License: MIT

{twc_cli-2.9.2 → twc_cli-2.10.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "twc-cli"
-version = "2.9.2"
+version = "2.10.0"
 description = "Timeweb Cloud Command Line Interface."
 authors = ["ge <dev@timeweb.cloud>"]
 homepage = "https://github.com/timeweb-cloud/twc"

{twc_cli-2.9.2 → twc_cli-2.10.0}/twc/__version__.py

@@ -12,5 +12,5 @@
 import sys
 
 
-__version__ = "2.9.2"
+__version__ = "2.10.0"
 __pyversion__ = sys.version.replace("\n", "")

{twc_cli-2.9.2 → twc_cli-2.10.0}/twc/api/client.py

@@ -1,5 +1,7 @@
 """Timeweb Cloud API client."""
 
+from __future__ import annotations
+
 from typing import Optional, Union, List
 from uuid import UUID
 from pathlib import Path
@@ -20,7 +22,6 @@ from .types import (
     ServiceRegion,
     ServiceAvailabilityZone,
     ResourceType,
-    DBMS,
     MySQLAuthPlugin,
     LoadBalancerProto,
     LoadBalancerAlgo,
@@ -727,19 +728,27 @@ class TimewebCloud(TimewebCloudBase):
         """Get database presets list."""
         return self._request("GET", f"{self.api_url}/presets/dbs")
 
+    def get_database_types(self):
+        """Get database types."""
+        return self._request("GET", f"{self.api_url}/database-types")
+
+    def get_database_configrators(self):
+        """Get database_configurators."""
+        return self._request(
+            "GET", f"{self.api_url_v1}/configurator/databases"
+        )
+
     def create_database(
         self,
         name: str,
-        dbms: DBMS,
+        dbms: str,
         preset_id: int,
         password: str,
         login: Optional[str] = None,
         hash_type: Optional[MySQLAuthPlugin] = None,
         config_parameters: Optional[dict] = None,
     ):
-        """Create database."""
-        if dbms == "mysql8":
-            dbms = "mysql"
+        """Create database. DEPRECATED."""
         payload = {
             "name": name,
             "type": dbms,
@@ -751,6 +760,42 @@ class TimewebCloud(TimewebCloudBase):
         }
         return self._request("POST", f"{self.api_url}/dbs", json=payload)
 
+    def create_database2(
+        self,
+        name: str,
+        dbms: str,
+        network: Optional[dict[str, str]] = None,
+        preset_id: Optional[int] = None,
+        configurator_id: Optional[int] = None,
+        admin: Optional[dict[str, str]] = None,
+        instance: Optional[dict[str, str]] = None,
+        auto_backups: Optional[dict[str, str]] = None,
+        hash_type: Optional[MySQLAuthPlugin] = None,
+        config_parameters: Optional[dict] = None,
+        project_id: Optional[int] = None,
+    ):
+        """Create database cluster."""
+        payload = {
+            "name": name,
+            "type": dbms,
+            "hash_type": hash_type,
+            **({"network": network} if network else {}),
+            **(
+                {"config_parameters": config_parameters}
+                if config_parameters
+                else {}
+            ),
+            **({"preset_id": preset_id} if preset_id else {}),
+            **(
+                {"configurator_id": configurator_id} if configurator_id else {}
+            ),
+            **({"admin": admin} if admin else {}),
+            **({"auto_backups": auto_backups} if auto_backups else {}),
+            **({"instance": instance} if instance else {}),
+            **({"project_id": project_id} if project_id else {}),
+        }
+        return self._request("POST", f"{self.api_url}/databases", json=payload)
+
     def update_database(
         self,
         db_id: int,
@@ -837,6 +882,110 @@ class TimewebCloud(TimewebCloudBase):
             f"{self.api_url}/dbs/{db_id}/backups/{backup_id}",
         )
 
+    def get_database_autobackup_settings(self, db_id: int):
+        """Get database autobackup settings."""
+        return self._request(
+            "GET",
+            f"{self.api_url}/dbs/{db_id}/auto-backups",
+        )
+
+    def update_database_autobackup_settings(
+        self,
+        db_id: int,
+        is_enabled: Optional[bool] = None,
+        copy_count: Optional[int] = None,
+        creation_start_at: Optional[int] = None,
+        interval: Optional[BackupInterval] = None,
+        day_of_week: Optional[int] = None,
+    ):
+        """Set database autobackup settings."""
+        payload = {
+            **({"is_enabled": is_enabled} if is_enabled is not None else {}),
+            **({"copy_count": copy_count} if copy_count else {}),
+            **(
+                {"creation_start_at": creation_start_at}
+                if creation_start_at
+                else {}
+            ),
+            **({"interval": interval} if interval else {}),
+            **({"day_of_week": day_of_week} if day_of_week else {}),
+        }
+        return self._request(
+            "PATCH",
+            f"{self.api_url}/dbs/{db_id}/auto-backups",
+            json=payload,
+        )
+
+    def create_database_user(
+        self,
+        db_id: int,
+        login: str,
+        password: str,
+        privileges: List[str],
+        host: Optional[str] = None,
+        instance_id: Optional[int] = None,
+        description: Optional[str] = None,
+    ):
+        payload = {
+            "login": login,
+            "password": password,
+            "privileges": privileges,
+        }
+        if host:
+            payload["host"] = host
+        if instance_id:
+            payload["instance_id"] = instance_id
+        if description:
+            payload["description"] = description
+        return self._request(
+            "POST", f"{self.api_url}/databases/{db_id}/admins", json=payload
+        )
+
+    def get_database_users(self, db_id: int):
+        """..."""
+        return self._request(
+            "GET", f"{self.api_url_v1}/databases/{db_id}/admins"
+        )
+
+    def get_database_user(self, db_id: int, user_id: int):
+        """..."""
+        return self._request(
+            "GET", f"{self.api_url_v1}/databases/{db_id}/admins/{user_id}"
+        )
+
+    def delete_database_user(self, db_id: int, user_id: int):
+        """..."""
+        return self._request(
+            "DELETE", f"{self.api_url_v1}/databases/{db_id}/admins/{user_id}"
+        )
+
+    def create_database_instance(
+        self,
+        db_id: int,
+        name: str,
+        description: Optional[str] = None,
+    ):
+        """..."""
+        payload = {"name": name}
+        if description:
+            payload["description"] = description
+        return self._request(
+            "POST", f"{self.api_url}/databases/{db_id}/instances"
+        )
+
+    def get_database_instances(self, db_id: int):
+        """..."""
+        return self._request(
+            "GET", f"{self.api_url}/databases/{db_id}/instances"
+        )
+
+    def delete_database_instance(self, db_id: int, instance_id: int):
+        """..."""
+        return self._request(
+            "DELETE",
+            f"{self.api_url}/databases/{db_id}/instances/{instance_id}",
+        )
+
     # -----------------------------------------------------------------------
     # Object Storage
 

{twc_cli-2.9.2 → twc_cli-2.10.0}/twc/api/types.py

@@ -13,6 +13,7 @@ class ServiceRegion(str, Enum):
     KZ_1 = "kz-1"
     PL_1 = "pl-1"
     NL_1 = "nl-1"
+    DE_1 = "de-1"
 
     @classmethod
     def get_zones(cls, region: str) -> List[str]:
@@ -29,6 +30,8 @@ class ServiceRegion(str, Enum):
             return ["gdn-1"]
         if region == cls.NL_1:
             return ["ams-1"]
+        if region == cls.DE_1:
+            return ["fra-1"]
         return []
 
 
@@ -44,6 +47,7 @@ class ServiceAvailabilityZone(str, Enum):
     ALA_1 = "ala-1"
     GDN_1 = "gdn-1"
     AMS_1 = "ams-1"
+    FRA_1 = "fra-1"
 
     @classmethod
     def get_region(cls, zone: str) -> Optional[str]:
@@ -60,6 +64,8 @@ class ServiceAvailabilityZone(str, Enum):
             return ServiceRegion.PL_1
         if zone == cls.AMS_1:
             return ServiceRegion.NL_1
+        if zone == cls.FRA_1:
+            return ServiceRegion.DE_1
         return None
 
 
@@ -170,16 +176,6 @@ class ResourceType(str, Enum):
     DEDICATED_SERVER = "dedicated"
 
 
-class DBMS(str, Enum):
-    """Available DBMS in Timeweb Cloud managed databases service."""
-
-    MYSQL_5 = "mysql5"
-    MYSQL_8 = "mysql8"
-    POSTGRES = "postgres"
-    REDIS = "redis"
-    MONGODB = "mongodb"
-
-
 class MySQLAuthPlugin(str, Enum):
     """MySQL auth plugin options in Timeweb Cloud managed databases
     service.