1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. wellarchitected
  6. AgentProfile

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi

    Resource Type definition for AWS::WellArchitected::AgentProfile. An Agent Profile defines the execution role, account/region scope (via aggregation configuration access roles), and Well-Architected pillar focus used to generate Well-Architected Agent recommendations.

    Create AgentProfile Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new AgentProfile(name: string, args: AgentProfileArgs, opts?: CustomResourceOptions);
    @overload
    def AgentProfile(resource_name: str,
                     args: AgentProfileArgs,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def AgentProfile(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     aggregation_configuration: Optional[Sequence[AgentProfileAggregationConfigurationArgs]] = None,
                     execution_role_arn: Optional[str] = None,
                     pillars: Optional[Sequence[AgentProfilePillar]] = None,
                     business_overview: Optional[str] = None,
                     deletion_protection: Optional[bool] = None,
                     description: Optional[str] = None,
                     display_name: Optional[str] = None,
                     name: Optional[str] = None,
                     tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewAgentProfile(ctx *Context, name string, args AgentProfileArgs, opts ...ResourceOption) (*AgentProfile, error)
    public AgentProfile(string name, AgentProfileArgs args, CustomResourceOptions? opts = null)
    public AgentProfile(String name, AgentProfileArgs args)
    public AgentProfile(String name, AgentProfileArgs args, CustomResourceOptions options)
    
    type: aws-native:wellarchitected:AgentProfile
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_wellarchitected_agent_profile" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args AgentProfileArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args AgentProfileArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args AgentProfileArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AgentProfileArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AgentProfileArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    AgentProfile Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The AgentProfile resource accepts the following input properties:

    AggregationConfiguration List<Pulumi.AwsNative.WellArchitected.Inputs.AgentProfileAggregationConfiguration>
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    ExecutionRoleArn string
    The ARN of the IAM role assumed to execute recommendation actions.
    Pillars List<Pulumi.AwsNative.WellArchitected.AgentProfilePillar>
    The list of Well-Architected pillars to focus on.
    BusinessOverview string
    A business overview for the profile used to improve recommendation quality.
    DeletionProtection bool
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    Description string
    A description of the profile.
    DisplayName string
    The human-readable display name of the profile.
    Name string
    The name of the profile. Unique within the account and used as the last component of the ARN.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    Key-value pairs to associate with the Agent Profile.
    AggregationConfiguration []AgentProfileAggregationConfigurationArgs
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    ExecutionRoleArn string
    The ARN of the IAM role assumed to execute recommendation actions.
    Pillars []AgentProfilePillar
    The list of Well-Architected pillars to focus on.
    BusinessOverview string
    A business overview for the profile used to improve recommendation quality.
    DeletionProtection bool
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    Description string
    A description of the profile.
    DisplayName string
    The human-readable display name of the profile.
    Name string
    The name of the profile. Unique within the account and used as the last component of the ARN.
    Tags TagArgs
    Key-value pairs to associate with the Agent Profile.
    aggregation_configuration list(object)
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    execution_role_arn string
    The ARN of the IAM role assumed to execute recommendation actions.
    pillars list("COST_OPTIMIZATION" | "SECURITY" | "RESILIENCE" | "PERFORMANCE")
    The list of Well-Architected pillars to focus on.
    business_overview string
    A business overview for the profile used to improve recommendation quality.
    deletion_protection bool
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    description string
    A description of the profile.
    display_name string
    The human-readable display name of the profile.
    name string
    The name of the profile. Unique within the account and used as the last component of the ARN.
    tags list(object)
    Key-value pairs to associate with the Agent Profile.
    aggregationConfiguration List<AgentProfileAggregationConfiguration>
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    executionRoleArn String
    The ARN of the IAM role assumed to execute recommendation actions.
    pillars List<AgentProfilePillar>
    The list of Well-Architected pillars to focus on.
    businessOverview String
    A business overview for the profile used to improve recommendation quality.
    deletionProtection Boolean
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    description String
    A description of the profile.
    displayName String
    The human-readable display name of the profile.
    name String
    The name of the profile. Unique within the account and used as the last component of the ARN.
    tags List<Tag>
    Key-value pairs to associate with the Agent Profile.
    aggregationConfiguration AgentProfileAggregationConfiguration[]
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    executionRoleArn string
    The ARN of the IAM role assumed to execute recommendation actions.
    pillars AgentProfilePillar[]
    The list of Well-Architected pillars to focus on.
    businessOverview string
    A business overview for the profile used to improve recommendation quality.
    deletionProtection boolean
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    description string
    A description of the profile.
    displayName string
    The human-readable display name of the profile.
    name string
    The name of the profile. Unique within the account and used as the last component of the ARN.
    tags Tag[]
    Key-value pairs to associate with the Agent Profile.
    aggregation_configuration Sequence[AgentProfileAggregationConfigurationArgs]
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    execution_role_arn str
    The ARN of the IAM role assumed to execute recommendation actions.
    pillars Sequence[AgentProfilePillar]
    The list of Well-Architected pillars to focus on.
    business_overview str
    A business overview for the profile used to improve recommendation quality.
    deletion_protection bool
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    description str
    A description of the profile.
    display_name str
    The human-readable display name of the profile.
    name str
    The name of the profile. Unique within the account and used as the last component of the ARN.
    tags Sequence[TagArgs]
    Key-value pairs to associate with the Agent Profile.
    aggregationConfiguration List<Property Map>
    The aggregation configuration entries (account, regions, access role) associated with this profile.
    executionRoleArn String
    The ARN of the IAM role assumed to execute recommendation actions.
    pillars List<"COST_OPTIMIZATION" | "SECURITY" | "RESILIENCE" | "PERFORMANCE">
    The list of Well-Architected pillars to focus on.
    businessOverview String
    A business overview for the profile used to improve recommendation quality.
    deletionProtection Boolean
    Whether deletion protection is enabled for the profile. When enabled, the profile cannot be deleted until deletion protection is disabled.
    description String
    A description of the profile.
    displayName String
    The human-readable display name of the profile.
    name String
    The name of the profile. Unique within the account and used as the last component of the ARN.
    tags List<Property Map>
    Key-value pairs to associate with the Agent Profile.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the AgentProfile resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the Agent Profile.
    CreatedAt string
    The timestamp when the profile was created.
    CreatedBy string
    The identifier of the system or user that created this profile.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedAt string
    The timestamp when the profile was last modified.
    LastModifiedBy string
    The identifier of the system or user that last modified this profile.
    Arn string
    The Amazon Resource Name (ARN) of the Agent Profile.
    CreatedAt string
    The timestamp when the profile was created.
    CreatedBy string
    The identifier of the system or user that created this profile.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedAt string
    The timestamp when the profile was last modified.
    LastModifiedBy string
    The identifier of the system or user that last modified this profile.
    arn string
    The Amazon Resource Name (ARN) of the Agent Profile.
    created_at string
    The timestamp when the profile was created.
    created_by string
    The identifier of the system or user that created this profile.
    id string
    The provider-assigned unique ID for this managed resource.
    last_modified_at string
    The timestamp when the profile was last modified.
    last_modified_by string
    The identifier of the system or user that last modified this profile.
    arn String
    The Amazon Resource Name (ARN) of the Agent Profile.
    createdAt String
    The timestamp when the profile was created.
    createdBy String
    The identifier of the system or user that created this profile.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt String
    The timestamp when the profile was last modified.
    lastModifiedBy String
    The identifier of the system or user that last modified this profile.
    arn string
    The Amazon Resource Name (ARN) of the Agent Profile.
    createdAt string
    The timestamp when the profile was created.
    createdBy string
    The identifier of the system or user that created this profile.
    id string
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt string
    The timestamp when the profile was last modified.
    lastModifiedBy string
    The identifier of the system or user that last modified this profile.
    arn str
    The Amazon Resource Name (ARN) of the Agent Profile.
    created_at str
    The timestamp when the profile was created.
    created_by str
    The identifier of the system or user that created this profile.
    id str
    The provider-assigned unique ID for this managed resource.
    last_modified_at str
    The timestamp when the profile was last modified.
    last_modified_by str
    The identifier of the system or user that last modified this profile.
    arn String
    The Amazon Resource Name (ARN) of the Agent Profile.
    createdAt String
    The timestamp when the profile was created.
    createdBy String
    The identifier of the system or user that created this profile.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt String
    The timestamp when the profile was last modified.
    lastModifiedBy String
    The identifier of the system or user that last modified this profile.

    Supporting Types

    AgentProfileAggregationConfiguration, AgentProfileAggregationConfigurationArgs

    Defines an account, its in-scope regions, and the access role used to reach resources in that account.
    AccessRoleArn string
    The ARN of the IAM role used to access resources in this account.
    AccountId string
    The target AWS account ID.
    Regions List<string>
    The target regions in the account.
    AccessRoleArn string
    The ARN of the IAM role used to access resources in this account.
    AccountId string
    The target AWS account ID.
    Regions []string
    The target regions in the account.
    access_role_arn string
    The ARN of the IAM role used to access resources in this account.
    account_id string
    The target AWS account ID.
    regions list(string)
    The target regions in the account.
    accessRoleArn String
    The ARN of the IAM role used to access resources in this account.
    accountId String
    The target AWS account ID.
    regions List<String>
    The target regions in the account.
    accessRoleArn string
    The ARN of the IAM role used to access resources in this account.
    accountId string
    The target AWS account ID.
    regions string[]
    The target regions in the account.
    access_role_arn str
    The ARN of the IAM role used to access resources in this account.
    account_id str
    The target AWS account ID.
    regions Sequence[str]
    The target regions in the account.
    accessRoleArn String
    The ARN of the IAM role used to access resources in this account.
    accountId String
    The target AWS account ID.
    regions List<String>
    The target regions in the account.

    AgentProfilePillar, AgentProfilePillarArgs

    CostOptimization
    COST_OPTIMIZATION
    Security
    SECURITY
    Resilience
    RESILIENCE
    Performance
    PERFORMANCE
    AgentProfilePillarCostOptimization
    COST_OPTIMIZATION
    AgentProfilePillarSecurity
    SECURITY
    AgentProfilePillarResilience
    RESILIENCE
    AgentProfilePillarPerformance
    PERFORMANCE
    "COST_OPTIMIZATION"
    COST_OPTIMIZATION
    "SECURITY"
    SECURITY
    "RESILIENCE"
    RESILIENCE
    "PERFORMANCE"
    PERFORMANCE
    CostOptimization
    COST_OPTIMIZATION
    Security
    SECURITY
    Resilience
    RESILIENCE
    Performance
    PERFORMANCE
    CostOptimization
    COST_OPTIMIZATION
    Security
    SECURITY
    Resilience
    RESILIENCE
    Performance
    PERFORMANCE
    COST_OPTIMIZATION
    COST_OPTIMIZATION
    SECURITY
    SECURITY
    RESILIENCE
    RESILIENCE
    PERFORMANCE
    PERFORMANCE
    "COST_OPTIMIZATION"
    COST_OPTIMIZATION
    "SECURITY"
    SECURITY
    "RESILIENCE"
    RESILIENCE
    "PERFORMANCE"
    PERFORMANCE

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.81.0
    published on Monday, Sep 28, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial