{"files":{"SKILL.md":"---\nname: aws-well-architected-tool\ndescription: \"AWS Well-Architected Tool API skill. Use when working with AWS Well-Architected Tool for workloads, lenses, profiles. Covers 72 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# AWS Well-Architected Tool\nAPI version: 2020-03-31\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. GET /consolidatedReport -- get a consolidated report of your workloads. you can optionally choose to include workloads that have been shared with you.\n3. POST /lenses/{LensAlias}/shares -- create first share\n\n## Endpoints\n72 endpoints across 15 groups. See references/api-spec.lap for full details.\n\n### Workloads\n| Method | Path | Description |\n|--------|------|-------------|\n| PATCH | /workloads/{WorkloadId}/associateLenses | 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  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. |\n| PATCH | /workloads/{WorkloadId}/associateProfiles | Associate a profile with a workload. |\n| POST | /workloads/{WorkloadId}/milestones | Create a milestone for an existing workload. |\n| POST | /workloads | 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 |\n| POST | /workloads/{WorkloadId}/shares | Create a workload share. The owner of a workload can share it with other Amazon Web Services accounts and users in the same Amazon Web Services Region. Shared access to a workload is not removed until the workload invitation is deleted. If you share a workload with an organization or OU, all accounts in the organization or OU are granted access to the workload. For more information, see Sharing a workload in the Well-Architected Tool User Guide. |\n| DELETE | /workloads/{WorkloadId} | Delete an existing workload. |\n| DELETE | /workloads/{WorkloadId}/shares/{ShareId} | Delete a workload share. |\n| PATCH | /workloads/{WorkloadId}/disassociateLenses | 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. |\n| PATCH | /workloads/{WorkloadId}/disassociateProfiles | Disassociate a profile from a workload. |\n| GET | /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers/{QuestionId} | Get the answer to a specific question in a workload review. |\n| GET | /workloads/{WorkloadId}/lensReviews/{LensAlias} | Get lens review. |\n| GET | /workloads/{WorkloadId}/lensReviews/{LensAlias}/report | Get lens review report. |\n| GET | /workloads/{WorkloadId}/milestones/{MilestoneNumber} | Get a milestone for an existing workload. |\n| GET | /workloads/{WorkloadId} | Get an existing workload. |\n| GET | /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers | List of answers for a particular workload and lens. |\n| POST | /workloads/{WorkloadId}/checks | List of Trusted Advisor check details by account related to the workload. |\n| POST | /workloads/{WorkloadId}/checkSummaries | List of Trusted Advisor checks summarized for all accounts related to the workload. |\n| GET | /workloads/{WorkloadId}/lensReviews/{LensAlias}/improvements | List the improvements of a particular lens review. |\n| GET | /workloads/{WorkloadId}/lensReviews | List lens reviews for a particular workload. |\n| POST | /workloads/{WorkloadId}/milestonesSummaries | List all milestones for an existing workload. |\n| GET | /workloads/{WorkloadId}/shares | List the workload shares associated with the workload. |\n| PATCH | /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers/{QuestionId} | Update the answer to a specific question in a workload review. |\n| POST | /workloads/{WorkloadId}/updateIntegration | Update integration features. |\n| PATCH | /workloads/{WorkloadId}/lensReviews/{LensAlias} | Update lens review for a particular workload. |\n| PATCH | /workloads/{WorkloadId} | Update an existing workload. |\n| PATCH | /workloads/{WorkloadId}/shares/{ShareId} | Update a workload share. |\n| PUT | /workloads/{WorkloadId}/lensReviews/{LensAlias}/upgrade | Upgrade lens review for a particular workload. |\n| PUT | /workloads/{WorkloadId}/profiles/{ProfileArn}/upgrade | Upgrade a profile. |\n\n### Lenses\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /lenses/{LensAlias}/shares | Create a lens share. The owner of a lens can share it with other Amazon Web Services accounts, users, an organization, and organizational units (OUs) in the same Amazon Web Services Region. Lenses provided by Amazon Web Services (Amazon Web Services Official Content) cannot be shared.  Shared access to a lens is not removed until the lens invitation is deleted. If you share a lens with an organization or OU, all accounts in the organization or OU are granted access to the lens. For more information, see Sharing a custom lens in the Well-Architected Tool User Guide.   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. |\n| POST | /lenses/{LensAlias}/versions | 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. |\n| DELETE | /lenses/{LensAlias} | 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  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. |\n| DELETE | /lenses/{LensAlias}/shares/{ShareId} | Delete a lens share. After the lens share is deleted, Amazon Web Services accounts, users, organizations, and organizational units (OUs) 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  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. |\n| GET | /lenses/{LensAlias}/export | Export 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  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. |\n| GET | /lenses/{LensAlias} | Get an existing lens. |\n| GET | /lenses/{LensAlias}/versionDifference | Get lens version differences. |\n| GET | /lenses/{LensAlias}/shares | List the lens shares associated with the lens. |\n| GET | /lenses | List the available lenses. |\n\n### Profiles\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /profiles | Create a profile. |\n| POST | /profiles/{ProfileArn}/shares | Create a profile share. |\n| DELETE | /profiles/{ProfileArn} | Delete a profile.   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. |\n| DELETE | /profiles/{ProfileArn}/shares/{ShareId} | Delete a profile share. |\n| GET | /profiles/{ProfileArn} | Get profile information. |\n| GET | /profiles/{ProfileArn}/shares | List profile shares. |\n| PATCH | /profiles/{ProfileArn} | Update a profile. |\n\n### ReviewTemplates\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /reviewTemplates | Create a review template.   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. |\n| DELETE | /reviewTemplates/{TemplateArn} | 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. |\n| GET | /reviewTemplates/{TemplateArn} | Get review template. |\n| GET | /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/answers/{QuestionId} | Get review template answer. |\n| GET | /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias} | Get a lens review associated with a review template. |\n| GET | /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/answers | List the answers of a review template. |\n| GET | /reviewTemplates | List review templates. |\n| PATCH | /reviewTemplates/{TemplateArn} | Update a review template. |\n| PATCH | /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/answers/{QuestionId} | Update a review template answer. |\n| PATCH | /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias} | Update a lens review associated with a review template. |\n| PUT | /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/upgrade | Upgrade the lens review of a review template. |\n\n### Templates\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /templates/shares/{TemplateArn} | Create a review template share. The owner of a review template can share it with other Amazon Web Services accounts, users, an organization, and organizational units (OUs) in the same Amazon Web Services Region.   Shared access to a review template is not removed until the review template share invitation is deleted. If you share a review template with an organization or OU, all accounts in the organization or OU are granted access to the review template.   Disclaimer  By sharing your review template with other Amazon Web Services accounts, you acknowledge that Amazon Web Services will make your review template available to those other accounts. |\n| DELETE | /templates/shares/{TemplateArn}/{ShareId} | Delete a review template share. After the review template share 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. |\n| GET | /templates/shares/{TemplateArn} | List review template shares. |\n\n### ConsolidatedReport\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /consolidatedReport | Get a consolidated report of your workloads. You can optionally choose to include workloads that have been shared with you. |\n\n### Global-settings\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /global-settings | Global settings for all workloads. |\n| PATCH | /global-settings | Update whether the Amazon Web Services account is opted into organization sharing and discovery integration features. |\n\n### ProfileTemplate\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /profileTemplate | Get profile template. |\n\n### ImportLens\n| Method | Path | Description |\n|--------|------|-------------|\n| PUT | /importLens | 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  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. |\n\n### Notifications\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /notifications | List lens notifications. |\n\n### ProfileNotifications\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /profileNotifications/ | List profile notifications. |\n\n### ProfileSummaries\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /profileSummaries | List profiles. |\n\n### ShareInvitations\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /shareInvitations | List the share invitations.  WorkloadNamePrefix, LensNamePrefix, ProfileNamePrefix, and TemplateNamePrefix are mutually exclusive. Use the parameter that matches your ShareResourceType. |\n| PATCH | /shareInvitations/{ShareInvitationId} | Update a workload or custom lens share invitation.  This API operation can be called independently of any resource. Previous documentation implied that a workload ARN must be specified. |\n\n### Tags\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /tags/{WorkloadArn} | 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. |\n| POST | /tags/{WorkloadArn} | 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. |\n| DELETE | /tags/{WorkloadArn} | 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 |\n\n### WorkloadsSummaries\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /workloadsSummaries | Paginated list of workloads. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a share?\" -> POST /lenses/{LensAlias}/shares\n- \"Create a version?\" -> POST /lenses/{LensAlias}/versions\n- \"Create a milestone?\" -> POST /workloads/{WorkloadId}/milestones\n- \"Create a profile?\" -> POST /profiles\n- \"Create a reviewTemplate?\" -> POST /reviewTemplates\n- \"Create a workload?\" -> POST /workloads\n- \"Delete a lense?\" -> DELETE /lenses/{LensAlias}\n- \"Delete a share?\" -> DELETE /lenses/{LensAlias}/shares/{ShareId}\n- \"Delete a profile?\" -> DELETE /profiles/{ProfileArn}\n- \"Delete a reviewTemplate?\" -> DELETE /reviewTemplates/{TemplateArn}\n- \"Delete a workload?\" -> DELETE /workloads/{WorkloadId}\n- \"List all export?\" -> GET /lenses/{LensAlias}/export\n- \"Get answer details?\" -> GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers/{QuestionId}\n- \"List all consolidatedReport?\" -> GET /consolidatedReport\n- \"List all global-settings?\" -> GET /global-settings\n- \"Get lense details?\" -> GET /lenses/{LensAlias}\n- \"Get lensReview details?\" -> GET /workloads/{WorkloadId}/lensReviews/{LensAlias}\n- \"List all report?\" -> GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/report\n- \"List all versionDifference?\" -> GET /lenses/{LensAlias}/versionDifference\n- \"Get milestone details?\" -> GET /workloads/{WorkloadId}/milestones/{MilestoneNumber}\n- \"Get profile details?\" -> GET /profiles/{ProfileArn}\n- \"List all profileTemplate?\" -> GET /profileTemplate\n- \"Get reviewTemplate details?\" -> GET /reviewTemplates/{TemplateArn}\n- \"Get workload details?\" -> GET /workloads/{WorkloadId}\n- \"List all answers?\" -> GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers\n- \"Create a check?\" -> POST /workloads/{WorkloadId}/checks\n- \"Create a checkSummary?\" -> POST /workloads/{WorkloadId}/checkSummaries\n- \"List all improvements?\" -> GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/improvements\n- \"List all lensReviews?\" -> GET /workloads/{WorkloadId}/lensReviews\n- \"List all shares?\" -> GET /lenses/{LensAlias}/shares\n- \"List all lenses?\" -> GET /lenses\n- \"Create a milestonesSummary?\" -> POST /workloads/{WorkloadId}/milestonesSummaries\n- \"Create a notification?\" -> POST /notifications\n- \"List all profileNotifications?\" -> GET /profileNotifications/\n- \"List all profileSummaries?\" -> GET /profileSummaries\n- \"List all reviewTemplates?\" -> GET /reviewTemplates\n- \"List all shareInvitations?\" -> GET /shareInvitations\n- \"Get tag details?\" -> GET /tags/{WorkloadArn}\n- \"Get share details?\" -> GET /templates/shares/{TemplateArn}\n- \"Create a workloadsSummary?\" -> POST /workloadsSummaries\n- \"Delete a tag?\" -> DELETE /tags/{WorkloadArn}\n- \"Partially update a answer?\" -> PATCH /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers/{QuestionId}\n- \"Create a updateIntegration?\" -> POST /workloads/{WorkloadId}/updateIntegration\n- \"Partially update a lensReview?\" -> PATCH /workloads/{WorkloadId}/lensReviews/{LensAlias}\n- \"Partially update a profile?\" -> PATCH /profiles/{ProfileArn}\n- \"Partially update a reviewTemplate?\" -> PATCH /reviewTemplates/{TemplateArn}\n- \"Partially update a shareInvitation?\" -> PATCH /shareInvitations/{ShareInvitationId}\n- \"Partially update a workload?\" -> PATCH /workloads/{WorkloadId}\n- \"Partially update a share?\" -> PATCH /workloads/{WorkloadId}/shares/{ShareId}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api AWS Well-Architected Tool\n@version 2020-03-31\n@auth AWS SigV4\n@endpoints 72\n@hint download_for_search\n@toc workloads(28), lenses(9), profiles(7), reviewTemplates(11), templates(3), consolidatedReport(1), global-settings(2), profileTemplate(1), importLens(1), notifications(1), profileNotifications(1), profileSummaries(1), shareInvitations(2), tags(3), workloadsSummaries(1)\n\n@group workloads\n@endpoint PATCH /workloads/{WorkloadId}/associateLenses\n@desc 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  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.\n@required {WorkloadId: str, LensAliases: [str]}\n\n@endpoint PATCH /workloads/{WorkloadId}/associateProfiles\n@desc Associate a profile with a workload.\n@required {WorkloadId: str, ProfileArns: [str]}\n\n@endgroup\n\n@group lenses\n@endpoint POST /lenses/{LensAlias}/shares\n@desc Create a lens share. The owner of a lens can share it with other Amazon Web Services accounts, users, an organization, and organizational units (OUs) in the same Amazon Web Services Region. Lenses provided by Amazon Web Services (Amazon Web Services Official Content) cannot be shared.  Shared access to a lens is not removed until the lens invitation is deleted. If you share a lens with an organization or OU, all accounts in the organization or OU are granted access to the lens. For more information, see Sharing a custom lens in the Well-Architected Tool User Guide.   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.\n@required {LensAlias: str, SharedWith: str, ClientRequestToken: str}\n@returns(200) {ShareId: str?}\n\n@endpoint POST /lenses/{LensAlias}/versions\n@desc 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.\n@required {LensAlias: str, LensVersion: str, ClientRequestToken: str}\n@optional {IsMajorVersion: bool}\n@returns(200) {LensArn: str?, LensVersion: str?}\n\n@endgroup\n\n@group workloads\n@endpoint POST /workloads/{WorkloadId}/milestones\n@desc Create a milestone for an existing workload.\n@required {WorkloadId: str, MilestoneName: str, ClientRequestToken: str}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?}\n\n@endgroup\n\n@group profiles\n@endpoint POST /profiles\n@desc Create a profile.\n@required {ProfileName: str, ProfileDescription: str, ProfileQuestions: [ProfileQuestionUpdate], ClientRequestToken: str}\n@optional {Tags: map<str,str>}\n@returns(200) {ProfileArn: str?, ProfileVersion: str?}\n\n@endpoint POST /profiles/{ProfileArn}/shares\n@desc Create a profile share.\n@required {ProfileArn: str, SharedWith: str, ClientRequestToken: str}\n@returns(200) {ShareId: str?, ProfileArn: str?}\n\n@endgroup\n\n@group reviewTemplates\n@endpoint POST /reviewTemplates\n@desc Create a review template.   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.\n@required {TemplateName: str, Description: str, Lenses: [str], ClientRequestToken: str}\n@optional {Notes: str, Tags: map<str,str>}\n@returns(200) {TemplateArn: str?}\n\n@endgroup\n\n@group templates\n@endpoint POST /templates/shares/{TemplateArn}\n@desc Create a review template share. The owner of a review template can share it with other Amazon Web Services accounts, users, an organization, and organizational units (OUs) in the same Amazon Web Services Region.   Shared access to a review template is not removed until the review template share invitation is deleted. If you share a review template with an organization or OU, all accounts in the organization or OU are granted access to the review template.   Disclaimer  By sharing your review template with other Amazon Web Services accounts, you acknowledge that Amazon Web Services will make your review template available to those other accounts.\n@required {TemplateArn: str, SharedWith: str, ClientRequestToken: str}\n@returns(200) {TemplateArn: str?, ShareId: str?}\n\n@endgroup\n\n@group workloads\n@endpoint POST /workloads\n@desc 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\n@required {WorkloadName: str, Description: str, Environment: str, Lenses: [str], ClientRequestToken: str}\n@optional {AccountIds: [str], AwsRegions: [str], NonAwsRegions: [str], PillarPriorities: [str], ArchitecturalDesign: str, ReviewOwner: str, IndustryType: str, Industry: str, Notes: str, Tags: map<str,str>, DiscoveryConfig: WorkloadDiscoveryConfig, Applications: [str], ProfileArns: [str], ReviewTemplateArns: [str], JiraConfiguration: WorkloadJiraConfigurationInput}\n@returns(200) {WorkloadId: str?, WorkloadArn: str?}\n\n@endpoint POST /workloads/{WorkloadId}/shares\n@desc Create a workload share. The owner of a workload can share it with other Amazon Web Services accounts and users in the same Amazon Web Services Region. Shared access to a workload is not removed until the workload invitation is deleted. If you share a workload with an organization or OU, all accounts in the organization or OU are granted access to the workload. For more information, see Sharing a workload in the Well-Architected Tool User Guide.\n@required {WorkloadId: str, SharedWith: str, PermissionType: str, ClientRequestToken: str}\n@returns(200) {WorkloadId: str?, ShareId: str?}\n\n@endgroup\n\n@group lenses\n@endpoint DELETE /lenses/{LensAlias}\n@desc 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  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.\n@required {LensAlias: str, ClientRequestToken: str, LensStatus: str}\n\n@endpoint DELETE /lenses/{LensAlias}/shares/{ShareId}\n@desc Delete a lens share. After the lens share is deleted, Amazon Web Services accounts, users, organizations, and organizational units (OUs) 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  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.\n@required {ShareId: str, LensAlias: str, ClientRequestToken: str}\n\n@endgroup\n\n@group profiles\n@endpoint DELETE /profiles/{ProfileArn}\n@desc Delete a profile.   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.\n@required {ProfileArn: str, ClientRequestToken: str}\n\n@endpoint DELETE /profiles/{ProfileArn}/shares/{ShareId}\n@desc Delete a profile share.\n@required {ShareId: str, ProfileArn: str, ClientRequestToken: str}\n\n@endgroup\n\n@group reviewTemplates\n@endpoint DELETE /reviewTemplates/{TemplateArn}\n@desc 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.\n@required {TemplateArn: str, ClientRequestToken: str}\n\n@endgroup\n\n@group templates\n@endpoint DELETE /templates/shares/{TemplateArn}/{ShareId}\n@desc Delete a review template share. After the review template share 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.\n@required {ShareId: str, TemplateArn: str, ClientRequestToken: str}\n\n@endgroup\n\n@group workloads\n@endpoint DELETE /workloads/{WorkloadId}\n@desc Delete an existing workload.\n@required {WorkloadId: str, ClientRequestToken: str}\n\n@endpoint DELETE /workloads/{WorkloadId}/shares/{ShareId}\n@desc Delete a workload share.\n@required {ShareId: str, WorkloadId: str, ClientRequestToken: str}\n\n@endpoint PATCH /workloads/{WorkloadId}/disassociateLenses\n@desc 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.\n@required {WorkloadId: str, LensAliases: [str]}\n\n@endpoint PATCH /workloads/{WorkloadId}/disassociateProfiles\n@desc Disassociate a profile from a workload.\n@required {WorkloadId: str, ProfileArns: [str]}\n\n@endgroup\n\n@group lenses\n@endpoint GET /lenses/{LensAlias}/export\n@desc Export 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  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.\n@required {LensAlias: str}\n@optional {LensVersion: str}\n@returns(200) {LensJSON: str?}\n\n@endgroup\n\n@group workloads\n@endpoint GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers/{QuestionId}\n@desc Get the answer to a specific question in a workload review.\n@required {WorkloadId: str, LensAlias: str, QuestionId: str}\n@optional {MilestoneNumber: int}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?, LensAlias: str?, LensArn: str?, Answer: Answer?{QuestionId: str?, PillarId: str?, QuestionTitle: str?, QuestionDescription: str?, ImprovementPlanUrl: str?, HelpfulResourceUrl: str?, HelpfulResourceDisplayText: str?, Choices: [Choice]?, SelectedChoices: [str]?, ChoiceAnswers: [ChoiceAnswer]?, IsApplicable: bool?, Risk: str?, Notes: str?, Reason: str?, JiraConfiguration: JiraConfiguration?{JiraIssueUrl: str?, LastSyncedTime: str(timestamp)?}}}\n\n@endgroup\n\n@group consolidatedReport\n@endpoint GET /consolidatedReport\n@desc Get a consolidated report of your workloads. You can optionally choose to include workloads that have been shared with you.\n@required {Format: str}\n@optional {IncludeSharedResources: bool, NextToken: str, MaxResults: int}\n@returns(200) {Metrics: [ConsolidatedReportMetric]?, NextToken: str?, Base64String: str?}\n\n@endgroup\n\n@group global-settings\n@endpoint GET /global-settings\n@desc Global settings for all workloads.\n@returns(200) {OrganizationSharingStatus: str?, DiscoveryIntegrationStatus: str?, JiraConfiguration: AccountJiraConfigurationOutput?{IntegrationStatus: str?, IssueManagementStatus: str?, IssueManagementType: str?, Subdomain: str?, JiraProjectKey: str?, StatusMessage: str?}}\n\n@endgroup\n\n@group lenses\n@endpoint GET /lenses/{LensAlias}\n@desc Get an existing lens.\n@required {LensAlias: str}\n@optional {LensVersion: str}\n@returns(200) {Lens: Lens?{LensArn: str?, LensVersion: str?, Name: str?, Description: str?, Owner: str?, ShareInvitationId: str?, Tags: map<str, str>?: any}}\n\n@endgroup\n\n@group workloads\n@endpoint GET /workloads/{WorkloadId}/lensReviews/{LensAlias}\n@desc Get lens review.\n@required {WorkloadId: str, LensAlias: str}\n@optional {MilestoneNumber: int}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?, LensReview: LensReview?{LensAlias: str?, LensArn: str?, LensVersion: str?, LensName: str?, LensStatus: str?, PillarReviewSummaries: [PillarReviewSummary]?, JiraConfiguration: JiraSelectedQuestionConfiguration?{SelectedPillars: [SelectedPillar]?}, UpdatedAt: str(timestamp)?, Notes: str?, RiskCounts: map<str, int>?: any, NextToken: str?, Profiles: [WorkloadProfile]?, PrioritizedRiskCounts: map<str, int>?: any}}\n\n@endpoint GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/report\n@desc Get lens review report.\n@required {WorkloadId: str, LensAlias: str}\n@optional {MilestoneNumber: int}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?, LensReviewReport: LensReviewReport?{LensAlias: str?, LensArn: str?, Base64String: str?}}\n\n@endgroup\n\n@group lenses\n@endpoint GET /lenses/{LensAlias}/versionDifference\n@desc Get lens version differences.\n@required {LensAlias: str}\n@optional {BaseLensVersion: str, TargetLensVersion: str}\n@returns(200) {LensAlias: str?, LensArn: str?, BaseLensVersion: str?, TargetLensVersion: str?, LatestLensVersion: str?, VersionDifferences: VersionDifferences?{PillarDifferences: [PillarDifference]?}}\n\n@endgroup\n\n@group workloads\n@endpoint GET /workloads/{WorkloadId}/milestones/{MilestoneNumber}\n@desc Get a milestone for an existing workload.\n@required {WorkloadId: str, MilestoneNumber: int}\n@returns(200) {WorkloadId: str?, Milestone: Milestone?{MilestoneNumber: int?, MilestoneName: str?, RecordedAt: str(timestamp)?, Workload: Workload?{WorkloadId: str?, WorkloadArn: str?, WorkloadName: str?, Description: str?, Environment: str?, UpdatedAt: str(timestamp)?, AccountIds: [str]?, AwsRegions: [str]?, NonAwsRegions: [str]?, ArchitecturalDesign: str?, ReviewOwner: str?, ReviewRestrictionDate: str(timestamp)?, IsReviewOwnerUpdateAcknowledged: bool?, IndustryType: str?, Industry: str?, Notes: str?, ImprovementStatus: str?, RiskCounts: map<str, int>?: any, PillarPriorities: [str]?, Lenses: [str]?, Owner: str?, ShareInvitationId: str?, Tags: map<str, str>?: any, DiscoveryConfig: WorkloadDiscoveryConfig?{TrustedAdvisorIntegrationStatus: str?, WorkloadResourceDefinition: [str]?}, Applications: [str]?, Profiles: [WorkloadProfile]?, PrioritizedRiskCounts: map<str, int>?: any, JiraConfiguration: WorkloadJiraConfigurationOutput?{IssueManagementStatus: str?, IssueManagementType: str?, JiraProjectKey: str?, StatusMessage: str?}}}}\n\n@endgroup\n\n@group profiles\n@endpoint GET /profiles/{ProfileArn}\n@desc Get profile information.\n@required {ProfileArn: str}\n@optional {ProfileVersion: str}\n@returns(200) {Profile: Profile?{ProfileArn: str?, ProfileVersion: str?, ProfileName: str?, ProfileDescription: str?, ProfileQuestions: [ProfileQuestion]?, Owner: str?, CreatedAt: str(timestamp)?, UpdatedAt: str(timestamp)?, ShareInvitationId: str?, Tags: map<str, str>?: any}}\n\n@endgroup\n\n@group profileTemplate\n@endpoint GET /profileTemplate\n@desc Get profile template.\n@returns(200) {ProfileTemplate: ProfileTemplate?{TemplateName: str?, TemplateQuestions: [ProfileTemplateQuestion]?, CreatedAt: str(timestamp)?, UpdatedAt: str(timestamp)?}}\n\n@endgroup\n\n@group reviewTemplates\n@endpoint GET /reviewTemplates/{TemplateArn}\n@desc Get review template.\n@required {TemplateArn: str}\n@returns(200) {ReviewTemplate: ReviewTemplate?{Description: str?, Lenses: [str]?, Notes: str?, QuestionCounts: map<str, int>?: any, Owner: str?, UpdatedAt: str(timestamp)?, TemplateArn: str?, TemplateName: str?, Tags: map<str, str>?: any, UpdateStatus: str?, ShareInvitationId: str?}}\n\n@endpoint GET /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/answers/{QuestionId}\n@desc Get review template answer.\n@required {TemplateArn: str, LensAlias: str, QuestionId: str}\n@returns(200) {TemplateArn: str?, LensAlias: str?, Answer: ReviewTemplateAnswer?{QuestionId: str?, PillarId: str?, QuestionTitle: str?, QuestionDescription: str?, ImprovementPlanUrl: str?, HelpfulResourceUrl: str?, HelpfulResourceDisplayText: str?, Choices: [Choice]?, SelectedChoices: [str]?, ChoiceAnswers: [ChoiceAnswer]?, IsApplicable: bool?, AnswerStatus: str?, Notes: str?, Reason: str?}}\n\n@endpoint GET /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}\n@desc Get a lens review associated with a review template.\n@required {TemplateArn: str, LensAlias: str}\n@returns(200) {TemplateArn: str?, LensReview: ReviewTemplateLensReview?{LensAlias: str?, LensArn: str?, LensVersion: str?, LensName: str?, LensStatus: str?, PillarReviewSummaries: [ReviewTemplatePillarReviewSummary]?, UpdatedAt: str(timestamp)?, Notes: str?, QuestionCounts: map<str, int>?: any, NextToken: str?}}\n\n@endgroup\n\n@group workloads\n@endpoint GET /workloads/{WorkloadId}\n@desc Get an existing workload.\n@required {WorkloadId: str}\n@returns(200) {Workload: Workload?{WorkloadId: str?, WorkloadArn: str?, WorkloadName: str?, Description: str?, Environment: str?, UpdatedAt: str(timestamp)?, AccountIds: [str]?, AwsRegions: [str]?, NonAwsRegions: [str]?, ArchitecturalDesign: str?, ReviewOwner: str?, ReviewRestrictionDate: str(timestamp)?, IsReviewOwnerUpdateAcknowledged: bool?, IndustryType: str?, Industry: str?, Notes: str?, ImprovementStatus: str?, RiskCounts: map<str, int>?: any, PillarPriorities: [str]?, Lenses: [str]?, Owner: str?, ShareInvitationId: str?, Tags: map<str, str>?: any, DiscoveryConfig: WorkloadDiscoveryConfig?{TrustedAdvisorIntegrationStatus: str?, WorkloadResourceDefinition: [str]?}, Applications: [str]?, Profiles: [WorkloadProfile]?, PrioritizedRiskCounts: map<str, int>?: any, JiraConfiguration: WorkloadJiraConfigurationOutput?{IssueManagementStatus: str?, IssueManagementType: str?, JiraProjectKey: str?, StatusMessage: str?}}}\n\n@endgroup\n\n@group importLens\n@endpoint PUT /importLens\n@desc 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  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.\n@required {JSONString: str, ClientRequestToken: str}\n@optional {LensAlias: str, Tags: map<str,str>}\n@returns(200) {LensArn: str?, Status: str?}\n\n@endgroup\n\n@group workloads\n@endpoint GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers\n@desc List of answers for a particular workload and lens.\n@required {WorkloadId: str, LensAlias: str}\n@optional {PillarId: str, MilestoneNumber: int, NextToken: str, MaxResults: int, QuestionPriority: str}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?, LensAlias: str?, LensArn: str?, AnswerSummaries: [AnswerSummary]?, NextToken: str?}\n\n@endpoint POST /workloads/{WorkloadId}/checks\n@desc List of Trusted Advisor check details by account related to the workload.\n@required {WorkloadId: str, LensArn: str, PillarId: str, QuestionId: str, ChoiceId: str}\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {CheckDetails: [CheckDetail]?, NextToken: str?}\n\n@endpoint POST /workloads/{WorkloadId}/checkSummaries\n@desc List of Trusted Advisor checks summarized for all accounts related to the workload.\n@required {WorkloadId: str, LensArn: str, PillarId: str, QuestionId: str, ChoiceId: str}\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {CheckSummaries: [CheckSummary]?, NextToken: str?}\n\n@endpoint GET /workloads/{WorkloadId}/lensReviews/{LensAlias}/improvements\n@desc List the improvements of a particular lens review.\n@required {WorkloadId: str, LensAlias: str}\n@optional {PillarId: str, MilestoneNumber: int, NextToken: str, MaxResults: int, QuestionPriority: str}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?, LensAlias: str?, LensArn: str?, ImprovementSummaries: [ImprovementSummary]?, NextToken: str?}\n\n@endpoint GET /workloads/{WorkloadId}/lensReviews\n@desc List lens reviews for a particular workload.\n@required {WorkloadId: str}\n@optional {MilestoneNumber: int, NextToken: str, MaxResults: int}\n@returns(200) {WorkloadId: str?, MilestoneNumber: int?, LensReviewSummaries: [LensReviewSummary]?, NextToken: str?}\n\n@endgroup\n\n@group lenses\n@endpoint GET /lenses/{LensAlias}/shares\n@desc List the lens shares associated with the lens.\n@required {LensAlias: str}\n@optional {SharedWithPrefix: str, NextToken: str, MaxResults: int, Status: str}\n@returns(200) {LensShareSummaries: [LensShareSummary]?, NextToken: str?}\n\n@endpoint GET /lenses\n@desc List the available lenses.\n@optional {NextToken: str, MaxResults: int, LensType: str, LensStatus: str, LensName: str}\n@returns(200) {LensSummaries: [LensSummary]?, NextToken: str?}\n\n@endgroup\n\n@group workloads\n@endpoint POST /workloads/{WorkloadId}/milestonesSummaries\n@desc List all milestones for an existing workload.\n@required {WorkloadId: str}\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {WorkloadId: str?, MilestoneSummaries: [MilestoneSummary]?, NextToken: str?}\n\n@endgroup\n\n@group notifications\n@endpoint POST /notifications\n@desc List lens notifications.\n@optional {WorkloadId: str, NextToken: str, MaxResults: int, ResourceArn: str}\n@returns(200) {NotificationSummaries: [NotificationSummary]?, NextToken: str?}\n\n@endgroup\n\n@group profileNotifications\n@endpoint GET /profileNotifications/\n@desc List profile notifications.\n@optional {WorkloadId: str, NextToken: str, MaxResults: int}\n@returns(200) {NotificationSummaries: [ProfileNotificationSummary]?, NextToken: str?}\n\n@endgroup\n\n@group profiles\n@endpoint GET /profiles/{ProfileArn}/shares\n@desc List profile shares.\n@required {ProfileArn: str}\n@optional {SharedWithPrefix: str, NextToken: str, MaxResults: int, Status: str}\n@returns(200) {ProfileShareSummaries: [ProfileShareSummary]?, NextToken: str?}\n\n@endgroup\n\n@group profileSummaries\n@endpoint GET /profileSummaries\n@desc List profiles.\n@optional {ProfileNamePrefix: str, ProfileOwnerType: str, NextToken: str, MaxResults: int}\n@returns(200) {ProfileSummaries: [ProfileSummary]?, NextToken: str?}\n\n@endgroup\n\n@group reviewTemplates\n@endpoint GET /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/answers\n@desc List the answers of a review template.\n@required {TemplateArn: str, LensAlias: str}\n@optional {PillarId: str, NextToken: str, MaxResults: int}\n@returns(200) {TemplateArn: str?, LensAlias: str?, AnswerSummaries: [ReviewTemplateAnswerSummary]?, NextToken: str?}\n\n@endpoint GET /reviewTemplates\n@desc List review templates.\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {ReviewTemplates: [ReviewTemplateSummary]?, NextToken: str?}\n\n@endgroup\n\n@group shareInvitations\n@endpoint GET /shareInvitations\n@desc List the share invitations.  WorkloadNamePrefix, LensNamePrefix, ProfileNamePrefix, and TemplateNamePrefix are mutually exclusive. Use the parameter that matches your ShareResourceType.\n@optional {WorkloadNamePrefix: str, LensNamePrefix: str, ShareResourceType: str, NextToken: str, MaxResults: int, ProfileNamePrefix: str, TemplateNamePrefix: str}\n@returns(200) {ShareInvitationSummaries: [ShareInvitationSummary]?, NextToken: str?}\n\n@endgroup\n\n@group tags\n@endpoint GET /tags/{WorkloadArn}\n@desc 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.\n@required {WorkloadArn: str}\n@returns(200) {Tags: map<str,str>?}\n\n@endgroup\n\n@group templates\n@endpoint GET /templates/shares/{TemplateArn}\n@desc List review template shares.\n@required {TemplateArn: str}\n@optional {SharedWithPrefix: str, NextToken: str, MaxResults: int, Status: str}\n@returns(200) {TemplateArn: str?, TemplateShareSummaries: [TemplateShareSummary]?, NextToken: str?}\n\n@endgroup\n\n@group workloads\n@endpoint GET /workloads/{WorkloadId}/shares\n@desc List the workload shares associated with the workload.\n@required {WorkloadId: str}\n@optional {SharedWithPrefix: str, NextToken: str, MaxResults: int, Status: str}\n@returns(200) {WorkloadId: str?, WorkloadShareSummaries: [WorkloadShareSummary]?, NextToken: str?}\n\n@endgroup\n\n@group workloadsSummaries\n@endpoint POST /workloadsSummaries\n@desc Paginated list of workloads.\n@optional {WorkloadNamePrefix: str, NextToken: str, MaxResults: int}\n@returns(200) {WorkloadSummaries: [WorkloadSummary]?, NextToken: str?}\n\n@endgroup\n\n@group tags\n@endpoint POST /tags/{WorkloadArn}\n@desc 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.\n@required {WorkloadArn: str, Tags: map<str,str>}\n\n@endpoint DELETE /tags/{WorkloadArn}\n@desc 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\n@required {WorkloadArn: str, tagKeys: [str]}\n\n@endgroup\n\n@group workloads\n@endpoint PATCH /workloads/{WorkloadId}/lensReviews/{LensAlias}/answers/{QuestionId}\n@desc Update the answer to a specific question in a workload review.\n@required {WorkloadId: str, LensAlias: str, QuestionId: str}\n@optional {SelectedChoices: [str], ChoiceUpdates: map<str,ChoiceUpdate>, Notes: str, IsApplicable: bool, Reason: str}\n@returns(200) {WorkloadId: str?, LensAlias: str?, LensArn: str?, Answer: Answer?{QuestionId: str?, PillarId: str?, QuestionTitle: str?, QuestionDescription: str?, ImprovementPlanUrl: str?, HelpfulResourceUrl: str?, HelpfulResourceDisplayText: str?, Choices: [Choice]?, SelectedChoices: [str]?, ChoiceAnswers: [ChoiceAnswer]?, IsApplicable: bool?, Risk: str?, Notes: str?, Reason: str?, JiraConfiguration: JiraConfiguration?{JiraIssueUrl: str?, LastSyncedTime: str(timestamp)?}}}\n\n@endgroup\n\n@group global-settings\n@endpoint PATCH /global-settings\n@desc Update whether the Amazon Web Services account is opted into organization sharing and discovery integration features.\n@optional {OrganizationSharingStatus: str, DiscoveryIntegrationStatus: str, JiraConfiguration: AccountJiraConfigurationInput}\n\n@endgroup\n\n@group workloads\n@endpoint POST /workloads/{WorkloadId}/updateIntegration\n@desc Update integration features.\n@required {WorkloadId: str, ClientRequestToken: str, IntegratingService: str}\n\n@endpoint PATCH /workloads/{WorkloadId}/lensReviews/{LensAlias}\n@desc Update lens review for a particular workload.\n@required {WorkloadId: str, LensAlias: str}\n@optional {LensNotes: str, PillarNotes: map<str,str>, JiraConfiguration: JiraSelectedQuestionConfiguration}\n@returns(200) {WorkloadId: str?, LensReview: LensReview?{LensAlias: str?, LensArn: str?, LensVersion: str?, LensName: str?, LensStatus: str?, PillarReviewSummaries: [PillarReviewSummary]?, JiraConfiguration: JiraSelectedQuestionConfiguration?{SelectedPillars: [SelectedPillar]?}, UpdatedAt: str(timestamp)?, Notes: str?, RiskCounts: map<str, int>?: any, NextToken: str?, Profiles: [WorkloadProfile]?, PrioritizedRiskCounts: map<str, int>?: any}}\n\n@endgroup\n\n@group profiles\n@endpoint PATCH /profiles/{ProfileArn}\n@desc Update a profile.\n@required {ProfileArn: str}\n@optional {ProfileDescription: str, ProfileQuestions: [ProfileQuestionUpdate]}\n@returns(200) {Profile: Profile?{ProfileArn: str?, ProfileVersion: str?, ProfileName: str?, ProfileDescription: str?, ProfileQuestions: [ProfileQuestion]?, Owner: str?, CreatedAt: str(timestamp)?, UpdatedAt: str(timestamp)?, ShareInvitationId: str?, Tags: map<str, str>?: any}}\n\n@endgroup\n\n@group reviewTemplates\n@endpoint PATCH /reviewTemplates/{TemplateArn}\n@desc Update a review template.\n@required {TemplateArn: str}\n@optional {TemplateName: str, Description: str, Notes: str, LensesToAssociate: [str], LensesToDisassociate: [str]}\n@returns(200) {ReviewTemplate: ReviewTemplate?{Description: str?, Lenses: [str]?, Notes: str?, QuestionCounts: map<str, int>?: any, Owner: str?, UpdatedAt: str(timestamp)?, TemplateArn: str?, TemplateName: str?, Tags: map<str, str>?: any, UpdateStatus: str?, ShareInvitationId: str?}}\n\n@endpoint PATCH /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/answers/{QuestionId}\n@desc Update a review template answer.\n@required {TemplateArn: str, LensAlias: str, QuestionId: str}\n@optional {SelectedChoices: [str], ChoiceUpdates: map<str,ChoiceUpdate>, Notes: str, IsApplicable: bool, Reason: str}\n@returns(200) {TemplateArn: str?, LensAlias: str?, Answer: ReviewTemplateAnswer?{QuestionId: str?, PillarId: str?, QuestionTitle: str?, QuestionDescription: str?, ImprovementPlanUrl: str?, HelpfulResourceUrl: str?, HelpfulResourceDisplayText: str?, Choices: [Choice]?, SelectedChoices: [str]?, ChoiceAnswers: [ChoiceAnswer]?, IsApplicable: bool?, AnswerStatus: str?, Notes: str?, Reason: str?}}\n\n@endpoint PATCH /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}\n@desc Update a lens review associated with a review template.\n@required {TemplateArn: str, LensAlias: str}\n@optional {LensNotes: str, PillarNotes: map<str,str>}\n@returns(200) {TemplateArn: str?, LensReview: ReviewTemplateLensReview?{LensAlias: str?, LensArn: str?, LensVersion: str?, LensName: str?, LensStatus: str?, PillarReviewSummaries: [ReviewTemplatePillarReviewSummary]?, UpdatedAt: str(timestamp)?, Notes: str?, QuestionCounts: map<str, int>?: any, NextToken: str?}}\n\n@endgroup\n\n@group shareInvitations\n@endpoint PATCH /shareInvitations/{ShareInvitationId}\n@desc Update a workload or custom lens share invitation.  This API operation can be called independently of any resource. Previous documentation implied that a workload ARN must be specified.\n@required {ShareInvitationId: str, ShareInvitationAction: str}\n@returns(200) {ShareInvitation: ShareInvitation?{ShareInvitationId: str?, ShareResourceType: str?, WorkloadId: str?, LensAlias: str?, LensArn: str?, ProfileArn: str?, TemplateArn: str?}}\n\n@endgroup\n\n@group workloads\n@endpoint PATCH /workloads/{WorkloadId}\n@desc Update an existing workload.\n@required {WorkloadId: str}\n@optional {WorkloadName: str, Description: str, Environment: str, AccountIds: [str], AwsRegions: [str], NonAwsRegions: [str], PillarPriorities: [str], ArchitecturalDesign: str, ReviewOwner: str, IsReviewOwnerUpdateAcknowledged: bool, IndustryType: str, Industry: str, Notes: str, ImprovementStatus: str, DiscoveryConfig: WorkloadDiscoveryConfig, Applications: [str], JiraConfiguration: WorkloadJiraConfigurationInput}\n@returns(200) {Workload: Workload?{WorkloadId: str?, WorkloadArn: str?, WorkloadName: str?, Description: str?, Environment: str?, UpdatedAt: str(timestamp)?, AccountIds: [str]?, AwsRegions: [str]?, NonAwsRegions: [str]?, ArchitecturalDesign: str?, ReviewOwner: str?, ReviewRestrictionDate: str(timestamp)?, IsReviewOwnerUpdateAcknowledged: bool?, IndustryType: str?, Industry: str?, Notes: str?, ImprovementStatus: str?, RiskCounts: map<str, int>?: any, PillarPriorities: [str]?, Lenses: [str]?, Owner: str?, ShareInvitationId: str?, Tags: map<str, str>?: any, DiscoveryConfig: WorkloadDiscoveryConfig?{TrustedAdvisorIntegrationStatus: str?, WorkloadResourceDefinition: [str]?}, Applications: [str]?, Profiles: [WorkloadProfile]?, PrioritizedRiskCounts: map<str, int>?: any, JiraConfiguration: WorkloadJiraConfigurationOutput?{IssueManagementStatus: str?, IssueManagementType: str?, JiraProjectKey: str?, StatusMessage: str?}}}\n\n@endpoint PATCH /workloads/{WorkloadId}/shares/{ShareId}\n@desc Update a workload share.\n@required {ShareId: str, WorkloadId: str, PermissionType: str}\n@returns(200) {WorkloadId: str?, WorkloadShare: WorkloadShare?{ShareId: str?, SharedBy: str?, SharedWith: str?, PermissionType: str?, Status: str?, WorkloadName: str?, WorkloadId: str?}}\n\n@endpoint PUT /workloads/{WorkloadId}/lensReviews/{LensAlias}/upgrade\n@desc Upgrade lens review for a particular workload.\n@required {WorkloadId: str, LensAlias: str, MilestoneName: str}\n@optional {ClientRequestToken: str}\n\n@endpoint PUT /workloads/{WorkloadId}/profiles/{ProfileArn}/upgrade\n@desc Upgrade a profile.\n@required {WorkloadId: str, ProfileArn: str}\n@optional {MilestoneName: str, ClientRequestToken: str}\n\n@endgroup\n\n@group reviewTemplates\n@endpoint PUT /reviewTemplates/{TemplateArn}/lensReviews/{LensAlias}/upgrade\n@desc Upgrade the lens review of a review template.\n@required {TemplateArn: str, LensAlias: str}\n@optional {ClientRequestToken: str}\n\n@endgroup\n\n@end\n"}}