Describes the credit option for CPU usage of one or more of your T2 or
T3 instances. The credit options are standard
and unlimited
.
ec2_describe_instance_credit_specifications(DryRun, Filters,
InstanceIds, MaxResults, NextToken)
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
.
One or more filters.
instance-id
- The ID of the instance.
One or more instance IDs.
Default: Describes all your instances.
Constraints: Maximum 1000 explicitly specified instance IDs.
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.
The token to retrieve the next page of results.
svc$describe_instance_credit_specifications( DryRun = TRUE|FALSE, Filters = list( list( Name = "string", Values = list( "string" ) ) ), InstanceIds = list( "string" ), MaxResults = 123, NextToken = "string" )
If you do not specify an instance ID, Amazon EC2 returns T2 and T3
instances with the unlimited
credit option, as well as instances that
were previously configured as T2 or T3 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 T2 or
T3 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 Elastic Compute Cloud User Guide.