ModifyInstanceAttribute

previous page next page

Description

Modifies an attribute of an instance.

Name	Description	Required
`InstanceId`	The instance ID. Type: String Default: None	Yes
`Attribute=kernel`	Modifies the ID of the kernel associated with the AMI. Type: String Default: None	No
`Attribute=ramdisk`	Modifies the ID of the RAM disk associated with the AMI. Type: String Default: None	No
`Attribute=userData`	MIME, Base64-encoded user data. Type: String Default: None	No
`Attribute=disableApiTermination`	Modifies whether the instance can be terminated using the APIs. You must modify this attribute before you can terminate any "locked" instances from the APIs. Type: Boolean Default: true	No
`Attribute=instanceInitiatedShutdownBehavior`	Specifies whether the instance's Amazon EBS volumes are stopped or terminated when the instance is shut down. Type: Boolean Valid Values: `stop` \| `terminate` Default: true	No
`Attribute=blockDeviceMapping`	Modifies the mapping that defines native device names to use when exposing virtual devices. Type: String Default: None	No

Name Description

Name	Description
`ModifyInstanceAttributeResponseType`	`ModifyInstanceAttributeResponseType` element. Type:

ModifyInstanceAttributeResponseType

ModifyInstanceAttributeResponseType element.

Type:

Ancestor: None

Children: requestId, return

requestId

The ID of the request.

Type: xsd:string

Ancestor: ModifyInstanceAttributeResponseType

Children: None

return

Returns true if successful. Otherwise, returns an error.

Type: xsd:boolean

Ancestor: ModifyInstanceAttributeResponseType

Children: None

This example changed the kernel for the instance.

https://ec2.amazonaws.com/?Action=ModifyInstanceAttribute&InstanceId=i-10a64379&Attribute=kernel&Value=aki-f70657b2&AuthParams

<ModifyInstanceAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
  <return>true</return>
</ModifyInstanceAttributeResponse>

previous page start next page