Struct aws_sdk_ec2::client::fluent_builders::DescribeInstanceCreditSpecifications

pub struct DescribeInstanceCreditSpecifications { /* private fields */ }

Fluent builder constructing a request to DescribeInstanceCreditSpecifications.

Describes the credit option for CPU usage of the specified burstable performance instances. The credit options are standard and unlimited.

If you do not specify an instance ID, Amazon EC2 returns burstable performance instances with the unlimited credit option, as well as instances that were previously configured as T2, T3, and T3a with the unlimited credit option. For example, if you resize a T2 instance, while it is configured as unlimited, to an M4 instance, Amazon EC2 returns the M4 instance.

If you specify one or more instance IDs, Amazon EC2 returns the credit option (standard or unlimited) of those instances. If you specify an instance ID that is not valid, such as an instance that is not a burstable performance instance, an error is returned.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

If an Availability Zone is experiencing a service disruption and you specify instance IDs in the affected zone, or do not specify any instance IDs at all, the call fails. If you specify only instance IDs in an unaffected zone, the call works normally.

For more information, see Burstable performance instances in the Amazon EC2 User Guide.

Implementations

impl DescribeInstanceCreditSpecifications

pub async fn send(
    self
) -> Result<DescribeInstanceCreditSpecificationsOutput, SdkError<DescribeInstanceCreditSpecificationsError>>

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 into_paginator(self) -> DescribeInstanceCreditSpecificationsPaginator

Create a paginator for this request

Paginators are used by calling send().await which returns a Stream.

pub fn dry_run(self, input: bool) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

pub fn set_dry_run(self, input: Option<bool>) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

pub fn filters(self, input: Filter) -> Self

Appends an item to Filters.

To override the contents of this collection use set_filters.

The filters.

• instance-id - The ID of the instance.

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

The filters.

• instance-id - The ID of the instance.

pub fn instance_ids(self, input: impl Into<String>) -> Self

Appends an item to InstanceIds.

To override the contents of this collection use set_instance_ids.

The instance IDs.

Default: Describes all your instances.

Constraints: Maximum 1000 explicitly specified instance IDs.

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

The instance IDs.

Default: Describes all your instances.

Constraints: Maximum 1000 explicitly specified instance IDs.

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

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

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

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000. You cannot specify this parameter and the instance IDs parameter in the same call.

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

The token to retrieve the next page of results.

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

The token to retrieve the next page of results.

Trait Implementations

impl Clone for DescribeInstanceCreditSpecifications

fn clone(&self) -> DescribeInstanceCreditSpecifications

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DescribeInstanceCreditSpecifications

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

Formats the value using the given formatter.