Modifying an Instance Attribute

You can modify an attribute of an instance, such as its type, user data, or termination behavior. Depending on the attribute you want to modify, the instance must be running or stopped.

Modifying an Instance Attribute Using Cockpit v1

Before you begin:

  • To modify the User Data and Instance Type attributes, you must stop the instance.

  • Other attributes can be modified when the instance is running or stopped.

Open the Modify Instance Attributes Dialog Box

  1. Click Compute > Instances.

  2. Click the instance whose attributes you want to modify.
    The instance is selected.

  3. Click Attributes .
    The MODIFY INSTANCE ATTRIBUTES dialog box appears.

(optional) Modify the Termination Behavior of the Instance

  1. Click the Disable Termination tab.

  2. Switch the button to true or false:

    • If set to true, you cannot terminate the instance.

    • If set to false, you can terminate it using Cockpit, the AWS CLI or the API.

(optional) Modify the Deletion Behavior of the Volumes Attached to the Instance

When you create an instance from an official OUTSCALE machine image (OMI) with Cockpit, the Delete on termination attribute is true for the root volume. If you attach secondary volumes with Cockpit, the attribute is false for those volumes.

The Delete on termination tab only allows you to switch the attribute to true or false for all volumes at the same time. If you want to modify this attribute on a volume by volume basis, you must use the ModifyInstanceAttribute API method.

  1. Click the Delete on termination tab.

  2. Switch the button to true or false:

    • Switch the button to true to delete all volumes when the instance is terminated.

    • Switch the button to false to keep all volumes when the instance is terminated.

(optional) Modify the Security Groups Associated with the Instance

  1. Click the Security Groups tab.

  2. From the list, select the security group(s) you want to associate with the instance.

  3. To disassociate a security group from the instance, click next to the name of the security group.

  4. Click Apply to validate.

(optional) Modify the Shutdown Behavior of the Instance

  1. Click the Shutdown Behavior tab.

  2. From the list, select one of the following values:

    • stop: When you initiate the shutdown, the instance stops.

    • terminate: When you initiate the shutdown, the instance stops and is terminated.

    • restart: When you initiate the shutdown, the instance stops, then automatically restarts.

      For more information, see About Instance Lifecycle > Termination.

  3. Click Apply to validate.

(VPC only, optional) Modify the Source/Destination Check of the Instance

  1. Click the Check Source and Destination tab.

  2. Switch the button to true or false:

    • If set to true, source/destination check of network traffic is enabled.

    • It set to false, source/destination check of network traffic is disabled.

(optional) Modify the Keypair Assigned to the Instance

  1. Click the Keypair tab.

  2. From the list, select the new keypair you want to assign to the instance.

  3. Click Apply to validate.

    This action only updates the public key reported by the metadata of the instance. To complete the replacement, you need to manually replace the old public key with the new public key in the ~/.ssh/authorized_keys file located inside the instance. You then need to restart the instance to apply the change.

    You can also use this action to assign a keypair to an instance for which you did not initially specify a keypair.

(optional) Modify User Data for the Instance

  1. Click the User Data tab.

  2. In the UserData fields, type the user data. For more information, see Configuring an Instance with User Data and OUTSCALE Tags.

    Cockpit then encodes this user data to Base64. The maximum size for the Base64-encoded user data is 500 kibibytes (KiB).

  3. Click Apply to validate.

(optional) Modify the Instance Type

  1. Click the Instance Type tab.

  2. Specify the following attributes for your instance:

    • CPU: The processor generation.

    • Performance: The performance flag.

      • Highest Performance: Provides maximum compute capacity on all the cores of the VM. This option is ideal for intensive compute applications.

      • High Performance: Provides high compute capacity on all the cores of the VM. This option offers small performance variability and applies to most cases.

      • Medium Performance: Provides performance with significant variability on all the cores of the VM. This option does not guarantee consistent performance, but is ideal for machines with low CPU demand.

    • Core(s): The number of vCores, up to 78.

    • Memory (GiB): The amount of memory, up to 1039 GiB.

    For more information about instance types, see Instance Types.

    To function properly, Windows instances require at least a v3 processor generation, 2 vCores, and 4 GiB of memory.

  3. Click Apply to validate.

Modifying a VM Attribute Using Cockpit v2-beta

Before you begin:

  • To modify the VM Type attribute, you must stop the instance.

  • Other attributes can be modified when the instance is running or stopped.

  1. Click inside the VMs dashboard to make checkboxes appear.

  2. Check the box of the VM whose attributes you want to update.

    Multiselection is available.

    The VM is selected and an action menu appears.

  3. Hover over IconEdit Update VM.
    The attributes available for modification appear.

(optional) Modify the Security Groups Associated with the VM

  1. Click IconSecurityGroup Security Groups.
    The UPDATE SECURITY GROUPS dialog box appears.

  2. Click in the field to make the list of security groups appear.
    From the list, select the security group(s) you want to associate with the VM.

  3. To disassociate a security group from the VM, click IconClose next to the name of the security group.

  4. Click Update Security Group to validate.

(optional) Modify the VM Type

  1. Click the IconEdit VM Type.
    The UPDATE VM TYPE dialog box appears.

  2. Specify the following attributes for your instance:

    • CPU generation: The processor generation.

    • Performance: The performance flag.

      • Highest Performance: Provides maximum compute capacity on all the cores of the VM. This option is ideal for intensive compute applications.

      • High Performance: Provides high compute capacity on all the cores of the VM. This option offers small performance variability and applies to most cases.

      • Medium Performance: Provides performance with significant variability on all the cores of the VM. This option does not guarantee consistent performance, but is ideal for machines with low CPU demand.

    • Core(s): The number of vCores, up to 78.

    • Memory (GiB): The amount of memory, up to 1039 GiB.

    For more information about VM types, see Instance Types.

    To function properly, Windows instances require at least a v3 processor generation, 2 vCores, and 4 GiB of memory.

  3. Click Submit to validate.

(optional) Modify the Shutdown Behavior of the VM

  1. Click the IconForceStop Shutdown Behavior.
    The UPDATE SHUTDOWN BEHAVIOR dialog box appears.

  2. From the list, select one of the following values:

    • Stop: When you initiate the shutdown, the VM stops.

    • Delete: When you initiate the shutdown, the VM stops and is deleted.

    • Restart: When you initiate the shutdown, the VM stops, then automatically restarts.

      For more information, see About Instance Lifecycle > Termination.

  3. Click Update Shutdown Behavior to validate.

(optional) Modify the Deletion Protection of the VM

  1. Click the IconDeletionProtection Deletion Protection.
    The UPDATE DELETION PROTECTION dialog box appears.

  2. Switch the button on or off:

    • If on, you cannot delete the VM.

    • If off, you can delete it using Cockpit, the AWS CLI or the API.

  3. Click Update Deletion Protection to validate.

Modifying an Instance Attribute Using AWS CLI

Before you begin:

  • To modify the instance-type, user-data and ebs-optimized attributes, you must stop the instance.

  • Other attributes can be modified when the instance is running or stopped.

To modify an instance attribute, use the modify-instance-attribute command following this syntax:

You can modify only one attribute at a time.

Request sample
$ aws ec2 modify-instance-attribute \
    --profile YOUR_PROFILE \
    --instance-id i-12345678 \
    --attribute ATTRIBUTE_NAME \
    --value ATTRIBUTE_VALUE \
    --disable-api-termination \
    --block-device-mappings VALUE \
    --instance-type m1.large \
    --user-data VALUE \
    --instance-initiated-shutdown-behavior ATTRIBUTE_VALUE \
    --groups sg-12345678 \
    --source-dest-check \
    [--ebs-optimized NOT_SPECIFIED] \
    --endpoint https://fcu.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • instance-id: The ID of the instance whose attribute you want to modify.

  • (optional) attribute: The name of the attribute (userData | rootDeviceName | instanceType | groupSet | ebsOptimized | sourceDestCheck | blockDeviceMapping | disableApiTermination | instanceInitiatedShutdownBehavior).

  • (optional) value: The value of the attribute (only for the following attributes: userData, disableApiTermination, or instanceInitiatedShutdownBehavior).

  • (optional) disable-api-termination: If true, you cannot terminate the instance using Cockpit, the CLI or the API. If false, you can.

  • (optional) block-device-mappings: Information about BSU volumes attached to the instance. This attribute contains the following elements that you need to specify:

  • (optional) Ebs: Information about the volume attached to the instance. This element contains the following element that you need to specify:

    • (optional) DeleteOnTermination: By default or if set to true, the volume is deleted when the instance is terminated. If set to false, it is not.

      To modify the block-device-mappings attribute for several volumes at the same time, use the following syntax:

      '[{"DeviceName": "/dev/sda1", "Ebs": {"DeleteOnTermination": false}}, {"DeviceName": "/dev/sdb", "Ebs": {"DeleteOnTermination": false}}]'
  • (optional) instance-type: The type of instance (amount of vCores, memory, storage). For more information about instance types, see Instance Types.

    To function properly, Windows instances require at least a v3 processor generation, 2 vCores, and 4 GiB of memory.

  • (optional) user-data: New user data for the instance. For more information, see Configuring an Instance with User Data and OUTSCALE Tags.

    Existing user data is erased and replaced by the one you specify here.

    AWS CLI then encodes this user data to Base64. The maximum size for the Base64-encoded user data is 500 kibibytes (KiB).

  • (optional) instance-initiated-shutdown-behavior: The behavior when you initiate the shutdown of the instance. By default or if set to stop, the instance stops. If set to terminate, the instance stops and is terminated. If set to restart, the instance stops, then automatically restarts.

  • (optional) groups: One or more security groups IDs for the instance.

  • (optional) source-dest-check|no-source-dest-check: If set to source-dest-check, source/destination check of network traffic is enabled. If set to no-source-dest-check, it is disabled.

    You can modify the sourceDestCheck attribute only if the instance is in a VPC.

  • (optional) ebs-optimized: Whether the instance is BSU-optimized.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The specified attribute is modified.

Related Pages

Corresponding API Method

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.