wellarchitected function

AWS Well-Architected Tool

AWS Well-Architected Tool

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.

wellarchitected( config = list(), credentials = list(), endpoint = NULL, region = NULL )

Arguments

  • config: Optional configuration of credentials, endpoint, and/or region.

    • credentials :

      • creds :

        • access_key_id : AWS access key ID
        • secret_access_key : AWS secret access key
        • session_token : AWS temporary session token
      • profile : The name of a profile to use. If not given, then the default profile is used.

      • anonymous : Set anonymous credentials.

    • endpoint : The complete URL to use for the constructed client.

    • region : The AWS Region used in instantiating the client.

    • close_connection : Immediately close all HTTP connections.

    • timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

    • s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

    • sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

  • credentials: Optional credentials shorthand for the config parameter

    • creds :

      • access_key_id : AWS access key ID
      • secret_access_key : AWS secret access key
      • session_token : AWS temporary session token
    • profile : The name of a profile to use. If not given, then the default profile is used.

    • anonymous : Set anonymous credentials.

  • endpoint: Optional shorthand for complete URL to use for the constructed client.

  • region: Optional shorthand for AWS Region used in instantiating the client.

Returns

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- wellarchitected(
  config = list(
    credentials = list(
 creds = list(
   access_key_id = "string",
   secret_access_key = "string",
   session_token = "string"
 ),
 profile = "string",
 anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
 access_key_id = "string",
 secret_access_key = "string",
 session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

associate_lensesAssociate a lens to a workload
associate_profilesAssociate a profile with a workload
create_lens_shareCreate a lens share
create_lens_versionCreate a new lens version
create_milestoneCreate a milestone for an existing workload
create_profileCreate a profile
create_profile_shareCreate a profile share
create_review_templateCreate a review template
create_template_shareCreate a review template share
create_workloadCreate a new workload
create_workload_shareCreate a workload share
delete_lensDelete an existing lens
delete_lens_shareDelete a lens share
delete_profileDelete a profile
delete_profile_shareDelete a profile share
delete_review_templateDelete a review template
delete_template_shareDelete a review template share
delete_workloadDelete an existing workload
delete_workload_shareDelete a workload share
disassociate_lensesDisassociate a lens from a workload
disassociate_profilesDisassociate a profile from a workload
export_lensExport an existing lens
get_answerGet the answer to a specific question in a workload review
get_consolidated_reportGet a consolidated report of your workloads
get_global_settingsGlobal settings for all workloads
get_lensGet an existing lens
get_lens_reviewGet lens review
get_lens_review_reportGet lens review report
get_lens_version_differenceGet lens version differences
get_milestoneGet a milestone for an existing workload
get_profileGet profile information
get_profile_templateGet profile template
get_review_templateGet review template
get_review_template_answerGet review template answer
get_review_template_lens_reviewGet a lens review associated with a review template
get_workloadGet an existing workload
import_lensImport a new custom lens or update an existing custom lens
list_answersList of answers for a particular workload and lens
list_check_detailsList of Trusted Advisor check details by account related to the workload
list_check_summariesList of Trusted Advisor checks summarized for all accounts related to the workload
list_lensesList the available lenses
list_lens_review_improvementsList the improvements of a particular lens review
list_lens_reviewsList lens reviews for a particular workload
list_lens_sharesList the lens shares associated with the lens
list_milestonesList all milestones for an existing workload
list_notificationsList lens notifications
list_profile_notificationsList profile notifications
list_profilesList profiles
list_profile_sharesList profile shares
list_review_template_answersList the answers of a review template
list_review_templatesList review templates
list_share_invitationsList the share invitations
list_tags_for_resourceList the tags for a resource
list_template_sharesList review template shares
list_workloadsPaginated list of workloads
list_workload_sharesList the workload shares associated with the workload
tag_resourceAdds one or more tags to the specified resource
untag_resourceDeletes specified tags from a resource
update_answerUpdate the answer to a specific question in a workload review
update_global_settingsUpdate whether the Amazon Web Services account is opted into organization sharing and discovery integration features
update_integrationUpdate integration features
update_lens_reviewUpdate lens review for a particular workload
update_profileUpdate a profile
update_review_templateUpdate a review template
update_review_template_answerUpdate a review template answer
update_review_template_lens_reviewUpdate a lens review associated with a review template
update_share_invitationUpdate a workload or custom lens share invitation
update_workloadUpdate an existing workload
update_workload_shareUpdate a workload share
upgrade_lens_reviewUpgrade lens review for a particular workload
upgrade_profile_versionUpgrade a profile
upgrade_review_template_lens_reviewUpgrade the lens review of a review template

Examples

## Not run: svc <- wellarchitected() svc$associate_lenses( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17