feat(rdb): promote read replica (#263)

Author: scaleway-bot

scaleway-async/scaleway_async/rdb/v1/api.py

@@ -1494,6 +1494,38 @@ async def reset_read_replica(
         self._throw_on_error(res)
         return unmarshal_ReadReplica(res.json())
 
+    async def promote_read_replica(
+        self,
+        *,
+        read_replica_id: str,
+        region: Optional[Region] = None,
+    ) -> Instance:
+        """
+        Promote a Read Replica.
+        Promote a Read Replica to Database Instance automatically.
+        :param region: Region to target. If none is passed will use default region from the config.
+        :param read_replica_id: UUID of the Read Replica.
+        :return: :class:`Instance <Instance>`
+
+        Usage:
+        ::
+
+            result = await api.promote_read_replica(read_replica_id="example")
+        """
+
+        param_region = validate_path_param(
+            "region", region or self.client.default_region
+        )
+        param_read_replica_id = validate_path_param("read_replica_id", read_replica_id)
+
+        res = self._request(
+            "POST",
+            f"/rdb/v1/regions/{param_region}/read-replicas/{param_read_replica_id}/promote",
+        )
+
+        self._throw_on_error(res)
+        return unmarshal_Instance(res.json())
+
     async def create_read_replica_endpoint(
         self,
         *,

scaleway-async/scaleway_async/rdb/v1/content.py

@@ -55,6 +55,7 @@
     ReadReplicaStatus.INITIALIZING,
     ReadReplicaStatus.DELETING,
     ReadReplicaStatus.CONFIGURING,
+    ReadReplicaStatus.PROMOTING,
 ]
 """
 Lists transient statutes of the enum :class:`ReadReplicaStatus <ReadReplicaStatus>`.

scaleway-async/scaleway_async/rdb/v1/types.py

@@ -220,6 +220,7 @@ class ReadReplicaStatus(str, Enum):
     ERROR = "error"
     LOCKED = "locked"
     CONFIGURING = "configuring"
+    PROMOTING = "promoting"
 
     def __str__(self) -> str:
         return str(self.value)
@@ -2105,6 +2106,19 @@ class ResetReadReplicaRequest:
     """
 
 
+@dataclass
+class PromoteReadReplicaRequest:
+    region: Optional[Region]
+    """
+    Region to target. If none is passed will use default region from the config.
+    """
+
+    read_replica_id: str
+    """
+    UUID of the Read Replica.
+    """
+
+
 @dataclass
 class CreateReadReplicaEndpointRequest:
     region: Optional[Region]

scaleway/scaleway/rdb/v1/api.py

@@ -1488,6 +1488,38 @@ def reset_read_replica(
         self._throw_on_error(res)
         return unmarshal_ReadReplica(res.json())
 
+    def promote_read_replica(
+        self,
+        *,
+        read_replica_id: str,
+        region: Optional[Region] = None,
+    ) -> Instance:
+        """
+        Promote a Read Replica.
+        Promote a Read Replica to Database Instance automatically.
+        :param region: Region to target. If none is passed will use default region from the config.
+        :param read_replica_id: UUID of the Read Replica.
+        :return: :class:`Instance <Instance>`
+
+        Usage:
+        ::
+
+            result = api.promote_read_replica(read_replica_id="example")
+        """
+
+        param_region = validate_path_param(
+            "region", region or self.client.default_region
+        )
+        param_read_replica_id = validate_path_param("read_replica_id", read_replica_id)
+
+        res = self._request(
+            "POST",
+            f"/rdb/v1/regions/{param_region}/read-replicas/{param_read_replica_id}/promote",
+        )
+
+        self._throw_on_error(res)
+        return unmarshal_Instance(res.json())
+
     def create_read_replica_endpoint(
         self,
         *,

scaleway/scaleway/rdb/v1/content.py

@@ -55,6 +55,7 @@
     ReadReplicaStatus.INITIALIZING,
     ReadReplicaStatus.DELETING,
     ReadReplicaStatus.CONFIGURING,
+    ReadReplicaStatus.PROMOTING,
 ]
 """
 Lists transient statutes of the enum :class:`ReadReplicaStatus <ReadReplicaStatus>`.

scaleway/scaleway/rdb/v1/types.py

@@ -220,6 +220,7 @@ class ReadReplicaStatus(str, Enum):
     ERROR = "error"
     LOCKED = "locked"
     CONFIGURING = "configuring"
+    PROMOTING = "promoting"
 
     def __str__(self) -> str:
         return str(self.value)
@@ -2105,6 +2106,19 @@ class ResetReadReplicaRequest:
     """
 
 
+@dataclass
+class PromoteReadReplicaRequest:
+    region: Optional[Region]
+    """
+    Region to target. If none is passed will use default region from the config.
+    """
+
+    read_replica_id: str
+    """
+    UUID of the Read Replica.
+    """
+
+
 @dataclass
 class CreateReadReplicaEndpointRequest:
     region: Optional[Region]