fastly_api/apis/
waf_rule_revisions_api.rs

1/*
2 * Fastly API
3 *
4 * Via the Fastly API you can perform any of the operations that are possible within the management console,  including creating services, domains, and backends, configuring rules or uploading your own application code, as well as account operations such as user administration and billing reports. The API is organized into collections of endpoints that allow manipulation of objects related to Fastly services and accounts. For the most accurate and up-to-date API reference content, visit our [Developer Hub](https://www.fastly.com/documentation/reference/api/) 
5 *
6 */
7
8
9use reqwest;
10
11use crate::apis::ResponseContent;
12use super::{Error, configuration};
13
14/// struct for passing parameters to the method [`get_waf_rule_revision`]
15#[derive(Clone, Debug, Default)]
16pub struct GetWafRuleRevisionParams {
17    /// Alphanumeric string identifying a WAF rule.
18    pub waf_rule_id: String,
19    /// Revision number.
20    pub waf_rule_revision_number: i32,
21    /// Include relationships. Optional, comma-separated values. Permitted values: `waf_rule`, `vcl`, and `source`. The `vcl` and `source` relationships show the WAF VCL and corresponding ModSecurity source. These fields are blank unless the relationship is included. 
22    pub include: Option<String>
23}
24
25/// struct for passing parameters to the method [`list_waf_rule_revisions`]
26#[derive(Clone, Debug, Default)]
27pub struct ListWafRuleRevisionsParams {
28    /// Alphanumeric string identifying a WAF rule.
29    pub waf_rule_id: String,
30    /// Current page.
31    pub page_number: Option<i32>,
32    /// Number of records per page.
33    pub page_size: Option<i32>,
34    /// Include relationships. Optional.
35    pub include: Option<String>
36}
37
38
39/// struct for typed errors of method [`get_waf_rule_revision`]
40#[derive(Debug, Clone, Serialize, Deserialize)]
41#[serde(untagged)]
42pub enum GetWafRuleRevisionError {
43    UnknownValue(serde_json::Value),
44}
45
46/// struct for typed errors of method [`list_waf_rule_revisions`]
47#[derive(Debug, Clone, Serialize, Deserialize)]
48#[serde(untagged)]
49pub enum ListWafRuleRevisionsError {
50    UnknownValue(serde_json::Value),
51}
52
53
54/// Get a specific rule revision.
55pub async fn get_waf_rule_revision(configuration: &mut configuration::Configuration, params: GetWafRuleRevisionParams) -> Result<crate::models::WafRuleRevisionResponse, Error<GetWafRuleRevisionError>> {
56    let local_var_configuration = configuration;
57
58    // unbox the parameters
59    let waf_rule_id = params.waf_rule_id;
60    let waf_rule_revision_number = params.waf_rule_revision_number;
61    let include = params.include;
62
63
64    let local_var_client = &local_var_configuration.client;
65
66    let local_var_uri_str = format!("{}/waf/rules/{waf_rule_id}/revisions/{waf_rule_revision_number}", local_var_configuration.base_path, waf_rule_id=crate::apis::urlencode(waf_rule_id), waf_rule_revision_number=waf_rule_revision_number);
67    let mut local_var_req_builder = local_var_client.request(reqwest::Method::GET, local_var_uri_str.as_str());
68
69    if let Some(ref local_var_str) = include {
70        local_var_req_builder = local_var_req_builder.query(&[("include", &local_var_str.to_string())]);
71    }
72    if let Some(ref local_var_user_agent) = local_var_configuration.user_agent {
73        local_var_req_builder = local_var_req_builder.header(reqwest::header::USER_AGENT, local_var_user_agent.clone());
74    }
75    if let Some(ref local_var_apikey) = local_var_configuration.api_key {
76        let local_var_key = local_var_apikey.key.clone();
77        let local_var_value = match local_var_apikey.prefix {
78            Some(ref local_var_prefix) => format!("{} {}", local_var_prefix, local_var_key),
79            None => local_var_key,
80        };
81        local_var_req_builder = local_var_req_builder.header("Fastly-Key", local_var_value);
82    };
83
84    let local_var_req = local_var_req_builder.build()?;
85    let local_var_resp = local_var_client.execute(local_var_req).await?;
86
87    if "GET" != "GET" && "GET" != "HEAD" {
88      let headers = local_var_resp.headers();
89      local_var_configuration.rate_limit_remaining = match headers.get("Fastly-RateLimit-Remaining") {
90          Some(v) => v.to_str().unwrap().parse().unwrap(),
91          None => configuration::DEFAULT_RATELIMIT,
92      };
93      local_var_configuration.rate_limit_reset = match headers.get("Fastly-RateLimit-Reset") {
94          Some(v) => v.to_str().unwrap().parse().unwrap(),
95          None => 0,
96      };
97    }
98
99    let local_var_status = local_var_resp.status();
100    let local_var_content = local_var_resp.text().await?;
101
102    if !local_var_status.is_client_error() && !local_var_status.is_server_error() {
103        serde_json::from_str(&local_var_content).map_err(Error::from)
104    } else {
105        let local_var_entity: Option<GetWafRuleRevisionError> = serde_json::from_str(&local_var_content).ok();
106        let local_var_error = ResponseContent { status: local_var_status, content: local_var_content, entity: local_var_entity };
107        Err(Error::ResponseError(local_var_error))
108    }
109}
110
111/// List all revisions for a specific rule. The `rule_id` provided can be the ModSecurity Rule ID or the Fastly generated rule ID.
112pub async fn list_waf_rule_revisions(configuration: &mut configuration::Configuration, params: ListWafRuleRevisionsParams) -> Result<crate::models::WafRuleRevisionsResponse, Error<ListWafRuleRevisionsError>> {
113    let local_var_configuration = configuration;
114
115    // unbox the parameters
116    let waf_rule_id = params.waf_rule_id;
117    let page_number = params.page_number;
118    let page_size = params.page_size;
119    let include = params.include;
120
121
122    let local_var_client = &local_var_configuration.client;
123
124    let local_var_uri_str = format!("{}/waf/rules/{waf_rule_id}/revisions", local_var_configuration.base_path, waf_rule_id=crate::apis::urlencode(waf_rule_id));
125    let mut local_var_req_builder = local_var_client.request(reqwest::Method::GET, local_var_uri_str.as_str());
126
127    if let Some(ref local_var_str) = page_number {
128        local_var_req_builder = local_var_req_builder.query(&[("page[number]", &local_var_str.to_string())]);
129    }
130    if let Some(ref local_var_str) = page_size {
131        local_var_req_builder = local_var_req_builder.query(&[("page[size]", &local_var_str.to_string())]);
132    }
133    if let Some(ref local_var_str) = include {
134        local_var_req_builder = local_var_req_builder.query(&[("include", &local_var_str.to_string())]);
135    }
136    if let Some(ref local_var_user_agent) = local_var_configuration.user_agent {
137        local_var_req_builder = local_var_req_builder.header(reqwest::header::USER_AGENT, local_var_user_agent.clone());
138    }
139    if let Some(ref local_var_apikey) = local_var_configuration.api_key {
140        let local_var_key = local_var_apikey.key.clone();
141        let local_var_value = match local_var_apikey.prefix {
142            Some(ref local_var_prefix) => format!("{} {}", local_var_prefix, local_var_key),
143            None => local_var_key,
144        };
145        local_var_req_builder = local_var_req_builder.header("Fastly-Key", local_var_value);
146    };
147
148    let local_var_req = local_var_req_builder.build()?;
149    let local_var_resp = local_var_client.execute(local_var_req).await?;
150
151    if "GET" != "GET" && "GET" != "HEAD" {
152      let headers = local_var_resp.headers();
153      local_var_configuration.rate_limit_remaining = match headers.get("Fastly-RateLimit-Remaining") {
154          Some(v) => v.to_str().unwrap().parse().unwrap(),
155          None => configuration::DEFAULT_RATELIMIT,
156      };
157      local_var_configuration.rate_limit_reset = match headers.get("Fastly-RateLimit-Reset") {
158          Some(v) => v.to_str().unwrap().parse().unwrap(),
159          None => 0,
160      };
161    }
162
163    let local_var_status = local_var_resp.status();
164    let local_var_content = local_var_resp.text().await?;
165
166    if !local_var_status.is_client_error() && !local_var_status.is_server_error() {
167        serde_json::from_str(&local_var_content).map_err(Error::from)
168    } else {
169        let local_var_entity: Option<ListWafRuleRevisionsError> = serde_json::from_str(&local_var_content).ok();
170        let local_var_error = ResponseContent { status: local_var_status, content: local_var_content, entity: local_var_entity };
171        Err(Error::ResponseError(local_var_error))
172    }
173}
174