Struct aws_sdk_ssm::client::fluent_builders::DescribeInstanceInformation

pub struct DescribeInstanceInformation<C = DynConnector, M = AwsMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to DescribeInstanceInformation.

Describes one or more of your instances, including information about the operating system platform, the version of SSM Agent installed on the instance, instance status, and so on.

If you specify one or more instance IDs, it returns information for those instances. If you don't specify instance IDs, it returns information for all your instances. If you specify an instance ID that isn't valid or an instance that you don't own, you receive an error.

The IamRole field for this API operation is the Identity and Access Management (IAM) role assigned to on-premises instances. This call doesn't return the IAM role for EC2 instances.

Implementations

impl<C, M, R> DescribeInstanceInformation<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(
    self
) -> Result<DescribeInstanceInformationOutput, SdkError<DescribeInstanceInformationError>> where
    R::Policy: SmithyRetryPolicy<DescribeInstanceInformationInputOperationOutputAlias, DescribeInstanceInformationOutput, DescribeInstanceInformationError, DescribeInstanceInformationInputOperationRetryAlias>, 

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, which can be set when configuring the client.

pub fn instance_information_filter_list(
    self,
    inp: impl Into<InstanceInformationFilter>
) -> Self

Appends an item to InstanceInformationFilterList.

To override the contents of this collection use set_instance_information_filter_list.

This is a legacy method. We recommend that you don't use this method. Instead, use the Filters data type. Filters enables you to return instance information by filtering based on tags applied to managed instances.

Attempting to use InstanceInformationFilterList and Filters leads to an exception error.

pub fn set_instance_information_filter_list(
    self,
    input: Option<Vec<InstanceInformationFilter>>
) -> Self

This is a legacy method. We recommend that you don't use this method. Instead, use the Filters data type. Filters enables you to return instance information by filtering based on tags applied to managed instances.

Attempting to use InstanceInformationFilterList and Filters leads to an exception error.

pub fn filters(self, inp: impl Into<InstanceInformationStringFilter>) -> Self

Appends an item to Filters.

To override the contents of this collection use set_filters.

One or more filters. Use a filter to return a more specific list of instances. You can filter based on tags applied to EC2 instances. Use this Filters data type instead of InstanceInformationFilterList, which is deprecated.

pub fn set_filters(
    self,
    input: Option<Vec<InstanceInformationStringFilter>>
) -> Self

One or more filters. Use a filter to return a more specific list of instances. You can filter based on tags applied to EC2 instances. Use this Filters data type instead of InstanceInformationFilterList, which is deprecated.

pub fn max_results(self, inp: i32) -> Self

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

pub fn set_max_results(self, input: Option<i32>) -> Self

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

pub fn next_token(self, inp: impl Into<String>) -> Self

The token for the next set of items to return. (You received this token from a previous call.)

pub fn set_next_token(self, input: Option<String>) -> Self

The token for the next set of items to return. (You received this token from a previous call.)

Trait Implementations

impl<C: Debug, M: Debug, R: Debug> Debug for DescribeInstanceInformation<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.