Skip to content

RosRule

This class is a base encapsulation around the ROS resource type ALIYUN::Config::Rule, which is used to create or modify a rule.

Initializers

import com.aliyun.ros.cdk.config.RosRule;
RosRule.Builder.create(Construct scope, java.lang.String id, java.lang.Boolean enableResourcePropertyConstraint)
    .configRuleTriggerTypes(java.lang.String)
    .configRuleTriggerTypes(IResolvable)
    .resourceTypesScope(IResolvable)
    .resourceTypesScope(java.util.List<java.lang.String)
    .resourceTypesScope(IResolvable>)
    .riskLevel(java.lang.Number)
    .riskLevel(IResolvable)
    .ruleName(java.lang.String)
    .ruleName(IResolvable)
    .sourceIdentifier(java.lang.String)
    .sourceIdentifier(IResolvable)
    .sourceOwner(java.lang.String)
    .sourceOwner(IResolvable)
//  .description(java.lang.String)
//  .description(IResolvable)
//  .excludeResourceIdsScope(java.lang.String)
//  .excludeResourceIdsScope(IResolvable)
//  .inputParameters(IResolvable)
//  .inputParameters(java.util.Map<java.lang.String, java.lang.Object>)
//  .maximumExecutionFrequency(java.lang.String)
//  .maximumExecutionFrequency(IResolvable)
//  .regionIdsScope(java.lang.String)
//  .regionIdsScope(IResolvable)
//  .resourceGroupIdsScope(java.lang.String)
//  .resourceGroupIdsScope(IResolvable)
//  .tagKeyLogicScope(java.lang.String)
//  .tagKeyLogicScope(IResolvable)
//  .tagKeyScope(java.lang.String)
//  .tagKeyScope(IResolvable)
//  .tagValueScope(java.lang.String)
//  .tagValueScope(IResolvable)
    .build();
Name Type Description
scope com.aliyun.ros.cdk.core.Construct - scope in which this resource is defined.
id java.lang.String - scoped id of the resource.
enableResourcePropertyConstraint java.lang.Boolean No description.
configRuleTriggerTypes java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
resourceTypesScope com.aliyun.ros.cdk.core.IResolvable OR java.util.List No description.
riskLevel java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable No description.
ruleName java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
sourceIdentifier java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
sourceOwner java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
description java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
excludeResourceIdsScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
inputParameters com.aliyun.ros.cdk.core.IResolvable OR java.util.Map No description.
maximumExecutionFrequency java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
regionIdsScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
resourceGroupIdsScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
tagKeyLogicScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
tagKeyScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
tagValueScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.

scopeRequired

  • Type: com.aliyun.ros.cdk.core.Construct

scope in which this resource is defined.


idRequired

  • Type: java.lang.String

scoped id of the resource.


enableResourcePropertyConstraintRequired

  • Type: java.lang.Boolean

configRuleTriggerTypesRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

resourceTypesScopeRequired

  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

riskLevelRequired

  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

ruleNameRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

sourceIdentifierRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

sourceOwnerRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

descriptionOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

excludeResourceIdsScopeOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

inputParametersOptional

  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.Map

maximumExecutionFrequencyOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

regionIdsScopeOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

resourceGroupIdsScopeOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

tagKeyLogicScopeOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

tagKeyScopeOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

tagValueScopeOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Methods

Name Description
toString Returns a string representation of this construct.
synthesize Allows this construct to emit artifacts into the cloud assembly during synthesis.
overrideLogicalId Overrides the auto-generated logical ID with a specific ID.
addCondition No description.
addCount No description.
addDeletionOverride Syntactic sugar for addOverride(path, undefined).
addDependsOn Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
addDesc No description.
addMetaData No description.
addOverride Adds an override to the synthesized ROS resource.
addPropertyDeletionOverride Adds an override that deletes the value of a property from the resource definition.
addPropertyOverride Adds an override to a resource property.
addRosDependency No description.
applyRemovalPolicy Sets the deletion policy of the resource based on the removal policy specified.
getAtt Returns a token for an runtime attribute of this resource.

toString

public java.lang.String toString()

Returns a string representation of this construct.

synthesize

public void synthesize(ISynthesisSession session)

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

sessionRequired

  • Type: com.aliyun.ros.cdk.core.ISynthesisSession

The synthesis session.


overrideLogicalId

public void overrideLogicalId(java.lang.String newLogicalId)

Overrides the auto-generated logical ID with a specific ID.

newLogicalIdRequired

  • Type: java.lang.String

The new logical ID to use for this stack element.


addCondition

public void addCondition(RosCondition con)

conRequired

  • Type: com.aliyun.ros.cdk.core.RosCondition

addCount

public void addCount(java.lang.Number OR IResolvable count)

countRequired

  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

addDeletionOverride

public void addDeletionOverride(java.lang.String path)

Syntactic sugar for addOverride(path, undefined).

pathRequired

  • Type: java.lang.String

The path of the value to delete.


addDependsOn

public void addDependsOn(RosResource target)

Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.

This can be used for resources across stacks (or nested stack) boundaries and the dependency will automatically be transferred to the relevant scope.

targetRequired

  • Type: com.aliyun.ros.cdk.core.RosResource

addDesc

public void addDesc(java.lang.String desc)

descRequired

  • Type: java.lang.String

addMetaData

public void addMetaData(java.lang.String key, java.lang.Object value)

keyRequired

  • Type: java.lang.String

valueRequired

  • Type: java.lang.Object

addOverride

public void addOverride(java.lang.String path, java.lang.Object value)

Adds an override to the synthesized ROS resource.

To add a property override, either use addPropertyOverride or prefix path with "Properties." (i.e. Properties.TopicName).

If the override is nested, separate each nested level using a dot (.) in the path parameter. If there is an array as part of the nesting, specify the index in the path.

For example,

addOverride('Properties.GlobalSecondaryIndexes.0.Projection.NonKeyAttributes', ['myattribute'])
addOverride('Properties.GlobalSecondaryIndexes.1.ProjectionType', 'INCLUDE')

would add the overrides

"Properties": {
   "GlobalSecondaryIndexes": [
     {
       "Projection": {
         "NonKeyAttributes": [ "myattribute" ]
         ...
       }
       ...
     },
     {
       "ProjectionType": "INCLUDE"
       ...
     },
   ]
   ...
}

pathRequired

  • Type: java.lang.String

The path of the property, you can use dot notation to override values in complex types.

Any intermdediate keys will be created as needed.


valueRequired

  • Type: java.lang.Object

The value.

Could be primitive or complex.


addPropertyDeletionOverride

public void addPropertyDeletionOverride(java.lang.String propertyPath)

Adds an override that deletes the value of a property from the resource definition.

propertyPathRequired

  • Type: java.lang.String

The path to the property.


addPropertyOverride

public void addPropertyOverride(java.lang.String propertyPath, java.lang.Object value)

Adds an override to a resource property.

Syntactic sugar for addOverride("Properties.<...>", value).

propertyPathRequired

  • Type: java.lang.String

The path of the property.


valueRequired

  • Type: java.lang.Object

The value.


addRosDependency

public void addRosDependency(java.lang.String target)

targetRequired

  • Type: java.lang.String

applyRemovalPolicy

public void applyRemovalPolicy()
public void applyRemovalPolicy(RemovalPolicy policy)
public void applyRemovalPolicy(RemovalPolicy policy, RemovalPolicyOptions options)

Sets the deletion policy of the resource based on the removal policy specified.

policyOptional

  • Type: com.aliyun.ros.cdk.core.RemovalPolicy

optionsOptional

  • Type: com.aliyun.ros.cdk.core.RemovalPolicyOptions

getAtt

public Reference getAtt(java.lang.String attributeName)

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility in case there is no generated attribute.

attributeNameRequired

  • Type: java.lang.String

The name of the attribute.


Static Functions

Name Description
isConstruct Return whether the given object is a Construct.
isRosElement Returns true if a construct is a stack element (i.e. part of the synthesized template).
isRosResource Check whether the given construct is a RosResource.

isConstruct

import com.aliyun.ros.cdk.config.RosRule;
RosRule.isConstruct(java.lang.Object x)

Return whether the given object is a Construct.

xRequired

  • Type: java.lang.Object

isRosElement

import com.aliyun.ros.cdk.config.RosRule;
RosRule.isRosElement(java.lang.Object x)

Returns true if a construct is a stack element (i.e. part of the synthesized template).

Uses duck-typing instead of instanceof to allow stack elements from different versions of this library to be included in the same stack.

xRequired

  • Type: java.lang.Object

isRosResource

import com.aliyun.ros.cdk.config.RosRule;
RosRule.isRosResource(IConstruct construct)

Check whether the given construct is a RosResource.

constructRequired

  • Type: com.aliyun.ros.cdk.core.IConstruct

Properties

Name Type Description
node com.aliyun.ros.cdk.core.ConstructNode The construct tree node associated with this construct.
creationStack java.util.List No description.
logicalId java.lang.String The logical ID for this stack element.
stack com.aliyun.ros.cdk.core.Stack The stack in which this element is defined.
ref java.lang.String Return a string that will be resolved to a RosTemplate { Ref } for this element.
rosOptions com.aliyun.ros.cdk.core.IRosResourceOptions Options for this resource, such as condition, update policy etc.
rosResourceType java.lang.String ROS resource type.
attrConfigRuleArn com.aliyun.ros.cdk.core.IResolvable No description.
attrConfigRuleId com.aliyun.ros.cdk.core.IResolvable No description.
attrConfigRuleTriggerTypes com.aliyun.ros.cdk.core.IResolvable No description.
attrDescription com.aliyun.ros.cdk.core.IResolvable No description.
attrEventSource com.aliyun.ros.cdk.core.IResolvable No description.
attrExcludeResourceIdsScope com.aliyun.ros.cdk.core.IResolvable No description.
attrInputParameters com.aliyun.ros.cdk.core.IResolvable No description.
attrMaximumExecutionFrequency com.aliyun.ros.cdk.core.IResolvable No description.
attrRegionIdsScope com.aliyun.ros.cdk.core.IResolvable No description.
attrResourceGroupIdsScope com.aliyun.ros.cdk.core.IResolvable No description.
attrResourceTypesScope com.aliyun.ros.cdk.core.IResolvable No description.
attrRiskLevel com.aliyun.ros.cdk.core.IResolvable No description.
attrRuleName com.aliyun.ros.cdk.core.IResolvable No description.
attrSourceIdentifier com.aliyun.ros.cdk.core.IResolvable No description.
attrSourceOwner com.aliyun.ros.cdk.core.IResolvable No description.
attrTagKeyScope com.aliyun.ros.cdk.core.IResolvable No description.
attrTagValueScope com.aliyun.ros.cdk.core.IResolvable No description.
configRuleTriggerTypes java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
enableResourcePropertyConstraint java.lang.Boolean No description.
resourceTypesScope com.aliyun.ros.cdk.core.IResolvable OR java.util.List No description.
riskLevel java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable No description.
ruleName java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
sourceIdentifier java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
sourceOwner java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
description java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
excludeResourceIdsScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
inputParameters com.aliyun.ros.cdk.core.IResolvable OR java.util.Map No description.
maximumExecutionFrequency java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
regionIdsScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
resourceGroupIdsScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
tagKeyLogicScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
tagKeyScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.
tagValueScope java.lang.String OR com.aliyun.ros.cdk.core.IResolvable No description.

nodeRequired

public ConstructNode getNode();
  • Type: com.aliyun.ros.cdk.core.ConstructNode

The construct tree node associated with this construct.


creationStackRequired

public java.util.List<java.lang.String> getCreationStack();
  • Type: java.util.List

logicalIdRequired

public java.lang.String getLogicalId();
  • Type: java.lang.String

The logical ID for this stack element.

The logical ID of the element is calculated from the path of the resource node in the construct tree.

To override this value, use overrideLogicalId(newLogicalId).


stackRequired

public Stack getStack();
  • Type: com.aliyun.ros.cdk.core.Stack

The stack in which this element is defined.

RosElements must be defined within a stack scope (directly or indirectly).


refRequired

public java.lang.String getRef();
  • Type: java.lang.String

Return a string that will be resolved to a RosTemplate { Ref } for this element.

If, by any chance, the intrinsic reference of a resource is not a string, you could coerce it to an IResolvable through Lazy.any({ produce: resource.ref }).


rosOptionsRequired

public IRosResourceOptions getRosOptions();
  • Type: com.aliyun.ros.cdk.core.IRosResourceOptions

Options for this resource, such as condition, update policy etc.


rosResourceTypeRequired

public java.lang.String getRosResourceType();
  • Type: java.lang.String

ROS resource type.


attrConfigRuleArnRequired

public IResolvable getAttrConfigRuleArn();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrConfigRuleIdRequired

public IResolvable getAttrConfigRuleId();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrConfigRuleTriggerTypesRequired

public IResolvable getAttrConfigRuleTriggerTypes();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrDescriptionRequired

public IResolvable getAttrDescription();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrEventSourceRequired

public IResolvable getAttrEventSource();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrExcludeResourceIdsScopeRequired

public IResolvable getAttrExcludeResourceIdsScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrInputParametersRequired

public IResolvable getAttrInputParameters();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrMaximumExecutionFrequencyRequired

public IResolvable getAttrMaximumExecutionFrequency();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrRegionIdsScopeRequired

public IResolvable getAttrRegionIdsScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrResourceGroupIdsScopeRequired

public IResolvable getAttrResourceGroupIdsScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrResourceTypesScopeRequired

public IResolvable getAttrResourceTypesScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrRiskLevelRequired

public IResolvable getAttrRiskLevel();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrRuleNameRequired

public IResolvable getAttrRuleName();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrSourceIdentifierRequired

public IResolvable getAttrSourceIdentifier();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrSourceOwnerRequired

public IResolvable getAttrSourceOwner();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrTagKeyScopeRequired

public IResolvable getAttrTagKeyScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable

attrTagValueScopeRequired

public IResolvable getAttrTagValueScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable

configRuleTriggerTypesRequired

public java.lang.Object getConfigRuleTriggerTypes();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

enableResourcePropertyConstraintRequired

public java.lang.Boolean getEnableResourcePropertyConstraint();
  • Type: java.lang.Boolean

resourceTypesScopeRequired

public java.lang.Object getResourceTypesScope();
  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

riskLevelRequired

public java.lang.Object getRiskLevel();
  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

ruleNameRequired

public java.lang.Object getRuleName();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

sourceIdentifierRequired

public java.lang.Object getSourceIdentifier();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

sourceOwnerRequired

public java.lang.Object getSourceOwner();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

descriptionOptional

public java.lang.Object getDescription();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

excludeResourceIdsScopeOptional

public java.lang.Object getExcludeResourceIdsScope();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

inputParametersOptional

public java.lang.Object getInputParameters();
  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.Map

maximumExecutionFrequencyOptional

public java.lang.Object getMaximumExecutionFrequency();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

regionIdsScopeOptional

public java.lang.Object getRegionIdsScope();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

resourceGroupIdsScopeOptional

public java.lang.Object getResourceGroupIdsScope();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

tagKeyLogicScopeOptional

public java.lang.Object getTagKeyLogicScope();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

tagKeyScopeOptional

public java.lang.Object getTagKeyScope();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

tagValueScopeOptional

public java.lang.Object getTagValueScope();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Constants

Name Type Description
ROS_RESOURCE_TYPE_NAME java.lang.String The resource type name for this resource class.

ROS_RESOURCE_TYPE_NAMERequired

public java.lang.String getRosResourceTypeName();
  • Type: java.lang.String

The resource type name for this resource class.