Skip to content

modify_default_credit_specification

Operation

modify_default_credit_specification

Modifies the default credit option for CPU usage of burstable performance instances. The default credit option is set at the account level per Amazon Web Services Region, and is specified per instance family. All new burstable performance instances in the account launch using the default credit option.

ModifyDefaultCreditSpecification is an asynchronous operation, which works at an Amazon Web Services Region level and modifies the credit option for each Availability Zone. All zones in a Region are updated within five minutes. But if instances are launched during this operation, they might not get the new credit option until the zone is updated. To verify whether the update has occurred, you can call GetDefaultCreditSpecification and check DefaultCreditSpecification for updates.

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

Parameters:

Name Type Description Default
request ModifyDefaultCreditSpecificationInput | ModifyDefaultCreditSpecificationInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[ModifyDefaultCreditSpecificationInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ModifyDefaultCreditSpecificationOutput

An instance of ModifyDefaultCreditSpecificationOutput.

modify_default_credit_specification async

Modifies the default credit option for CPU usage of burstable performance instances. The default credit option is set at the account level per Amazon Web Services Region, and is specified per instance family. All new burstable performance instances in the account launch using the default credit option.

ModifyDefaultCreditSpecification is an asynchronous operation, which works at an Amazon Web Services Region level and modifies the credit option for each Availability Zone. All zones in a Region are updated within five minutes. But if instances are launched during this operation, they might not get the new credit option until the zone is updated. To verify whether the update has occurred, you can call GetDefaultCreditSpecification and check DefaultCreditSpecification for updates.

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

Parameters:

Name Type Description Default
request ModifyDefaultCreditSpecificationInput | ModifyDefaultCreditSpecificationInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[ModifyDefaultCreditSpecificationInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ModifyDefaultCreditSpecificationOutput

An instance of ModifyDefaultCreditSpecificationOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

ModifyDefaultCreditSpecificationInputDict

Bases: TypedDict

Dictionary form of ModifyDefaultCreditSpecificationInput.

Attributes

cpu_credits instance-attribute
cpu_credits: Required[str]

The credit option for CPU usage of the instance family.

Valid Values: standard | unlimited

dry_run instance-attribute
dry_run: bool | None

Checks whether you have the required permissions for the operation, 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.

instance_family instance-attribute
instance_family: Required[str]

The instance family.

ModifyDefaultCreditSpecificationInput dataclass

Bases: _SerdeShape

Dataclass for ModifyDefaultCreditSpecificationInput structure.

Attributes

cpu_credits class-attribute instance-attribute
cpu_credits: str | None = ...

The credit option for CPU usage of the instance family.

Valid Values: standard | unlimited

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

Checks whether you have the required permissions for the operation, 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.

instance_family class-attribute instance-attribute
instance_family: str | None = ...

The instance family.

Output

ModifyDefaultCreditSpecificationOutput dataclass

Bases: _SerdeShape

Dataclass for ModifyDefaultCreditSpecificationOutput structure.

Attributes

instance_family_credit_specification class-attribute instance-attribute
instance_family_credit_specification: InstanceFamilyCreditSpecification | None = ...

The default credit option for CPU usage of the instance family.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.