docs(client-api-gateway): Documentation updates for Amazon API Gateway

Author: awstools

clients/client-api-gateway/src/models/models_0.ts

@@ -2189,7 +2189,7 @@ export interface MethodSetting {
 
   /**
    * @public
-   * <p>Specifies whether data trace logging is enabled for this method, which affects the log entries pushed to Amazon CloudWatch Logs.</p>
+   * <p>Specifies whether data trace logging is enabled for this method, which affects the log entries pushed to Amazon CloudWatch Logs. This can be useful to troubleshoot APIs, but can result in logging sensitive data. We recommend that you don't enable this option for production APIs.</p>
    */
   dataTraceEnabled?: boolean;
 

codegen/sdk-codegen/aws-models/api-gateway.json

@@ -9144,7 +9144,7 @@
           "target": "com.amazonaws.apigateway#Boolean",
           "traits": {
             "smithy.api#default": false,
-            "smithy.api#documentation": "<p>Specifies whether data trace logging is enabled for this method, which affects the log entries pushed to Amazon CloudWatch Logs.</p>"
+            "smithy.api#documentation": "<p>Specifies whether data trace logging is enabled for this method, which affects the log entries pushed to Amazon CloudWatch Logs. This can be useful to troubleshoot APIs, but can result in logging sensitive data. We recommend that you don't enable this option for production APIs.</p>"
           }
         },
         "throttlingBurstLimit": {