Add IncludeRoot parameters to GetCatalogs API to return root catalog.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/glue/glue-2017-03-31.api.json

@@ -9054,7 +9054,8 @@
         "ParentCatalogId":{"shape":"CatalogIdString"},
         "NextToken":{"shape":"Token"},
         "MaxResults":{"shape":"PageSize"},
-        "Recursive":{"shape":"Boolean"}
+        "Recursive":{"shape":"Boolean"},
+        "IncludeRoot":{"shape":"NullableBoolean"}
       }
     },
     "GetCatalogsResponse":{

generator/ServiceModels/glue/glue-2017-03-31.docs.json

@@ -1003,7 +1003,7 @@
         "CrawlerMetrics$StillEstimating": "<p>True if the crawler is still estimating how long it will take to complete this run.</p>",
         "DataLakeAccessProperties$DataLakeAccess": "<p>Turns on or off data lake access for Apache Spark applications that access Amazon Redshift databases in the Data Catalog from any non-Redshift engine, such as Amazon Athena, Amazon EMR, or Glue ETL.</p>",
         "DataLakeAccessPropertiesOutput$DataLakeAccess": "<p>Turns on or off data lake access for Apache Spark applications that access Amazon Redshift databases in the Data Catalog.</p>",
-        "GetCatalogsRequest$Recursive": "<p>When specified as true, iterates through the account and returns all catalog resources (including top-level resources and child resources)</p>",
+        "GetCatalogsRequest$Recursive": "<p>Whether to list all catalogs across the catalog hierarchy, starting from the <code>ParentCatalogId</code>. Defaults to <code>false</code> . When <code>true</code>, all catalog objects in the <code>ParentCatalogID</code> hierarchy are enumerated in the response.</p>",
         "GetConnectionRequest$HidePassword": "<p>Allows you to retrieve the connection metadata without returning the password. For instance, the Glue console uses this flag to retrieve the connection, and does not display the password. Set this parameter when the caller might not have permission to use the KMS key to decrypt the password, but it does have permission to access the rest of the connection properties.</p>",
         "GetConnectionsRequest$HidePassword": "<p>Allows you to retrieve the connection metadata without returning the password. For instance, the Glue console uses this flag to retrieve the connection, and does not display the password. Set this parameter when the caller might not have permission to use the KMS key to decrypt the password, but it does have permission to access the rest of the connection properties.</p>",
         "GetUnfilteredPartitionMetadataResponse$IsRegisteredWithLakeFormation": "<p>A Boolean value that indicates whether the partition location is registered with Lake Formation.</p>",
@@ -7565,6 +7565,7 @@
         "FindMatchesParameters$EnforceProvidedLabels": "<p>The value to switch on or off to force the output to match the provided labels from users. If the value is <code>True</code>, the <code>find matches</code> transform forces the output to match the provided labels. The results override the normal conflation results. If the value is <code>False</code>, the <code>find matches</code> transform does not ensure all the labels provided are respected, and the results rely on the trained model.</p> <p>Note that setting this value to true may increase the conflation execution time.</p>",
         "GetBlueprintRequest$IncludeBlueprint": "<p>Specifies whether or not to include the blueprint in the response.</p>",
         "GetBlueprintRequest$IncludeParameterSpec": "<p>Specifies whether or not to include the parameter specification.</p>",
+        "GetCatalogsRequest$IncludeRoot": "<p>Whether to list the default catalog in the account and region in the response. Defaults to <code>false</code>. When <code>true</code> and <code>ParentCatalogId = NULL | Amazon Web Services Account ID</code>, all catalogs and the default catalog are enumerated in the response.</p> <p>When the <code>ParentCatalogId</code> is not equal to null, and this attribute is passed as <code>false</code> or <code>true</code>, an <code>InvalidInputException</code> is thrown.</p>",
         "GetWorkflowRequest$IncludeGraph": "<p>Specifies whether to include a graph when returning the workflow resource metadata.</p>",
         "GetWorkflowRunRequest$IncludeGraph": "<p>Specifies whether to include the workflow graph in response or not.</p>",
         "GetWorkflowRunsRequest$IncludeGraph": "<p>Specifies whether to include the workflow graph in response or not.</p>",
@@ -10352,12 +10353,12 @@
         "GetDataQualityRulesetEvaluationRunResponse$Timeout": "<p>The timeout for a run in minutes. This is the maximum time that a run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours).</p>",
         "GetMLTransformResponse$Timeout": "<p>The timeout for a task run for this transform in minutes. This is the maximum time that a task run for this transform can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours).</p>",
         "Job$Timeout": "<p>The job timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours) for batch jobs.</p> <p>Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the value is left blank, the job will be restarted after 7 days based if you have not setup a maintenance window. If you have setup maintenance window, it will be restarted during the maintenance window after 7 days.</p>",
-        "JobRun$Timeout": "<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job.</p> <p>Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the value is left blank, the job will be restarted after 7 days based if you have not setup a maintenance window. If you have setup maintenance window, it will be restarted during the maintenance window after 7 days.</p>",
+        "JobRun$Timeout": "<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job.</p> <p>Jobs must have timeout values less than 7 days or 10080 minutes. Otherwise, the jobs will throw an exception.</p> <p>When the value is left blank, the timeout is defaulted to 2880 minutes.</p> <p>Any existing Glue jobs that had a timeout value greater than 7 days will be defaulted to 7 days. For instance if you have specified a timeout of 20 days for a batch job, it will be stopped on the 7th day.</p>",
         "JobUpdate$Timeout": "<p>The job timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours) for batch jobs.</p> <p>Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the value is left blank, the job will be restarted after 7 days based if you have not setup a maintenance window. If you have setup maintenance window, it will be restarted during the maintenance window after 7 days.</p>",
         "MLTransform$Timeout": "<p>The timeout in minutes of the machine learning transform.</p>",
         "StartDataQualityRuleRecommendationRunRequest$Timeout": "<p>The timeout for a run in minutes. This is the maximum time that a run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours).</p>",
         "StartDataQualityRulesetEvaluationRunRequest$Timeout": "<p>The timeout for a run in minutes. This is the maximum time that a run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours).</p>",
-        "StartJobRunRequest$Timeout": "<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job. </p> <p>Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the value is left blank, the job will be restarted after 7 days based if you have not setup a maintenance window. If you have setup maintenance window, it will be restarted during the maintenance window after 7 days.</p>",
+        "StartJobRunRequest$Timeout": "<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job. </p> <p>Jobs must have timeout values less than 7 days or 10080 minutes. Otherwise, the jobs will throw an exception.</p> <p>When the value is left blank, the timeout is defaulted to 2880 minutes.</p> <p>Any existing Glue jobs that had a timeout value greater than 7 days will be defaulted to 7 days. For instance if you have specified a timeout of 20 days for a batch job, it will be stopped on the 7th day.</p>",
         "UpdateMLTransformRequest$Timeout": "<p>The timeout for a task run for this transform in minutes. This is the maximum time that a task run for this transform can consume resources before it is terminated and enters <code>TIMEOUT</code> status. The default is 2,880 minutes (48 hours).</p>"
       }
     },

generator/ServiceModels/glue/glue-2017-03-31.normal.json

@@ -13402,7 +13402,11 @@
         },
         "Recursive":{
           "shape":"Boolean",
-          "documentation":"<p>When specified as true, iterates through the account and returns all catalog resources (including top-level resources and child resources)</p>"
+          "documentation":"<p>Whether to list all catalogs across the catalog hierarchy, starting from the <code>ParentCatalogId</code>. Defaults to <code>false</code> . When <code>true</code>, all catalog objects in the <code>ParentCatalogID</code> hierarchy are enumerated in the response.</p>"
+        },
+        "IncludeRoot":{
+          "shape":"NullableBoolean",
+          "documentation":"<p>Whether to list the default catalog in the account and region in the response. Defaults to <code>false</code>. When <code>true</code> and <code>ParentCatalogId = NULL | Amazon Web Services Account ID</code>, all catalogs and the default catalog are enumerated in the response.</p> <p>When the <code>ParentCatalogId</code> is not equal to null, and this attribute is passed as <code>false</code> or <code>true</code>, an <code>InvalidInputException</code> is thrown.</p>"
         }
       }
     },
@@ -17476,7 +17480,7 @@
         },
         "Timeout":{
           "shape":"Timeout",
-          "documentation":"<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job.</p> <p>Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the value is left blank, the job will be restarted after 7 days based if you have not setup a maintenance window. If you have setup maintenance window, it will be restarted during the maintenance window after 7 days.</p>"
+          "documentation":"<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job.</p> <p>Jobs must have timeout values less than 7 days or 10080 minutes. Otherwise, the jobs will throw an exception.</p> <p>When the value is left blank, the timeout is defaulted to 2880 minutes.</p> <p>Any existing Glue jobs that had a timeout value greater than 7 days will be defaulted to 7 days. For instance if you have specified a timeout of 20 days for a batch job, it will be stopped on the 7th day.</p>"
         },
         "MaxCapacity":{
           "shape":"NullableDouble",
@@ -23714,7 +23718,7 @@
         },
         "Timeout":{
           "shape":"Timeout",
-          "documentation":"<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job. </p> <p>Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the value is left blank, the job will be restarted after 7 days based if you have not setup a maintenance window. If you have setup maintenance window, it will be restarted during the maintenance window after 7 days.</p>"
+          "documentation":"<p>The <code>JobRun</code> timeout in minutes. This is the maximum time that a job run can consume resources before it is terminated and enters <code>TIMEOUT</code> status. This value overrides the timeout value set in the parent job. </p> <p>Jobs must have timeout values less than 7 days or 10080 minutes. Otherwise, the jobs will throw an exception.</p> <p>When the value is left blank, the timeout is defaulted to 2880 minutes.</p> <p>Any existing Glue jobs that had a timeout value greater than 7 days will be defaulted to 7 days. For instance if you have specified a timeout of 20 days for a batch job, it will be stopped on the 7th day.</p>"
         },
         "MaxCapacity":{
           "shape":"NullableDouble",

sdk/src/Services/Glue/Generated/Model/GetCatalogsRequest.cs

@@ -37,11 +37,37 @@ namespace Amazon.Glue.Model
     /// </summary>
     public partial class GetCatalogsRequest : AmazonGlueRequest
     {
+        private bool? _includeRoot;
         private int? _maxResults;
         private string _nextToken;
         private string _parentCatalogId;
         private bool? _recursive;
 
+        /// <summary>
+        /// Gets and sets the property IncludeRoot. 
+        /// <para>
+        /// Whether to list the default catalog in the account and region in the response. Defaults
+        /// to <c>false</c>. When <c>true</c> and <c>ParentCatalogId = NULL | Amazon Web Services
+        /// Account ID</c>, all catalogs and the default catalog are enumerated in the response.
+        /// </para>
+        ///  
+        /// <para>
+        /// When the <c>ParentCatalogId</c> is not equal to null, and this attribute is passed
+        /// as <c>false</c> or <c>true</c>, an <c>InvalidInputException</c> is thrown.
+        /// </para>
+        /// </summary>
+        public bool IncludeRoot
+        {
+            get { return this._includeRoot.GetValueOrDefault(); }
+            set { this._includeRoot = value; }
+        }
+
+        // Check to see if IncludeRoot property is set
+        internal bool IsSetIncludeRoot()
+        {
+            return this._includeRoot.HasValue; 
+        }
+
         /// <summary>
         /// Gets and sets the property MaxResults. 
         /// <para>
@@ -102,8 +128,9 @@ internal bool IsSetParentCatalogId()
         /// <summary>
         /// Gets and sets the property Recursive. 
         /// <para>
-        /// When specified as true, iterates through the account and returns all catalog resources
-        /// (including top-level resources and child resources)
+        /// Whether to list all catalogs across the catalog hierarchy, starting from the <c>ParentCatalogId</c>.
+        /// Defaults to <c>false</c> . When <c>true</c>, all catalog objects in the <c>ParentCatalogID</c>
+        /// hierarchy are enumerated in the response.
         /// </para>
         /// </summary>
         public bool Recursive

sdk/src/Services/Glue/Generated/Model/Internal/MarshallTransformations/GetCatalogsRequestMarshaller.cs

@@ -69,6 +69,12 @@ public IRequest Marshall(GetCatalogsRequest publicRequest)
                 writer.Validate = false;
                 writer.WriteObjectStart();
                 var context = new JsonMarshallerContext(request, writer);
+                if(publicRequest.IsSetIncludeRoot())
+                {
+                    context.Writer.WritePropertyName("IncludeRoot");
+                    context.Writer.Write(publicRequest.IncludeRoot);
+                }
+
                 if(publicRequest.IsSetMaxResults())
                 {
                     context.Writer.WritePropertyName("MaxResults");

sdk/src/Services/Glue/Generated/Model/JobRun.cs

@@ -700,10 +700,18 @@ internal bool IsSetStateDetail()
         /// </para>
         ///  
         /// <para>
-        /// Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the
-        /// value is left blank, the job will be restarted after 7 days based if you have not
-        /// setup a maintenance window. If you have setup maintenance window, it will be restarted
-        /// during the maintenance window after 7 days.
+        /// Jobs must have timeout values less than 7 days or 10080 minutes. Otherwise, the jobs
+        /// will throw an exception.
+        /// </para>
+        ///  
+        /// <para>
+        /// When the value is left blank, the timeout is defaulted to 2880 minutes.
+        /// </para>
+        ///  
+        /// <para>
+        /// Any existing Glue jobs that had a timeout value greater than 7 days will be defaulted
+        /// to 7 days. For instance if you have specified a timeout of 20 days for a batch job,
+        /// it will be stopped on the 7th day.
         /// </para>
         /// </summary>
         [AWSProperty(Min=1)]

sdk/src/Services/Glue/Generated/Model/StartJobRunRequest.cs

@@ -330,10 +330,18 @@ internal bool IsSetSecurityConfiguration()
         /// </para>
         ///  
         /// <para>
-        /// Streaming jobs must have timeout values less than 7 days or 10080 minutes. When the
-        /// value is left blank, the job will be restarted after 7 days based if you have not
-        /// setup a maintenance window. If you have setup maintenance window, it will be restarted
-        /// during the maintenance window after 7 days.
+        /// Jobs must have timeout values less than 7 days or 10080 minutes. Otherwise, the jobs
+        /// will throw an exception.
+        /// </para>
+        ///  
+        /// <para>
+        /// When the value is left blank, the timeout is defaulted to 2880 minutes.
+        /// </para>
+        ///  
+        /// <para>
+        /// Any existing Glue jobs that had a timeout value greater than 7 days will be defaulted
+        /// to 7 days. For instance if you have specified a timeout of 20 days for a batch job,
+        /// it will be stopped on the 7th day.
         /// </para>
         /// </summary>
         [AWSProperty(Min=1)]