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

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

Viewing docs for AWS Cloud Control v1.78.0
published on Monday, Sep 7, 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.78.0
published on Monday, Sep 7, 2026 by Pulumi

    Definition of AWS::WellArchitected::Workload Resource Type

    Create Workload Resource

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

    Constructor syntax

    new Workload(name: string, args: WorkloadArgs, opts?: CustomResourceOptions);
    @overload
    def Workload(resource_name: str,
                 args: WorkloadArgs,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def Workload(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 description: Optional[str] = None,
                 lenses: Optional[Sequence[str]] = None,
                 environment: Optional[WorkloadEnvironment] = None,
                 industry: Optional[str] = None,
                 discovery_config: Optional[DiscoveryConfigPropertiesArgs] = None,
                 aws_regions: Optional[Sequence[str]] = None,
                 account_ids: Optional[Sequence[str]] = None,
                 industry_type: Optional[str] = None,
                 architectural_design: Optional[str] = None,
                 non_aws_regions: Optional[Sequence[str]] = None,
                 notes: Optional[str] = None,
                 review_owner: Optional[str] = None,
                 tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
                 workload_name: Optional[str] = None)
    func NewWorkload(ctx *Context, name string, args WorkloadArgs, opts ...ResourceOption) (*Workload, error)
    public Workload(string name, WorkloadArgs args, CustomResourceOptions? opts = null)
    public Workload(String name, WorkloadArgs args)
    public Workload(String name, WorkloadArgs args, CustomResourceOptions options)
    
    type: aws-native:wellarchitected:Workload
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_wellarchitected_workload" "name" {
        # resource properties
    }

    Parameters

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

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

    Description string
    The description for the workload.
    Environment Pulumi.AwsNative.WellArchitected.WorkloadEnvironment
    The environment for the workload.
    Lenses List<string>
    The list of lenses associated with the workload.
    AccountIds List<string>
    The list of Amazon Web Services account IDs associated with the workload.
    ArchitecturalDesign string
    The URL of the architectural design for the workload.
    AwsRegions List<string>
    The list of Amazon Web Services Regions associated with the workload.
    DiscoveryConfig Pulumi.AwsNative.WellArchitected.Inputs.DiscoveryConfigProperties
    Discovery configuration associated to the workload.
    Industry string
    The industry for the workload.
    IndustryType string
    The industry type for the workload.
    NonAwsRegions List<string>
    The list of non-Amazon Web Services Regions associated with the workload.
    Notes string
    The notes associated with the workload.
    ReviewOwner string
    The review owner of the workload.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags associated with the workload.
    WorkloadName string
    The name of the workload.
    Description string
    The description for the workload.
    Environment WorkloadEnvironment
    The environment for the workload.
    Lenses []string
    The list of lenses associated with the workload.
    AccountIds []string
    The list of Amazon Web Services account IDs associated with the workload.
    ArchitecturalDesign string
    The URL of the architectural design for the workload.
    AwsRegions []string
    The list of Amazon Web Services Regions associated with the workload.
    DiscoveryConfig DiscoveryConfigPropertiesArgs
    Discovery configuration associated to the workload.
    Industry string
    The industry for the workload.
    IndustryType string
    The industry type for the workload.
    NonAwsRegions []string
    The list of non-Amazon Web Services Regions associated with the workload.
    Notes string
    The notes associated with the workload.
    ReviewOwner string
    The review owner of the workload.
    Tags TagArgs
    The tags associated with the workload.
    WorkloadName string
    The name of the workload.
    description string
    The description for the workload.
    environment "PRODUCTION" | "PREPRODUCTION"
    The environment for the workload.
    lenses list(string)
    The list of lenses associated with the workload.
    account_ids list(string)
    The list of Amazon Web Services account IDs associated with the workload.
    architectural_design string
    The URL of the architectural design for the workload.
    aws_regions list(string)
    The list of Amazon Web Services Regions associated with the workload.
    discovery_config object
    Discovery configuration associated to the workload.
    industry string
    The industry for the workload.
    industry_type string
    The industry type for the workload.
    non_aws_regions list(string)
    The list of non-Amazon Web Services Regions associated with the workload.
    notes string
    The notes associated with the workload.
    review_owner string
    The review owner of the workload.
    tags list(object)
    The tags associated with the workload.
    workload_name string
    The name of the workload.
    description String
    The description for the workload.
    environment WorkloadEnvironment
    The environment for the workload.
    lenses List<String>
    The list of lenses associated with the workload.
    accountIds List<String>
    The list of Amazon Web Services account IDs associated with the workload.
    architecturalDesign String
    The URL of the architectural design for the workload.
    awsRegions List<String>
    The list of Amazon Web Services Regions associated with the workload.
    discoveryConfig DiscoveryConfigProperties
    Discovery configuration associated to the workload.
    industry String
    The industry for the workload.
    industryType String
    The industry type for the workload.
    nonAwsRegions List<String>
    The list of non-Amazon Web Services Regions associated with the workload.
    notes String
    The notes associated with the workload.
    reviewOwner String
    The review owner of the workload.
    tags List<Tag>
    The tags associated with the workload.
    workloadName String
    The name of the workload.
    description string
    The description for the workload.
    environment WorkloadEnvironment
    The environment for the workload.
    lenses string[]
    The list of lenses associated with the workload.
    accountIds string[]
    The list of Amazon Web Services account IDs associated with the workload.
    architecturalDesign string
    The URL of the architectural design for the workload.
    awsRegions string[]
    The list of Amazon Web Services Regions associated with the workload.
    discoveryConfig DiscoveryConfigProperties
    Discovery configuration associated to the workload.
    industry string
    The industry for the workload.
    industryType string
    The industry type for the workload.
    nonAwsRegions string[]
    The list of non-Amazon Web Services Regions associated with the workload.
    notes string
    The notes associated with the workload.
    reviewOwner string
    The review owner of the workload.
    tags Tag[]
    The tags associated with the workload.
    workloadName string
    The name of the workload.
    description str
    The description for the workload.
    environment WorkloadEnvironment
    The environment for the workload.
    lenses Sequence[str]
    The list of lenses associated with the workload.
    account_ids Sequence[str]
    The list of Amazon Web Services account IDs associated with the workload.
    architectural_design str
    The URL of the architectural design for the workload.
    aws_regions Sequence[str]
    The list of Amazon Web Services Regions associated with the workload.
    discovery_config DiscoveryConfigPropertiesArgs
    Discovery configuration associated to the workload.
    industry str
    The industry for the workload.
    industry_type str
    The industry type for the workload.
    non_aws_regions Sequence[str]
    The list of non-Amazon Web Services Regions associated with the workload.
    notes str
    The notes associated with the workload.
    review_owner str
    The review owner of the workload.
    tags Sequence[TagArgs]
    The tags associated with the workload.
    workload_name str
    The name of the workload.
    description String
    The description for the workload.
    environment "PRODUCTION" | "PREPRODUCTION"
    The environment for the workload.
    lenses List<String>
    The list of lenses associated with the workload.
    accountIds List<String>
    The list of Amazon Web Services account IDs associated with the workload.
    architecturalDesign String
    The URL of the architectural design for the workload.
    awsRegions List<String>
    The list of Amazon Web Services Regions associated with the workload.
    discoveryConfig Property Map
    Discovery configuration associated to the workload.
    industry String
    The industry for the workload.
    industryType String
    The industry type for the workload.
    nonAwsRegions List<String>
    The list of non-Amazon Web Services Regions associated with the workload.
    notes String
    The notes associated with the workload.
    reviewOwner String
    The review owner of the workload.
    tags List<Property Map>
    The tags associated with the workload.
    workloadName String
    The name of the workload.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    ImprovementStatus Pulumi.AwsNative.WellArchitected.WorkloadImprovementStatus
    The improvement status for a workload.
    WorkloadArn string
    The ARN for the workload.
    WorkloadId string
    The ID assigned to the workload.
    Id string
    The provider-assigned unique ID for this managed resource.
    ImprovementStatus WorkloadImprovementStatus
    The improvement status for a workload.
    WorkloadArn string
    The ARN for the workload.
    WorkloadId string
    The ID assigned to the workload.
    id string
    The provider-assigned unique ID for this managed resource.
    improvement_status "NOT_APPLICABLE" | "NOT_STARTED" | "IN_PROGRESS" | "COMPLETE" | "RISK_ACKNOWLEDGED"
    The improvement status for a workload.
    workload_arn string
    The ARN for the workload.
    workload_id string
    The ID assigned to the workload.
    id String
    The provider-assigned unique ID for this managed resource.
    improvementStatus WorkloadImprovementStatus
    The improvement status for a workload.
    workloadArn String
    The ARN for the workload.
    workloadId String
    The ID assigned to the workload.
    id string
    The provider-assigned unique ID for this managed resource.
    improvementStatus WorkloadImprovementStatus
    The improvement status for a workload.
    workloadArn string
    The ARN for the workload.
    workloadId string
    The ID assigned to the workload.
    id str
    The provider-assigned unique ID for this managed resource.
    improvement_status WorkloadImprovementStatus
    The improvement status for a workload.
    workload_arn str
    The ARN for the workload.
    workload_id str
    The ID assigned to the workload.
    id String
    The provider-assigned unique ID for this managed resource.
    improvementStatus "NOT_APPLICABLE" | "NOT_STARTED" | "IN_PROGRESS" | "COMPLETE" | "RISK_ACKNOWLEDGED"
    The improvement status for a workload.
    workloadArn String
    The ARN for the workload.
    workloadId String
    The ID assigned to the workload.

    Supporting Types

    DiscoveryConfigProperties, DiscoveryConfigPropertiesArgs

    Discovery configuration associated to the workload.
    TrustedAdvisorIntegrationStatus WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatus
    Discovery integration status in respect to Trusted Advisor for the workload.
    WorkloadResourceDefinition []WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItem
    The mode to use for identifying resources associated with the workload.
    trusted_advisor_integration_status "ENABLED" | "DISABLED"
    Discovery integration status in respect to Trusted Advisor for the workload.
    workload_resource_definition list("WORKLOAD_METADATA" | "APP_REGISTRY")
    The mode to use for identifying resources associated with the workload.
    trustedAdvisorIntegrationStatus WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatus
    Discovery integration status in respect to Trusted Advisor for the workload.
    workloadResourceDefinition List<WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItem>
    The mode to use for identifying resources associated with the workload.
    trustedAdvisorIntegrationStatus WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatus
    Discovery integration status in respect to Trusted Advisor for the workload.
    workloadResourceDefinition WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItem[]
    The mode to use for identifying resources associated with the workload.
    trusted_advisor_integration_status WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatus
    Discovery integration status in respect to Trusted Advisor for the workload.
    workload_resource_definition Sequence[WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItem]
    The mode to use for identifying resources associated with the workload.
    trustedAdvisorIntegrationStatus "ENABLED" | "DISABLED"
    Discovery integration status in respect to Trusted Advisor for the workload.
    workloadResourceDefinition List<"WORKLOAD_METADATA" | "APP_REGISTRY">
    The mode to use for identifying resources associated with the workload.

    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

    WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatus, WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatusArgs

    Enabled
    ENABLED
    Disabled
    DISABLED
    WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatusEnabled
    ENABLED
    WorkloadDiscoveryConfigPropertiesTrustedAdvisorIntegrationStatusDisabled
    DISABLED
    "ENABLED"
    ENABLED
    "DISABLED"
    DISABLED
    Enabled
    ENABLED
    Disabled
    DISABLED
    Enabled
    ENABLED
    Disabled
    DISABLED
    ENABLED
    ENABLED
    DISABLED
    DISABLED
    "ENABLED"
    ENABLED
    "DISABLED"
    DISABLED

    WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItem, WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItemArgs

    WorkloadMetadata
    WORKLOAD_METADATA
    AppRegistry
    APP_REGISTRY
    WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItemWorkloadMetadata
    WORKLOAD_METADATA
    WorkloadDiscoveryConfigPropertiesWorkloadResourceDefinitionItemAppRegistry
    APP_REGISTRY
    "WORKLOAD_METADATA"
    WORKLOAD_METADATA
    "APP_REGISTRY"
    APP_REGISTRY
    WorkloadMetadata
    WORKLOAD_METADATA
    AppRegistry
    APP_REGISTRY
    WorkloadMetadata
    WORKLOAD_METADATA
    AppRegistry
    APP_REGISTRY
    WORKLOAD_METADATA
    WORKLOAD_METADATA
    APP_REGISTRY
    APP_REGISTRY
    "WORKLOAD_METADATA"
    WORKLOAD_METADATA
    "APP_REGISTRY"
    APP_REGISTRY

    WorkloadEnvironment, WorkloadEnvironmentArgs

    Production
    PRODUCTION
    Preproduction
    PREPRODUCTION
    WorkloadEnvironmentProduction
    PRODUCTION
    WorkloadEnvironmentPreproduction
    PREPRODUCTION
    "PRODUCTION"
    PRODUCTION
    "PREPRODUCTION"
    PREPRODUCTION
    Production
    PRODUCTION
    Preproduction
    PREPRODUCTION
    Production
    PRODUCTION
    Preproduction
    PREPRODUCTION
    PRODUCTION
    PRODUCTION
    PREPRODUCTION
    PREPRODUCTION
    "PRODUCTION"
    PRODUCTION
    "PREPRODUCTION"
    PREPRODUCTION

    WorkloadImprovementStatus, WorkloadImprovementStatusArgs

    NotApplicable
    NOT_APPLICABLE
    NotStarted
    NOT_STARTED
    InProgress
    IN_PROGRESS
    Complete
    COMPLETE
    RiskAcknowledged
    RISK_ACKNOWLEDGED
    WorkloadImprovementStatusNotApplicable
    NOT_APPLICABLE
    WorkloadImprovementStatusNotStarted
    NOT_STARTED
    WorkloadImprovementStatusInProgress
    IN_PROGRESS
    WorkloadImprovementStatusComplete
    COMPLETE
    WorkloadImprovementStatusRiskAcknowledged
    RISK_ACKNOWLEDGED
    "NOT_APPLICABLE"
    NOT_APPLICABLE
    "NOT_STARTED"
    NOT_STARTED
    "IN_PROGRESS"
    IN_PROGRESS
    "COMPLETE"
    COMPLETE
    "RISK_ACKNOWLEDGED"
    RISK_ACKNOWLEDGED
    NotApplicable
    NOT_APPLICABLE
    NotStarted
    NOT_STARTED
    InProgress
    IN_PROGRESS
    Complete
    COMPLETE
    RiskAcknowledged
    RISK_ACKNOWLEDGED
    NotApplicable
    NOT_APPLICABLE
    NotStarted
    NOT_STARTED
    InProgress
    IN_PROGRESS
    Complete
    COMPLETE
    RiskAcknowledged
    RISK_ACKNOWLEDGED
    NOT_APPLICABLE
    NOT_APPLICABLE
    NOT_STARTED
    NOT_STARTED
    IN_PROGRESS
    IN_PROGRESS
    COMPLETE
    COMPLETE
    RISK_ACKNOWLEDGED
    RISK_ACKNOWLEDGED
    "NOT_APPLICABLE"
    NOT_APPLICABLE
    "NOT_STARTED"
    NOT_STARTED
    "IN_PROGRESS"
    IN_PROGRESS
    "COMPLETE"
    COMPLETE
    "RISK_ACKNOWLEDGED"
    RISK_ACKNOWLEDGED

    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.78.0
    published on Monday, Sep 7, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial