redis-enterprise 0.8.7

Redis Enterprise REST API client library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! Active-Active database task operations
//!
//! ## Overview
//! - Track CRDB async operations
//! - Query task status
//! - Manage replication tasks

use crate::client::RestClient;
use crate::error::Result;
use serde::{Deserialize, Serialize};
use serde_json::Value;
use typed_builder::TypedBuilder;

/// CRDB task information
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CrdbTask {
    /// Unique task identifier
    pub task_id: String,
    /// Globally unique Active-Active database ID (GUID)
    pub crdb_guid: String,
    /// Type of task being executed
    pub task_type: String,
    /// Current status of the task (queued, running, completed, failed)
    pub status: String,
    /// Task completion progress as a percentage (0.0-100.0)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub progress: Option<f32>,
    /// Timestamp when the task was started (ISO 8601 format)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub start_time: Option<String>,
    /// Timestamp when the task was completed or failed (ISO 8601 format)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub end_time: Option<String>,
    /// Error description if the task failed
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error: Option<String>,
}

/// CRDB task creation request
#[derive(Debug, Clone, Serialize, Deserialize, TypedBuilder)]
pub struct CreateCrdbTaskRequest {
    /// Globally unique Active-Active database ID (GUID) for the target CRDB
    #[builder(setter(into))]
    pub crdb_guid: String,
    /// Type of task to create (e.g., "flush", "purge", "update_config")
    #[builder(setter(into))]
    pub task_type: String,
    /// Optional parameters specific to the task type
    #[serde(skip_serializing_if = "Option::is_none")]
    #[builder(default, setter(strip_option))]
    pub params: Option<Value>,
}

/// CRDB tasks handler
pub struct CrdbTasksHandler {
    client: RestClient,
}

impl CrdbTasksHandler {
    pub fn new(client: RestClient) -> Self {
        CrdbTasksHandler { client }
    }

    /// List all CRDB tasks
    pub async fn list(&self) -> Result<Vec<CrdbTask>> {
        self.client.get("/v1/crdb_tasks").await
    }

    /// Get specific CRDB task
    pub async fn get(&self, task_id: &str) -> Result<CrdbTask> {
        self.client
            .get(&format!("/v1/crdb_tasks/{}", task_id))
            .await
    }

    /// Create a new CRDB task
    pub async fn create(&self, request: CreateCrdbTaskRequest) -> Result<CrdbTask> {
        self.client.post("/v1/crdb_tasks", &request).await
    }

    /// Cancel a CRDB task
    pub async fn cancel(&self, task_id: &str) -> Result<()> {
        self.client
            .delete(&format!("/v1/crdb_tasks/{}", task_id))
            .await
    }

    /// Get tasks for a specific CRDB
    pub async fn list_by_crdb(&self, crdb_guid: &str) -> Result<Vec<CrdbTask>> {
        self.client
            .get(&format!("/v1/crdbs/{}/tasks", crdb_guid))
            .await
    }
}