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
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
/// <p>Contains details about the CloudTrail trail being analyzed to generate a policy.</p>
#[non_exhaustive]
#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
pub struct Trail {
/// <p>Specifies the ARN of the trail. The format of a trail ARN is <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>.</p>
pub cloud_trail_arn: ::std::string::String,
/// <p>A list of regions to get CloudTrail data from and analyze to generate a policy.</p>
pub regions: ::std::option::Option<::std::vec::Vec<::std::string::String>>,
/// <p>Possible values are <code>true</code> or <code>false</code>. If set to <code>true</code>, IAM Access Analyzer retrieves CloudTrail data from all regions to analyze and generate a policy.</p>
pub all_regions: ::std::option::Option<bool>,
}
impl Trail {
/// <p>Specifies the ARN of the trail. The format of a trail ARN is <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>.</p>
pub fn cloud_trail_arn(&self) -> &str {
use std::ops::Deref;
self.cloud_trail_arn.deref()
}
/// <p>A list of regions to get CloudTrail data from and analyze to generate a policy.</p>
///
/// If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use `.regions.is_none()`.
pub fn regions(&self) -> &[::std::string::String] {
self.regions.as_deref().unwrap_or_default()
}
/// <p>Possible values are <code>true</code> or <code>false</code>. If set to <code>true</code>, IAM Access Analyzer retrieves CloudTrail data from all regions to analyze and generate a policy.</p>
pub fn all_regions(&self) -> ::std::option::Option<bool> {
self.all_regions
}
}
impl Trail {
/// Creates a new builder-style object to manufacture [`Trail`](crate::types::Trail).
pub fn builder() -> crate::types::builders::TrailBuilder {
crate::types::builders::TrailBuilder::default()
}
}
/// A builder for [`Trail`](crate::types::Trail).
#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
#[non_exhaustive]
pub struct TrailBuilder {
pub(crate) cloud_trail_arn: ::std::option::Option<::std::string::String>,
pub(crate) regions: ::std::option::Option<::std::vec::Vec<::std::string::String>>,
pub(crate) all_regions: ::std::option::Option<bool>,
}
impl TrailBuilder {
/// <p>Specifies the ARN of the trail. The format of a trail ARN is <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>.</p>
/// This field is required.
pub fn cloud_trail_arn(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.cloud_trail_arn = ::std::option::Option::Some(input.into());
self
}
/// <p>Specifies the ARN of the trail. The format of a trail ARN is <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>.</p>
pub fn set_cloud_trail_arn(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.cloud_trail_arn = input;
self
}
/// <p>Specifies the ARN of the trail. The format of a trail ARN is <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>.</p>
pub fn get_cloud_trail_arn(&self) -> &::std::option::Option<::std::string::String> {
&self.cloud_trail_arn
}
/// Appends an item to `regions`.
///
/// To override the contents of this collection use [`set_regions`](Self::set_regions).
///
/// <p>A list of regions to get CloudTrail data from and analyze to generate a policy.</p>
pub fn regions(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
let mut v = self.regions.unwrap_or_default();
v.push(input.into());
self.regions = ::std::option::Option::Some(v);
self
}
/// <p>A list of regions to get CloudTrail data from and analyze to generate a policy.</p>
pub fn set_regions(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
self.regions = input;
self
}
/// <p>A list of regions to get CloudTrail data from and analyze to generate a policy.</p>
pub fn get_regions(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
&self.regions
}
/// <p>Possible values are <code>true</code> or <code>false</code>. If set to <code>true</code>, IAM Access Analyzer retrieves CloudTrail data from all regions to analyze and generate a policy.</p>
pub fn all_regions(mut self, input: bool) -> Self {
self.all_regions = ::std::option::Option::Some(input);
self
}
/// <p>Possible values are <code>true</code> or <code>false</code>. If set to <code>true</code>, IAM Access Analyzer retrieves CloudTrail data from all regions to analyze and generate a policy.</p>
pub fn set_all_regions(mut self, input: ::std::option::Option<bool>) -> Self {
self.all_regions = input;
self
}
/// <p>Possible values are <code>true</code> or <code>false</code>. If set to <code>true</code>, IAM Access Analyzer retrieves CloudTrail data from all regions to analyze and generate a policy.</p>
pub fn get_all_regions(&self) -> &::std::option::Option<bool> {
&self.all_regions
}
/// Consumes the builder and constructs a [`Trail`](crate::types::Trail).
/// This method will fail if any of the following fields are not set:
/// - [`cloud_trail_arn`](crate::types::builders::TrailBuilder::cloud_trail_arn)
pub fn build(self) -> ::std::result::Result<crate::types::Trail, ::aws_smithy_types::error::operation::BuildError> {
::std::result::Result::Ok(crate::types::Trail {
cloud_trail_arn: self.cloud_trail_arn.ok_or_else(|| {
::aws_smithy_types::error::operation::BuildError::missing_field(
"cloud_trail_arn",
"cloud_trail_arn was not specified but it is required when building Trail",
)
})?,
regions: self.regions,
all_regions: self.all_regions,
})
}
}