AWS EC2 Modify Instance Attribute Version 1

This handler uses the AWS REST API to modify the specified attribute of the specified instance. You can specify only one attribute at a time. For more information see the AWS Amazon Virtual Private Cloud User Guide online.

The Dry Run parameter validates user permissions and inputs. If it is set to true, an error will always be thrown by the handler before completing the handler action. Error response will be 'DryRunOperation' if the account has proper permissions and inputs; 'UnauthorizedOperation' if the account does not have proper permissions.

Parameters

Name Description
Dry Run Dry run validates user permissions and inputs without completing the EC2 action (true or false).
Instance ID The ID of the instance.
attribute The name of the attribute
Value A new value for the attribute.
Block Device Mapping Modifies the DeleteOnTermination attribute for volumes that are currently attached.
Source Destination Check true or false. Specifies whether source/destination checking is enabled.
Disable API Termination true or false. If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
Instance Type The instance type. Changes the instance type to the specified value.
Kernel ID Changes the instance's kernel to the specified value.
Ramdisk ID Changes the instance's RAM disk to the specified value.
User Data Changes the instance's user data to the specified value. Input is base64-encoded MIME data.
Instance Initiated Shutdown Behavior Accepts 'stop' or 'terminate'.
Security Group IDs One or more security group names, separated by commas.
EBS Optimized true or false. Specifies whether the instance is optimized for EBS I/O.
SRIOV Net Support Set to simple to enable enhanced networking for the instance.

Sample Configuration

Name Description
Dry Run
Instance ID
attribute
Value
Block Device Mapping
Source Destination Check
Disable API Termination
Instance Type
Kernel ID
Ramdisk ID
User Data
Instance Initiated Shutdown Behavior
Security Group IDs
EBS Optimized
SRIOV Net Support

Results

This handler does not return any results.

Changelog

AWS EC2 Modify Instance Attribute V1 (2017-08-24)

  • Initial version. See README for details.


Related Handlers

AWS EC2 Attach Internet Gateway
Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC.
AWS EC2 Create Internet Gateway
Creates an internet gateway
AWS EC2 Create Key Pair
Creates a 2048-bit RSA key pair with the specified name.
AWS EC2 Create Route Table
Creates a route table for the specified VPC.
AWS EC2 Create Security Group
This handler is used to create a security group in AWS.
AWS EC2 Create Tag
Creates a single tag against a single resource.
AWS EC2 Delete Internet Gateway
Deletes a VPC
AWS EC2 Delete Route Table
Deletes a specified route table.
AWS EC2 Delete Security Group
Deletes a security group.
AWS EC2 Delete Tag
Deletes a single tag against a single resource.
AWS EC2 Describe Availability Zone
Returns a single availability zone's Name, State, and Region.
AWS EC2 Describe Images
Describes one or more of the images (AMIs, AKIs, and ARIs) available to you. Images available to you include public images, private images that you own, and private images owned by other AWS accounts but for which you have explicit launch permissions.
AWS EC2 Disassociate Route Table
Disassociates a subnet from a route table.
AWS EC2 Image Retrieve
Retrieves the properties of the image supplied
AWS EC2 Instance Retrieve Status
Retrieves the status of a particular EC2 instance.
AWS EC2 Instance Start
This handler sends a start request to an AWS EC2 machine instance
AWS EC2 Revoke Security Group Ingress
Removes one or more ingress rules from a security group.
AWS EC2 Run Instances
Launches the specified number of instances using an AMI for which you have permissions.