
modify-instance-attribute
*************************


DESCRIPTION
===========

Modifies an attribute of an instance.


SYNOPSIS
========

   aws ec2 modify-instance-attribute
     --instance-id <value>
     [--ramdisk <value>]
     [--kernel <value>]
     [--source-dest-check <value>]
     [--user-data <value>]
     [--attribute <value>]
     [--instance-initiated-shutdown-behavior <value>]
     [--value <value>]
     [--block-device-mappings <value>]
     [--groups <value>]
     [--ebs-optimized <value>]
     [--disable-api-termination <value>]
     [--instance-type <value>]


REQUIRED PARAMETERS
===================

"--instance-id"  (string)
   The ID of the instance whose attribute is being modified.


OPTIONAL PARAMETERS
===================

"--ramdisk"  (structure)
   "value"  (string)String value

   *Parameter Syntax*

      {
        "value": "string"
      }

"--kernel"  (structure)
   "value"  (string)String value

   *Parameter Syntax*

      {
        "value": "string"
      }

"--source-dest-check"  (structure)
   "value"  (boolean)Boolean value

   *Parameter Syntax*

      {
        "value": true|false
      }

"--user-data"  (structure)
   "value"  (string)String value

   *Parameter Syntax*

      {
        "value": "string"
      }

"--attribute"  (string)
   The name of the attribute being modified.

   Available attribute names: "instanceType" , "kernel" , "ramdisk" ,
   "userData" , "disableApiTermination" ,
   "instanceInitiatedShutdownBehavior" , "rootDevice" ,
   "blockDeviceMapping"

"--instance-initiated-shutdown-behavior"  (structure)
   "value"  (string)String value

   *Parameter Syntax*

      {
        "value": "string"
      }

"--value"  (string)
   The new value of the instance attribute being modified.

   Only valid when "kernel" , "ramdisk" , "userData" ,
   "disableApiTermination" or "instanceInitiateShutdownBehavior" is
   specified as the attribute being modified.

"--block-device-mappings"  (list)
   The new block device mappings for the instance whose attributes are
   being modified.

   Only valid when blockDeviceMapping is specified as the attribute
   being modified.

      (structure)
         Specifies how an instance's block devices should be mapped on
         a running instance.

         "device_name"  (string)
            The device name (e.g., "/dev/sdh" ) at which the block
            device is exposed on the instance.

         "virtual_name"  (string)
            The virtual device name.

         "no_device"  (string)
            When set to the empty string, specifies that the device
            name in this object should not be mapped to any real
            device.

         "ebs"  (structure)
            The EBS instance block device specification describing the
            EBS block device to map to the specified device name on a
            running instance.

            "delete_on_termination"  (boolean)
               Specifies whether the Amazon EBS volume is deleted on
               instance termination.

            "volume_id"  (string)
               The ID of the EBS volume that should be mounted as a
               block device on an Amazon EC2 instance.

   *Parameter Syntax*

      [
        {
          "device_name": "string",
          "virtual_name": "string",
          "no_device": "string",
          "ebs": {
            {
              "delete_on_termination": true|false,
              "volume_id": "string"
            }
        }
        ...
      ]

"--groups"  (list of string)

   *Parameter Syntax*

      ["string", ...]

"--ebs-optimized"  (structure)
   "value"  (boolean)Boolean value

   *Parameter Syntax*

      {
        "value": true|false
      }

"--disable-api-termination"  (structure)
   "value"  (boolean)Boolean value

   *Parameter Syntax*

      {
        "value": true|false
      }

"--instance-type"  (structure)
   "value"  (string)String value

   *Parameter Syntax*

      {
        "value": "string"
      }
