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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::list_backup_job_summaries::_list_backup_job_summaries_input::ListBackupJobSummariesInputBuilder;
pub use crate::operation::list_backup_job_summaries::_list_backup_job_summaries_output::ListBackupJobSummariesOutputBuilder;
impl crate::operation::list_backup_job_summaries::builders::ListBackupJobSummariesInputBuilder {
/// Sends a request with this input using the given client.
pub async fn send_with(
self,
client: &crate::Client,
) -> ::std::result::Result<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let mut fluent_builder = client.list_backup_job_summaries();
fluent_builder.inner = self;
fluent_builder.send().await
}
}
/// Fluent builder constructing a request to `ListBackupJobSummaries`.
///
/// <p>This is a request for a summary of backup jobs created or running within the most recent 30 days. You can include parameters AccountID, State, ResourceType, MessageCategory, AggregationPeriod, MaxResults, or NextToken to filter results.</p>
/// <p>This request returns a summary that contains Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, and Count of included jobs.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct ListBackupJobSummariesFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::list_backup_job_summaries::builders::ListBackupJobSummariesInputBuilder,
config_override: ::std::option::Option<crate::config::Builder>,
}
impl
crate::client::customize::internal::CustomizableSend<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesOutput,
crate::operation::list_backup_job_summaries::ListBackupJobSummariesError,
> for ListBackupJobSummariesFluentBuilder
{
fn send(
self,
config_override: crate::config::Builder,
) -> crate::client::customize::internal::BoxFuture<
crate::client::customize::internal::SendResult<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesOutput,
crate::operation::list_backup_job_summaries::ListBackupJobSummariesError,
>,
> {
::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
}
}
impl ListBackupJobSummariesFluentBuilder {
/// Creates a new `ListBackupJobSummariesFluentBuilder`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
config_override: ::std::option::Option::None,
}
}
/// Access the ListBackupJobSummaries as a reference.
pub fn as_input(&self) -> &crate::operation::list_backup_job_summaries::builders::ListBackupJobSummariesInputBuilder {
&self.inner
}
/// Sends the request and returns the response.
///
/// If an error occurs, an `SdkError` will be returned with additional details that
/// can be matched against.
///
/// By default, any retryable failures will be retried twice. Retry behavior
/// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> ::std::result::Result<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let input = self
.inner
.build()
.map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
let runtime_plugins = crate::operation::list_backup_job_summaries::ListBackupJobSummaries::operation_runtime_plugins(
self.handle.runtime_plugins.clone(),
&self.handle.conf,
self.config_override,
);
crate::operation::list_backup_job_summaries::ListBackupJobSummaries::orchestrate(&runtime_plugins, input).await
}
/// Consumes this builder, creating a customizable operation that can be modified before being sent.
pub fn customize(
self,
) -> crate::client::customize::CustomizableOperation<
crate::operation::list_backup_job_summaries::ListBackupJobSummariesOutput,
crate::operation::list_backup_job_summaries::ListBackupJobSummariesError,
Self,
> {
crate::client::customize::CustomizableOperation::new(self)
}
pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
self.set_config_override(::std::option::Option::Some(config_override.into()));
self
}
pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
self.config_override = config_override;
self
}
/// Create a paginator for this request
///
/// Paginators are used by calling [`send().await`](crate::operation::list_backup_job_summaries::paginator::ListBackupJobSummariesPaginator::send) which returns a [`PaginationStream`](aws_smithy_async::future::pagination_stream::PaginationStream).
pub fn into_paginator(self) -> crate::operation::list_backup_job_summaries::paginator::ListBackupJobSummariesPaginator {
crate::operation::list_backup_job_summaries::paginator::ListBackupJobSummariesPaginator::new(self.handle, self.inner)
}
/// <p>Returns the job count for the specified account.</p>
/// <p>If the request is sent from a member account or an account not part of Amazon Web Services Organizations, jobs within requestor's account will be returned.</p>
/// <p>Root, admin, and delegated administrator accounts can use the value ANY to return job counts from every account in the organization.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts from all accounts within the authenticated organization, then returns the sum.</p>
pub fn account_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.account_id(input.into());
self
}
/// <p>Returns the job count for the specified account.</p>
/// <p>If the request is sent from a member account or an account not part of Amazon Web Services Organizations, jobs within requestor's account will be returned.</p>
/// <p>Root, admin, and delegated administrator accounts can use the value ANY to return job counts from every account in the organization.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts from all accounts within the authenticated organization, then returns the sum.</p>
pub fn set_account_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_account_id(input);
self
}
/// <p>Returns the job count for the specified account.</p>
/// <p>If the request is sent from a member account or an account not part of Amazon Web Services Organizations, jobs within requestor's account will be returned.</p>
/// <p>Root, admin, and delegated administrator accounts can use the value ANY to return job counts from every account in the organization.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts from all accounts within the authenticated organization, then returns the sum.</p>
pub fn get_account_id(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_account_id()
}
/// <p>This parameter returns the job count for jobs with the specified state.</p>
/// <p>The the value ANY returns count of all states.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all states and returns the sum.</p>
/// <p><code>Completed with issues</code> is a status found only in the Backup console. For API, this status refers to jobs with a state of <code>COMPLETED</code> and a <code>MessageCategory</code> with a value other than <code>SUCCESS</code>; that is, the status is completed but comes with a status message. To obtain the job count for <code>Completed with issues</code>, run two GET requests, and subtract the second, smaller number:</p>
/// <p>GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN_DAYS&State=COMPLETED</p>
/// <p>GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN_DAYS&MessageCategory=SUCCESS&State=COMPLETED</p>
pub fn state(mut self, input: crate::types::BackupJobStatus) -> Self {
self.inner = self.inner.state(input);
self
}
/// <p>This parameter returns the job count for jobs with the specified state.</p>
/// <p>The the value ANY returns count of all states.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all states and returns the sum.</p>
/// <p><code>Completed with issues</code> is a status found only in the Backup console. For API, this status refers to jobs with a state of <code>COMPLETED</code> and a <code>MessageCategory</code> with a value other than <code>SUCCESS</code>; that is, the status is completed but comes with a status message. To obtain the job count for <code>Completed with issues</code>, run two GET requests, and subtract the second, smaller number:</p>
/// <p>GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN_DAYS&State=COMPLETED</p>
/// <p>GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN_DAYS&MessageCategory=SUCCESS&State=COMPLETED</p>
pub fn set_state(mut self, input: ::std::option::Option<crate::types::BackupJobStatus>) -> Self {
self.inner = self.inner.set_state(input);
self
}
/// <p>This parameter returns the job count for jobs with the specified state.</p>
/// <p>The the value ANY returns count of all states.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all states and returns the sum.</p>
/// <p><code>Completed with issues</code> is a status found only in the Backup console. For API, this status refers to jobs with a state of <code>COMPLETED</code> and a <code>MessageCategory</code> with a value other than <code>SUCCESS</code>; that is, the status is completed but comes with a status message. To obtain the job count for <code>Completed with issues</code>, run two GET requests, and subtract the second, smaller number:</p>
/// <p>GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN_DAYS&State=COMPLETED</p>
/// <p>GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN_DAYS&MessageCategory=SUCCESS&State=COMPLETED</p>
pub fn get_state(&self) -> &::std::option::Option<crate::types::BackupJobStatus> {
self.inner.get_state()
}
/// <p>Returns the job count for the specified resource type. Use request <code>GetSupportedResourceTypes</code> to obtain strings for supported resource types.</p>
/// <p>The the value ANY returns count of all resource types.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all resource types and returns the sum.</p>
/// <p>The type of Amazon Web Services resource to be backed up; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.</p>
pub fn resource_type(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.resource_type(input.into());
self
}
/// <p>Returns the job count for the specified resource type. Use request <code>GetSupportedResourceTypes</code> to obtain strings for supported resource types.</p>
/// <p>The the value ANY returns count of all resource types.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all resource types and returns the sum.</p>
/// <p>The type of Amazon Web Services resource to be backed up; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.</p>
pub fn set_resource_type(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_resource_type(input);
self
}
/// <p>Returns the job count for the specified resource type. Use request <code>GetSupportedResourceTypes</code> to obtain strings for supported resource types.</p>
/// <p>The the value ANY returns count of all resource types.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all resource types and returns the sum.</p>
/// <p>The type of Amazon Web Services resource to be backed up; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.</p>
pub fn get_resource_type(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_resource_type()
}
/// <p>This parameter returns the job count for the specified message category.</p>
/// <p>Example accepted strings include <code>AccessDenied</code>, <code>Success</code>, and <code>InvalidParameters</code>. See <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html">Monitoring</a> for a list of accepted MessageCategory strings.</p>
/// <p>The the value ANY returns count of all message categories.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all message categories and returns the sum.</p>
pub fn message_category(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.message_category(input.into());
self
}
/// <p>This parameter returns the job count for the specified message category.</p>
/// <p>Example accepted strings include <code>AccessDenied</code>, <code>Success</code>, and <code>InvalidParameters</code>. See <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html">Monitoring</a> for a list of accepted MessageCategory strings.</p>
/// <p>The the value ANY returns count of all message categories.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all message categories and returns the sum.</p>
pub fn set_message_category(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_message_category(input);
self
}
/// <p>This parameter returns the job count for the specified message category.</p>
/// <p>Example accepted strings include <code>AccessDenied</code>, <code>Success</code>, and <code>InvalidParameters</code>. See <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html">Monitoring</a> for a list of accepted MessageCategory strings.</p>
/// <p>The the value ANY returns count of all message categories.</p>
/// <p><code>AGGREGATE_ALL</code> aggregates job counts for all message categories and returns the sum.</p>
pub fn get_message_category(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_message_category()
}
/// <p>The period for the returned results.</p>
/// <ul>
/// <li>
/// <p><code>ONE_DAY</code> - The daily job count for the prior 14 days.</p></li>
/// <li>
/// <p><code>SEVEN_DAYS</code> - The aggregated job count for the prior 7 days.</p></li>
/// <li>
/// <p><code>FOURTEEN_DAYS</code> - The aggregated job count for prior 14 days.</p></li>
/// </ul>
pub fn aggregation_period(mut self, input: crate::types::AggregationPeriod) -> Self {
self.inner = self.inner.aggregation_period(input);
self
}
/// <p>The period for the returned results.</p>
/// <ul>
/// <li>
/// <p><code>ONE_DAY</code> - The daily job count for the prior 14 days.</p></li>
/// <li>
/// <p><code>SEVEN_DAYS</code> - The aggregated job count for the prior 7 days.</p></li>
/// <li>
/// <p><code>FOURTEEN_DAYS</code> - The aggregated job count for prior 14 days.</p></li>
/// </ul>
pub fn set_aggregation_period(mut self, input: ::std::option::Option<crate::types::AggregationPeriod>) -> Self {
self.inner = self.inner.set_aggregation_period(input);
self
}
/// <p>The period for the returned results.</p>
/// <ul>
/// <li>
/// <p><code>ONE_DAY</code> - The daily job count for the prior 14 days.</p></li>
/// <li>
/// <p><code>SEVEN_DAYS</code> - The aggregated job count for the prior 7 days.</p></li>
/// <li>
/// <p><code>FOURTEEN_DAYS</code> - The aggregated job count for prior 14 days.</p></li>
/// </ul>
pub fn get_aggregation_period(&self) -> &::std::option::Option<crate::types::AggregationPeriod> {
self.inner.get_aggregation_period()
}
/// <p>The maximum number of items to be returned.</p>
/// <p>The value is an integer. Range of accepted values is from 1 to 500.</p>
pub fn max_results(mut self, input: i32) -> Self {
self.inner = self.inner.max_results(input);
self
}
/// <p>The maximum number of items to be returned.</p>
/// <p>The value is an integer. Range of accepted values is from 1 to 500.</p>
pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
self.inner = self.inner.set_max_results(input);
self
}
/// <p>The maximum number of items to be returned.</p>
/// <p>The value is an integer. Range of accepted values is from 1 to 500.</p>
pub fn get_max_results(&self) -> &::std::option::Option<i32> {
self.inner.get_max_results()
}
/// <p>The next item following a partial list of returned resources. For example, if a request is made to return <code>MaxResults</code> number of resources, <code>NextToken</code> allows you to return more items in your list starting at the location pointed to by the next token.</p>
pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.next_token(input.into());
self
}
/// <p>The next item following a partial list of returned resources. For example, if a request is made to return <code>MaxResults</code> number of resources, <code>NextToken</code> allows you to return more items in your list starting at the location pointed to by the next token.</p>
pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_next_token(input);
self
}
/// <p>The next item following a partial list of returned resources. For example, if a request is made to return <code>MaxResults</code> number of resources, <code>NextToken</code> allows you to return more items in your list starting at the location pointed to by the next token.</p>
pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_next_token()
}
}