Merge pull request #328 from rnhurt/instance-stop-protection

Add instance-stop-protection functions

Author: mbailey

aliases

@@ -114,6 +114,9 @@ alias instance-stack='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-stack'
 alias instance-start='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-start'
 alias instance-state='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-state'
 alias instance-stop='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-stop'
+alias instance-stop-protection='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-stop-protection'
+alias instance-stop-protection-disable='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-stop-protection-disable'
+alias instance-stop-protection-enable='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-stop-protection-enable'
 alias instance-subnet='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-subnet'
 alias instance-tag='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-tag'
 alias instance-tag-create='${BMA_HOME:-$HOME/.bash-my-aws}/bin/bma instance-tag-create'

bash_completion.sh

@@ -185,6 +185,9 @@ complete -F _bma_instances_completion instance-stack
 complete -F _bma_instances_completion instance-start
 complete -F _bma_instances_completion instance-state
 complete -F _bma_instances_completion instance-stop
+complete -F _bma_instances_completion instance-stop-protection
+complete -F _bma_instances_completion instance-stop-protection-disable
+complete -F _bma_instances_completion instance-stop-protection-enable
 complete -F _bma_instances_completion instance-subnet
 complete -F _bma_instances_completion instance-tag
 complete -F _bma_instances_completion instance-tag-create

docs/command-reference.md

@@ -663,20 +663,43 @@ Stop EC2 Instance(s)
     i-5d74753e210bfe04d  PreviousState=running  CurrentState=stopping
 
 
+### instance-stop-protection
+
+List current state of stop Protection for EC2 Instance(s)
+
+    USAGE: instance-stop-protection instance-id [instance-id]
+
+    $ instances | instance-stop-protection
+    i-4e15ece1de1a3f869 DisableApiStop=true
+    i-89cefa9403373d7a5 DisableApiStop=false
+    i-806d8f1592e2a2efd DisableApiStop=false
+    i-61e86ac6be1e2c193 DisableApiStop=false
+
+### instance-stop-protection-disable
+
+Disable EC2 Instance stop protection
+
+    USAGE: instance-stop-protection-disable instance-id [instance-id]
+
+
+### instance-stop-protection-enable
+
+Enable EC2 Instance stop protection
+
+    USAGE: instance-stop-protection-enable instance-id [instance-id]
+
 ### instance-subnet
 
 List subnet for EC2 Instance(s)
 
     USAGE: instance-subnets instance-id [instance-id]
 
-
 ### instance-tags
 
 List tags applied EC2 Instance(s)
 
     USAGE: instance-tags instance-id [instance-id]
 
-
 ### instance-tag
 
 List named tag on EC2 Instance(s)

lib/instance-functions

@@ -471,6 +471,91 @@ instance-subnet() {
   column -s$'\t' -t
 }
 
+instance-stop-protection() {
+
+  # List current state of Stop Protection for EC2 Instance(s)
+  #
+  #     USAGE: instance-stop-protection instance-id [instance-id]
+  #
+  #     $ instances | instance-termination-protection
+  #     i-4e15ece1de1a3f869 DisableApiStop=true
+  #     i-89cefa9403373d7a5 DisableApiStop=false
+  #     i-806d8f1592e2a2efd DisableApiStop=false
+  #     i-61e86ac6be1e2c193 DisableApiStop=false
+
+  local instance_ids=$(skim-stdin "$@")
+  [[ -z $instance_ids ]] && __bma_usage "instance-id [instance-id]" && return 1
+
+  for instance_id in $instance_ids; do
+    aws ec2 describe-instance-attribute \
+      --attribute disableApiStop        \
+      --instance-id "$instance_id"      \
+      --output text                     \
+      --query "[
+        InstanceId,
+        join('=', [
+          'DisableApiStop',
+          to_string(DisableApiStop.Value)
+        ])
+      ]"
+  done
+}
+
+
+instance-stop-protection-disable() {
+
+  # Disable EC2 Instance stop protection
+  #
+  #     USAGE: instance-stop-protection-disable instance-id [instance-id]
+
+  local instance_ids=$(skim-stdin "$@")
+  [[ -z $instance_ids ]] && __bma_usage "instance-id [instance-id]" && return 1
+
+  echo "You are about to disable stop protection on the following instances:"
+  echo "$instance_ids" | tr ' ' "\n" | instances
+  [ -t 0 ] || exec </dev/tty # reattach keyboard to STDIN
+  local regex_yes="^[Yy]$"
+  read -p "Are you sure you want to continue? " -n 1 -r
+  echo
+  if [[ $REPLY =~ $regex_yes ]]
+  then
+    for instance_id in $instance_ids; do
+      aws ec2 modify-instance-attribute   \
+        --attribute disableApiStop        \
+        --value false                     \
+        --instance-id "$instance_id"
+    done
+  fi
+}
+
+
+instance-stop-protection-enable() {
+
+  # Enable EC2 Instance stop protection
+  #
+  #     USAGE: instance-stop-protection-enable instance-id [instance-id]
+
+  local instance_ids=$(skim-stdin "$@")
+  [[ -z $instance_ids ]] && __bma_usage "instance-id [instance-id]" && return 1
+
+  echo "You are about to enable stop protection on the following instances:"
+  echo "$instance_ids" | tr ' ' "\n" | instances
+  [ -t 0 ] || exec </dev/tty # reattach keyboard to STDIN
+  local regex_yes="^[Yy]$"
+  read -p "Are you sure you want to continue? " -n 1 -r
+  echo
+  if [[ $REPLY =~ $regex_yes ]]
+  then
+    for instance_id in $instance_ids; do
+      aws ec2 modify-instance-attribute   \
+        --attribute disableApiStop        \
+        --value true                      \
+        --instance-id "$instance_id"
+    done
+  fi
+}
+
+
 instance-tags() {
 
   # List tags applied EC2 Instance(s)