Package com.pulumi.aws.uxc

Class AccountCustomizations

  • public class AccountCustomizations
extends com.pulumi.resources.CustomResource
    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 
     
 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.ArrayList;
 import java.util.Arrays;
 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());
 
     }
 }
    ### Restrict Visible Regions and Services 
     
 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.ArrayList;
 import java.util.Arrays;
 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());
 
     }
 }
    ## Import ### Identity Schema #### Optional * `accountId` (String) Account ID where this resource is managed. Using `pulumi import`, import UXC Account Customizations using the AWS account ID. For example: ```sh $ pulumi import aws:uxc/accountCustomizations:AccountCustomizations example 123456789012 ```

    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal

      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.pulumi.core.Output<java.lang.String> accountColor()  
      static AccountCustomizations get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, AccountCustomizationsState state, com.pulumi.resources.CustomResourceOptions options)
      Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
      com.pulumi.core.Output<java.util.List<java.lang.String>> visibleRegions()  
      com.pulumi.core.Output<java.util.List<java.lang.String>> visibleServices()  

      • Methods inherited from class com.pulumi.resources.CustomResource

        getId, id, idFuture

      • Methods inherited from class com.pulumi.resources.Resource

        getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • AccountCustomizations

        public AccountCustomizations​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • AccountCustomizations

        public AccountCustomizations​(java.lang.String name,
                             @Nullable
                             AccountCustomizationsArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • AccountCustomizations

        public AccountCustomizations​(java.lang.String name,
                             @Nullable
                             AccountCustomizationsArgs args,
                             @Nullable
                             com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.

    • Method Detail

      • accountColor

        public com.pulumi.core.Output<java.lang.String> accountColor()
        Returns:
        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

        public com.pulumi.core.Output<java.util.List<java.lang.String>> visibleRegions()
        Returns:
        Set of AWS region codes to display in the console. When omitted or empty, all regions are visible.

      • visibleServices

        public com.pulumi.core.Output<java.util.List<java.lang.String>> visibleServices()
        Returns:
        Set of AWS service identifiers to display in the console. When omitted or empty, all services are visible.

      • get

        public static AccountCustomizations get​(java.lang.String name,
                                        com.pulumi.core.Output<java.lang.String> id,
                                        @Nullable
                                        AccountCustomizationsState state,
                                        @Nullable
                                        com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.