1. Packages
  2. AWS
  3. API Docs
  4. uxc
  5. AccountCustomizations
Viewing docs for AWS v7.26.0
published on Thursday, Apr 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.uxc.AccountCustomizations

aws logo
Viewing docs for AWS v7.26.0
published on Thursday, Apr 16, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    Manages UXC Account Customizations for an AWS Account. This resource controls the console experience for the account, including the account color and which AWS regions and services are visible in the AWS Management Console.

    Note: There is only a single set of account customizations per AWS account.

    Note: This resource operates globally and always targets the us-east-1 region regardless of the provider region configuration.

    Note: The UXC API does not provide a delete operation. Destroying this resource resets all customizations to their defaults: accountColor is set to none, and both visibleRegions and visibleServices are cleared to allow all regions and services.

    Example Usage

    Set Account Color

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.uxc.AccountCustomizations("example", {accountColor: "lightBlue"});

    import pulumi
import pulumi_aws as aws

example = aws.uxc.AccountCustomizations("example", account_color="lightBlue")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/uxc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := uxc.NewAccountCustomizations(ctx, "example", &uxc.AccountCustomizationsArgs{
			AccountColor: pulumi.String("lightBlue"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Uxc.AccountCustomizations("example", new()
    {
        AccountColor = "lightBlue",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.uxc.AccountCustomizations;
import com.pulumi.aws.uxc.AccountCustomizationsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new AccountCustomizations("example", AccountCustomizationsArgs.builder()
            .accountColor("lightBlue")
            .build());

    }
}

    resources:
  example:
    type: aws:uxc:AccountCustomizations
    properties:
      accountColor: lightBlue

    Restrict Visible Regions and Services

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.uxc.AccountCustomizations("example", {
    accountColor: "green",
    visibleRegions: [
        "us-east-1",
        "us-west-2",
        "eu-west-1",
    ],
    visibleServices: [
        "ec2",
        "s3",
        "rds",
    ],
});

    import pulumi
import pulumi_aws as aws

example = aws.uxc.AccountCustomizations("example",
    account_color="green",
    visible_regions=[
        "us-east-1",
        "us-west-2",
        "eu-west-1",
    ],
    visible_services=[
        "ec2",
        "s3",
        "rds",
    ])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/uxc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := uxc.NewAccountCustomizations(ctx, "example", &uxc.AccountCustomizationsArgs{
			AccountColor: pulumi.String("green"),
			VisibleRegions: pulumi.StringArray{
				pulumi.String("us-east-1"),
				pulumi.String("us-west-2"),
				pulumi.String("eu-west-1"),
			},
			VisibleServices: pulumi.StringArray{
				pulumi.String("ec2"),
				pulumi.String("s3"),
				pulumi.String("rds"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Uxc.AccountCustomizations("example", new()
    {
        AccountColor = "green",
        VisibleRegions = new[]
        {
            "us-east-1",
            "us-west-2",
            "eu-west-1",
        },
        VisibleServices = new[]
        {
            "ec2",
            "s3",
            "rds",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.uxc.AccountCustomizations;
import com.pulumi.aws.uxc.AccountCustomizationsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new AccountCustomizations("example", AccountCustomizationsArgs.builder()
            .accountColor("green")
            .visibleRegions(            
                "us-east-1",
                "us-west-2",
                "eu-west-1")
            .visibleServices(            
                "ec2",
                "s3",
                "rds")
            .build());

    }
}

    resources:
  example:
    type: aws:uxc:AccountCustomizations
    properties:
      accountColor: green
      visibleRegions:
        - us-east-1
        - us-west-2
        - eu-west-1
      visibleServices:
        - ec2
        - s3
        - rds

    Create AccountCustomizations Resource

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

    Constructor syntax

    new AccountCustomizations(name: string, args?: AccountCustomizationsArgs, opts?: CustomResourceOptions);
    @overload
def AccountCustomizations(resource_name: str,
                          args: Optional[AccountCustomizationsArgs] = None,
                          opts: Optional[ResourceOptions] = None)

@overload
def AccountCustomizations(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          account_color: Optional[str] = None,
                          visible_regions: Optional[Sequence[str]] = None,
                          visible_services: Optional[Sequence[str]] = None)
    func NewAccountCustomizations(ctx *Context, name string, args *AccountCustomizationsArgs, opts ...ResourceOption) (*AccountCustomizations, error)
    public AccountCustomizations(string name, AccountCustomizationsArgs? args = null, CustomResourceOptions? opts = null)
    public AccountCustomizations(String name, AccountCustomizationsArgs args)
public AccountCustomizations(String name, AccountCustomizationsArgs args, CustomResourceOptions options)

    type: aws:uxc:AccountCustomizations
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

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

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var accountCustomizationsResource = new Aws.Uxc.AccountCustomizations("accountCustomizationsResource", new()
{
    AccountColor = "string",
    VisibleRegions = new[]
    {
        "string",
    },
    VisibleServices = new[]
    {
        "string",
    },
});

    example, err := uxc.NewAccountCustomizations(ctx, "accountCustomizationsResource", &uxc.AccountCustomizationsArgs{
	AccountColor: pulumi.String("string"),
	VisibleRegions: pulumi.StringArray{
		pulumi.String("string"),
	},
	VisibleServices: pulumi.StringArray{
		pulumi.String("string"),
	},
})

    var accountCustomizationsResource = new AccountCustomizations("accountCustomizationsResource", AccountCustomizationsArgs.builder()
    .accountColor("string")
    .visibleRegions("string")
    .visibleServices("string")
    .build());

    account_customizations_resource = aws.uxc.AccountCustomizations("accountCustomizationsResource",
    account_color="string",
    visible_regions=["string"],
    visible_services=["string"])

    const accountCustomizationsResource = new aws.uxc.AccountCustomizations("accountCustomizationsResource", {
    accountColor: "string",
    visibleRegions: ["string"],
    visibleServices: ["string"],
});

    type: aws:uxc:AccountCustomizations
properties:
    accountColor: string
    visibleRegions:
        - string
    visibleServices:
        - string

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

    AccountColor string
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    VisibleRegions List<string>
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    VisibleServices List<string>
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    AccountColor string
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    VisibleRegions []string
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    VisibleServices []string
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    accountColor String
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visibleRegions List<String>
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visibleServices List<String>
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    accountColor string
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visibleRegions string[]
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visibleServices string[]
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    account_color str
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visible_regions Sequence[str]
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visible_services Sequence[str]
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    accountColor String
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visibleRegions List<String>
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visibleServices List<String>
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing AccountCustomizations Resource

    Get an existing AccountCustomizations resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: AccountCustomizationsState, opts?: CustomResourceOptions): AccountCustomizations
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_color: Optional[str] = None,
        visible_regions: Optional[Sequence[str]] = None,
        visible_services: Optional[Sequence[str]] = None) -> AccountCustomizations
    func GetAccountCustomizations(ctx *Context, name string, id IDInput, state *AccountCustomizationsState, opts ...ResourceOption) (*AccountCustomizations, error)
    public static AccountCustomizations Get(string name, Input<string> id, AccountCustomizationsState? state, CustomResourceOptions? opts = null)
    public static AccountCustomizations get(String name, Output<String> id, AccountCustomizationsState state, CustomResourceOptions options)
    resources:  _:    type: aws:uxc:AccountCustomizations    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountColor string
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    VisibleRegions List<string>
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    VisibleServices List<string>
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    AccountColor string
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    VisibleRegions []string
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    VisibleServices []string
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    accountColor String
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visibleRegions List<String>
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visibleServices List<String>
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    accountColor string
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visibleRegions string[]
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visibleServices string[]
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    account_color str
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visible_regions Sequence[str]
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visible_services Sequence[str]
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.
    accountColor String
    Color used to identify the account in the AWS Management Console. Valid values are none, red, darkBlue, lightBlue, green, yellow, orange, pink, purple, and teal. Defaults to none.
    visibleRegions List<String>
    Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.
    visibleServices List<String>
    Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.

    Import

    Using pulumi import, import UXC Account Customizations using the AWS account ID. For example:

    $ pulumi import aws:uxc/accountCustomizations:AccountCustomizations example 123456789012

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v7.26.0
    published on Thursday, Apr 16, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.