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

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 schema for AWS::WellArchitected::AgentGoal. An Agent Goal expresses a Well-Architected objective (a title, optional description, and the pillars it targets) within an Agent Profile, used to focus Well-Architected Agent recommendations.

    Create AgentGoal Resource

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

    Constructor syntax

    new AgentGoal(name: string, args: AgentGoalArgs, opts?: CustomResourceOptions);
    @overload
    def AgentGoal(resource_name: str,
                  args: AgentGoalArgs,
                  opts: Optional[ResourceOptions] = None)
    
    @overload
    def AgentGoal(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  pillars: Optional[Sequence[AgentGoalPillar]] = None,
                  profile_arn: Optional[str] = None,
                  title: Optional[str] = None,
                  description: Optional[str] = None)
    func NewAgentGoal(ctx *Context, name string, args AgentGoalArgs, opts ...ResourceOption) (*AgentGoal, error)
    public AgentGoal(string name, AgentGoalArgs args, CustomResourceOptions? opts = null)
    public AgentGoal(String name, AgentGoalArgs args)
    public AgentGoal(String name, AgentGoalArgs args, CustomResourceOptions options)
    
    type: aws-native:wellarchitected:AgentGoal
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_wellarchitected_agent_goal" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args AgentGoalArgs
    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 AgentGoalArgs
    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 AgentGoalArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AgentGoalArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AgentGoalArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    AgentGoal 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 AgentGoal resource accepts the following input properties:

    Pillars List<Pulumi.AwsNative.WellArchitected.AgentGoalPillar>
    The list of Well-Architected pillars this goal targets.
    ProfileArn string
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    Title string
    The title of the Agent Goal.
    Description string
    A description of the Agent Goal.
    Pillars []AgentGoalPillar
    The list of Well-Architected pillars this goal targets.
    ProfileArn string
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    Title string
    The title of the Agent Goal.
    Description string
    A description of the Agent Goal.
    pillars list("COST_OPTIMIZATION" | "SECURITY" | "RESILIENCE" | "PERFORMANCE" | "OPERATIONAL_EXCELLENCE")
    The list of Well-Architected pillars this goal targets.
    profile_arn string
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    title string
    The title of the Agent Goal.
    description string
    A description of the Agent Goal.
    pillars List<AgentGoalPillar>
    The list of Well-Architected pillars this goal targets.
    profileArn String
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    title String
    The title of the Agent Goal.
    description String
    A description of the Agent Goal.
    pillars AgentGoalPillar[]
    The list of Well-Architected pillars this goal targets.
    profileArn string
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    title string
    The title of the Agent Goal.
    description string
    A description of the Agent Goal.
    pillars Sequence[AgentGoalPillar]
    The list of Well-Architected pillars this goal targets.
    profile_arn str
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    title str
    The title of the Agent Goal.
    description str
    A description of the Agent Goal.
    pillars List<"COST_OPTIMIZATION" | "SECURITY" | "RESILIENCE" | "PERFORMANCE" | "OPERATIONAL_EXCELLENCE">
    The list of Well-Architected pillars this goal targets.
    profileArn String
    The Amazon Resource Name (ARN) of the parent Agent Profile that owns this goal. Pass !Ref of the parent AWS::WellArchitected::AgentProfile to flow its ARN here.
    title String
    The title of the Agent Goal.
    description String
    A description of the Agent Goal.

    Outputs

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

    Arn string
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    AwsId string
    The service-generated unique identifier of the Agent Goal.
    CreatedAt string
    The timestamp when the goal was created.
    CreatedBy string
    The identifier of the system or user that created this goal.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedAt string
    The timestamp when the goal was last modified.
    LastModifiedBy string
    The identifier of the system or user that last modified this goal.
    Arn string
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    AwsId string
    The service-generated unique identifier of the Agent Goal.
    CreatedAt string
    The timestamp when the goal was created.
    CreatedBy string
    The identifier of the system or user that created this goal.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedAt string
    The timestamp when the goal was last modified.
    LastModifiedBy string
    The identifier of the system or user that last modified this goal.
    arn string
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    aws_id string
    The service-generated unique identifier of the Agent Goal.
    created_at string
    The timestamp when the goal was created.
    created_by string
    The identifier of the system or user that created this goal.
    id string
    The provider-assigned unique ID for this managed resource.
    last_modified_at string
    The timestamp when the goal was last modified.
    last_modified_by string
    The identifier of the system or user that last modified this goal.
    arn String
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    awsId String
    The service-generated unique identifier of the Agent Goal.
    createdAt String
    The timestamp when the goal was created.
    createdBy String
    The identifier of the system or user that created this goal.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt String
    The timestamp when the goal was last modified.
    lastModifiedBy String
    The identifier of the system or user that last modified this goal.
    arn string
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    awsId string
    The service-generated unique identifier of the Agent Goal.
    createdAt string
    The timestamp when the goal was created.
    createdBy string
    The identifier of the system or user that created this goal.
    id string
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt string
    The timestamp when the goal was last modified.
    lastModifiedBy string
    The identifier of the system or user that last modified this goal.
    arn str
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    aws_id str
    The service-generated unique identifier of the Agent Goal.
    created_at str
    The timestamp when the goal was created.
    created_by str
    The identifier of the system or user that created this goal.
    id str
    The provider-assigned unique ID for this managed resource.
    last_modified_at str
    The timestamp when the goal was last modified.
    last_modified_by str
    The identifier of the system or user that last modified this goal.
    arn String
    The synthetic Amazon Resource Name (ARN) of the Agent Goal, composed of the parent profile ARN and the goal id.
    awsId String
    The service-generated unique identifier of the Agent Goal.
    createdAt String
    The timestamp when the goal was created.
    createdBy String
    The identifier of the system or user that created this goal.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt String
    The timestamp when the goal was last modified.
    lastModifiedBy String
    The identifier of the system or user that last modified this goal.

    Supporting Types

    AgentGoalPillar, AgentGoalPillarArgs

    CostOptimization
    COST_OPTIMIZATION
    Security
    SECURITY
    Resilience
    RESILIENCE
    Performance
    PERFORMANCE
    OperationalExcellence
    OPERATIONAL_EXCELLENCE
    AgentGoalPillarCostOptimization
    COST_OPTIMIZATION
    AgentGoalPillarSecurity
    SECURITY
    AgentGoalPillarResilience
    RESILIENCE
    AgentGoalPillarPerformance
    PERFORMANCE
    AgentGoalPillarOperationalExcellence
    OPERATIONAL_EXCELLENCE
    "COST_OPTIMIZATION"
    COST_OPTIMIZATION
    "SECURITY"
    SECURITY
    "RESILIENCE"
    RESILIENCE
    "PERFORMANCE"
    PERFORMANCE
    "OPERATIONAL_EXCELLENCE"
    OPERATIONAL_EXCELLENCE
    CostOptimization
    COST_OPTIMIZATION
    Security
    SECURITY
    Resilience
    RESILIENCE
    Performance
    PERFORMANCE
    OperationalExcellence
    OPERATIONAL_EXCELLENCE
    CostOptimization
    COST_OPTIMIZATION
    Security
    SECURITY
    Resilience
    RESILIENCE
    Performance
    PERFORMANCE
    OperationalExcellence
    OPERATIONAL_EXCELLENCE
    COST_OPTIMIZATION
    COST_OPTIMIZATION
    SECURITY
    SECURITY
    RESILIENCE
    RESILIENCE
    PERFORMANCE
    PERFORMANCE
    OPERATIONAL_EXCELLENCE
    OPERATIONAL_EXCELLENCE
    "COST_OPTIMIZATION"
    COST_OPTIMIZATION
    "SECURITY"
    SECURITY
    "RESILIENCE"
    RESILIENCE
    "PERFORMANCE"
    PERFORMANCE
    "OPERATIONAL_EXCELLENCE"
    OPERATIONAL_EXCELLENCE

    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