fix: documenation for usageplans

versions/2016-10-31.md

@@ -1041,8 +1041,7 @@ Define Lambda and Cognito `Authorizers` and specify a `DefaultAuthorizer`. If yo
 Auth:
   ApiKeyRequired: true # OPTIONAL
   UsagePlan: # OPTIONAL
-    CreateUsagePlan: SINGLE # REQUIRED if UsagePlan property is set. accepted values: SINGLE, SHARED, NONE
-    # UsagePlanId: !Ref usagePlan # REQUIRED if CreateUsagePlan is None
+    CreateUsagePlan: PER_API # REQUIRED if UsagePlan property is set. accepted values: PER_API, SHARED, NONE
   DefaultAuthorizer: MyCognitoAuth # OPTIONAL, if you use IAM permissions, specify AWS_IAM.
   AddDefaultAuthorizerToCorsPreflight: false # OPTIONAL; Default: true
   ResourcePolicy:
@@ -1125,16 +1124,13 @@ Auth:
 ```
 
 **UsagePlan:**
-Create Usage Plan for API Auth. Usage Plans can be set in Globals level as well for Apis. 
-SAM creates a single Usage Plan, Api Key and Usage Plan Api Key resources if `CreateUsagePlan` is `SHARED` and a Usage Plan, Api Key and Usage Plan Api Key resources per Api when `CreateUsagePlan` is `SINGLE`.
-SAM creates Api Key and Usage Plan Api Key and expects `UsagePlanId` property to be set if `CreateUsagePlan` is NONE 
+Create Usage Plan for API Auth. Usage Plans can be set in Globals level as well for RestApis. 
+SAM creates a single Usage Plan, Api Key and Usage Plan Api Key resources if `CreateUsagePlan` is `SHARED` and a Usage Plan, Api Key and Usage Plan Api Key resources per Api when `CreateUsagePlan` is `PER_API`. 
 
 ```yaml
     Auth:
       UsagePlan:  
-        CreateUsagePlan: NONE # Required  supported values: SHARED | NONE | SINGLE
-        UsagePlanId: !Ref usagePlan # This field is required if CreateUsagePlan is NONE
-
+        CreateUsagePlan: NONE # Required  supported values: SHARED | NONE | PER_API
 ```
 #### Function Auth Object