Amazon QuickSight Update: added warnings to a few CLI pages

Author: AWS

.changes/next-release/feature-AmazonQuickSight-2bd3055.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon QuickSight",
+    "contributor": "",
+    "description": "added warnings to a few CLI pages"
+}

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

@@ -587,7 +587,7 @@
         {"shape":"InternalFailureException"},
         {"shape":"ResourceUnavailableException"}
       ],
-      "documentation":"<p>Deletes all Amazon QuickSight customizations in this Amazon Web Services Region for the specified Amazon Web Services account and QuickSight namespace.</p>"
+      "documentation":"<important> <p>This API permanently deletes all QuickSight customizations for the specified Amazon Web Services account and namespace in this Amazon Web Services Region. When you delete account customizations:</p> <ul> <li> <p>All customizations are removed including themes, branding, and visual settings</p> </li> <li> <p>The deletion affects only the specified Amazon Web Services Region - customizations in other regions remain unchanged</p> </li> <li> <p>This action cannot be undone through the API</p> </li> <li> <p>Users will see default QuickSight styling after customizations are deleted</p> </li> </ul> <p> <b>Before proceeding:</b> Ensure you have backups of any custom themes or branding elements you may want to recreate.</p> </important> <p>Deletes all Amazon QuickSight customizations in this Amazon Web Services Region for the specified Amazon Web Services account and QuickSight namespace.</p>"
     },
     "DeleteAccountSubscription":{
       "name":"DeleteAccountSubscription",
@@ -606,7 +606,7 @@
         {"shape":"InternalFailureException"},
         {"shape":"ResourceUnavailableException"}
       ],
-      "documentation":"<p>Use the <code>DeleteAccountSubscription</code> operation to delete an QuickSight account. This operation will result in an error message if you have configured your account termination protection settings to <code>True</code>. To change this setting and delete your account, call the <code>UpdateAccountSettings</code> API and set the value of the <code>TerminationProtectionEnabled</code> parameter to <code>False</code>, then make another call to the <code>DeleteAccountSubscription</code> API.</p>"
+      "documentation":"<important> <p>Deleting your QuickSight account subscription has permanent, irreversible consequences across all Amazon Web Services regions:</p> <ul> <li> <p>Global deletion – Running this operation from any single region will delete your QuickSight account and all data in every Amazon Web Services region where you have QuickSight resources.</p> </li> <li> <p>Complete data loss – All dashboards, analyses, datasets, data sources, and custom visuals will be permanently deleted across all regions.</p> </li> <li> <p>Embedded content failure – All embedded dashboards and visuals in your applications will immediately stop working and display errors to end users.</p> </li> <li> <p>Shared resources removed – All shared dashboards, folders, and resources will become inaccessible to other users and external recipients.</p> </li> <li> <p>User access terminated – All QuickSight users in your account will lose access immediately, including authors, readers, and administrators.</p> </li> <li> <p> <b>No recovery possible</b> – Once deleted, your QuickSight account and all associated data cannot be restored.</p> </li> </ul> <p>Consider exporting critical dashboards and data before proceeding with account deletion.</p> </important> <p>Use the <code>DeleteAccountSubscription</code> operation to delete an QuickSight account. This operation will result in an error message if you have configured your account termination protection settings to <code>True</code>. To change this setting and delete your account, call the <code>UpdateAccountSettings</code> API and set the value of the <code>TerminationProtectionEnabled</code> parameter to <code>False</code>, then make another call to the <code>DeleteAccountSubscription</code> API.</p>"
     },
     "DeleteAnalysis":{
       "name":"DeleteAnalysis",
@@ -643,7 +643,7 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"}
       ],
-      "documentation":"<p>Deletes an QuickSight brand.</p>",
+      "documentation":"<important> <p>This API permanently deletes the specified QuickSight brand. When you delete a brand:</p> <ul> <li> <p>The brand and all its associated branding elements are permanently removed</p> </li> <li> <p>Any applications or dashboards using this brand will revert to default styling</p> </li> <li> <p>This action cannot be undone through the API</p> </li> </ul> <p> <b>Before proceeding:</b> Verify that the brand is no longer needed and consider the impact on any applications currently using this brand.</p> </important> <p>Deletes an QuickSight brand.</p>",
       "idempotent":true
     },
     "DeleteBrandAssignment":{
@@ -1323,7 +1323,8 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"}
       ],
-      "documentation":"<p>Describes a brand.</p>"
+      "documentation":"<p>Describes a brand.</p>",
+      "readonly":true
     },
     "DescribeBrandAssignment":{
       "name":"DescribeBrandAssignment",
@@ -1342,7 +1343,8 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"}
       ],
-      "documentation":"<p>Describes a brand assignment.</p>"
+      "documentation":"<p>Describes a brand assignment.</p>",
+      "readonly":true
     },
     "DescribeBrandPublishedVersion":{
       "name":"DescribeBrandPublishedVersion",
@@ -1361,7 +1363,8 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"}
       ],
-      "documentation":"<p>Describes the published version of the brand.</p>"
+      "documentation":"<p>Describes the published version of the brand.</p>",
+      "readonly":true
     },
     "DescribeCustomPermissions":{
       "name":"DescribeCustomPermissions",
@@ -2258,7 +2261,8 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InternalServerException"}
       ],
-      "documentation":"<p>Lists all brands in an QuickSight account.</p>"
+      "documentation":"<p>Lists all brands in an QuickSight account.</p>",
+      "readonly":true
     },
     "ListCustomPermissions":{
       "name":"ListCustomPermissions",
@@ -3655,7 +3659,7 @@
         {"shape":"UnsupportedPricingPlanException"},
         {"shape":"InternalFailureException"}
       ],
-      "documentation":"<p>Use the <code>UpdatePublicSharingSettings</code> operation to turn on or turn off the public sharing settings of an QuickSight dashboard.</p> <p>To use this operation, turn on session capacity pricing for your QuickSight account.</p> <p>Before you can turn on public sharing on your account, make sure to give public sharing permissions to an administrative user in the Identity and Access Management (IAM) console. For more information on using IAM with QuickSight, see <a href=\"https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html\">Using QuickSight with IAM</a> in the <i>QuickSight User Guide</i>.</p>"
+      "documentation":"<important> <p>This API controls public sharing settings for your entire QuickSight account, affecting data security and access. When you enable public sharing:</p> <ul> <li> <p>Dashboards can be shared publicly</p> </li> <li> <p>This setting affects your entire Amazon Web Services account and all QuickSight users</p> </li> </ul> <p> <b>Before proceeding:</b> Ensure you understand the security implications and have proper IAM permissions configured.</p> </important> <p>Use the <code>UpdatePublicSharingSettings</code> operation to turn on or turn off the public sharing settings of an QuickSight dashboard.</p> <p>To use this operation, turn on session capacity pricing for your QuickSight account.</p> <p>Before you can turn on public sharing on your account, make sure to give public sharing permissions to an administrative user in the Identity and Access Management (IAM) console. For more information on using IAM with QuickSight, see <a href=\"https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html\">Using QuickSight with IAM</a> in the <i>QuickSight User Guide</i>.</p>"
     },
     "UpdateQPersonalizationConfiguration":{
       "name":"UpdateQPersonalizationConfiguration",