Skip to main content

clientapi_pbs/apis/
reader_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 [`reader_get_reader`]
19#[derive(Debug, Clone, Serialize, Deserialize)]
20#[serde(untagged)]
21pub enum ReaderGetReaderError {
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-reader-protocol-v1').  Permissions: The user needs Datastore.Read privilege on /datastore/{store}.
34pub async fn reader_get_reader(configuration: &configuration::Configuration, backup_id: &str, backup_time: i64, backup_type: models::PbsBackupTypeEnum, store: &str, debug: Option<bool>, ns: Option<&str>) -> Result<models::ReaderGetReaderResponse, Error<ReaderGetReaderError>> {
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_debug = debug;
41    let p_query_ns = ns;
42
43    let uri_str = format!("{}/reader", configuration.base_path);
44    let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
45
46    req_builder = req_builder.query(&[("backup-id", &p_query_backup_id.to_string())]);
47    req_builder = req_builder.query(&[("backup-time", &p_query_backup_time.to_string())]);
48    req_builder = req_builder.query(&[("backup-type", &p_query_backup_type.to_string())]);
49    if let Some(ref param_value) = p_query_debug {
50        req_builder = req_builder.query(&[("debug", &param_value.to_string())]);
51    }
52    if let Some(ref param_value) = p_query_ns {
53        req_builder = req_builder.query(&[("ns", &param_value.to_string())]);
54    }
55    req_builder = req_builder.query(&[("store", &p_query_store.to_string())]);
56    if let Some(ref user_agent) = configuration.user_agent {
57        req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
58    }
59    if let Some(ref apikey) = configuration.api_key {
60        let key = apikey.key.clone();
61        let value = match apikey.prefix {
62            Some(ref prefix) => format!("{} {}", prefix, key),
63            None => key,
64        };
65        req_builder = req_builder.header("Authorization", value);
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("CSRFPreventionToken", value);
74    };
75
76    let req = req_builder.build()?;
77    let resp = configuration.client.execute(req).await?;
78
79    let status = resp.status();
80    let content_type = resp
81        .headers()
82        .get("content-type")
83        .and_then(|v| v.to_str().ok())
84        .unwrap_or("application/octet-stream");
85    let content_type = super::ContentType::from(content_type);
86
87    if !status.is_client_error() && !status.is_server_error() {
88        let content = resp.text().await?;
89        match content_type {
90            ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
91            ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::ReaderGetReaderResponse`"))),
92            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::ReaderGetReaderResponse`")))),
93        }
94    } else {
95        let content = resp.text().await?;
96        let entity: Option<ReaderGetReaderError> = serde_json::from_str(&content).ok();
97        Err(Error::ResponseError(ResponseContent { status, content, entity }))
98    }
99}
100