class HostedConfiguration (construct)
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.AppConfig.Alpha.HostedConfiguration |
Go | github.com/aws/aws-cdk-go/awscdkappconfigalpha/v2#HostedConfiguration |
Java | software.amazon.awscdk.services.appconfig.alpha.HostedConfiguration |
Python | aws_cdk.aws_appconfig_alpha.HostedConfiguration |
TypeScript (source) | @aws-cdk/aws-appconfig-alpha » HostedConfiguration |
⚠️ Deprecated: undefined
Implements
IConstruct
, IDependable
, IConfiguration
, IExtensible
A hosted configuration represents configuration stored in the AWS AppConfig hosted configuration store.
Example
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as appconfig_alpha from '@aws-cdk/aws-appconfig-alpha';
import { aws_kms as kms } from 'aws-cdk-lib';
declare const application: appconfig_alpha.Application;
declare const configurationContent: appconfig_alpha.ConfigurationContent;
declare const deploymentStrategy: appconfig_alpha.DeploymentStrategy;
declare const environment: appconfig_alpha.Environment;
declare const key: kms.Key;
declare const validator: appconfig_alpha.IValidator;
const hostedConfiguration = new appconfig_alpha.HostedConfiguration(this, 'MyHostedConfiguration', {
application: application,
content: configurationContent,
// the properties below are optional
deploymentKey: key,
deploymentStrategy: deploymentStrategy,
deployTo: [environment],
description: 'description',
latestVersionNumber: 123,
name: 'name',
type: appconfig_alpha.ConfigurationType.FREEFORM,
validators: [validator],
versionLabel: 'versionLabel',
});
Initializer
new HostedConfiguration(scope: Construct, id: string, props: HostedConfigurationProps)
⚠️ Deprecated: undefined
Parameters
- scope
Construct
- id
string
- props
Hosted
Configuration Props
Construct Props
Name | Type | Description |
---|---|---|
application | IApplication | The application associated with the configuration. |
content | Configuration | The content of the hosted configuration. |
deploy | IEnvironment [] | The list of environments to deploy the configuration to. |
deployment | IKey | The deployment key of the configuration. |
deployment | IDeployment | The deployment strategy for the configuration. |
description? | string | The description of the configuration. |
latest | number | The latest version number of the hosted configuration. |
name? | string | The name of the configuration. |
type? | Configuration | The type of configuration. |
validators? | IValidator [] | The validators for the configuration. |
version | string | The version label of the hosted configuration. |
application
⚠️ Deprecated: undefined
Type:
IApplication
The application associated with the configuration.
content
⚠️ Deprecated: undefined
Type:
Configuration
The content of the hosted configuration.
deployTo?
⚠️ Deprecated: undefined
Type:
IEnvironment
[]
(optional, default: None.)
The list of environments to deploy the configuration to.
If this parameter is not specified, then there will be no deployment.
deploymentKey?
⚠️ Deprecated: undefined
Type:
IKey
(optional, default: None.)
The deployment key of the configuration.
deploymentStrategy?
⚠️ Deprecated: undefined
Type:
IDeployment
(optional, default: A deployment strategy with the rollout strategy set to
RolloutStrategy.CANARY_10_PERCENT_20_MINUTES)
The deployment strategy for the configuration.
description?
⚠️ Deprecated: undefined
Type:
string
(optional, default: No description.)
The description of the configuration.
latestVersionNumber?
⚠️ Deprecated: undefined
Type:
number
(optional, default: None.)
The latest version number of the hosted configuration.
name?
⚠️ Deprecated: undefined
Type:
string
(optional, default: A name is generated.)
The name of the configuration.
type?
⚠️ Deprecated: undefined
Type:
Configuration
(optional, default: ConfigurationType.FREEFORM)
The type of configuration.
validators?
⚠️ Deprecated: undefined
Type:
IValidator
[]
(optional, default: No validators.)
The validators for the configuration.
versionLabel?
⚠️ Deprecated: undefined
Type:
string
(optional, default: None.)
The version label of the hosted configuration.
Properties
Name | Type | Description |
---|---|---|
application | IApplication | The application associated with the configuration. |
application | string | |
configuration | string | The Amazon Resource Name (ARN) of the configuration profile. |
configuration | string | The ID of the configuration profile. |
content | string | The content of the hosted configuration. |
extensible | Extensible | |
hosted | string | The Amazon Resource Name (ARN) of the hosted configuration version. |
node | Node | The tree node. |
content | string | The content type of the hosted configuration. |
deploy | IEnvironment [] | The environments to deploy to. |
deployment | IKey | The deployment key for the configuration. |
deployment | IDeployment | The deployment strategy for the configuration. |
description? | string | The description of the configuration. |
latest | number | The latest version number of the hosted configuration. |
name? | string | The name of the configuration. |
type? | Configuration | The configuration type. |
validators? | IValidator [] | The validators for the configuration. |
version | string | The version label of the hosted configuration. |
version | string | The version number of the hosted configuration. |
application
⚠️ Deprecated: undefined
Type:
IApplication
The application associated with the configuration.
applicationId
⚠️ Deprecated: undefined
Type:
string
configurationProfileArn
⚠️ Deprecated: undefined
Type:
string
The Amazon Resource Name (ARN) of the configuration profile.
configurationProfileId
⚠️ Deprecated: undefined
Type:
string
The ID of the configuration profile.
content
⚠️ Deprecated: undefined
Type:
string
The content of the hosted configuration.
extensible
⚠️ Deprecated: undefined
Type:
Extensible
hostedConfigurationVersionArn
⚠️ Deprecated: undefined
Type:
string
The Amazon Resource Name (ARN) of the hosted configuration version.
node
⚠️ Deprecated: undefined
Type:
Node
The tree node.
contentType?
⚠️ Deprecated: undefined
Type:
string
(optional)
The content type of the hosted configuration.
deployTo?
⚠️ Deprecated: undefined
Type:
IEnvironment
[]
(optional)
The environments to deploy to.
deploymentKey?
⚠️ Deprecated: undefined
Type:
IKey
(optional)
The deployment key for the configuration.
deploymentStrategy?
⚠️ Deprecated: undefined
Type:
IDeployment
(optional)
The deployment strategy for the configuration.
description?
⚠️ Deprecated: undefined
Type:
string
(optional)
The description of the configuration.
latestVersionNumber?
⚠️ Deprecated: undefined
Type:
number
(optional)
The latest version number of the hosted configuration.
name?
⚠️ Deprecated: undefined
Type:
string
(optional)
The name of the configuration.
type?
⚠️ Deprecated: undefined
Type:
Configuration
(optional)
The configuration type.
validators?
⚠️ Deprecated: undefined
Type:
IValidator
[]
(optional)
The validators for the configuration.
versionLabel?
⚠️ Deprecated: undefined
Type:
string
(optional)
The version label of the hosted configuration.
versionNumber?
⚠️ Deprecated: undefined
Type:
string
(optional)
The version number of the hosted configuration.
Methods
Name | Description |
---|---|
add | Adds an extension association to the configuration profile. |
deploy(environment) | Deploys the configuration to the specified environment. |
on(actionPoint, eventDestination, options?) | Adds an extension defined by the action point and event destination and also creates an extension association to the configuration profile. |
on | Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the configuration profile. |
on | Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the configuration profile. |
on | Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the configuration profile. |
on | Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the configuration profile. |
on | Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the configuration profile. |
pre | Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the configuration profile. |
pre | Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the configuration profile. |
to | Returns a string representation of this construct. |
protected add | |
protected deploy |
Extension(extension)
addpublic addExtension(extension: IExtension): void
⚠️ Deprecated: undefined
Parameters
- extension
IExtension
— The extension to create an association for.
Adds an extension association to the configuration profile.
deploy(environment)
public deploy(environment: IEnvironment): void
⚠️ Deprecated: Use deployTo
as a property instead. We do not recommend
creating resources in multiple stacks. If you want to do this still,
please take a look into https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_appconfig.CfnDeployment.html.
Parameters
- environment
IEnvironment
— The environment to deploy the configuration to.
Deploys the configuration to the specified environment.
on(actionPoint, eventDestination, options?)
public on(actionPoint: ActionPoint, eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- actionPoint
Action
— The action point which triggers the event.Point - eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds an extension defined by the action point and event destination and also creates an extension association to the configuration profile.
DeploymentBaking(eventDestination, options?)
onpublic onDeploymentBaking(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds an ON_DEPLOYMENT_BAKING extension with the provided event destination and also creates an extension association to the configuration profile.
DeploymentComplete(eventDestination, options?)
onpublic onDeploymentComplete(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds an ON_DEPLOYMENT_COMPLETE extension with the provided event destination and also creates an extension association to the configuration profile.
DeploymentRolledBack(eventDestination, options?)
onpublic onDeploymentRolledBack(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds an ON_DEPLOYMENT_ROLLED_BACK extension with the provided event destination and also creates an extension association to the configuration profile.
DeploymentStart(eventDestination, options?)
onpublic onDeploymentStart(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds an ON_DEPLOYMENT_START extension with the provided event destination and also creates an extension association to the configuration profile.
DeploymentStep(eventDestination, options?)
onpublic onDeploymentStep(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds an ON_DEPLOYMENT_STEP extension with the provided event destination and also creates an extension association to the configuration profile.
CreateHostedConfigurationVersion(eventDestination, options?)
prepublic preCreateHostedConfigurationVersion(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds a PRE_CREATE_HOSTED_CONFIGURATION_VERSION extension with the provided event destination and also creates an extension association to the configuration profile.
StartDeployment(eventDestination, options?)
prepublic preStartDeployment(eventDestination: IEventDestination, options?: ExtensionOptions): void
⚠️ Deprecated: undefined
Parameters
- eventDestination
IEvent
— The event that occurs during the extension.Destination - options
Extension
— Options for the extension.Options
Adds a PRE_START_DEPLOYMENT extension with the provided event destination and also creates an extension association to the configuration profile.
String()
topublic toString(): string
⚠️ Deprecated: undefined
Returns
string
Returns a string representation of this construct.
ExistingEnvironmentsToApplication()
protected addprotected addExistingEnvironmentsToApplication(): void
⚠️ Deprecated: undefined
ConfigToEnvironments()
protected deployprotected deployConfigToEnvironments(): void
⚠️ Deprecated: undefined