Skip to main content

clientapi_pbs/apis/
backup_api.rs

1/*
2 * Proxmox Backup Server API
3 *
4 * Generated from apidoc.js. NOT an official Proxmox specification. See https://pbs.proxmox.com/docs/api-viewer/ for the upstream documentation.
5 *
6 * The version of the OpenAPI document: 9.x
7 * 
8 * Generated by: https://openapi-generator.tech
9 */
10
11
12use reqwest;
13use serde::{Deserialize, Serialize, de::Error as _};
14use crate::{apis::ResponseContent, models};
15use super::{Error, configuration, ContentType};
16
17
18/// struct for typed errors of method [`backup_get_backup`]
19#[derive(Debug, Clone, Serialize, Deserialize)]
20#[serde(untagged)]
21pub enum BackupGetBackupError {
22    Status400(models::PbsError),
23    Status401(models::PbsError),
24    Status403(models::PbsError),
25    Status404(models::PbsError),
26    Status500(models::PbsError),
27    Status501(models::PbsError),
28    Status503(models::PbsError),
29    UnknownValue(serde_json::Value),
30}
31
32
33/// Upgraded to backup protocol ('proxmox-backup-protocol-v1').  Permissions: Requires on /datastore/{store}[/{namespace}] DATASTORE_BACKUP and being the owner of the group
34pub async fn backup_get_backup(configuration: &configuration::Configuration, backup_id: &str, backup_time: i64, backup_type: models::PbsBackupTypeEnum, store: &str, benchmark: Option<bool>, debug: Option<bool>, no_cache: Option<bool>, ns: Option<&str>) -> Result<models::BackupGetBackupResponse, Error<BackupGetBackupError>> {
35    // add a prefix to parameters to efficiently prevent name collisions
36    let p_query_backup_id = backup_id;
37    let p_query_backup_time = backup_time;
38    let p_query_backup_type = backup_type;
39    let p_query_store = store;
40    let p_query_benchmark = benchmark;
41    let p_query_debug = debug;
42    let p_query_no_cache = no_cache;
43    let p_query_ns = ns;
44
45    let uri_str = format!("{}/backup", configuration.base_path);
46    let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
47
48    req_builder = req_builder.query(&[("backup-id", &p_query_backup_id.to_string())]);
49    req_builder = req_builder.query(&[("backup-time", &p_query_backup_time.to_string())]);
50    req_builder = req_builder.query(&[("backup-type", &p_query_backup_type.to_string())]);
51    if let Some(ref param_value) = p_query_benchmark {
52        req_builder = req_builder.query(&[("benchmark", &param_value.to_string())]);
53    }
54    if let Some(ref param_value) = p_query_debug {
55        req_builder = req_builder.query(&[("debug", &param_value.to_string())]);
56    }
57    if let Some(ref param_value) = p_query_no_cache {
58        req_builder = req_builder.query(&[("no-cache", &param_value.to_string())]);
59    }
60    if let Some(ref param_value) = p_query_ns {
61        req_builder = req_builder.query(&[("ns", &param_value.to_string())]);
62    }
63    req_builder = req_builder.query(&[("store", &p_query_store.to_string())]);
64    if let Some(ref user_agent) = configuration.user_agent {
65        req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
66    }
67    if let Some(ref apikey) = configuration.api_key {
68        let key = apikey.key.clone();
69        let value = match apikey.prefix {
70            Some(ref prefix) => format!("{} {}", prefix, key),
71            None => key,
72        };
73        req_builder = req_builder.header("Authorization", value);
74    };
75    if let Some(ref apikey) = configuration.api_key {
76        let key = apikey.key.clone();
77        let value = match apikey.prefix {
78            Some(ref prefix) => format!("{} {}", prefix, key),
79            None => key,
80        };
81        req_builder = req_builder.header("CSRFPreventionToken", value);
82    };
83
84    let req = req_builder.build()?;
85    let resp = configuration.client.execute(req).await?;
86
87    let status = resp.status();
88    let content_type = resp
89        .headers()
90        .get("content-type")
91        .and_then(|v| v.to_str().ok())
92        .unwrap_or("application/octet-stream");
93    let content_type = super::ContentType::from(content_type);
94
95    if !status.is_client_error() && !status.is_server_error() {
96        let content = resp.text().await?;
97        match content_type {
98            ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
99            ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::BackupGetBackupResponse`"))),
100            ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::BackupGetBackupResponse`")))),
101        }
102    } else {
103        let content = resp.text().await?;
104        let entity: Option<BackupGetBackupError> = serde_json::from_str(&content).ok();
105        Err(Error::ResponseError(ResponseContent { status, content, entity }))
106    }
107}
108