AWS Well-Architected Tool Update: This update provides support for Well-Architected API users to mark answer choices as not applicable.

Author: AWS

.changes/next-release/feature-AWSWellArchitectedTool-36d9ef1.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS Well-Architected Tool",
+    "contributor": "",
+    "description": "This update provides support for Well-Architected API users to mark answer choices as not applicable."
+}

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

@@ -152,7 +152,7 @@
         {"shape":"AccessDeniedException"},
         {"shape":"ThrottlingException"}
       ],
-      "documentation":"<p>Get lens review.</p>"
+      "documentation":"<p>Get the answer to a specific question in a workload review.</p>"
     },
     "GetLensReview":{
       "name":"GetLensReview",
@@ -428,7 +428,7 @@
         {"shape":"InternalServerException"},
         {"shape":"ResourceNotFoundException"}
       ],
-      "documentation":"<p>Deletes specified tags from a resource.</p>"
+      "documentation":"<p>Deletes specified tags from a resource.</p> <p>To specify multiple tags, use separate <b>tagKeys</b> parameters, for example:</p> <p> <code>DELETE /tags/WorkloadArn?tagKeys=key1&amp;tagKeys=key2</code> </p>"
     },
     "UpdateAnswer":{
       "name":"UpdateAnswer",
@@ -560,12 +560,30 @@
         "HelpfulResourceUrl":{"shape":"HelpfulResourceUrl"},
         "Choices":{"shape":"Choices"},
         "SelectedChoices":{"shape":"SelectedChoices"},
+        "ChoiceAnswers":{
+          "shape":"ChoiceAnswers",
+          "documentation":"<p>A list of selected choices to a question in your workload.</p>"
+        },
         "IsApplicable":{"shape":"IsApplicable"},
         "Risk":{"shape":"Risk"},
-        "Notes":{"shape":"Notes"}
+        "Notes":{"shape":"Notes"},
+        "Reason":{
+          "shape":"AnswerReason",
+          "documentation":"<p>The reason why the question is not applicable to your workload.</p>"
+        }
       },
       "documentation":"<p>An answer of the question.</p>"
     },
+    "AnswerReason":{
+      "type":"string",
+      "enum":[
+        "OUT_OF_SCOPE",
+        "BUSINESS_PRIORITIES",
+        "ARCHITECTURE_CONSTRAINTS",
+        "OTHER",
+        "NONE"
+      ]
+    },
     "AnswerSummaries":{
       "type":"list",
       "member":{"shape":"AnswerSummary"},
@@ -579,8 +597,16 @@
         "QuestionTitle":{"shape":"QuestionTitle"},
         "Choices":{"shape":"Choices"},
         "SelectedChoices":{"shape":"SelectedChoices"},
+        "ChoiceAnswerSummaries":{
+          "shape":"ChoiceAnswerSummaries",
+          "documentation":"<p>A list of selected choices to a question in your workload.</p>"
+        },
         "IsApplicable":{"shape":"IsApplicable"},
-        "Risk":{"shape":"Risk"}
+        "Risk":{"shape":"Risk"},
+        "Reason":{
+          "shape":"AnswerReason",
+          "documentation":"<p>The reason why a choice is non-applicable to a question in your workload.</p>"
+        }
       },
       "documentation":"<p>An answer summary of a lens review in a workload.</p>"
     },
@@ -623,6 +649,48 @@
       },
       "documentation":"<p>A choice available to answer question.</p>"
     },
+    "ChoiceAnswer":{
+      "type":"structure",
+      "members":{
+        "ChoiceId":{"shape":"ChoiceId"},
+        "Status":{
+          "shape":"ChoiceStatus",
+          "documentation":"<p>The status of a choice.</p>"
+        },
+        "Reason":{
+          "shape":"ChoiceReason",
+          "documentation":"<p>The reason why a choice is non-applicable to a question in your workload.</p>"
+        },
+        "Notes":{
+          "shape":"ChoiceNotes",
+          "documentation":"<p>The notes associated with a choice.</p>"
+        }
+      },
+      "documentation":"<p>A choice that has been answered on a question in your workload.</p>"
+    },
+    "ChoiceAnswerSummaries":{
+      "type":"list",
+      "member":{"shape":"ChoiceAnswerSummary"}
+    },
+    "ChoiceAnswerSummary":{
+      "type":"structure",
+      "members":{
+        "ChoiceId":{"shape":"ChoiceId"},
+        "Status":{
+          "shape":"ChoiceStatus",
+          "documentation":"<p>The status of a choice.</p>"
+        },
+        "Reason":{
+          "shape":"ChoiceReason",
+          "documentation":"<p>The reason why a choice is non-applicable to a question in your workload.</p>"
+        }
+      },
+      "documentation":"<p>A choice summary that has been answered on a question in your workload.</p>"
+    },
+    "ChoiceAnswers":{
+      "type":"list",
+      "member":{"shape":"ChoiceAnswer"}
+    },
     "ChoiceDescription":{
       "type":"string",
       "documentation":"<p>The description of a choice.</p>",
@@ -635,12 +703,58 @@
       "max":64,
       "min":1
     },
+    "ChoiceNotes":{
+      "type":"string",
+      "max":250
+    },
+    "ChoiceReason":{
+      "type":"string",
+      "enum":[
+        "OUT_OF_SCOPE",
+        "BUSINESS_PRIORITIES",
+        "ARCHITECTURE_CONSTRAINTS",
+        "OTHER",
+        "NONE"
+      ]
+    },
+    "ChoiceStatus":{
+      "type":"string",
+      "enum":[
+        "SELECTED",
+        "NOT_APPLICABLE",
+        "UNSELECTED"
+      ]
+    },
     "ChoiceTitle":{
       "type":"string",
       "documentation":"<p>The title of a choice.</p>",
       "max":512,
       "min":1
     },
+    "ChoiceUpdate":{
+      "type":"structure",
+      "required":["Status"],
+      "members":{
+        "Status":{
+          "shape":"ChoiceStatus",
+          "documentation":"<p>The status of a choice.</p>"
+        },
+        "Reason":{
+          "shape":"ChoiceReason",
+          "documentation":"<p>The reason why a choice is non-applicable to a question in your workload.</p>"
+        },
+        "Notes":{
+          "shape":"ChoiceNotes",
+          "documentation":"<p>The notes associated with a choice.</p>"
+        }
+      },
+      "documentation":"<p>A list of choices to be updated.</p>"
+    },
+    "ChoiceUpdates":{
+      "type":"map",
+      "key":{"shape":"ChoiceId"},
+      "value":{"shape":"ChoiceUpdate"}
+    },
     "Choices":{
       "type":"list",
       "member":{"shape":"Choice"},
@@ -1057,7 +1171,7 @@
     },
     "ImprovementPlanUrl":{
       "type":"string",
-      "documentation":"<p>The improvement plan URL for a question.</p>",
+      "documentation":"<p>The improvement plan URL for a question.</p> <p>This value is only available if the question has been answered.</p>",
       "max":2048,
       "min":1
     },
@@ -1946,7 +2060,7 @@
         },
         "TagKeys":{
           "shape":"TagKeyList",
-          "documentation":"<p>The keys of the tags to be removed.</p>",
+          "documentation":"<p>A list of tag keys. Existing tags of the resource whose keys are members of this list are removed from the resource.</p>",
           "location":"querystring",
           "locationName":"tagKeys"
         }
@@ -1981,8 +2095,16 @@
           "locationName":"QuestionId"
         },
         "SelectedChoices":{"shape":"SelectedChoices"},
+        "ChoiceUpdates":{
+          "shape":"ChoiceUpdates",
+          "documentation":"<p>A list of choices to update on a question in your workload. The String key corresponds to the choice ID to be updated.</p>"
+        },
         "Notes":{"shape":"Notes"},
-        "IsApplicable":{"shape":"IsApplicable"}
+        "IsApplicable":{"shape":"IsApplicable"},
+        "Reason":{
+          "shape":"AnswerReason",
+          "documentation":"<p>The reason why a question is not applicable to your workload.</p>"
+        }
       },
       "documentation":"<p>Input to update answer.</p>"
     },