WellArchitected / Client / update_workload

update_workload#

WellArchitected.Client.update_workload(**kwargs)#

Update an existing workload.

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