Amazon Elastic Compute Cloud

2024/12/09 - Amazon Elastic Compute Cloud - 1 new7 updated api methods

Changes  This release includes a new API for modifying instance network-performance-options after launch.

ModifyInstanceNetworkPerformanceOptions (new) Link ¶

Change the configuration of the network performance options for an existing instance.

See also: AWS API Documentation

Request Syntax

client.modify_instance_network_performance_options(
    InstanceId='string',
    BandwidthWeighting='default'|'vpc-1'|'ebs-1',
    DryRun=True|False
)
type InstanceId:

string

param InstanceId:

[REQUIRED]

The ID of the instance to update.

type BandwidthWeighting:

string

param BandwidthWeighting:

[REQUIRED]

Specify the bandwidth weighting option to boost the associated type of baseline bandwidth, as follows:

default

This option uses the standard bandwidth configuration for your instance type.

vpc-1

This option boosts your networking baseline bandwidth and reduces your EBS baseline bandwidth.

ebs-1

This option boosts your EBS baseline bandwidth and reduces your networking baseline bandwidth.

type DryRun:

boolean

param DryRun:

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.

rtype:

dict

returns:

Response Syntax

{
    'InstanceId': 'string',
    'BandwidthWeighting': 'default'|'vpc-1'|'ebs-1'
}

Response Structure

  • (dict) --

    • InstanceId (string) --

      The instance ID that was updated.

    • BandwidthWeighting (string) --

      Contains the updated configuration for bandwidth weighting on the specified instance.

CreateLaunchTemplate (updated) Link ¶
Changes (request)
{'LaunchTemplateData': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default '
                                                                            '| '
                                                                            'vpc-1 '
                                                                            '| '
                                                                            'ebs-1'}}}
CreateLaunchTemplateVersion (updated) Link ¶
Changes (request, response)
Request
{'LaunchTemplateData': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default '
                                                                            '| '
                                                                            'vpc-1 '
                                                                            '| '
                                                                            'ebs-1'}}}
Response
{'LaunchTemplateVersion': {'LaunchTemplateData': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default '
                                                                                                      '| '
                                                                                                      'vpc-1 '
                                                                                                      '| '
                                                                                                      'ebs-1'}}}}
DescribeInstanceTypes (updated) Link ¶
Changes (response)
{'InstanceTypes': {'NetworkInfo': {'BandwidthWeightings': ['default | vpc-1 | '
                                                           'ebs-1']}}}
DescribeInstances (updated) Link ¶
Changes (response)
{'Reservations': {'Instances': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default '
                                                                                    '| '
                                                                                    'vpc-1 '
                                                                                    '| '
                                                                                    'ebs-1'}}}}
DescribeLaunchTemplateVersions (updated) Link ¶
Changes (response)
{'LaunchTemplateVersions': {'LaunchTemplateData': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default '
                                                                                                       '| '
                                                                                                       'vpc-1 '
                                                                                                       '| '
                                                                                                       'ebs-1'}}}}
GetLaunchTemplateData (updated) Link ¶
Changes (response)
{'LaunchTemplateData': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default '
                                                                            '| '
                                                                            'vpc-1 '
                                                                            '| '
                                                                            'ebs-1'}}}
RunInstances (updated) Link ¶
Changes (request, response)
Request
{'NetworkPerformanceOptions': {'BandwidthWeighting': 'default | vpc-1 | ebs-1'}}
Response
{'Instances': {'NetworkPerformanceOptions': {'BandwidthWeighting': 'default | '
                                                                   'vpc-1 | '
                                                                   'ebs-1'}}}