We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 28, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
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:
- Aggregation
Configuration List<Pulumi.Aws Native. Well Architected. Inputs. Agent Profile Aggregation Configuration> - The aggregation configuration entries (account, regions, access role) associated with this profile.
- Execution
Role stringArn - The ARN of the IAM role assumed to execute recommendation actions.
- Pillars
List<Pulumi.
Aws Native. Well Architected. Agent Profile Pillar> - 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.
-
List<Pulumi.
Aws Native. Inputs. Tag> - Key-value pairs to associate with the Agent Profile.
- Aggregation
Configuration []AgentProfile Aggregation Configuration Args - The aggregation configuration entries (account, regions, access role) associated with this profile.
- Execution
Role stringArn - The ARN of the IAM role assumed to execute recommendation actions.
- Pillars
[]Agent
Profile Pillar - 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.
-
Tag
Args - 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_ stringarn - 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.
- list(object)
- Key-value pairs to associate with the Agent Profile.
- aggregation
Configuration List<AgentProfile Aggregation Configuration> - The aggregation configuration entries (account, regions, access role) associated with this profile.
- execution
Role StringArn - The ARN of the IAM role assumed to execute recommendation actions.
- pillars
List<Agent
Profile Pillar> - 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 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.
- 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.
- List<Tag>
- Key-value pairs to associate with the Agent Profile.
- aggregation
Configuration AgentProfile Aggregation Configuration[] - The aggregation configuration entries (account, regions, access role) associated with this profile.
- execution
Role stringArn - The ARN of the IAM role assumed to execute recommendation actions.
- pillars
Agent
Profile Pillar[] - 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 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.
- 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.
- Tag[]
- Key-value pairs to associate with the Agent Profile.
- aggregation_
configuration Sequence[AgentProfile Aggregation Configuration Args] - The aggregation configuration entries (account, regions, access role) associated with this profile.
- execution_
role_ strarn - The ARN of the IAM role assumed to execute recommendation actions.
- pillars
Sequence[Agent
Profile Pillar] - 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.
-
Sequence[Tag
Args] - Key-value pairs to associate with the Agent Profile.
- aggregation
Configuration List<Property Map> - The aggregation configuration entries (account, regions, access role) associated with this profile.
- execution
Role StringArn - 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 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.
- 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.
- 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.
- 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 stringAt - The timestamp when the profile was last modified.
- Last
Modified stringBy - 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 stringAt - The timestamp when the profile was last modified.
- Last
Modified stringBy - 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_ stringat - The timestamp when the profile was last modified.
- last_
modified_ stringby - 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 StringAt - The timestamp when the profile was last modified.
- last
Modified StringBy - 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 stringAt - The timestamp when the profile was last modified.
- last
Modified stringBy - 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_ strat - The timestamp when the profile was last modified.
- last_
modified_ strby - 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 StringAt - The timestamp when the profile was last modified.
- last
Modified StringBy - 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.- Access
Role stringArn - 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.
- Access
Role stringArn - The ARN of the IAM role used to access resources in this account.
- Account
Id string - The target AWS account ID.
- Regions []string
- The target regions in the account.
- access_
role_ stringarn - 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.
- access
Role StringArn - 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.
- access
Role stringArn - The ARN of the IAM role used to access resources in this account.
- account
Id string - The target AWS account ID.
- regions string[]
- The target regions in the account.
- access_
role_ strarn - 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.
- access
Role StringArn - 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.
AgentProfilePillar, AgentProfilePillarArgs
- Cost
Optimization COST_OPTIMIZATION- Security
SECURITY- Resilience
RESILIENCE- Performance
PERFORMANCE
- Agent
Profile Pillar Cost Optimization COST_OPTIMIZATION- Agent
Profile Pillar Security SECURITY- Agent
Profile Pillar Resilience RESILIENCE- Agent
Profile Pillar Performance PERFORMANCE
- "COST_OPTIMIZATION"
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
- 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.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 28, 2026 by Pulumi