fastly_api/apis/
billing_usage_metrics_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_service_level_usage`]
15#[derive(Clone, Debug, Default)]
16pub struct GetServiceLevelUsageParams {
17    /// The product identifier for the metrics returned (e.g., `cdn_usage`).
18    pub product_id: Option<String>,
19    /// The usage type name for the metrics returned (e.g., `North America Requests`).
20    pub usage_type_name: Option<String>,
21    pub start_month: Option<String>,
22    pub end_month: Option<String>,
23    /// Number of results per page. The maximum is 100.
24    pub limit: Option<String>,
25    /// Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
26    pub cursor: Option<String>
27}
28
29/// struct for passing parameters to the method [`get_usage_metrics`]
30#[derive(Clone, Debug, Default)]
31pub struct GetUsageMetricsParams {
32    pub start_month: String,
33    pub end_month: String
34}
35
36
37/// struct for typed errors of method [`get_service_level_usage`]
38#[derive(Debug, Clone, Serialize, Deserialize)]
39#[serde(untagged)]
40pub enum GetServiceLevelUsageError {
41    Status400(crate::models::Error),
42    Status401(crate::models::Error),
43    Status500(crate::models::Error),
44    UnknownValue(serde_json::Value),
45}
46
47/// struct for typed errors of method [`get_usage_metrics`]
48#[derive(Debug, Clone, Serialize, Deserialize)]
49#[serde(untagged)]
50pub enum GetUsageMetricsError {
51    Status400(crate::models::Error),
52    Status401(crate::models::Error),
53    Status500(crate::models::Error),
54    UnknownValue(serde_json::Value),
55}
56
57
58/// Returns product usage, broken down by service.
59pub async fn get_service_level_usage(configuration: &mut configuration::Configuration, params: GetServiceLevelUsageParams) -> Result<crate::models::Serviceusagemetrics, Error<GetServiceLevelUsageError>> {
60    let local_var_configuration = configuration;
61
62    // unbox the parameters
63    let product_id = params.product_id;
64    let usage_type_name = params.usage_type_name;
65    let start_month = params.start_month;
66    let end_month = params.end_month;
67    let limit = params.limit;
68    let cursor = params.cursor;
69
70
71    let local_var_client = &local_var_configuration.client;
72
73    let local_var_uri_str = format!("{}/billing/v3/service-usage-metrics", local_var_configuration.base_path);
74    let mut local_var_req_builder = local_var_client.request(reqwest::Method::GET, local_var_uri_str.as_str());
75
76    if let Some(ref local_var_str) = product_id {
77        local_var_req_builder = local_var_req_builder.query(&[("product_id", &local_var_str.to_string())]);
78    }
79    if let Some(ref local_var_str) = usage_type_name {
80        local_var_req_builder = local_var_req_builder.query(&[("usage_type_name", &local_var_str.to_string())]);
81    }
82    if let Some(ref local_var_str) = start_month {
83        local_var_req_builder = local_var_req_builder.query(&[("start_month", &local_var_str.to_string())]);
84    }
85    if let Some(ref local_var_str) = end_month {
86        local_var_req_builder = local_var_req_builder.query(&[("end_month", &local_var_str.to_string())]);
87    }
88    if let Some(ref local_var_str) = limit {
89        local_var_req_builder = local_var_req_builder.query(&[("limit", &local_var_str.to_string())]);
90    }
91    if let Some(ref local_var_str) = cursor {
92        local_var_req_builder = local_var_req_builder.query(&[("cursor", &local_var_str.to_string())]);
93    }
94    if let Some(ref local_var_user_agent) = local_var_configuration.user_agent {
95        local_var_req_builder = local_var_req_builder.header(reqwest::header::USER_AGENT, local_var_user_agent.clone());
96    }
97    if let Some(ref local_var_apikey) = local_var_configuration.api_key {
98        let local_var_key = local_var_apikey.key.clone();
99        let local_var_value = match local_var_apikey.prefix {
100            Some(ref local_var_prefix) => format!("{} {}", local_var_prefix, local_var_key),
101            None => local_var_key,
102        };
103        local_var_req_builder = local_var_req_builder.header("Fastly-Key", local_var_value);
104    };
105
106    let local_var_req = local_var_req_builder.build()?;
107    let local_var_resp = local_var_client.execute(local_var_req).await?;
108
109    if "GET" != "GET" && "GET" != "HEAD" {
110      let headers = local_var_resp.headers();
111      local_var_configuration.rate_limit_remaining = match headers.get("Fastly-RateLimit-Remaining") {
112          Some(v) => v.to_str().unwrap().parse().unwrap(),
113          None => configuration::DEFAULT_RATELIMIT,
114      };
115      local_var_configuration.rate_limit_reset = match headers.get("Fastly-RateLimit-Reset") {
116          Some(v) => v.to_str().unwrap().parse().unwrap(),
117          None => 0,
118      };
119    }
120
121    let local_var_status = local_var_resp.status();
122    let local_var_content = local_var_resp.text().await?;
123
124    if !local_var_status.is_client_error() && !local_var_status.is_server_error() {
125        serde_json::from_str(&local_var_content).map_err(Error::from)
126    } else {
127        let local_var_entity: Option<GetServiceLevelUsageError> = serde_json::from_str(&local_var_content).ok();
128        let local_var_error = ResponseContent { status: local_var_status, content: local_var_content, entity: local_var_entity };
129        Err(Error::ResponseError(local_var_error))
130    }
131}
132
133/// Returns monthly usage metrics for customer by product.
134pub async fn get_usage_metrics(configuration: &mut configuration::Configuration, params: GetUsageMetricsParams) -> Result<crate::models::Usagemetric, Error<GetUsageMetricsError>> {
135    let local_var_configuration = configuration;
136
137    // unbox the parameters
138    let start_month = params.start_month;
139    let end_month = params.end_month;
140
141
142    let local_var_client = &local_var_configuration.client;
143
144    let local_var_uri_str = format!("{}/billing/v3/usage-metrics", local_var_configuration.base_path);
145    let mut local_var_req_builder = local_var_client.request(reqwest::Method::GET, local_var_uri_str.as_str());
146
147    local_var_req_builder = local_var_req_builder.query(&[("start_month", &start_month.to_string())]);
148    local_var_req_builder = local_var_req_builder.query(&[("end_month", &end_month.to_string())]);
149    if let Some(ref local_var_user_agent) = local_var_configuration.user_agent {
150        local_var_req_builder = local_var_req_builder.header(reqwest::header::USER_AGENT, local_var_user_agent.clone());
151    }
152    if let Some(ref local_var_apikey) = local_var_configuration.api_key {
153        let local_var_key = local_var_apikey.key.clone();
154        let local_var_value = match local_var_apikey.prefix {
155            Some(ref local_var_prefix) => format!("{} {}", local_var_prefix, local_var_key),
156            None => local_var_key,
157        };
158        local_var_req_builder = local_var_req_builder.header("Fastly-Key", local_var_value);
159    };
160
161    let local_var_req = local_var_req_builder.build()?;
162    let local_var_resp = local_var_client.execute(local_var_req).await?;
163
164    if "GET" != "GET" && "GET" != "HEAD" {
165      let headers = local_var_resp.headers();
166      local_var_configuration.rate_limit_remaining = match headers.get("Fastly-RateLimit-Remaining") {
167          Some(v) => v.to_str().unwrap().parse().unwrap(),
168          None => configuration::DEFAULT_RATELIMIT,
169      };
170      local_var_configuration.rate_limit_reset = match headers.get("Fastly-RateLimit-Reset") {
171          Some(v) => v.to_str().unwrap().parse().unwrap(),
172          None => 0,
173      };
174    }
175
176    let local_var_status = local_var_resp.status();
177    let local_var_content = local_var_resp.text().await?;
178
179    if !local_var_status.is_client_error() && !local_var_status.is_server_error() {
180        serde_json::from_str(&local_var_content).map_err(Error::from)
181    } else {
182        let local_var_entity: Option<GetUsageMetricsError> = serde_json::from_str(&local_var_content).ok();
183        let local_var_error = ResponseContent { status: local_var_status, content: local_var_content, entity: local_var_entity };
184        Err(Error::ResponseError(local_var_error))
185    }
186}
187
fastly_api/apis/billing_usage_metrics_api.rs

fastly_api/apis/
billing_usage_metrics_api.rs
