View Source AWS.WellArchitected (aws-elixir v1.0.4)
Well-Architected Tool
This is the Well-Architected Tool API Reference.
The WA Tool API provides programmatic access to the Well-Architected Tool in the Amazon Web Services Management Console. For information about the Well-Architected Tool, see the Well-Architected Tool User Guide.
Link to this section Summary
Functions
Associate a lens to a workload.
Associate a profile with a workload.
Create a lens share.
Create a new lens version.
Create a milestone for an existing workload.
Create a profile.
Create a profile share.
Create a review template.
Create a review template share.
Create a new workload.
Create a workload share.
Delete an existing lens.
Delete a lens share.
Delete a profile.
Delete a profile share.
Delete a review template.
Delete a review template share.
Delete an existing workload.
Delete a workload share.
Disassociate a lens from a workload.
Disassociate a profile from a workload.
Export an existing lens.
Get the answer to a specific question in a workload review.
Get a consolidated report of your workloads.
Global settings for all workloads.
Get an existing lens.
Get lens review.
Get lens review report.
Get lens version differences.
Get a milestone for an existing workload.
Get profile information.
Get profile template.
Get review template.
Get review template answer.
Get a lens review associated with a review template.
Get an existing workload.
Import a new custom lens or update an existing custom lens.
List of answers for a particular workload and lens.
List of Trusted Advisor check details by account related to the workload.
List of Trusted Advisor checks summarized for all accounts related to the workload.
List the improvements of a particular lens review.
List lens reviews for a particular workload.
List the lens shares associated with the lens.
List the available lenses.
List all milestones for an existing workload.
List lens notifications.
List profile notifications.
List profile shares.
List profiles.
List the answers of a review template.
List review templates.
List the share invitations.
List the tags for a resource.
List review template shares.
List the workload shares associated with the workload.
Paginated list of workloads.
Adds one or more tags to the specified resource.
Deletes specified tags from a resource.
Update the answer to a specific question in a workload review.
Update whether the Amazon Web Services account is opted into organization sharing and discovery integration features.
Update integration features.
Update lens review for a particular workload.
Update a profile.
Update a review template.
Update a review template answer.
Update a lens review associated with a review template.
Update a workload or custom lens share invitation.
Update an existing workload.
Update a workload share.
Upgrade lens review for a particular workload.
Upgrade the lens review of a review template.
Link to this section Functions
Associate a lens to a workload.
Up to 10 lenses can be associated with a workload in a single API operation. A maximum of 20 lenses can be associated with a workload.
disclaimer
Disclaimer
By accessing and/or applying custom lenses created by another Amazon Web Services user or account, you acknowledge that custom lenses created by other users and shared with you are Third Party Content as defined in the Amazon Web Services Customer Agreement.
Associate a profile with a workload.
Create a new lens version.
A lens can have up to 100 versions.
Use this operation to publish a new lens version after you have imported a lens.
The LensAlias
is used to identify the lens to be published.
The owner of a lens can share the lens with other
Amazon Web Services accounts and users in the same Amazon Web Services Region.
Only the owner of a lens can delete it.
Create a milestone for an existing workload.
Create a profile.
Create a review template.
disclaimer
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.
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.
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
Delete an existing lens.
Only the owner of a lens can delete it. After the lens is deleted, Amazon Web Services accounts and users that you shared the lens with can continue to use it, but they will no longer be able to apply it to new workloads.
disclaimer
Disclaimer
By sharing your custom lenses with other Amazon Web Services accounts, you acknowledge that Amazon Web Services will make your custom lenses available to those other accounts. Those other accounts may continue to access and use your shared custom lenses even if you delete the custom lenses from your own Amazon Web Services account or terminate your Amazon Web Services account.
Delete a profile.
disclaimer
Disclaimer
By sharing your profile with other Amazon Web Services accounts, you acknowledge that Amazon Web Services will make your profile available to those other accounts. Those other accounts may continue to access and use your shared profile even if you delete the profile from your own Amazon Web Services account or terminate your Amazon Web Services account.
delete_review_template(client, template_arn, input, options \\ [])
View SourceDelete 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.
Delete an existing workload.
Disassociate a lens from a workload.
Up to 10 lenses can be disassociated from a workload in a single API operation.
The Amazon Web Services Well-Architected Framework lens (wellarchitected
)
cannot be
removed from a workload.
Disassociate a profile from a workload.
export_lens(client, lens_alias, lens_version \\ nil, options \\ [])
View SourceExport an existing lens.
Only the owner of a lens can export it. Lenses provided by Amazon Web Services (Amazon Web Services Official Content) cannot be exported.
Lenses are defined in JSON. For more information, see JSON format specification in the Well-Architected Tool User Guide.
disclaimer
Disclaimer
Do not include or gather personal identifiable information (PII) of end users or other identifiable individuals in or via your custom lenses. If your custom lens 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.
get_answer(client, lens_alias, question_id, workload_id, milestone_number \\ nil, options \\ [])
View SourceGet the answer to a specific question in a workload review.
get_consolidated_report(client, format, include_shared_resources \\ nil, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceGet a consolidated report of your workloads.
You can optionally choose to include workloads that have been shared with you.
Global settings for all workloads.
Get an existing lens.
get_lens_review(client, lens_alias, workload_id, milestone_number \\ nil, options \\ [])
View SourceGet lens review.
get_lens_review_report(client, lens_alias, workload_id, milestone_number \\ nil, options \\ [])
View SourceGet lens review report.
get_lens_version_difference(client, lens_alias, base_lens_version \\ nil, target_lens_version \\ nil, options \\ [])
View SourceGet lens version differences.
get_milestone(client, milestone_number, workload_id, options \\ [])
View SourceGet a milestone for an existing workload.
get_profile(client, profile_arn, profile_version \\ nil, options \\ [])
View SourceGet profile information.
Get profile template.
Get review template.
get_review_template_answer(client, lens_alias, question_id, template_arn, options \\ [])
View SourceGet review template answer.
get_review_template_lens_review(client, lens_alias, template_arn, options \\ [])
View SourceGet a lens review associated with a review template.
Get an existing workload.
Import a new custom lens or update an existing custom lens.
To update an existing custom lens, specify its ARN as the LensAlias
. If
no ARN is specified, a new custom lens is created.
The new or updated lens will have a status of DRAFT
. The lens cannot be
applied to workloads or shared with other Amazon Web Services accounts until
it's
published with CreateLensVersion
.
Lenses are defined in JSON. For more information, see JSON format specification in the Well-Architected Tool User Guide.
A custom lens cannot exceed 500 KB in size.
disclaimer
Disclaimer
Do not include or gather personal identifiable information (PII) of end users or other identifiable individuals in or via your custom lenses. If your custom lens 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.
list_answers(client, lens_alias, workload_id, max_results \\ nil, milestone_number \\ nil, next_token \\ nil, pillar_id \\ nil, question_priority \\ nil, options \\ [])
View SourceList of answers for a particular workload and lens.
List of Trusted Advisor check details by account related to the workload.
List of Trusted Advisor checks summarized for all accounts related to the workload.
list_lens_review_improvements(client, lens_alias, workload_id, max_results \\ nil, milestone_number \\ nil, next_token \\ nil, pillar_id \\ nil, question_priority \\ nil, options \\ [])
View SourceList the improvements of a particular lens review.
list_lens_reviews(client, workload_id, max_results \\ nil, milestone_number \\ nil, next_token \\ nil, options \\ [])
View SourceList lens reviews for a particular workload.
list_lenses(client, lens_name \\ nil, lens_status \\ nil, lens_type \\ nil, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceList the available lenses.
List all milestones for an existing workload.
List lens notifications.
list_profile_notifications(client, max_results \\ nil, next_token \\ nil, workload_id \\ nil, options \\ [])
View SourceList profile notifications.
list_profiles(client, max_results \\ nil, next_token \\ nil, profile_name_prefix \\ nil, profile_owner_type \\ nil, options \\ [])
View SourceList profiles.
list_review_template_answers(client, lens_alias, template_arn, max_results \\ nil, next_token \\ nil, pillar_id \\ nil, options \\ [])
View SourceList the answers of a review template.
list_review_templates(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceList review templates.
List the tags for a resource.
The WorkloadArn parameter can be a workload ARN, a custom lens ARN, a profile ARN, or review template ARN.
Paginated list of workloads.
Adds one or more tags to the specified resource.
The WorkloadArn parameter can be a workload ARN, a custom lens ARN, a profile ARN, or review template ARN.
Deletes specified tags from a resource.
The WorkloadArn parameter can be a workload ARN, a custom lens ARN, a profile ARN, or review template ARN.
To specify multiple tags, use separate tagKeys parameters, for example:
DELETE /tags/WorkloadArn?tagKeys=key1&tagKeys=key2
update_answer(client, lens_alias, question_id, workload_id, input, options \\ [])
View SourceUpdate the answer to a specific question in a workload review.
Update whether the Amazon Web Services account is opted into organization sharing and discovery integration features.
Update integration features.
update_lens_review(client, lens_alias, workload_id, input, options \\ [])
View SourceUpdate lens review for a particular workload.
Update a profile.
update_review_template(client, template_arn, input, options \\ [])
View SourceUpdate a review template.
update_review_template_answer(client, lens_alias, question_id, template_arn, input, options \\ [])
View SourceUpdate a review template answer.
update_review_template_lens_review(client, lens_alias, template_arn, input, options \\ [])
View SourceUpdate a lens review associated with a review template.
Update an existing workload.
upgrade_lens_review(client, lens_alias, workload_id, input, options \\ [])
View SourceUpgrade lens review for a particular workload.
upgrade_profile_version(client, profile_arn, workload_id, input, options \\ [])
View SourceUpgrade a profile.
upgrade_review_template_lens_review(client, lens_alias, template_arn, input, options \\ [])
View SourceUpgrade the lens review of a review template.