Made the instructions more clear; Changed the default maxGrowSizePercent to 200%.

Author: kcantrel

Management-Utilities/auto_set_fsxn_auto_grow/README.md

@@ -1,7 +1,7 @@
 # Automatically Set Auto Size mode to Grow on FSx for NetApp ONTAP Volumes
 
 ## Introduction
-This project helps to mitigate the issue of not being able to set the auto size mode
+This sample shows one way to mitigate the issue of not being able to set the auto size mode
 on an FSxN volume when creating it from the AWS console or API. It does this by providing
 a Lambda function that will set the mode for you, and instructions on how to set up a
 CloudWatch event to trigger the Lambda function whenever a volume is created. With this
@@ -11,6 +11,13 @@ set up the way you want for all volumes.
 ## Set Up
 There are just a few things you have to do to set this up:
 
+### Create secrets in AWS Secrets Manager
+Create a secret in Secrets Manager for each of the FSxN file systems you want to manage with
+this script. Each secret should have the key value pairs. One that specifies the
+user account to use when issuing API calls, and the other that specifies the password for
+that account. Note that if you use the same username and password, it is okay
+to use the same secret for multiple file systems.
+
 ### Create a role for the Lambda function
 The Lambda function doesn't leverage that many AWS services, so only a few permissions are required:
 
@@ -37,24 +44,35 @@ FSxN file system is attached to.
 ### Create the Lambda Function
 Create a Lambda function with the following parameters:
 
-- Authored from scratch
-- Uses the Python runtime
+- Authored from scratch.
+- Uses the Python runtime.
 - Set the permissions to the role created above.
-- Enable VPC. Found under the Advanced Settings
-  - Attached to the VPC that contains the FSxN file system
-  - Attached to the Subnets that contain the FSxN file system.
-  - Attached a security group that allows access from any IP within the two subnets.
+- Enable VPC. Found under the Advanced Settings.
+    - Attached to the VPC that contains the FSxN file system
+    - Attached to the Subnets that contain the FSxN file system.
+    - Attached a security group that allows access from any IP within the two subnets.
 
 After you create the function, you will be able to insert the code included with this 
-project into the code box. Once you have inserted the code, modify the "secretsTable"
-array to provide the secrets name, and the keys for the username as password for each
-of the FSxN File Systems that you want to manage with this script. Also, set the
-secretsManagerRegion variable to the region where your secrets are stored. Finally
-set the auto size parameters (autoSizeMode, growThresholdPercentage,
-maxGrowSizePercentage, shrinkThresholdPercentage, minShrinkSizePercentage and
-maxWaitTime) as you see fit. NOTE: Do note delete the variables
-or set them to None or empty strings, as the script will fail to run appropriately
-if done so.
+sample into the code box. Once you have inserted the code, modify the definitions
+of the following variables to suit your needs:
+- secretsTable - This is an array that defines the secrets created above. Each element in the array
+is a dictionary with the following keys:
+    - secretName - The name of the secret in Secrets Manager.
+    - usernameKey - The name of the key in the secret that contains the username.
+    - passwordKey - The name of the key in the secret that contains the password.
+- secretsManagerRegion - Defines the region where your secrets are stored.
+- autoSizeMode - Defines the auto size mode you want to set the volume to. Valid values are:
+    - grow - The volume will automatically grow when it reaches the grow threshold.
+    - grow_shrink - The volume will automatically grow and shrink when it eachs the shrink threshold.
+    - off - The volume will not automatically grow or shrink.
+- growThresholdPercentage - The percentage of the volume that must be used before the volume will grow.
+- maxGrowSizePercentage - The maximum size the volume can auto grow to expressed in terms of a percentage of the volume size. The default is 200%.
+- shrinkThresholdPercentage - The percentage of the volume that must be used before the volume will shrink.
+- minShrinkSizePercentage - The minimum size the volume can auto shrink to expressed in terms of a percentage of the volume size. The default is 50%.
+- maxWaitTime - The maximum time, in seconds, the script will wait for the volume to be created before it will give up and exit.
+
+** NOTE:** Do not delete the variables or set them to None or empty
+strings, as the script will not run properly if done so.
 
 Once you have updated the program, click on the "Deploy" button.
 

Management-Utilities/auto_set_fsxn_auto_grow/set_fsxn_volume_auto_grow.py

@@ -49,7 +49,7 @@
 growThresholdPercentage = 85
 #
 # Set the maximum grow size for the volume in terms of the percentage of the provisioned size.
-maxGrowSizePercentage = 120
+maxGrowSizePercentage = 200
 #
 # Set the shrink-threshold-percentage for the volume. This is the percentage of the volume that must be free before it shrinks.
 shrinkThresholdPercentage = 50
@@ -62,11 +62,11 @@
 # the auto size parameters. It will wait up to the number of seconds specified
 # below before giving up. NOTE: You must set the timeout of this function
 # to at least the number of seconds specified here, and probably two times
-# the number here to account for the time it takes to do the API call,
+# the number to account for the time it takes to do the API calls,
 # otherwise the Lambda timeout feature will kill it before it is able to
-# iterate as many times as you want it to. Also note that the main reason for
+# wait as long you want it to. Also note that the main reason for
 # it to take a while for a volume to get created is when multiple are being
-# created at the same time, so if you have automation that might create a lot of
+# created at the same time. So, if you have automation that might create a lot of
 # volumes at the same time, you might need to either adjust this number really
 # high, or come up with another way to get the auto size mode.
 maxWaitTime=60