Amazon Web Services Plugin Commands

Cloud Power Commands

The following table describes the Cloud Power Commands. These commands are available starting from BigFix Platform version 11.0.3.

Name Syntax Description
start instance start instance This command starts the target Cloud instance.
stop instance stop instance This command stops the target Cloud instance.
restart instance restart instance This command restarts the target Cloud instance.
stop force instance stop force instance This command forces the target Cloud instance shutdown operation.
Note: The exit codes returned by the actions performed in the BigFix Console match with the exit codes provided by Amazon Web Services (AWS) for the corresponding actions.

Required privileges:

  • ec2.StartInstances
  • ec2.StopInstances
  • ec2.RebootInstances

In addition to the above listed privileges, your role also requires KMS permissions in order to perform the actions because EBS volumes, that instances use, are encrypted and without these permissions you cannot perform the actions on the device.

Install agent Command

The following table describes the install agent Command. This command is available starting from BigFix Platform versions 11.0.0 and 10.0.2.

Name Syntax Description
install agent install agent This command installs the BigFix agent on the target machine.

Action Commands

The following table describes the Action Commands. These commands are available starting from BigFix Platform version 11.0.6.

Name Syntax Description
set tag

set tag "<Key>"

set tag "<Key>" "<Value>"

 Adds or updates a tag with the specified key and value on the target instance.
delete tag delete tag "<Key>" Removes the tag with the specified key from the target instance.

Required privileges:

  • ec2:CreateTags (Required for "set tag")
  • ec2:DeleteTags (Required for "delete tag")