Added important considerations to the PutConformancePack and PutOrganizationConformancPack APIs.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/config/config-2014-11-12.api.json

@@ -1,5 +1,4 @@
 {
   "version": "1.0",
-  "examples": {
-  }
+  "examples": {}
 }

generator/ServiceModels/config/config-2014-11-12.docs.json

@@ -127,7 +127,9 @@ internal bool IsSetAwsRegion()
         /// <summary>
         /// Gets and sets the property Configuration. 
         /// <para>
-        /// The description of the resource configuration.
+        /// A JSON-encoded string that contains the contents for the resource configuration. This
+        /// string needs to be deserialized using <c>json.loads()</c> before you can access the
+        /// contents. 
         /// </para>
         /// </summary>
         public string Configuration
@@ -252,6 +254,15 @@ internal bool IsSetConfigurationStateId()
         /// <para>
         /// The recording frequency that Config uses to record configuration changes for the resource.
         /// </para>
+        ///  <note> 
+        /// <para>
+        /// This field only appears in the API response when <c>DAILY</c> recording is enabled
+        /// for a resource type. If this field is not present, <c>CONTINUOUS</c> recording is
+        /// enabled for that resource type. For more information on daily recording and continuous
+        /// recording, see <a href="https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-recording-frequency">Recording
+        /// Frequency</a> in the <i>Config Developer Guide</i>.
+        /// </para>
+        ///  </note>
         /// </summary>
         public RecordingFrequency RecordingFrequency
         {
@@ -341,8 +352,14 @@ internal bool IsSetResourceType()
         /// <summary>
         /// Gets and sets the property SupplementaryConfiguration. 
         /// <para>
-        /// Configuration attributes that Config returns for certain resource types to supplement
-        /// the information returned for the configuration parameter.
+        /// A string to string map that contains additional contents for the resource configuration.Config
+        /// returns this field for certain resource types to supplement the information returned
+        /// for the <c>configuration</c> field.
+        /// </para>
+        ///  
+        /// <para>
+        /// This string needs to be deserialized using <c>json.loads()</c> before you can access
+        /// the contents.
         /// </para>
         /// </summary>
         public Dictionary<string, string> SupplementaryConfiguration

generator/ServiceModels/config/config-2014-11-12.examples.json

@@ -297,11 +297,6 @@ internal bool IsSetMaximumExecutionFrequency()
         /// that can trigger an evaluation for the rule. If you do not specify a scope, evaluations
         /// are triggered when any resource in the recording group changes.
         /// </para>
-        ///  <note> 
-        /// <para>
-        /// The scope can be empty. 
-        /// </para>
-        ///  </note>
         /// </summary>
         public Scope Scope
         {

generator/ServiceModels/config/config-2014-11-12.normal.json

@@ -131,7 +131,9 @@ internal bool IsSetAwsRegion()
         /// <summary>
         /// Gets and sets the property Configuration. 
         /// <para>
-        /// The description of the resource configuration.
+        /// A JSON-encoded string that contains the contents for the resource configuration. This
+        /// string needs to be deserialized using <c>json.loads()</c> before you can access the
+        /// contents.
         /// </para>
         /// </summary>
         public string Configuration
@@ -174,8 +176,11 @@ internal bool IsSetConfigurationItemCaptureTime()
         /// This field is optional and is not guaranteed to be present in a configuration item
         /// (CI). If you are using daily recording, this field will be populated. However, if
         /// you are using continuous recording, this field will be omitted since the delivery
-        /// time is instantaneous as the CI is available right away. For more information on daily
-        /// recording and continuous recording, see <a href="https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-recording-frequency">Recording
+        /// time is instantaneous as the CI is available right away.
+        /// </para>
+        ///  
+        /// <para>
+        /// For more information on daily recording and continuous recording, see <a href="https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-recording-frequency">Recording
         /// Frequency</a> in the <i>Config Developer Guide</i>.
         /// </para>
         ///  </note>
@@ -279,6 +284,15 @@ internal bool IsSetConfigurationStateId()
         /// <para>
         /// The recording frequency that Config uses to record configuration changes for the resource.
         /// </para>
+        ///  <note> 
+        /// <para>
+        /// This field only appears in the API response when <c>DAILY</c> recording is enabled
+        /// for a resource type. If this field is not present, <c>CONTINUOUS</c> recording is
+        /// enabled for that resource type. For more information on daily recording and continuous
+        /// recording, see <a href="https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-recording-frequency">Recording
+        /// Frequency</a> in the <i>Config Developer Guide</i>.
+        /// </para>
+        ///  </note>
         /// </summary>
         public RecordingFrequency RecordingFrequency
         {
@@ -416,8 +430,14 @@ internal bool IsSetResourceType()
         /// <summary>
         /// Gets and sets the property SupplementaryConfiguration. 
         /// <para>
-        /// Configuration attributes that Config returns for certain resource types to supplement
-        /// the information returned for the <c>configuration</c> parameter.
+        /// A string to string map that contains additional contents for the resource configuration.Config
+        /// returns this field for certain resource types to supplement the information returned
+        /// for the <c>configuration</c> field.
+        /// </para>
+        ///  
+        /// <para>
+        /// This string to string map needs to be deserialized using <c>json.loads()</c> before
+        /// you can accessing the contents.
         /// </para>
         /// </summary>
         public Dictionary<string, string> SupplementaryConfiguration

sdk/src/Services/ConfigService/Generated/Model/BaseConfigurationItem.cs

@@ -81,7 +81,8 @@ internal bool IsSetArn()
         ///  
         /// <para>
         /// For service-linked configuration recorders, Config automatically assigns a name that
-        /// has the prefix "<c>AWS</c>" to a new service-linked configuration recorder.
+        /// has the prefix "<c>AWSConfigurationRecorderFor</c>" to a new service-linked configuration
+        /// recorder.
         /// </para>
         ///  <note> 
         /// <para>

sdk/src/Services/ConfigService/Generated/Model/ConfigRule.cs

@@ -45,33 +45,29 @@ namespace Amazon.ConfigService.Model
     /// </para>
     ///  <note> 
     /// <para>
-    ///  <b>Recommendation: Stop recording resource compliance before deleting rules</b> 
+    ///  <b>Recommendation: Consider excluding the <c>AWS::Config::ResourceCompliance</c>
+    /// resource type from recording before deleting rules</b> 
     /// </para>
     ///  
     /// <para>
-    /// It is highly recommended that you stop recording for the <c>AWS::Config::ResourceCompliance</c>
-    /// resource type before you delete rules in your account. Deleting rules creates CIs
-    /// for <c>AWS::Config::ResourceCompliance</c> and can affect your Config <a href="https://docs.aws.amazon.com/config/latest/developerguide/stop-start-recorder.html">configuration
-    /// recorder</a> costs. If you are deleting rules which evaluate a large number of resource
-    /// types, this can lead to a spike in the number of CIs recorded.
+    /// Deleting rules creates configuration items (CIs) for <c>AWS::Config::ResourceCompliance</c>
+    /// that can affect your costs for the configuration recorder. If you are deleting rules
+    /// which evaluate a large number of resource types, this can lead to a spike in the number
+    /// of CIs recorded.
     /// </para>
     ///  
     /// <para>
-    /// Best practice:
+    /// To avoid the associated costs, you can opt to disable recording for the <c>AWS::Config::ResourceCompliance</c>
+    /// resource type before deleting rules, and re-enable recording after the rules have
+    /// been deleted.
     /// </para>
-    ///  <ol> <li> 
-    /// <para>
-    /// Stop recording <c>AWS::Config::ResourceCompliance</c> 
-    /// </para>
-    ///  </li> <li> 
-    /// <para>
-    /// Delete rule(s)
-    /// </para>
-    ///  </li> <li> 
+    ///  
     /// <para>
-    /// Turn on recording for <c>AWS::Config::ResourceCompliance</c> 
+    /// However, since deleting rules is an asynchronous process, it might take an hour or
+    /// more to complete. During the time when recording is disabled for <c>AWS::Config::ResourceCompliance</c>,
+    /// rule evaluations will not be recorded in the associated resource’s history.
     /// </para>
-    ///  </li> </ol> </note>
+    ///  </note>
     /// </summary>
     public partial class DeleteConfigRuleRequest : AmazonConfigServiceRequest
     {

sdk/src/Services/ConfigService/Generated/Model/ConfigurationItem.cs

@@ -39,6 +39,31 @@ namespace Amazon.ConfigService.Model
     /// Config sets the conformance pack to <c>DELETE_IN_PROGRESS</c> until the deletion is
     /// complete. You cannot update a conformance pack while it is in this state.
     /// </para>
+    ///  <note> 
+    /// <para>
+    ///  <b>Recommendation: Consider excluding the <c>AWS::Config::ResourceCompliance</c>
+    /// resource type from recording before deleting rules</b> 
+    /// </para>
+    ///  
+    /// <para>
+    /// Deleting rules creates configuration items (CIs) for <c>AWS::Config::ResourceCompliance</c>
+    /// that can affect your costs for the configuration recorder. If you are deleting rules
+    /// which evaluate a large number of resource types, this can lead to a spike in the number
+    /// of CIs recorded.
+    /// </para>
+    ///  
+    /// <para>
+    /// To avoid the associated costs, you can opt to disable recording for the <c>AWS::Config::ResourceCompliance</c>
+    /// resource type before deleting rules, and re-enable recording after the rules have
+    /// been deleted.
+    /// </para>
+    ///  
+    /// <para>
+    /// However, since deleting rules is an asynchronous process, it might take an hour or
+    /// more to complete. During the time when recording is disabled for <c>AWS::Config::ResourceCompliance</c>,
+    /// rule evaluations will not be recorded in the associated resource’s history.
+    /// </para>
+    ///  </note>
     /// </summary>
     public partial class DeleteConformancePackRequest : AmazonConfigServiceRequest
     {