software.amazon.awscdk.services.appconfig

Class CfnConfigurationProfile

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.CfnElement

software.amazon.awscdk.core.CfnRefElement

software.amazon.awscdk.core.CfnResource

software.amazon.awscdk.services.appconfig.CfnConfigurationProfile

All Implemented Interfaces:

IConstruct, IDependable, IInspectable

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:35.296Z")
public class CfnConfigurationProfile
extends CfnResource
implements IInspectable

A CloudFormation `AWS::AppConfig::ConfigurationProfile`.

The AWS::AppConfig::ConfigurationProfile resource creates a configuration profile that enables AWS AppConfig to access the configuration source. Valid configuration sources include AWS Systems Manager (SSM) documents, SSM Parameter Store parameters, and Amazon S3 . A configuration profile includes the following information.

• The Uri location of the configuration data.
• The AWS Identity and Access Management ( IAM ) role that provides access to the configuration data.
• A validator for the configuration data. Available validators include either a JSON Schema or the Amazon Resource Name (ARN) of an AWS Lambda function.

AWS AppConfig requires that you create resources and deploy a configuration in the following order:

• Create an application
• Create an environment
• Create a configuration profile
• Create a deployment strategy
• Deploy the configuration

For more information, see AWS AppConfig in the AWS AppConfig User Guide .

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.appconfig.*;
 CfnConfigurationProfile cfnConfigurationProfile = CfnConfigurationProfile.Builder.create(this, "MyCfnConfigurationProfile")
         .applicationId("applicationId")
         .locationUri("locationUri")
         .name("name")
         // the properties below are optional
         .description("description")
         .retrievalRoleArn("retrievalRoleArn")
         .tags(List.of(TagsProperty.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .type("type")
         .validators(List.of(ValidatorsProperty.builder()
                 .content("content")
                 .type("type")
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CfnConfigurationProfile.Builder A fluent builder for CfnConfigurationProfile.
static interface	CfnConfigurationProfile.TagsProperty Metadata to assign to the configuration profile.
static interface	CfnConfigurationProfile.ValidatorsProperty A validator provides a syntactic or semantic check to ensure the configuration that you want to deploy functions as intended.

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct

IConstruct.Jsii$Default

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CFN_RESOURCE_TYPE_NAME The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor and Description
	CfnConfigurationProfile(Construct scope, java.lang.String id, CfnConfigurationProfileProps props) Create a new `AWS::AppConfig::ConfigurationProfile`.
protected	CfnConfigurationProfile(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnConfigurationProfile(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getApplicationId() The application ID.
protected java.util.Map<java.lang.String,java.lang.Object>	getCfnProperties()
java.lang.String	getDescription() A description of the configuration profile.
java.lang.String	getLocationUri() A URI to locate the configuration.
java.lang.String	getName() A name for the configuration profile.
java.lang.String	getRetrievalRoleArn() The ARN of an IAM role with permission to access the configuration at the specified `LocationUri` .
java.util.List<CfnConfigurationProfile.TagsProperty>	getTags() Metadata to assign to the configuration profile.
java.lang.String	getType() The type of configurations contained in the profile.
java.lang.Object	getValidators() A list of methods for validating the configuration.
void	inspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.
protected java.util.Map<java.lang.String,java.lang.Object>	renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)
void	setApplicationId(java.lang.String value) The application ID.
void	setDescription(java.lang.String value) A description of the configuration profile.
void	setLocationUri(java.lang.String value) A URI to locate the configuration.
void	setName(java.lang.String value) A name for the configuration profile.
void	setRetrievalRoleArn(java.lang.String value) The ARN of an IAM role with permission to access the configuration at the specified `LocationUri` .
void	setTags(java.util.List<CfnConfigurationProfile.TagsProperty> value) Metadata to assign to the configuration profile.
void	setType(java.lang.String value) The type of configurations contained in the profile.
void	setValidators(IResolvable value) A list of methods for validating the configuration.
void	setValidators(java.util.List<java.lang.Object> value) A list of methods for validating the configuration.

Methods inherited from class software.amazon.awscdk.core.CfnResource

addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.core.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.core.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

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

Field Detail

CFN_RESOURCE_TYPE_NAME

public static final java.lang.String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Detail

CfnConfigurationProfile

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

CfnConfigurationProfile

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

CfnConfigurationProfile

public CfnConfigurationProfile(Construct scope,
                               java.lang.String id,
                               CfnConfigurationProfileProps props)

Create a new `AWS::AppConfig::ConfigurationProfile`.

Parameters:

scope - - scope in which this resource is defined. This parameter is required.

id - - scoped id of the resource. This parameter is required.

props - - resource properties. This parameter is required.

Method Detail

inspect

public void inspect(TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - - tree inspector to collect and process attributes. This parameter is required.

renderProperties

protected java.util.Map<java.lang.String,java.lang.Object> renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getCfnProperties

protected java.util.Map<java.lang.String,java.lang.Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getApplicationId

public java.lang.String getApplicationId()

The application ID.

setApplicationId

public void setApplicationId(java.lang.String value)

The application ID.

getLocationUri

public java.lang.String getLocationUri()

A URI to locate the configuration. You can specify the following:.

• For the AWS AppConfig hosted configuration store and for feature flags, specify hosted .
• For an AWS Systems Manager Parameter Store parameter, specify either the parameter name in the format ssm-parameter://<parameter name> or the ARN.
• For an AWS Secrets Manager secret, specify the URI in the following format: secretsmanager ://.
• For an Amazon S3 object, specify the URI in the following format: s3://<bucket>/<objectKey> . Here is an example: s3://my-bucket/my-app/us-east-1/my-config.json
• For an SSM document, specify either the document name in the format ssm-document://<document name> or the Amazon Resource Name (ARN).

setLocationUri

public void setLocationUri(java.lang.String value)

A URI to locate the configuration. You can specify the following:.

• For the AWS AppConfig hosted configuration store and for feature flags, specify hosted .
• For an AWS Systems Manager Parameter Store parameter, specify either the parameter name in the format ssm-parameter://<parameter name> or the ARN.
• For an AWS Secrets Manager secret, specify the URI in the following format: secretsmanager ://.
• For an Amazon S3 object, specify the URI in the following format: s3://<bucket>/<objectKey> . Here is an example: s3://my-bucket/my-app/us-east-1/my-config.json
• For an SSM document, specify either the document name in the format ssm-document://<document name> or the Amazon Resource Name (ARN).

getName

public java.lang.String getName()

A name for the configuration profile.

setName

public void setName(java.lang.String value)

A name for the configuration profile.

getDescription

public java.lang.String getDescription()

A description of the configuration profile.

setDescription

public void setDescription(java.lang.String value)

A description of the configuration profile.

getRetrievalRoleArn

public java.lang.String getRetrievalRoleArn()

The ARN of an IAM role with permission to access the configuration at the specified `LocationUri` .

A retrieval role ARN is not required for configurations stored in the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.

setRetrievalRoleArn

public void setRetrievalRoleArn(java.lang.String value)

The ARN of an IAM role with permission to access the configuration at the specified `LocationUri` .

A retrieval role ARN is not required for configurations stored in the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.

getTags

public java.util.List<CfnConfigurationProfile.TagsProperty> getTags()

Metadata to assign to the configuration profile.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

setTags

public void setTags(java.util.List<CfnConfigurationProfile.TagsProperty> value)

Metadata to assign to the configuration profile.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

getType

public java.lang.String getType()

The type of configurations contained in the profile.

AWS AppConfig supports feature flags and freeform configurations. We recommend you create feature flag configurations to enable or disable new features and freeform configurations to distribute configurations to an application. When calling this API, enter one of the following values for Type :

AWS.AppConfig.FeatureFlags

AWS.Freeform

setType

public void setType(java.lang.String value)

The type of configurations contained in the profile.

AWS AppConfig supports feature flags and freeform configurations. We recommend you create feature flag configurations to enable or disable new features and freeform configurations to distribute configurations to an application. When calling this API, enter one of the following values for Type :

AWS.AppConfig.FeatureFlags

AWS.Freeform

getValidators

public java.lang.Object getValidators()

A list of methods for validating the configuration.

setValidators

public void setValidators(IResolvable value)

A list of methods for validating the configuration.

setValidators

public void setValidators(java.util.List<java.lang.Object> value)

A list of methods for validating the configuration.