WellArchitected / Client / update_workload

update_workload#

WellArchitected.Client.update_workload(**kwargs)#

Update an existing workload.

See also: AWS API Documentation

Request Syntax

response = client.update_workload(
    WorkloadId='string',
    WorkloadName='string',
    Description='string',
    Environment='PRODUCTION'|'PREPRODUCTION',
    AccountIds=[
        'string',
    ],
    AwsRegions=[
        'string',
    ],
    NonAwsRegions=[
        'string',
    ],
    PillarPriorities=[
        'string',
    ],
    ArchitecturalDesign='string',
    ReviewOwner='string',
    IsReviewOwnerUpdateAcknowledged=True|False,
    IndustryType='string',
    Industry='string',
    Notes='string',
    ImprovementStatus='NOT_APPLICABLE'|'NOT_STARTED'|'IN_PROGRESS'|'COMPLETE'|'RISK_ACKNOWLEDGED',
    DiscoveryConfig={
        'TrustedAdvisorIntegrationStatus': 'ENABLED'|'DISABLED',
        'WorkloadResourceDefinition': [
            'WORKLOAD_METADATA'|'APP_REGISTRY',
        ]
    },
    Applications=[
        'string',
    ],
    JiraConfiguration={
        'IssueManagementStatus': 'ENABLED'|'DISABLED'|'INHERIT',
        'IssueManagementType': 'AUTO'|'MANUAL',
        'JiraProjectKey': 'string'
    }
)
Parameters:
  • WorkloadId (string) –

    [REQUIRED]

    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.

  • Description (string) – The description for the workload.

  • Environment (string) – The environment for the workload.

  • AccountIds (list) –

    The list of Amazon Web Services account IDs associated with the workload.

    • (string) –

      An Amazon Web Services account ID.

  • AwsRegions (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.

  • NonAwsRegions (list) –

    The list of non-Amazon Web Services Regions associated with the workload.

    • (string) –

  • PillarPriorities (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.

  • ArchitecturalDesign (string) – The URL of the architectural design for the workload.

  • ReviewOwner (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.

  • IsReviewOwnerUpdateAcknowledged (boolean) –

    Flag indicating whether the workload owner has acknowledged that the Review owner field is required.

    If a Review owner is not added to the workload within 60 days of acknowledgement, access to the workload is restricted until an owner is added.

  • IndustryType (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

  • Industry (string) – The industry for the workload.

  • 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.

  • ImprovementStatus (string) – The improvement status for a workload.

  • DiscoveryConfig (dict) –

    Well-Architected discovery configuration settings to associate 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) –

  • Applications (list) –

    List of AppRegistry application ARNs to associate to the workload.

    • (string) –

  • JiraConfiguration (dict) –

    Configuration of the Jira integration.

    • IssueManagementStatus (string) –

      Workload-level: Jira issue management status.

    • IssueManagementType (string) –

      Workload-level: Jira issue management type.

    • JiraProjectKey (string) –

      Workload-level: Jira project key to sync workloads to.

Return type:

dict

Returns:

Response Syntax

{
    'Workload': {
        'WorkloadId': 'string',
        'WorkloadArn': 'string',
        'WorkloadName': 'string',
        'Description': 'string',
        'Environment': 'PRODUCTION'|'PREPRODUCTION',
        'UpdatedAt': datetime(2015, 1, 1),
        'AccountIds': [
            'string',
        ],
        'AwsRegions': [
            'string',
        ],
        'NonAwsRegions': [
            'string',
        ],
        'ArchitecturalDesign': 'string',
        'ReviewOwner': 'string',
        'ReviewRestrictionDate': datetime(2015, 1, 1),
        'IsReviewOwnerUpdateAcknowledged': True|False,
        'IndustryType': 'string',
        'Industry': 'string',
        'Notes': 'string',
        'ImprovementStatus': 'NOT_APPLICABLE'|'NOT_STARTED'|'IN_PROGRESS'|'COMPLETE'|'RISK_ACKNOWLEDGED',
        'RiskCounts': {
            'string': 123
        },
        'PillarPriorities': [
            'string',
        ],
        'Lenses': [
            'string',
        ],
        'Owner': 'string',
        'ShareInvitationId': 'string',
        'Tags': {
            'string': 'string'
        },
        'DiscoveryConfig': {
            'TrustedAdvisorIntegrationStatus': 'ENABLED'|'DISABLED',
            'WorkloadResourceDefinition': [
                'WORKLOAD_METADATA'|'APP_REGISTRY',
            ]
        },
        'Applications': [
            'string',
        ],
        'Profiles': [
            {
                'ProfileArn': 'string',
                'ProfileVersion': 'string'
            },
        ],
        'PrioritizedRiskCounts': {
            'string': 123
        },
        'JiraConfiguration': {
            'IssueManagementStatus': 'ENABLED'|'DISABLED'|'INHERIT',
            'IssueManagementType': 'AUTO'|'MANUAL',
            'JiraProjectKey': 'string',
            'StatusMessage': 'string'
        }
    }
}

Response Structure

  • (dict) –

    Output of an update workload call.

    • Workload (dict) –

      A workload return object.

      • 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.

      • 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.

      • Description (string) –

        The description for the workload.

      • Environment (string) –

        The environment for the workload.

      • UpdatedAt (datetime) –

        The date and time recorded.

      • AccountIds (list) –

        The list of Amazon Web Services account IDs associated with the workload.

        • (string) –

          An Amazon Web Services account ID.

      • AwsRegions (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.

      • NonAwsRegions (list) –

        The list of non-Amazon Web Services Regions associated with the workload.

        • (string) –

      • ArchitecturalDesign (string) –

        The URL of the architectural design for the workload.

      • ReviewOwner (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.

      • ReviewRestrictionDate (datetime) –

        The date and time recorded.

      • IsReviewOwnerUpdateAcknowledged (boolean) –

        Flag indicating whether the workload owner has acknowledged that the Review owner field is required.

        If a Review owner is not added to the workload within 60 days of acknowledgement, access to the workload is restricted until an owner is added.

      • IndustryType (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

      • Industry (string) –

        The industry for the workload.

      • 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.

      • ImprovementStatus (string) –

        The improvement status for a workload.

      • RiskCounts (dict) –

        A map from risk names to the count of how many questions have that rating.

        • (string) –

          The risk for a given workload, lens review, pillar, or question.

          • (integer) –

            A non-negative integer that denotes how many.

      • PillarPriorities (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.

      • Lenses (list) –

        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.

      • Owner (string) –

        An Amazon Web Services account ID.

      • ShareInvitationId (string) –

        The ID assigned to the share invitation.

      • Tags (dict) –

        The tags associated with the workload.

        • (string) –

          • (string) –

      • DiscoveryConfig (dict) –

        Discovery configuration 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) –

      • Applications (list) –

        List of AppRegistry application ARNs associated to the workload.

        • (string) –

      • Profiles (list) –

        Profile associated with a workload.

        • (dict) –

          The profile associated with a workload.

          • ProfileArn (string) –

            The profile ARN.

          • ProfileVersion (string) –

            The profile version.

      • PrioritizedRiskCounts (dict) –

        A map from risk names to the count of how many questions have that rating.

        • (string) –

          The risk for a given workload, lens review, pillar, or question.

          • (integer) –

            A non-negative integer that denotes how many.

      • JiraConfiguration (dict) –

        Jira configuration for a specific workload.

        • IssueManagementStatus (string) –

          Workload-level: Jira issue management status.

        • IssueManagementType (string) –

          Workload-level: Jira issue management type.

        • JiraProjectKey (string) –

          Workload-level: Jira project key to sync workloads to.

        • StatusMessage (string) –

          Workload-level: Status message on configuration of the Jira integration.

Exceptions

  • WellArchitected.Client.exceptions.ValidationException

  • WellArchitected.Client.exceptions.ResourceNotFoundException

  • WellArchitected.Client.exceptions.ConflictException

  • WellArchitected.Client.exceptions.InternalServerException

  • WellArchitected.Client.exceptions.AccessDeniedException

  • WellArchitected.Client.exceptions.ThrottlingException