2023/10/03 - AWS Well-Architected Tool - 14 new 4 updated api methods
Changes AWS Well-Architected now supports Review Templates that allows you to create templates with pre-filled answers for Well-Architected and Custom Lens best practices.
Delete a review template.
Only the owner of a review template can delete it.
After the review template is deleted, Amazon Web Services accounts, users, organizations, and organizational units (OUs) that you shared the review template with will no longer be able to apply it to new workloads.
See also: AWS API Documentation
Request Syntax
client.delete_review_template(
TemplateArn='string',
ClientRequestToken='string'
)
string
[REQUIRED]
The review template ARN.
string
[REQUIRED]
A unique case-sensitive string used to ensure that this request is idempotent (executes only once).
You should not reuse the same token for other requests. If you retry a request with the same client request token and the same parameters after the original request has completed successfully, the result of the original request is returned.
Warning
This token is listed as required, however, if you do not specify it, the Amazon Web Services SDKs automatically generate one for you. If you are not using the Amazon Web Services SDK or the CLI, you must provide this token or the request will fail.
This field is autopopulated if not provided.
None
Create a review template.
Note
Disclaimer
Do not include or gather personal identifiable information (PII) of end users or other identifiable individuals in or via your review templates. If your review template or those shared with you and used in your account do include or collect PII you are responsible for: ensuring that the included PII is processed in accordance with applicable law, providing adequate privacy notices, and obtaining necessary consents for processing such data.
See also: AWS API Documentation
Request Syntax
client.create_review_template(
TemplateName='string',
Description='string',
Lenses=[
'string',
],
Notes='string',
Tags={
'string': 'string'
},
ClientRequestToken='string'
)
string
[REQUIRED]
Name of the review template.
string
[REQUIRED]
The review template description.
list
[REQUIRED]
Lenses applied to the review template.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
dict
The tags assigned to the review template.
(string) --
(string) --
string
[REQUIRED]
A unique case-sensitive string used to ensure that this request is idempotent (executes only once).
You should not reuse the same token for other requests. If you retry a request with the same client request token and the same parameters after the original request has completed successfully, the result of the original request is returned.
Warning
This token is listed as required, however, if you do not specify it, the Amazon Web Services SDKs automatically generate one for you. If you are not using the Amazon Web Services SDK or the CLI, you must provide this token or the request will fail.
This field is autopopulated if not provided.
dict
Response Syntax
{
'TemplateArn': 'string'
}
Response Structure
(dict) --
TemplateArn (string) --
The review template ARN.
Update a review template answer.
See also: AWS API Documentation
Request Syntax
client.update_review_template_answer(
TemplateArn='string',
LensAlias='string',
QuestionId='string',
SelectedChoices=[
'string',
],
ChoiceUpdates={
'string': {
'Status': 'SELECTED'|'NOT_APPLICABLE'|'UNSELECTED',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE',
'Notes': 'string'
}
},
Notes='string',
IsApplicable=True|False,
Reason='OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE'
)
string
[REQUIRED]
The review template ARN.
string
[REQUIRED]
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
[REQUIRED]
The ID of the question.
list
List of selected choice IDs in a question answer.
The values entered replace the previously selected choices.
(string) --
The ID of a choice.
dict
A list of choices to be updated.
(string) --
The ID of a choice.
(dict) --
A list of choices to be updated.
Status (string) -- [REQUIRED]
The status of a choice.
Reason (string) --
The reason why a choice is non-applicable to a question in your workload.
Notes (string) --
The notes associated with a choice.
string
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
boolean
Defines whether this question is applicable to a lens review.
string
The update reason.
dict
Response Syntax
{
'TemplateArn': 'string',
'LensAlias': 'string',
'Answer': {
'QuestionId': 'string',
'PillarId': 'string',
'QuestionTitle': 'string',
'QuestionDescription': 'string',
'ImprovementPlanUrl': 'string',
'HelpfulResourceUrl': 'string',
'HelpfulResourceDisplayText': 'string',
'Choices': [
{
'ChoiceId': 'string',
'Title': 'string',
'Description': 'string',
'HelpfulResource': {
'DisplayText': 'string',
'Url': 'string'
},
'ImprovementPlan': {
'DisplayText': 'string',
'Url': 'string'
},
'AdditionalResources': [
{
'Type': 'HELPFUL_RESOURCE'|'IMPROVEMENT_PLAN',
'Content': [
{
'DisplayText': 'string',
'Url': 'string'
},
]
},
]
},
],
'SelectedChoices': [
'string',
],
'ChoiceAnswers': [
{
'ChoiceId': 'string',
'Status': 'SELECTED'|'NOT_APPLICABLE'|'UNSELECTED',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE',
'Notes': 'string'
},
],
'IsApplicable': True|False,
'AnswerStatus': 'UNANSWERED'|'ANSWERED',
'Notes': 'string',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE'
}
}
Response Structure
(dict) --
TemplateArn (string) --
The review template ARN.
LensAlias (string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
Answer (dict) --
An answer of the question.
QuestionId (string) --
The ID of the question.
PillarId (string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
QuestionTitle (string) --
The title of the question.
QuestionDescription (string) --
The description of the question.
ImprovementPlanUrl (string) --
The improvement plan URL for a question in an Amazon Web Services official lenses.
This value is only available if the question has been answered.
This value does not apply to custom lenses.
HelpfulResourceUrl (string) --
The helpful resource URL.
For Amazon Web Services official lenses, this is the helpful resource URL for a question or choice.
For custom lenses, this is the helpful resource URL for a question and is only provided if HelpfulResourceDisplayText was specified for the question.
HelpfulResourceDisplayText (string) --
The helpful resource text to be displayed for a custom lens.
Note
This field does not apply to Amazon Web Services official lenses.
Choices (list) --
List of choices available for a question.
(dict) --
A choice available to answer question.
ChoiceId (string) --
The ID of a choice.
Title (string) --
The title of a choice.
Description (string) --
The description of a choice.
HelpfulResource (dict) --
The helpful resource (both text and URL) for a particular choice.
This field only applies to custom lenses. Each choice can have only one helpful resource.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
ImprovementPlan (dict) --
The improvement plan (both text and URL) for a particular choice.
This field only applies to custom lenses. Each choice can have only one improvement plan.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
AdditionalResources (list) --
The additional resources for a choice in a custom lens.
A choice can have up to two additional resources: one of type HELPFUL_RESOURCE , one of type IMPROVEMENT_PLAN , or both.
(dict) --
The choice level additional resources for a custom lens.
This field does not apply to Amazon Web Services official lenses.
Type (string) --
Type of additional resource for a custom lens.
Content (list) --
The URLs for additional resources, either helpful resources or improvement plans, for a custom lens. Up to five additional URLs can be specified.
(dict) --
The choice content.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
SelectedChoices (list) --
List of selected choice IDs in a question answer.
The values entered replace the previously selected choices.
(string) --
The ID of a choice.
ChoiceAnswers (list) --
A list of selected choices to a question in your review template.
(dict) --
A choice that has been answered on a question in your workload.
ChoiceId (string) --
The ID of a choice.
Status (string) --
The status of a choice.
Reason (string) --
The reason why a choice is non-applicable to a question in your workload.
Notes (string) --
The notes associated with a choice.
IsApplicable (boolean) --
Defines whether this question is applicable to a lens review.
AnswerStatus (string) --
The status of whether or not this question has been answered.
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
Reason (string) --
The reason why the question is not applicable to your review template.
Get review template.
See also: AWS API Documentation
Request Syntax
client.get_review_template(
TemplateArn='string'
)
string
[REQUIRED]
The review template ARN.
dict
Response Syntax
{
'ReviewTemplate': {
'Description': 'string',
'Lenses': [
'string',
],
'Notes': 'string',
'QuestionCounts': {
'string': 123
},
'Owner': 'string',
'UpdatedAt': datetime(2015, 1, 1),
'TemplateArn': 'string',
'TemplateName': 'string',
'Tags': {
'string': 'string'
},
'UpdateStatus': 'CURRENT'|'LENS_NOT_CURRENT',
'ShareInvitationId': 'string'
}
}
Response Structure
(dict) --
ReviewTemplate (dict) --
The review template.
Description (string) --
The review template description.
Lenses (list) --
The lenses applied to the review template.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
QuestionCounts (dict) --
A count of how many total questions are answered and unanswered in the review template.
(string) --
(integer) --
A non-negative integer that denotes how many.
Owner (string) --
An Amazon Web Services account ID.
UpdatedAt (datetime) --
The date and time recorded.
TemplateArn (string) --
The review template ARN.
TemplateName (string) --
The name of the review template.
Tags (dict) --
The tags assigned to the review template.
(string) --
(string) --
UpdateStatus (string) --
The latest status of a review template.
ShareInvitationId (string) --
The ID assigned to the template share invitation.
List the answers of a review template.
See also: AWS API Documentation
Request Syntax
client.list_review_template_answers(
TemplateArn='string',
LensAlias='string',
PillarId='string',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The ARN of the review template.
string
[REQUIRED]
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
string
The token to use to retrieve the next set of results.
integer
The maximum number of results to return for this request.
dict
Response Syntax
{
'TemplateArn': 'string',
'LensAlias': 'string',
'AnswerSummaries': [
{
'QuestionId': 'string',
'PillarId': 'string',
'QuestionTitle': 'string',
'Choices': [
{
'ChoiceId': 'string',
'Title': 'string',
'Description': 'string',
'HelpfulResource': {
'DisplayText': 'string',
'Url': 'string'
},
'ImprovementPlan': {
'DisplayText': 'string',
'Url': 'string'
},
'AdditionalResources': [
{
'Type': 'HELPFUL_RESOURCE'|'IMPROVEMENT_PLAN',
'Content': [
{
'DisplayText': 'string',
'Url': 'string'
},
]
},
]
},
],
'SelectedChoices': [
'string',
],
'ChoiceAnswerSummaries': [
{
'ChoiceId': 'string',
'Status': 'SELECTED'|'NOT_APPLICABLE'|'UNSELECTED',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE'
},
],
'IsApplicable': True|False,
'AnswerStatus': 'UNANSWERED'|'ANSWERED',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE',
'QuestionType': 'PRIORITIZED'|'NON_PRIORITIZED'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
TemplateArn (string) --
The ARN of the review template.
LensAlias (string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
AnswerSummaries (list) --
List of answer summaries of a lens review in a review template.
(dict) --
The summary of review template answers.
QuestionId (string) --
The ID of the question.
PillarId (string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
QuestionTitle (string) --
The title of the question.
Choices (list) --
List of choices available for a question.
(dict) --
A choice available to answer question.
ChoiceId (string) --
The ID of a choice.
Title (string) --
The title of a choice.
Description (string) --
The description of a choice.
HelpfulResource (dict) --
The helpful resource (both text and URL) for a particular choice.
This field only applies to custom lenses. Each choice can have only one helpful resource.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
ImprovementPlan (dict) --
The improvement plan (both text and URL) for a particular choice.
This field only applies to custom lenses. Each choice can have only one improvement plan.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
AdditionalResources (list) --
The additional resources for a choice in a custom lens.
A choice can have up to two additional resources: one of type HELPFUL_RESOURCE , one of type IMPROVEMENT_PLAN , or both.
(dict) --
The choice level additional resources for a custom lens.
This field does not apply to Amazon Web Services official lenses.
Type (string) --
Type of additional resource for a custom lens.
Content (list) --
The URLs for additional resources, either helpful resources or improvement plans, for a custom lens. Up to five additional URLs can be specified.
(dict) --
The choice content.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
SelectedChoices (list) --
List of selected choice IDs in a question answer.
The values entered replace the previously selected choices.
(string) --
The ID of a choice.
ChoiceAnswerSummaries (list) --
A list of selected choices to a question in the review template.
(dict) --
A choice summary that has been answered on a question in your workload.
ChoiceId (string) --
The ID of a choice.
Status (string) --
The status of a choice.
Reason (string) --
The reason why a choice is non-applicable to a question in your workload.
IsApplicable (boolean) --
Defines whether this question is applicable to a lens review.
AnswerStatus (string) --
The status of whether or not this question has been answered.
Reason (string) --
The reason why a choice is not-applicable to a question in the review template.
QuestionType (string) --
The type of question.
NextToken (string) --
The token to use to retrieve the next set of results.
Upgrade the lens review of a review template.
See also: AWS API Documentation
Request Syntax
client.upgrade_review_template_lens_review(
TemplateArn='string',
LensAlias='string',
ClientRequestToken='string'
)
string
[REQUIRED]
The ARN of the review template.
string
[REQUIRED]
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
A unique case-sensitive string used to ensure that this request is idempotent (executes only once).
You should not reuse the same token for other requests. If you retry a request with the same client request token and the same parameters after the original request has completed successfully, the result of the original request is returned.
Warning
This token is listed as required, however, if you do not specify it, the Amazon Web Services SDKs automatically generate one for you. If you are not using the Amazon Web Services SDK or the CLI, you must provide this token or the request will fail.
None
Update a review template.
See also: AWS API Documentation
Request Syntax
client.update_review_template(
TemplateArn='string',
TemplateName='string',
Description='string',
Notes='string',
LensesToAssociate=[
'string',
],
LensesToDisassociate=[
'string',
]
)
string
[REQUIRED]
The review template ARN.
string
The review template name.
string
The review template description.
string
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
list
A list of lens aliases or ARNs to apply to the review template.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
list
A list of lens aliases or ARNs to unapply to the review template. The wellarchitected lens cannot be unapplied.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
dict
Response Syntax
{
'ReviewTemplate': {
'Description': 'string',
'Lenses': [
'string',
],
'Notes': 'string',
'QuestionCounts': {
'string': 123
},
'Owner': 'string',
'UpdatedAt': datetime(2015, 1, 1),
'TemplateArn': 'string',
'TemplateName': 'string',
'Tags': {
'string': 'string'
},
'UpdateStatus': 'CURRENT'|'LENS_NOT_CURRENT',
'ShareInvitationId': 'string'
}
}
Response Structure
(dict) --
ReviewTemplate (dict) --
A review template.
Description (string) --
The review template description.
Lenses (list) --
The lenses applied to the review template.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
QuestionCounts (dict) --
A count of how many total questions are answered and unanswered in the review template.
(string) --
(integer) --
A non-negative integer that denotes how many.
Owner (string) --
An Amazon Web Services account ID.
UpdatedAt (datetime) --
The date and time recorded.
TemplateArn (string) --
The review template ARN.
TemplateName (string) --
The name of the review template.
Tags (dict) --
The tags assigned to the review template.
(string) --
(string) --
UpdateStatus (string) --
The latest status of a review template.
ShareInvitationId (string) --
The ID assigned to the template share invitation.
List review templates.
See also: AWS API Documentation
Request Syntax
client.list_review_templates(
NextToken='string',
MaxResults=123
)
string
The token to use to retrieve the next set of results.
integer
The maximum number of results to return for this request.
dict
Response Syntax
{
'ReviewTemplates': [
{
'Description': 'string',
'Lenses': [
'string',
],
'Owner': 'string',
'UpdatedAt': datetime(2015, 1, 1),
'TemplateArn': 'string',
'TemplateName': 'string',
'UpdateStatus': 'CURRENT'|'LENS_NOT_CURRENT'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
ReviewTemplates (list) --
List of review templates.
(dict) --
Summary of a review template.
Description (string) --
Description of the review template.
Lenses (list) --
Lenses associated with the review template.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
Owner (string) --
An Amazon Web Services account ID.
UpdatedAt (datetime) --
The date and time recorded.
TemplateArn (string) --
The review template ARN.
TemplateName (string) --
The name of the review template.
UpdateStatus (string) --
The latest status of a review template.
NextToken (string) --
The token to use to retrieve the next set of results.
Get a lens review associated with a review template.
See also: AWS API Documentation
Request Syntax
client.get_review_template_lens_review(
TemplateArn='string',
LensAlias='string'
)
string
[REQUIRED]
The review template ARN.
string
[REQUIRED]
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
dict
Response Syntax
{
'TemplateArn': 'string',
'LensReview': {
'LensAlias': 'string',
'LensArn': 'string',
'LensVersion': 'string',
'LensName': 'string',
'LensStatus': 'CURRENT'|'NOT_CURRENT'|'DEPRECATED'|'DELETED'|'UNSHARED',
'PillarReviewSummaries': [
{
'PillarId': 'string',
'PillarName': 'string',
'Notes': 'string',
'QuestionCounts': {
'string': 123
}
},
],
'UpdatedAt': datetime(2015, 1, 1),
'Notes': 'string',
'QuestionCounts': {
'string': 123
},
'NextToken': 'string'
}
}
Response Structure
(dict) --
TemplateArn (string) --
The review template ARN.
LensReview (dict) --
A lens review of a question.
LensAlias (string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
LensArn (string) --
The lens ARN.
LensVersion (string) --
The version of the lens.
LensName (string) --
The full name of the lens.
LensStatus (string) --
The status of the lens.
PillarReviewSummaries (list) --
Pillar review summaries of a lens review.
(dict) --
Summary of a review template.
PillarId (string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
PillarName (string) --
The name of the pillar.
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
QuestionCounts (dict) --
A count of how many questions are answered and unanswered in the requested pillar of the lens review.
(string) --
(integer) --
A non-negative integer that denotes how many.
UpdatedAt (datetime) --
The date and time recorded.
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
QuestionCounts (dict) --
A count of how many questions are answered and unanswered in the lens review.
(string) --
(integer) --
A non-negative integer that denotes how many.
NextToken (string) --
The token to use to retrieve the next set of results.
Get review template answer.
See also: AWS API Documentation
Request Syntax
client.get_review_template_answer(
TemplateArn='string',
LensAlias='string',
QuestionId='string'
)
string
[REQUIRED]
The review template ARN.
string
[REQUIRED]
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
[REQUIRED]
The ID of the question.
dict
Response Syntax
{
'TemplateArn': 'string',
'LensAlias': 'string',
'Answer': {
'QuestionId': 'string',
'PillarId': 'string',
'QuestionTitle': 'string',
'QuestionDescription': 'string',
'ImprovementPlanUrl': 'string',
'HelpfulResourceUrl': 'string',
'HelpfulResourceDisplayText': 'string',
'Choices': [
{
'ChoiceId': 'string',
'Title': 'string',
'Description': 'string',
'HelpfulResource': {
'DisplayText': 'string',
'Url': 'string'
},
'ImprovementPlan': {
'DisplayText': 'string',
'Url': 'string'
},
'AdditionalResources': [
{
'Type': 'HELPFUL_RESOURCE'|'IMPROVEMENT_PLAN',
'Content': [
{
'DisplayText': 'string',
'Url': 'string'
},
]
},
]
},
],
'SelectedChoices': [
'string',
],
'ChoiceAnswers': [
{
'ChoiceId': 'string',
'Status': 'SELECTED'|'NOT_APPLICABLE'|'UNSELECTED',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE',
'Notes': 'string'
},
],
'IsApplicable': True|False,
'AnswerStatus': 'UNANSWERED'|'ANSWERED',
'Notes': 'string',
'Reason': 'OUT_OF_SCOPE'|'BUSINESS_PRIORITIES'|'ARCHITECTURE_CONSTRAINTS'|'OTHER'|'NONE'
}
}
Response Structure
(dict) --
TemplateArn (string) --
The review template ARN.
LensAlias (string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
Answer (dict) --
An answer of the question.
QuestionId (string) --
The ID of the question.
PillarId (string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
QuestionTitle (string) --
The title of the question.
QuestionDescription (string) --
The description of the question.
ImprovementPlanUrl (string) --
The improvement plan URL for a question in an Amazon Web Services official lenses.
This value is only available if the question has been answered.
This value does not apply to custom lenses.
HelpfulResourceUrl (string) --
The helpful resource URL.
For Amazon Web Services official lenses, this is the helpful resource URL for a question or choice.
For custom lenses, this is the helpful resource URL for a question and is only provided if HelpfulResourceDisplayText was specified for the question.
HelpfulResourceDisplayText (string) --
The helpful resource text to be displayed for a custom lens.
Note
This field does not apply to Amazon Web Services official lenses.
Choices (list) --
List of choices available for a question.
(dict) --
A choice available to answer question.
ChoiceId (string) --
The ID of a choice.
Title (string) --
The title of a choice.
Description (string) --
The description of a choice.
HelpfulResource (dict) --
The helpful resource (both text and URL) for a particular choice.
This field only applies to custom lenses. Each choice can have only one helpful resource.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
ImprovementPlan (dict) --
The improvement plan (both text and URL) for a particular choice.
This field only applies to custom lenses. Each choice can have only one improvement plan.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
AdditionalResources (list) --
The additional resources for a choice in a custom lens.
A choice can have up to two additional resources: one of type HELPFUL_RESOURCE , one of type IMPROVEMENT_PLAN , or both.
(dict) --
The choice level additional resources for a custom lens.
This field does not apply to Amazon Web Services official lenses.
Type (string) --
Type of additional resource for a custom lens.
Content (list) --
The URLs for additional resources, either helpful resources or improvement plans, for a custom lens. Up to five additional URLs can be specified.
(dict) --
The choice content.
DisplayText (string) --
The display text for the choice content.
Url (string) --
The URL for the choice content.
SelectedChoices (list) --
List of selected choice IDs in a question answer.
The values entered replace the previously selected choices.
(string) --
The ID of a choice.
ChoiceAnswers (list) --
A list of selected choices to a question in your review template.
(dict) --
A choice that has been answered on a question in your workload.
ChoiceId (string) --
The ID of a choice.
Status (string) --
The status of a choice.
Reason (string) --
The reason why a choice is non-applicable to a question in your workload.
Notes (string) --
The notes associated with a choice.
IsApplicable (boolean) --
Defines whether this question is applicable to a lens review.
AnswerStatus (string) --
The status of whether or not this question has been answered.
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
Reason (string) --
The reason why the question is not applicable to your review template.
Update a lens review associated with a review template.
See also: AWS API Documentation
Request Syntax
client.update_review_template_lens_review(
TemplateArn='string',
LensAlias='string',
LensNotes='string',
PillarNotes={
'string': 'string'
}
)
string
[REQUIRED]
The review template ARN.
string
[REQUIRED]
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
dict
List of pillar notes of a lens review in a workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
(string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
(string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
dict
Response Syntax
{
'TemplateArn': 'string',
'LensReview': {
'LensAlias': 'string',
'LensArn': 'string',
'LensVersion': 'string',
'LensName': 'string',
'LensStatus': 'CURRENT'|'NOT_CURRENT'|'DEPRECATED'|'DELETED'|'UNSHARED',
'PillarReviewSummaries': [
{
'PillarId': 'string',
'PillarName': 'string',
'Notes': 'string',
'QuestionCounts': {
'string': 123
}
},
],
'UpdatedAt': datetime(2015, 1, 1),
'Notes': 'string',
'QuestionCounts': {
'string': 123
},
'NextToken': 'string'
}
}
Response Structure
(dict) --
TemplateArn (string) --
The review template ARN.
LensReview (dict) --
A lens review of a question.
LensAlias (string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
LensArn (string) --
The lens ARN.
LensVersion (string) --
The version of the lens.
LensName (string) --
The full name of the lens.
LensStatus (string) --
The status of the lens.
PillarReviewSummaries (list) --
Pillar review summaries of a lens review.
(dict) --
Summary of a review template.
PillarId (string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
PillarName (string) --
The name of the pillar.
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
QuestionCounts (dict) --
A count of how many questions are answered and unanswered in the requested pillar of the lens review.
(string) --
(integer) --
A non-negative integer that denotes how many.
UpdatedAt (datetime) --
The date and time recorded.
Notes (string) --
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
QuestionCounts (dict) --
A count of how many questions are answered and unanswered in the lens review.
(string) --
(integer) --
A non-negative integer that denotes how many.
NextToken (string) --
The token to use to retrieve the next set of results.
{'ReviewTemplateArns': ['string']}
Create a new workload.
The owner of a workload can share the workload with other Amazon Web Services accounts, users, an organization, and organizational units (OUs) in the same Amazon Web Services Region. Only the owner of a workload can delete it.
For more information, see Defining a Workload in the Well-Architected Tool User Guide .
Warning
Either AwsRegions , NonAwsRegions , or both must be specified when creating a workload.
You also must specify ReviewOwner , even though the parameter is listed as not being required in the following section.
When creating a workload using a review template, you must have the following IAM permissions:
wellarchitected:GetReviewTemplate
wellarchitected:GetReviewTemplateAnswer
wellarchitected:ListReviewTemplateAnswers
wellarchitected:GetReviewTemplateLensReview
See also: AWS API Documentation
Request Syntax
client.create_workload(
WorkloadName='string',
Description='string',
Environment='PRODUCTION'|'PREPRODUCTION',
AccountIds=[
'string',
],
AwsRegions=[
'string',
],
NonAwsRegions=[
'string',
],
PillarPriorities=[
'string',
],
ArchitecturalDesign='string',
ReviewOwner='string',
IndustryType='string',
Industry='string',
Lenses=[
'string',
],
Notes='string',
ClientRequestToken='string',
Tags={
'string': 'string'
},
DiscoveryConfig={
'TrustedAdvisorIntegrationStatus': 'ENABLED'|'DISABLED',
'WorkloadResourceDefinition': [
'WORKLOAD_METADATA'|'APP_REGISTRY',
]
},
Applications=[
'string',
],
ProfileArns=[
'string',
],
ReviewTemplateArns=[
'string',
]
)
string
[REQUIRED]
The name of the workload.
The name must be unique within an account within an Amazon Web Services Region. Spaces and capitalization are ignored when checking for uniqueness.
string
[REQUIRED]
The description for the workload.
string
[REQUIRED]
The environment for the workload.
list
The list of Amazon Web Services account IDs associated with the workload.
(string) --
An Amazon Web Services account ID.
list
The list of Amazon Web Services Regions associated with the workload, for example, us-east-2 , or ca-central-1 .
(string) --
An Amazon Web Services Region, for example, us-west-2 or ap-northeast-1 .
list
The list of non-Amazon Web Services Regions associated with the workload.
(string) --
list
The priorities of the pillars, which are used to order items in the improvement plan. Each pillar is represented by its PillarReviewSummary$PillarId .
(string) --
The ID used to identify a pillar, for example, security .
A pillar is identified by its PillarReviewSummary$PillarId .
string
The URL of the architectural design for the workload.
string
The review owner of the workload. The name, email address, or identifier for the primary group or individual that owns the workload review process.
string
The industry type for the workload.
If specified, must be one of the following:
Agriculture
Automobile
Defense
Design and Engineering
Digital Advertising
Education
Environmental Protection
Financial Services
Gaming
General Public Services
Healthcare
Hospitality
InfoTech
Justice and Public Safety
Life Sciences
Manufacturing
Media & Entertainment
Mining & Resources
Oil & Gas
Power & Utilities
Professional Services
Real Estate & Construction
Retail & Wholesale
Social Protection
Telecommunications
Travel, Transportation & Logistics
Other
string
The industry for the workload.
list
[REQUIRED]
The list of lenses associated with the workload. Each lens is identified by its LensSummary$LensAlias .
If a review template that specifies lenses is applied to the workload, those lenses are applied to the workload in addition to these lenses.
(string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
string
The notes associated with the workload.
For a review template, these are the notes that will be associated with the workload when the template is applied.
string
[REQUIRED]
A unique case-sensitive string used to ensure that this request is idempotent (executes only once).
You should not reuse the same token for other requests. If you retry a request with the same client request token and the same parameters after the original request has completed successfully, the result of the original request is returned.
Warning
This token is listed as required, however, if you do not specify it, the Amazon Web Services SDKs automatically generate one for you. If you are not using the Amazon Web Services SDK or the CLI, you must provide this token or the request will fail.
This field is autopopulated if not provided.
dict
The tags to be associated with the workload.
(string) --
(string) --
dict
Well-Architected discovery configuration settings associated to the workload.
TrustedAdvisorIntegrationStatus (string) --
Discovery integration status in respect to Trusted Advisor for the workload.
WorkloadResourceDefinition (list) --
The mode to use for identifying resources associated with the workload.
You can specify WORKLOAD_METADATA , APP_REGISTRY , or both.
(string) --
list
List of AppRegistry application ARNs associated to the workload.
(string) --
list
The list of profile ARNs associated with the workload.
(string) --
list
The list of review template ARNs to associate with the workload.
(string) --
dict
Response Syntax
{
'WorkloadId': 'string',
'WorkloadArn': 'string'
}
Response Structure
(dict) --
Output of a create workload call.
WorkloadId (string) --
The ID assigned to the workload. This ID is unique within an Amazon Web Services Region.
WorkloadArn (string) --
The ARN for the workload.
{'ResourceArn': 'string'}
Response {'NotificationSummaries': {'LensUpgradeSummary': {'ResourceArn': 'string',
'ResourceName': 'string'}}}
List lens notifications.
See also: AWS API Documentation
Request Syntax
client.list_notifications(
WorkloadId='string',
NextToken='string',
MaxResults=123,
ResourceArn='string'
)
string
The ID assigned to the workload. This ID is unique within an Amazon Web Services Region.
string
The token to use to retrieve the next set of results.
integer
The maximum number of results to return for this request.
string
The ARN for the related resource for the notification.
Note
Only one of WorkloadID or ResourceARN should be specified.
dict
Response Syntax
{
'NotificationSummaries': [
{
'Type': 'LENS_VERSION_UPGRADED'|'LENS_VERSION_DEPRECATED',
'LensUpgradeSummary': {
'WorkloadId': 'string',
'WorkloadName': 'string',
'LensAlias': 'string',
'LensArn': 'string',
'CurrentLensVersion': 'string',
'LatestLensVersion': 'string',
'ResourceArn': 'string',
'ResourceName': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
NotificationSummaries (list) --
List of lens notification summaries in a workload.
(dict) --
A notification summary return object.
Type (string) --
The type of notification.
LensUpgradeSummary (dict) --
Summary of lens upgrade.
WorkloadId (string) --
The ID assigned to the workload. This ID is unique within an Amazon Web Services Region.
WorkloadName (string) --
The name of the workload.
The name must be unique within an account within an Amazon Web Services Region. Spaces and capitalization are ignored when checking for uniqueness.
LensAlias (string) --
The alias of the lens.
For Amazon Web Services official lenses, this is either the lens alias, such as serverless , or the lens ARN, such as arn:aws:wellarchitected:us-east-1::lens/serverless . Note that some operations (such as ExportLens and CreateLensShare) are not permitted on Amazon Web Services official lenses.
For custom lenses, this is the lens ARN, such as arn:aws:wellarchitected:us-west-2:123456789012:lens/0123456789abcdef01234567890abcdef .
Each lens is identified by its LensSummary$LensAlias .
LensArn (string) --
The ARN for the lens.
CurrentLensVersion (string) --
The current version of the lens.
LatestLensVersion (string) --
The latest version of the lens.
ResourceArn (string) --
ResourceArn of the lens being upgraded
ResourceName (string) --
The name of the workload.
The name must be unique within an account within an Amazon Web Services Region. Spaces and capitalization are ignored when checking for uniqueness.
NextToken (string) --
The token to use to retrieve the next set of results.