aws_sdk_applicationdiscovery/operation/describe_agents/
_describe_agents_output.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2#[allow(missing_docs)] // documentation missing in model
3#[non_exhaustive]
4#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
5pub struct DescribeAgentsOutput {
6    /// <p>Lists agents or the collector by ID or lists all agents/collectors associated with your user, if you did not specify an agent/collector ID. The output includes agent/collector IDs, IP addresses, media access control (MAC) addresses, agent/collector health, host name where the agent/collector resides, and the version number of each agent/collector.</p>
7    pub agents_info: ::std::option::Option<::std::vec::Vec<crate::types::AgentInfo>>,
8    /// <p>Token to retrieve the next set of results. For example, if you specified 100 IDs for <code>DescribeAgentsRequest$agentIds</code> but set <code>DescribeAgentsRequest$maxResults</code> to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.</p>
9    pub next_token: ::std::option::Option<::std::string::String>,
10    _request_id: Option<String>,
11}
12impl DescribeAgentsOutput {
13    /// <p>Lists agents or the collector by ID or lists all agents/collectors associated with your user, if you did not specify an agent/collector ID. The output includes agent/collector IDs, IP addresses, media access control (MAC) addresses, agent/collector health, host name where the agent/collector resides, and the version number of each agent/collector.</p>
14    ///
15    /// If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use `.agents_info.is_none()`.
16    pub fn agents_info(&self) -> &[crate::types::AgentInfo] {
17        self.agents_info.as_deref().unwrap_or_default()
18    }
19    /// <p>Token to retrieve the next set of results. For example, if you specified 100 IDs for <code>DescribeAgentsRequest$agentIds</code> but set <code>DescribeAgentsRequest$maxResults</code> to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.</p>
20    pub fn next_token(&self) -> ::std::option::Option<&str> {
21        self.next_token.as_deref()
22    }
23}
24impl ::aws_types::request_id::RequestId for DescribeAgentsOutput {
25    fn request_id(&self) -> Option<&str> {
26        self._request_id.as_deref()
27    }
28}
29impl DescribeAgentsOutput {
30    /// Creates a new builder-style object to manufacture [`DescribeAgentsOutput`](crate::operation::describe_agents::DescribeAgentsOutput).
31    pub fn builder() -> crate::operation::describe_agents::builders::DescribeAgentsOutputBuilder {
32        crate::operation::describe_agents::builders::DescribeAgentsOutputBuilder::default()
33    }
34}
35
36/// A builder for [`DescribeAgentsOutput`](crate::operation::describe_agents::DescribeAgentsOutput).
37#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
38#[non_exhaustive]
39pub struct DescribeAgentsOutputBuilder {
40    pub(crate) agents_info: ::std::option::Option<::std::vec::Vec<crate::types::AgentInfo>>,
41    pub(crate) next_token: ::std::option::Option<::std::string::String>,
42    _request_id: Option<String>,
43}
44impl DescribeAgentsOutputBuilder {
45    /// Appends an item to `agents_info`.
46    ///
47    /// To override the contents of this collection use [`set_agents_info`](Self::set_agents_info).
48    ///
49    /// <p>Lists agents or the collector by ID or lists all agents/collectors associated with your user, if you did not specify an agent/collector ID. The output includes agent/collector IDs, IP addresses, media access control (MAC) addresses, agent/collector health, host name where the agent/collector resides, and the version number of each agent/collector.</p>
50    pub fn agents_info(mut self, input: crate::types::AgentInfo) -> Self {
51        let mut v = self.agents_info.unwrap_or_default();
52        v.push(input);
53        self.agents_info = ::std::option::Option::Some(v);
54        self
55    }
56    /// <p>Lists agents or the collector by ID or lists all agents/collectors associated with your user, if you did not specify an agent/collector ID. The output includes agent/collector IDs, IP addresses, media access control (MAC) addresses, agent/collector health, host name where the agent/collector resides, and the version number of each agent/collector.</p>
57    pub fn set_agents_info(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::AgentInfo>>) -> Self {
58        self.agents_info = input;
59        self
60    }
61    /// <p>Lists agents or the collector by ID or lists all agents/collectors associated with your user, if you did not specify an agent/collector ID. The output includes agent/collector IDs, IP addresses, media access control (MAC) addresses, agent/collector health, host name where the agent/collector resides, and the version number of each agent/collector.</p>
62    pub fn get_agents_info(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::AgentInfo>> {
63        &self.agents_info
64    }
65    /// <p>Token to retrieve the next set of results. For example, if you specified 100 IDs for <code>DescribeAgentsRequest$agentIds</code> but set <code>DescribeAgentsRequest$maxResults</code> to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.</p>
66    pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
67        self.next_token = ::std::option::Option::Some(input.into());
68        self
69    }
70    /// <p>Token to retrieve the next set of results. For example, if you specified 100 IDs for <code>DescribeAgentsRequest$agentIds</code> but set <code>DescribeAgentsRequest$maxResults</code> to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.</p>
71    pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
72        self.next_token = input;
73        self
74    }
75    /// <p>Token to retrieve the next set of results. For example, if you specified 100 IDs for <code>DescribeAgentsRequest$agentIds</code> but set <code>DescribeAgentsRequest$maxResults</code> to 10, you received a set of 10 results along with this token. Use this token in the next query to retrieve the next set of 10.</p>
76    pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
77        &self.next_token
78    }
79    pub(crate) fn _request_id(mut self, request_id: impl Into<String>) -> Self {
80        self._request_id = Some(request_id.into());
81        self
82    }
83
84    pub(crate) fn _set_request_id(&mut self, request_id: Option<String>) -> &mut Self {
85        self._request_id = request_id;
86        self
87    }
88    /// Consumes the builder and constructs a [`DescribeAgentsOutput`](crate::operation::describe_agents::DescribeAgentsOutput).
89    pub fn build(self) -> crate::operation::describe_agents::DescribeAgentsOutput {
90        crate::operation::describe_agents::DescribeAgentsOutput {
91            agents_info: self.agents_info,
92            next_token: self.next_token,
93            _request_id: self._request_id,
94        }
95    }
96}