WellArchitected / Client / update_agent_profile

update_agent_profile

WellArchitected.Client.update_agent_profile(**kwargs)

Updates an existing optimization profile’s configuration, including its pillars, execution role, and aggregation settings.

See also: AWS API Documentation

Request Syntax

response = client.update_agent_profile(
    clientToken='string',
    profileArn='string',
    displayName='string',
    description='string',
    executionRoleArn='string',
    aggregationConfiguration=[
        {
            'accountId': 'string',
            'regions': [
                'string',
            ],
            'accessRoleArn': 'string'
        },
    ],
    businessOverview='string',
    pillars=[
        'COST_OPTIMIZATION'|'SECURITY'|'RESILIENCE'|'PERFORMANCE'|'OPERATIONAL_EXCELLENCE',
    ],
    deletionProtection=True|False
)

Parameters:

• clientToken (string) –

  A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

  This field is autopopulated if not provided.

• profileArn (string) –

  [REQUIRED]

  The Amazon Resource Name (ARN) of the profile to update.

• displayName (string) – The updated display name of the profile.

• description (string) – The updated description of the profile.

• executionRoleArn (string) – The updated ARN of the IAM execution role.

• aggregationConfiguration (list) –

  The updated aggregation configuration.

  • (dict) –

    Configuration settings that define the scope of Amazon Web Services resources to analyze for optimization recommendations.

    • accountId (string) – [REQUIRED]

      The Amazon Web Services account ID to analyze.

    • regions (list) – [REQUIRED]

      A list of Amazon Web Services Regions to include in the analysis.

      • (string) –

    • accessRoleArn (string) – [REQUIRED]

      The ARN of an IAM role to assume for resource analysis in this account.

• businessOverview (string) – The updated business overview for the profile.

• pillars (list) –

  The updated Well-Architected Tool Framework pillars for the profile.

  • (string) –

• deletionProtection (boolean) – Indicates whether deletion protection is enabled for the profile.

Return type:

dict

Returns:

Response Syntax

{
    'name': 'string',
    'displayName': 'string',
    'description': 'string',
    'businessOverview': 'string',
    'pillars': [
        'COST_OPTIMIZATION'|'SECURITY'|'RESILIENCE'|'PERFORMANCE'|'OPERATIONAL_EXCELLENCE',
    ],
    'deletionProtection': True|False,
    'executionRoleArn': 'string',
    'aggregationConfiguration': [
        {
            'accountId': 'string',
            'regions': [
                'string',
            ],
            'accessRoleArn': 'string'
        },
    ],
    'arn': 'string',
    'eligibleForScheduledGeneration': True|False,
    'eligibleForArchitectureGeneration': True|False,
    'fieldErrors': {
        'string': 'string'
    },
    'tags': [
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    'createdBy': 'string',
    'createdAt': datetime(2015, 1, 1),
    'lastModifiedBy': 'string',
    'lastModifiedAt': datetime(2015, 1, 1)
}

Response Structure

• (dict) –

  • name (string) –

    The system name of the updated profile.

  • displayName (string) –

    The display name of the updated profile.

  • description (string) –

    A description of the updated profile.

  • businessOverview (string) –

    The business overview of the updated profile.

  • pillars (list) –

    The Well-Architected Tool Framework pillars associated with the updated profile.

    • (string) –

  • deletionProtection (boolean) –

    Indicates whether deletion protection is enabled.

  • executionRoleArn (string) –

    The ARN of the IAM execution role.

  • aggregationConfiguration (list) –

    The aggregation configuration.

    • (dict) –

      Configuration settings that define the scope of Amazon Web Services resources to analyze for optimization recommendations.

      • accountId (string) –

        The Amazon Web Services account ID to analyze.

      • regions (list) –

        A list of Amazon Web Services Regions to include in the analysis.

        • (string) –

      • accessRoleArn (string) –

        The ARN of an IAM role to assume for resource analysis in this account.

  • arn (string) –

    The Amazon Resource Name (ARN) of the updated profile.

  • eligibleForScheduledGeneration (boolean) –

    Indicates whether the profile is valid for scheduled recommendation generation.

  • eligibleForArchitectureGeneration (boolean) –

    Indicates whether the profile is valid for manual architecture generation.

  • fieldErrors (dict) –

    A map of field paths to error messages for invalid or missing input fields.

    • (string) –

      • (string) –

  • tags (list) –

    The tags associated with the updated profile.

    • (dict) –

      A key-value pair associated with a resource for cost allocation and access control.

      • key (string) –

        The key of the tag.

      • value (string) –

        The value of the tag.

  • createdBy (string) –

    The identifier of the user or system that created this profile.

  • createdAt (datetime) –

    The timestamp when the profile was created.

  • lastModifiedBy (string) –

    The identifier of the user or system that last modified this profile.

  • lastModifiedAt (datetime) –

    The timestamp when the profile was last modified.

Exceptions

• WellArchitected.Client.exceptions.AccessDeniedException

• WellArchitected.Client.exceptions.ValidationException

• WellArchitected.Client.exceptions.InternalServerException

• WellArchitected.Client.exceptions.ResourceNotFoundException

• WellArchitected.Client.exceptions.ThrottlingException