Add IncludeInstances parameter to DescribeAutoScalingGroups API

Author: aws-sdk-dotnet-automation

generator/ServiceModels/autoscaling/autoscaling-2011-01-01.api.json

@@ -1262,6 +1262,7 @@
       "type":"structure",
       "members":{
         "AutoScalingGroupNames":{"shape":"AutoScalingGroupNames"},
+        "IncludeInstances":{"shape":"IncludeInstances"},
         "NextToken":{"shape":"XmlString"},
         "MaxRecords":{"shape":"MaxRecords"},
         "Filters":{"shape":"Filters"}
@@ -2157,6 +2158,7 @@
       ]
     },
     "IncludeDeletedGroups":{"type":"boolean"},
+    "IncludeInstances":{"type":"boolean"},
     "Instance":{
       "type":"structure",
       "required":[

generator/ServiceModels/autoscaling/autoscaling-2011-01-01.docs.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0",
-  "service": "<fullname>Amazon EC2 Auto Scaling</fullname> <p>Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.</p> <p>For more information, see the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html\">Amazon EC2 Auto Scaling User Guide</a> and the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html\">Amazon EC2 Auto Scaling API Reference</a>.</p>",
+  "service": "<fullname>Amazon EC2 Auto Scaling</fullname> <p>The <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html\">DescribeAutoScalingGroups</a> API operation might be throttled when retrieving details for an Auto Scaling group that contains many instances. By default, this operation returns details for all instances in the group. To help prevent throttling, you can set the <code>IncludeInstances</code> parameter to <code>false</code> to exclude instance details from the response.</p> <p>Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.</p> <p>For more information, see the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html\">Amazon EC2 Auto Scaling User Guide</a> and the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html\">Amazon EC2 Auto Scaling API Reference</a>.</p>",
   "operations": {
     "AttachInstances": "<p>Attaches one or more EC2 instances to the specified Auto Scaling group.</p> <p>When you attach instances, Amazon EC2 Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.</p> <p>If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-detach-attach-instances.html\">Detach or attach instances</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>",
     "AttachLoadBalancerTargetGroups": "<note> <p>This API operation is superseded by <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_AttachTrafficSources.html\">AttachTrafficSources</a>, which can attach multiple traffic sources types. We recommend using <code>AttachTrafficSources</code> to simplify how you manage traffic sources. However, we continue to support <code>AttachLoadBalancerTargetGroups</code>. You can use both the original <code>AttachLoadBalancerTargetGroups</code> API operation and <code>AttachTrafficSources</code> on the same Auto Scaling group.</p> </note> <p>Attaches one or more target groups to the specified Auto Scaling group.</p> <p>This operation is used with the following load balancer types: </p> <ul> <li> <p>Application Load Balancer - Operates at the application layer (layer 7) and supports HTTP and HTTPS. </p> </li> <li> <p>Network Load Balancer - Operates at the transport layer (layer 4) and supports TCP, TLS, and UDP. </p> </li> <li> <p>Gateway Load Balancer - Operates at the network layer (layer 3).</p> </li> </ul> <p>To describe the target groups for an Auto Scaling group, call the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeLoadBalancerTargetGroups.html\">DescribeLoadBalancerTargetGroups</a> API. To detach the target group from the Auto Scaling group, call the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DetachLoadBalancerTargetGroups.html\">DetachLoadBalancerTargetGroups</a> API.</p> <p>This operation is additive and does not detach existing target groups or Classic Load Balancers from the Auto Scaling group.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html\">Use Elastic Load Balancing to distribute traffic across the instances in your Auto Scaling group</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>. </p>",
@@ -966,6 +966,12 @@
         "DescribeScalingActivitiesType$IncludeDeletedGroups": "<p>Indicates whether to include scaling activity from deleted Auto Scaling groups.</p>"
       }
     },
+    "IncludeInstances": {
+      "base": null,
+      "refs": {
+        "AutoScalingGroupNamesType$IncludeInstances": "<p> Specifies whether to include information about Amazon EC2 instances in the response. When set to <code>true</code> (default), the response includes instance details. </p>"
+      }
+    },
     "Instance": {
       "base": "<p>Describes an EC2 instance.</p>",
       "refs": {

generator/ServiceModels/autoscaling/autoscaling-2011-01-01.normal.json

@@ -1552,6 +1552,10 @@
           "shape":"AutoScalingGroupNames",
           "documentation":"<p>The names of the Auto Scaling groups. By default, you can only specify up to 50 names. You can optionally increase this limit using the <code>MaxRecords</code> property.</p> <p>If you omit this property, all Auto Scaling groups are described.</p>"
         },
+        "IncludeInstances":{
+          "shape":"IncludeInstances",
+          "documentation":"<p> Specifies whether to include information about Amazon EC2 instances in the response. When set to <code>true</code> (default), the response includes instance details. </p>"
+        },
         "NextToken":{
           "shape":"XmlString",
           "documentation":"<p>The token for the next set of items to return. (You received this token from a previous call.)</p>"
@@ -3172,6 +3176,7 @@
       ]
     },
     "IncludeDeletedGroups":{"type":"boolean"},
+    "IncludeInstances":{"type":"boolean"},
     "Instance":{
       "type":"structure",
       "required":[
@@ -5983,5 +5988,5 @@
     },
     "ZonalShiftEnabled":{"type":"boolean"}
   },
-  "documentation":"<fullname>Amazon EC2 Auto Scaling</fullname> <p>Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.</p> <p>For more information, see the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html\">Amazon EC2 Auto Scaling User Guide</a> and the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html\">Amazon EC2 Auto Scaling API Reference</a>.</p>"
+  "documentation":"<fullname>Amazon EC2 Auto Scaling</fullname> <p>The <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html\">DescribeAutoScalingGroups</a> API operation might be throttled when retrieving details for an Auto Scaling group that contains many instances. By default, this operation returns details for all instances in the group. To help prevent throttling, you can set the <code>IncludeInstances</code> parameter to <code>false</code> to exclude instance details from the response.</p> <p>Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.</p> <p>For more information, see the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html\">Amazon EC2 Auto Scaling User Guide</a> and the <a href=\"https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html\">Amazon EC2 Auto Scaling API Reference</a>.</p>"
 }

sdk/src/Services/AutoScaling/Generated/Model/DescribeAutoScalingGroupsRequest.cs

@@ -52,6 +52,7 @@ public partial class DescribeAutoScalingGroupsRequest : AmazonAutoScalingRequest
     {
         private List<string> _autoScalingGroupNames = AWSConfigs.InitializeCollections ? new List<string>() : null;
         private List<Filter> _filters = AWSConfigs.InitializeCollections ? new List<Filter>() : null;
+        private bool? _includeInstances;
         private int? _maxRecords;
         private string _nextToken;
 
@@ -96,6 +97,25 @@ internal bool IsSetFilters()
             return this._filters != null && (this._filters.Count > 0 || !AWSConfigs.InitializeCollections); 
         }
 
+        /// <summary>
+        /// Gets and sets the property IncludeInstances. 
+        /// <para>
+        ///  Specifies whether to include information about Amazon EC2 instances in the response.
+        /// When set to <c>true</c> (default), the response includes instance details. 
+        /// </para>
+        /// </summary>
+        public bool IncludeInstances
+        {
+            get { return this._includeInstances.GetValueOrDefault(); }
+            set { this._includeInstances = value; }
+        }
+
+        // Check to see if IncludeInstances property is set
+        internal bool IsSetIncludeInstances()
+        {
+            return this._includeInstances.HasValue; 
+        }
+
         /// <summary>
         /// Gets and sets the property MaxRecords. 
         /// <para>

sdk/src/Services/AutoScaling/Generated/Model/Internal/MarshallTransformations/DescribeAutoScalingGroupsRequestMarshaller.cs

@@ -89,6 +89,10 @@ public IRequest Marshall(DescribeAutoScalingGroupsRequest publicRequest)
                         publicRequestlistValueIndex++;
                     }
                 }
+                if(publicRequest.IsSetIncludeInstances())
+                {
+                    request.Parameters.Add("IncludeInstances", StringUtils.FromBool(publicRequest.IncludeInstances));
+                }
                 if(publicRequest.IsSetMaxRecords())
                 {
                     request.Parameters.Add("MaxRecords", StringUtils.FromInt(publicRequest.MaxRecords));

sdk/src/Services/AutoScaling/Generated/_bcl35/AmazonAutoScalingClient.cs

@@ -38,6 +38,14 @@ namespace Amazon.AutoScaling
     ///
     /// Amazon EC2 Auto Scaling 
     /// <para>
+    /// The <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html">DescribeAutoScalingGroups</a>
+    /// API operation might be throttled when retrieving details for an Auto Scaling group
+    /// that contains many instances. By default, this operation returns details for all instances
+    /// in the group. To help prevent throttling, you can set the <c>IncludeInstances</c>
+    /// parameter to <c>false</c> to exclude instance details from the response.
+    /// </para>
+    ///  
+    /// <para>
     /// Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
     /// based on user-defined scaling policies, scheduled actions, and health checks.
     /// </para>

sdk/src/Services/AutoScaling/Generated/_bcl35/IAmazonAutoScaling.cs

@@ -32,6 +32,14 @@ namespace Amazon.AutoScaling
     ///
     /// Amazon EC2 Auto Scaling 
     /// <para>
+    /// The <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html">DescribeAutoScalingGroups</a>
+    /// API operation might be throttled when retrieving details for an Auto Scaling group
+    /// that contains many instances. By default, this operation returns details for all instances
+    /// in the group. To help prevent throttling, you can set the <c>IncludeInstances</c>
+    /// parameter to <c>false</c> to exclude instance details from the response.
+    /// </para>
+    ///  
+    /// <para>
     /// Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
     /// based on user-defined scaling policies, scheduled actions, and health checks.
     /// </para>

sdk/src/Services/AutoScaling/Generated/_bcl45/AmazonAutoScalingClient.cs

@@ -41,6 +41,14 @@ namespace Amazon.AutoScaling
     ///
     /// Amazon EC2 Auto Scaling 
     /// <para>
+    /// The <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html">DescribeAutoScalingGroups</a>
+    /// API operation might be throttled when retrieving details for an Auto Scaling group
+    /// that contains many instances. By default, this operation returns details for all instances
+    /// in the group. To help prevent throttling, you can set the <c>IncludeInstances</c>
+    /// parameter to <c>false</c> to exclude instance details from the response.
+    /// </para>
+    ///  
+    /// <para>
     /// Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
     /// based on user-defined scaling policies, scheduled actions, and health checks.
     /// </para>

sdk/src/Services/AutoScaling/Generated/_bcl45/IAmazonAutoScaling.cs

@@ -34,6 +34,14 @@ namespace Amazon.AutoScaling
     ///
     /// Amazon EC2 Auto Scaling 
     /// <para>
+    /// The <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html">DescribeAutoScalingGroups</a>
+    /// API operation might be throttled when retrieving details for an Auto Scaling group
+    /// that contains many instances. By default, this operation returns details for all instances
+    /// in the group. To help prevent throttling, you can set the <c>IncludeInstances</c>
+    /// parameter to <c>false</c> to exclude instance details from the response.
+    /// </para>
+    ///  
+    /// <para>
     /// Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
     /// based on user-defined scaling policies, scheduled actions, and health checks.
     /// </para>

sdk/src/Services/AutoScaling/Generated/_netstandard/AmazonAutoScalingClient.cs

@@ -41,6 +41,14 @@ namespace Amazon.AutoScaling
     ///
     /// Amazon EC2 Auto Scaling 
     /// <para>
+    /// The <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html">DescribeAutoScalingGroups</a>
+    /// API operation might be throttled when retrieving details for an Auto Scaling group
+    /// that contains many instances. By default, this operation returns details for all instances
+    /// in the group. To help prevent throttling, you can set the <c>IncludeInstances</c>
+    /// parameter to <c>false</c> to exclude instance details from the response.
+    /// </para>
+    ///  
+    /// <para>
     /// Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
     /// based on user-defined scaling policies, scheduled actions, and health checks.
     /// </para>