Amazon Athena Update: Introducing new NotebookS3LocationUri parameter to Athena ImportNotebook API. Payload is no longer required and either Payload or NotebookS3LocationUri needs to be provided (not both) for a successful ImportNotebook API call. If both are provided, an InvalidRequestException will be thrown.

Author: AWS

.changes/next-release/feature-AmazonAthena-231efc4.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon Athena",
+    "contributor": "",
+    "description": "Introducing new NotebookS3LocationUri parameter to Athena ImportNotebook API. Payload is no longer required and either Payload or NotebookS3LocationUri needs to be provided (not both) for a successful ImportNotebook API call. If both are provided, an InvalidRequestException will be thrown."
+}

services/athena/src/main/resources/codegen-resources/service-2.json

@@ -536,7 +536,7 @@
         {"shape":"InvalidRequestException"},
         {"shape":"TooManyRequestsException"}
       ],
-      "documentation":"<p>Imports a single <code>ipynb</code> file to a Spark enabled workgroup. The maximum file size that can be imported is 10 megabytes. If an <code>ipynb</code> file with the same name already exists in the workgroup, throws an error.</p>"
+      "documentation":"<p>Imports a single <code>ipynb</code> file to a Spark enabled workgroup. To import the notebook, the request must specify a value for either <code>Payload</code> or <code>NoteBookS3LocationUri</code>. If neither is specified or both are specified, an <code>InvalidRequestException</code> occurs. The maximum file size that can be imported is 10 megabytes. If an <code>ipynb</code> file with the same name already exists in the workgroup, throws an error.</p>"
     },
     "ListApplicationDPUSizes":{
       "name":"ListApplicationDPUSizes",
@@ -2656,7 +2656,6 @@
       "required":[
         "WorkGroup",
         "Name",
-        "Payload",
         "Type"
       ],
       "members":{
@@ -2670,12 +2669,16 @@
         },
         "Payload":{
           "shape":"Payload",
-          "documentation":"<p>The notebook content to be imported.</p>"
+          "documentation":"<p>The notebook content to be imported. The payload must be in <code>ipynb</code> format.</p>"
         },
         "Type":{
           "shape":"NotebookType",
           "documentation":"<p>The notebook content type. Currently, the only valid type is <code>IPYNB</code>.</p>"
         },
+        "NotebookS3LocationUri":{
+          "shape":"S3Uri",
+          "documentation":"<p>A URI that specifies the Amazon S3 location of a notebook file in <code>ipynb</code> format.</p>"
+        },
         "ClientRequestToken":{
           "shape":"ClientRequestToken",
           "documentation":"<p>A unique case-sensitive string used to ensure the request to import the notebook is idempotent (executes only once).</p> <important> <p>This token is listed as not required because Amazon Web Services SDKs (for example the Amazon Web Services SDK for Java) auto-generate the token for you. If you are not using the Amazon Web Services SDK or the Amazon Web Services CLI, you must provide this token or the action will fail.</p> </important>"
@@ -4875,7 +4878,7 @@
         },
         "ExecutionRole":{
           "shape":"RoleArn",
-          "documentation":"<p>The ARN of the execution role used to access user resources for Spark sessions and Identity Center enabled workgroups. This property applies only to Spark enabled workgroups and Identity Center enabled workgroups.</p>"
+          "documentation":"<p>The ARN of the execution role used to access user resources for Spark sessions and IAM Identity Center enabled workgroups. This property applies only to Spark enabled workgroups and IAM Identity Center enabled workgroups. The property is required for IAM Identity Center enabled workgroups.</p>"
         },
         "CustomerContentEncryptionConfiguration":{
           "shape":"CustomerContentEncryptionConfiguration",