Package software.amazon.awscdk.services.appconfig

Class HostedConfiguration

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.services.appconfig.HostedConfiguration
All Implemented Interfaces:
IConfiguration, IExtensible, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)", date="2025-12-05T22:26:28.167Z") @Stability(Stable) public class HostedConfiguration extends software.constructs.Construct implements IConfiguration, IExtensible
A hosted configuration represents configuration stored in the AWS AppConfig hosted configuration store.

Example: 

 Application application;
 Function fn;
 HostedConfiguration.Builder.create(this, "MyHostedConfiguration")
         .application(application)
         .content(ConfigurationContent.fromInlineText("This is my configuration content."))
         .validators(List.of(JsonSchemaValidator.fromFile("schema.json"), LambdaValidator.fromFunction(fn)))
         .build();

  • Constructor Details

    • HostedConfiguration

      protected HostedConfiguration(software.amazon.jsii.JsiiObjectRef objRef)

    • HostedConfiguration

      protected HostedConfiguration(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • HostedConfiguration

      @Stability(Stable) public HostedConfiguration(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull HostedConfigurationProps props)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.

  • Method Details

    • addExistingEnvironmentsToApplication

      @Stability(Stable) protected void addExistingEnvironmentsToApplication()

    • addExtension

      @Stability(Stable) public void addExtension(@NotNull IExtension extension)
      Adds an extension association to the configuration profile.

      Specified by:
      addExtension in interface IExtensible
      Parameters:
      extension - The extension to create an association for. This parameter is required.

    • atDeploymentTick

      @Stability(Stable) public void atDeploymentTick(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an AT_DEPLOYMENT_TICK extension with the provided event destination and also creates an extension association to an application.

      Specified by:
      atDeploymentTick in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • atDeploymentTick

      @Stability(Stable) public void atDeploymentTick(@NotNull IEventDestination eventDestination)
      Adds an AT_DEPLOYMENT_TICK extension with the provided event destination and also creates an extension association to an application.

      Specified by:
      atDeploymentTick in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • deployConfigToEnvironments

      @Stability(Stable) protected void deployConfigToEnvironments()

    • on

      @Stability(Stable) public void on(@NotNull ActionPoint actionPoint, @NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an extension defined by the action point and event destination and also creates an extension association to the configuration profile.

      Specified by:
      on in interface IExtensible
      Parameters:
      actionPoint - The action point which triggers the event. This parameter is required.
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • on

      @Stability(Stable) public void on(@NotNull ActionPoint actionPoint, @NotNull IEventDestination eventDestination)
      Adds an extension defined by the action point and event destination and also creates an extension association to the configuration profile.

      Specified by:
      on in interface IExtensible
      Parameters:
      actionPoint - The action point which triggers the event. This parameter is required.
      eventDestination - The event that occurs during the extension. This parameter is required.

    • onDeploymentBaking

      @Stability(Stable) public void onDeploymentBaking(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentBaking in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • onDeploymentBaking

      @Stability(Stable) public void onDeploymentBaking(@NotNull IEventDestination eventDestination)
      Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentBaking in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • onDeploymentComplete

      @Stability(Stable) public void onDeploymentComplete(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentComplete in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • onDeploymentComplete

      @Stability(Stable) public void onDeploymentComplete(@NotNull IEventDestination eventDestination)
      Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentComplete in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • onDeploymentRolledBack

      @Stability(Stable) public void onDeploymentRolledBack(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentRolledBack in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • onDeploymentRolledBack

      @Stability(Stable) public void onDeploymentRolledBack(@NotNull IEventDestination eventDestination)
      Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentRolledBack in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • onDeploymentStart

      @Stability(Stable) public void onDeploymentStart(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentStart in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • onDeploymentStart

      @Stability(Stable) public void onDeploymentStart(@NotNull IEventDestination eventDestination)
      Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentStart in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • onDeploymentStep

      @Stability(Stable) public void onDeploymentStep(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentStep in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • onDeploymentStep

      @Stability(Stable) public void onDeploymentStep(@NotNull IEventDestination eventDestination)
      Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      onDeploymentStep in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • preCreateHostedConfigurationVersion

      @Stability(Stable) public void preCreateHostedConfigurationVersion(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      preCreateHostedConfigurationVersion in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • preCreateHostedConfigurationVersion

      @Stability(Stable) public void preCreateHostedConfigurationVersion(@NotNull IEventDestination eventDestination)
      Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      preCreateHostedConfigurationVersion in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • preStartDeployment

      @Stability(Stable) public void preStartDeployment(@NotNull IEventDestination eventDestination, @Nullable ExtensionOptions options)
      Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      preStartDeployment in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.
      options - Options for the extension.

    • preStartDeployment

      @Stability(Stable) public void preStartDeployment(@NotNull IEventDestination eventDestination)
      Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the configuration profile.

      Specified by:
      preStartDeployment in interface IExtensible
      Parameters:
      eventDestination - The event that occurs during the extension. This parameter is required.

    • getApplication

      @Stability(Stable) @NotNull public IApplication getApplication()
      The application associated with the configuration.
      Specified by:
      getApplication in interface IConfiguration

    • getConfigurationProfileArn

      @Stability(Stable) @NotNull public String getConfigurationProfileArn()
      The Amazon Resource Name (ARN) of the configuration profile.

    • getConfigurationProfileId

      @Stability(Stable) @NotNull public String getConfigurationProfileId()
      The ID of the configuration profile.
      Specified by:
      getConfigurationProfileId in interface IConfiguration

    • getContent

      @Stability(Stable) @NotNull public String getContent()
      The content of the hosted configuration.

    • getHostedConfigurationVersionArn

      @Stability(Stable) @NotNull public String getHostedConfigurationVersionArn()
      The Amazon Resource Name (ARN) of the hosted configuration version.

    • getContentType

      @Stability(Stable) @Nullable public String getContentType()
      The configuration content type, specified as a standard MIME type. Supported examples include: - text/plain - application/json - application/octet-stream - application/x-yaml.

      For an up-to-date list of valid MIME types, see: https://www.iana.org/assignments/media-types/media-types.xhtml

    • getDeploymentKey

      @Stability(Stable) @Nullable public IKey getDeploymentKey()
      The deployment key for the configuration.
      Specified by:
      getDeploymentKey in interface IConfiguration

    • getDeploymentStrategy

      @Stability(Stable) @Nullable public IDeploymentStrategy getDeploymentStrategy()
      The deployment strategy for the configuration.
      Specified by:
      getDeploymentStrategy in interface IConfiguration

    • getDeployTo

      @Stability(Stable) @Nullable public List<IEnvironment> getDeployTo()
      The environments to deploy to.
      Specified by:
      getDeployTo in interface IConfiguration

    • getDescription

      @Stability(Stable) @Nullable public String getDescription()
      The description of the configuration.
      Specified by:
      getDescription in interface IConfiguration

    • getLatestVersionNumber

      @Stability(Stable) @Nullable public Number getLatestVersionNumber()
      The latest version number of the hosted configuration.

    • getName

      @Stability(Stable) @Nullable public String getName()
      The name of the configuration.
      Specified by:
      getName in interface IConfiguration

    • getType

      @Stability(Stable) @Nullable public ConfigurationType getType()
      The configuration type.
      Specified by:
      getType in interface IConfiguration

    • getValidators

      @Stability(Stable) @Nullable public List<IValidator> getValidators()
      The validators for the configuration.
      Specified by:
      getValidators in interface IConfiguration

    • getVersionLabel

      @Stability(Stable) @Nullable public String getVersionLabel()
      The version label of the hosted configuration.

    • getVersionNumber

      @Stability(Stable) @Nullable public String getVersionNumber()
      The version number of the hosted configuration.
      Specified by:
      getVersionNumber in interface IConfiguration

    • getApplicationId

      @Stability(Stable) @NotNull protected String getApplicationId()

    • setApplicationId

      @Stability(Stable) protected void setApplicationId(@NotNull String value)

    • getExtensible

      @Stability(Stable) @NotNull protected ExtensibleBase getExtensible()

    • setExtensible

      @Stability(Stable) protected void setExtensible(@NotNull ExtensibleBase value)

    • getDeletionProtectionCheck

      @Stability(Stable) @Nullable protected DeletionProtectionCheck getDeletionProtectionCheck()

    • setDeletionProtectionCheck

      @Stability(Stable) protected void setDeletionProtectionCheck(@Nullable DeletionProtectionCheck value)