securityGroupRule.md

securityGroupRule Submodule

Constructs

SecurityGroupRule

Represents a {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule aws_security_group_rule}.

Initializers

import { securityGroupRule } from '@cdktf/aws-cdk'

new securityGroupRule.SecurityGroupRule(scope: Construct, id: string, config: SecurityGroupRuleConfig)

Name	Type	Description
scope	constructs.Construct	The scope in which to define this construct.
id	string	The scoped construct ID.
config	SecurityGroupRuleConfig	No description.

---

scope^Required

• Type: constructs.Construct

The scope in which to define this construct.

---

id^Required

• Type: string

The scoped construct ID.

Must be unique amongst siblings in the same scope

---

config^Required

• Type: SecurityGroupRuleConfig

---

Methods

Name	Description
toString	Returns a string representation of this construct.
addOverride	No description.
overrideLogicalId	Overrides the auto-generated logical ID with a specific ID.
resetOverrideLogicalId	Resets a previously passed logical Id to use the auto-generated logical id again.
toHclTerraform	No description.
toMetadata	No description.
toTerraform	Adds this resource to the terraform JSON output.
addMoveTarget	Adds a user defined moveTarget string to this resource to be later used in .moveTo(moveTarget) to resolve the location of the move.
getAnyMapAttribute	No description.
getBooleanAttribute	No description.
getBooleanMapAttribute	No description.
getListAttribute	No description.
getNumberAttribute	No description.
getNumberListAttribute	No description.
getNumberMapAttribute	No description.
getStringAttribute	No description.
getStringMapAttribute	No description.
hasResourceMove	No description.
importFrom	No description.
interpolationForAttribute	No description.
moveFromId	Move the resource corresponding to "id" to this resource.
moveTo	Moves this resource to the target resource given by moveTarget.
moveToId	Moves this resource to the resource corresponding to "id".
resetCidrBlocks	No description.
resetDescription	No description.
resetId	No description.
resetIpv6CidrBlocks	No description.
resetPrefixListIds	No description.
resetSelfAttribute	No description.
resetSourceSecurityGroupId	No description.

---

toString

public toString(): string

Returns a string representation of this construct.

addOverride

public addOverride(path: string, value: any): void

path^Required

• Type: string

---

value^Required

• Type: any

---

overrideLogicalId

public overrideLogicalId(newLogicalId: string): void

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

newLogicalId^Required

• Type: string

The new logical ID to use for this stack element.

---

resetOverrideLogicalId

public resetOverrideLogicalId(): void

Resets a previously passed logical Id to use the auto-generated logical id again.

toHclTerraform

public toHclTerraform(): any

toMetadata

public toMetadata(): any

toTerraform

public toTerraform(): any

Adds this resource to the terraform JSON output.

addMoveTarget

public addMoveTarget(moveTarget: string): void

Adds a user defined moveTarget string to this resource to be later used in .moveTo(moveTarget) to resolve the location of the move.

moveTarget^Required

• Type: string

The string move target that will correspond to this resource.

---

getAnyMapAttribute

public getAnyMapAttribute(terraformAttribute: string): {[ key: string ]: any}

terraformAttribute^Required

• Type: string

---

getBooleanAttribute

public getBooleanAttribute(terraformAttribute: string): IResolvable

terraformAttribute^Required

• Type: string

---

getBooleanMapAttribute

public getBooleanMapAttribute(terraformAttribute: string): {[ key: string ]: boolean}

terraformAttribute^Required

• Type: string

---

getListAttribute

public getListAttribute(terraformAttribute: string): string[]

terraformAttribute^Required

• Type: string

---

getNumberAttribute

public getNumberAttribute(terraformAttribute: string): number

terraformAttribute^Required

• Type: string

---

getNumberListAttribute

public getNumberListAttribute(terraformAttribute: string): number[]

terraformAttribute^Required

• Type: string

---

getNumberMapAttribute

public getNumberMapAttribute(terraformAttribute: string): {[ key: string ]: number}

terraformAttribute^Required

• Type: string

---

getStringAttribute

public getStringAttribute(terraformAttribute: string): string

terraformAttribute^Required

• Type: string

---

getStringMapAttribute

public getStringMapAttribute(terraformAttribute: string): {[ key: string ]: string}

terraformAttribute^Required

• Type: string

---

hasResourceMove

public hasResourceMove(): TerraformResourceMoveByTarget | TerraformResourceMoveById

importFrom

public importFrom(id: string, provider?: TerraformProvider): void

id^Required

• Type: string

---

provider^Optional

• Type: cdktf.TerraformProvider

---

interpolationForAttribute

public interpolationForAttribute(terraformAttribute: string): IResolvable

terraformAttribute^Required

• Type: string

---

moveFromId

public moveFromId(id: string): void

Move the resource corresponding to "id" to this resource.

Note that the resource being moved from must be marked as moved using it's instance function.

id^Required

• Type: string

Full id of resource being moved from, e.g. "aws_s3_bucket.example".

---

moveTo

public moveTo(moveTarget: string, index?: string | number): void

Moves this resource to the target resource given by moveTarget.

moveTarget^Required

• Type: string

The previously set user defined string set by .addMoveTarget() corresponding to the resource to move to.

---

index^Optional

• Type: string | number

Optional The index corresponding to the key the resource is to appear in the foreach of a resource to move to.

---

moveToId

public moveToId(id: string): void

Moves this resource to the resource corresponding to "id".

id^Required

• Type: string

Full id of resource to move to, e.g. "aws_s3_bucket.example".

---

resetCidrBlocks

public resetCidrBlocks(): void

resetDescription

public resetDescription(): void

resetId

public resetId(): void

resetIpv6CidrBlocks

public resetIpv6CidrBlocks(): void

resetPrefixListIds

public resetPrefixListIds(): void

resetSelfAttribute

public resetSelfAttribute(): void

resetSourceSecurityGroupId

public resetSourceSecurityGroupId(): void

Static Functions

Name	Description
isConstruct	Checks if x is a construct.
isTerraformElement	No description.
isTerraformResource	No description.
generateConfigForImport	Generates CDKTF code for importing a SecurityGroupRule resource upon running "cdktf plan ".

---

isConstruct

import { securityGroupRule } from '@cdktf/aws-cdk'

securityGroupRule.SecurityGroupRule.isConstruct(x: any)

Checks if x is a construct.

Use this method instead of instanceof to properly detect Construct instances, even when the construct library is symlinked.

Explanation: in JavaScript, multiple copies of the constructs library on disk are seen as independent, completely different libraries. As a consequence, the class Construct in each copy of the constructs library is seen as a different class, and an instance of one class will not test as instanceof the other class. npm install will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the constructs library can be accidentally installed, and instanceof will behave unpredictably. It is safest to avoid using instanceof, and using this type-testing method instead.

x^Required

• Type: any

Any object.

---

isTerraformElement

import { securityGroupRule } from '@cdktf/aws-cdk'

securityGroupRule.SecurityGroupRule.isTerraformElement(x: any)

x^Required

• Type: any

---

isTerraformResource

import { securityGroupRule } from '@cdktf/aws-cdk'

securityGroupRule.SecurityGroupRule.isTerraformResource(x: any)

x^Required

• Type: any

---

generateConfigForImport

import { securityGroupRule } from '@cdktf/aws-cdk'

securityGroupRule.SecurityGroupRule.generateConfigForImport(scope: Construct, importToId: string, importFromId: string, provider?: TerraformProvider)

Generates CDKTF code for importing a SecurityGroupRule resource upon running "cdktf plan ".

scope^Required

• Type: constructs.Construct

The scope in which to define this construct.

---

importToId^Required

• Type: string

The construct id used in the generated config for the SecurityGroupRule to import.

---

importFromId^Required

• Type: string

The id of the existing SecurityGroupRule that should be imported.

Refer to the {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#import import section} in the documentation of this resource for the id to use

---

provider^Optional

• Type: cdktf.TerraformProvider

? Optional instance of the provider where the SecurityGroupRule to import is found.

---

Properties

Name	Type	Description
node	constructs.Node	The tree node.
cdktfStack	cdktf.TerraformStack	No description.
fqn	string	No description.
friendlyUniqueId	string	No description.
terraformMetaArguments	{[ key: string ]: any}	No description.
terraformResourceType	string	No description.
terraformGeneratorMetadata	cdktf.TerraformProviderGeneratorMetadata	No description.
connection	cdktf.SSHProvisionerConnection | cdktf.WinrmProvisionerConnection	No description.
count	number | cdktf.TerraformCount	No description.
dependsOn	string[]	No description.
forEach	cdktf.ITerraformIterator	No description.
lifecycle	cdktf.TerraformResourceLifecycle	No description.
provider	cdktf.TerraformProvider	No description.
provisioners	cdktf.FileProvisioner | cdktf.LocalExecProvisioner | cdktf.RemoteExecProvisioner[]	No description.
cidrBlocksInput	string[]	No description.
descriptionInput	string	No description.
fromPortInput	number	No description.
idInput	string	No description.
ipv6CidrBlocksInput	string[]	No description.
prefixListIdsInput	string[]	No description.
protocolInput	string	No description.
securityGroupIdInput	string	No description.
selfAttributeInput	boolean | cdktf.IResolvable	No description.
sourceSecurityGroupIdInput	string	No description.
toPortInput	number	No description.
typeInput	string	No description.
cidrBlocks	string[]	No description.
description	string	No description.
fromPort	number	No description.
id	string	No description.
ipv6CidrBlocks	string[]	No description.
prefixListIds	string[]	No description.
protocol	string	No description.
securityGroupId	string	No description.
selfAttribute	boolean | cdktf.IResolvable	No description.
sourceSecurityGroupId	string	No description.
toPort	number	No description.
type	string	No description.

---

node^Required

public readonly node: Node;

• Type: constructs.Node

The tree node.

---

cdktfStack^Required

public readonly cdktfStack: TerraformStack;

• Type: cdktf.TerraformStack

---

fqn^Required

public readonly fqn: string;

• Type: string

---

friendlyUniqueId^Required

public readonly friendlyUniqueId: string;

• Type: string

---

terraformMetaArguments^Required

public readonly terraformMetaArguments: {[ key: string ]: any};

• Type: {[ key: string ]: any}

---

terraformResourceType^Required

public readonly terraformResourceType: string;

• Type: string

---

terraformGeneratorMetadata^Optional

public readonly terraformGeneratorMetadata: TerraformProviderGeneratorMetadata;

• Type: cdktf.TerraformProviderGeneratorMetadata

---

connection^Optional

public readonly connection: SSHProvisionerConnection | WinrmProvisionerConnection;

• Type: cdktf.SSHProvisionerConnection | cdktf.WinrmProvisionerConnection

---

count^Optional

public readonly count: number | TerraformCount;

• Type: number | cdktf.TerraformCount

---

dependsOn^Optional

public readonly dependsOn: string[];

• Type: string[]

---

forEach^Optional

public readonly forEach: ITerraformIterator;

• Type: cdktf.ITerraformIterator

---

lifecycle^Optional

public readonly lifecycle: TerraformResourceLifecycle;

• Type: cdktf.TerraformResourceLifecycle

---

provider^Optional

public readonly provider: TerraformProvider;

• Type: cdktf.TerraformProvider

---

provisioners^Optional

public readonly provisioners: FileProvisioner | LocalExecProvisioner | RemoteExecProvisioner[];

• Type: cdktf.FileProvisioner | cdktf.LocalExecProvisioner | cdktf.RemoteExecProvisioner[]

---

cidrBlocksInput^Optional

public readonly cidrBlocksInput: string[];

• Type: string[]

---

descriptionInput^Optional

public readonly descriptionInput: string;

• Type: string

---

fromPortInput^Optional

public readonly fromPortInput: number;

• Type: number

---

idInput^Optional

public readonly idInput: string;

• Type: string

---

ipv6CidrBlocksInput^Optional

public readonly ipv6CidrBlocksInput: string[];

• Type: string[]

---

prefixListIdsInput^Optional

public readonly prefixListIdsInput: string[];

• Type: string[]

---

protocolInput^Optional

public readonly protocolInput: string;

• Type: string

---

securityGroupIdInput^Optional

public readonly securityGroupIdInput: string;

• Type: string

---

selfAttributeInput^Optional

public readonly selfAttributeInput: boolean | IResolvable;

• Type: boolean | cdktf.IResolvable

---

sourceSecurityGroupIdInput^Optional

public readonly sourceSecurityGroupIdInput: string;

• Type: string

---

toPortInput^Optional

public readonly toPortInput: number;

• Type: number

---

typeInput^Optional

public readonly typeInput: string;

• Type: string

---

cidrBlocks^Required

public readonly cidrBlocks: string[];

• Type: string[]

---

description^Required

public readonly description: string;

• Type: string

---

fromPort^Required

public readonly fromPort: number;

• Type: number

---

id^Required

public readonly id: string;

• Type: string

---

ipv6CidrBlocks^Required

public readonly ipv6CidrBlocks: string[];

• Type: string[]

---

prefixListIds^Required

public readonly prefixListIds: string[];

• Type: string[]

---

protocol^Required

public readonly protocol: string;

• Type: string

---

securityGroupId^Required

public readonly securityGroupId: string;

• Type: string

---

selfAttribute^Required

public readonly selfAttribute: boolean | IResolvable;

• Type: boolean | cdktf.IResolvable

---

sourceSecurityGroupId^Required

public readonly sourceSecurityGroupId: string;

• Type: string

---

toPort^Required

public readonly toPort: number;

• Type: number

---

type^Required

public readonly type: string;

• Type: string

---

Constants

Name	Type	Description
tfResourceType	string	No description.

---

tfResourceType^Required

public readonly tfResourceType: string;

• Type: string

---

Structs

SecurityGroupRuleConfig

Initializer

import { securityGroupRule } from '@cdktf/aws-cdk'

const securityGroupRuleConfig: securityGroupRule.SecurityGroupRuleConfig = { ... }

Properties

Name	Type	Description
connection	cdktf.SSHProvisionerConnection | cdktf.WinrmProvisionerConnection	No description.
count	number | cdktf.TerraformCount	No description.
dependsOn	cdktf.ITerraformDependable[]	No description.
forEach	cdktf.ITerraformIterator	No description.
lifecycle	cdktf.TerraformResourceLifecycle	No description.
provider	cdktf.TerraformProvider	No description.
provisioners	cdktf.FileProvisioner | cdktf.LocalExecProvisioner | cdktf.RemoteExecProvisioner[]	No description.
fromPort	number	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#from_port SecurityGroupRule#from_port}.
protocol	string	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#protocol SecurityGroupRule#protocol}.
securityGroupId	string	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#security_group_id SecurityGroupRule#security_group_id}.
toPort	number	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#to_port SecurityGroupRule#to_port}.
type	string	Type of rule, ingress (inbound) or egress (outbound).
cidrBlocks	string[]	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#cidr_blocks SecurityGroupRule#cidr_blocks}.
description	string	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#description SecurityGroupRule#description}.
id	string	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#id SecurityGroupRule#id}.
ipv6CidrBlocks	string[]	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#ipv6_cidr_blocks SecurityGroupRule#ipv6_cidr_blocks}.
prefixListIds	string[]	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#prefix_list_ids SecurityGroupRule#prefix_list_ids}.
selfAttribute	boolean | cdktf.IResolvable	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#self SecurityGroupRule#self}.
sourceSecurityGroupId	string	Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#source_security_group_id SecurityGroupRule#source_security_group_id}.

---

connection^Optional

public readonly connection: SSHProvisionerConnection | WinrmProvisionerConnection;

• Type: cdktf.SSHProvisionerConnection | cdktf.WinrmProvisionerConnection

---

count^Optional

public readonly count: number | TerraformCount;

• Type: number | cdktf.TerraformCount

---

dependsOn^Optional

public readonly dependsOn: ITerraformDependable[];

• Type: cdktf.ITerraformDependable[]

---

forEach^Optional

public readonly forEach: ITerraformIterator;

• Type: cdktf.ITerraformIterator

---

lifecycle^Optional

public readonly lifecycle: TerraformResourceLifecycle;

• Type: cdktf.TerraformResourceLifecycle

---

provider^Optional

public readonly provider: TerraformProvider;

• Type: cdktf.TerraformProvider

---

provisioners^Optional

public readonly provisioners: FileProvisioner | LocalExecProvisioner | RemoteExecProvisioner[];

• Type: cdktf.FileProvisioner | cdktf.LocalExecProvisioner | cdktf.RemoteExecProvisioner[]

---

fromPort^Required

public readonly fromPort: number;

• Type: number

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#from_port SecurityGroupRule#from_port}.

---

protocol^Required

public readonly protocol: string;

• Type: string

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#protocol SecurityGroupRule#protocol}.

---

securityGroupId^Required

public readonly securityGroupId: string;

• Type: string

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#security_group_id SecurityGroupRule#security_group_id}.

---

toPort^Required

public readonly toPort: number;

• Type: number

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#to_port SecurityGroupRule#to_port}.

---

type^Required

public readonly type: string;

• Type: string

Type of rule, ingress (inbound) or egress (outbound).

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#type SecurityGroupRule#type}

---

cidrBlocks^Optional

public readonly cidrBlocks: string[];

• Type: string[]

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#cidr_blocks SecurityGroupRule#cidr_blocks}.

---

description^Optional

public readonly description: string;

• Type: string

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#description SecurityGroupRule#description}.

---

id^Optional

public readonly id: string;

• Type: string

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#id SecurityGroupRule#id}.

Please be aware that the id field is automatically added to all resources in Terraform providers using a Terraform provider SDK version below 2. If you experience problems setting this value it might not be settable. Please take a look at the provider documentation to ensure it should be settable.

---

ipv6CidrBlocks^Optional

public readonly ipv6CidrBlocks: string[];

• Type: string[]

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#ipv6_cidr_blocks SecurityGroupRule#ipv6_cidr_blocks}.

---

prefixListIds^Optional

public readonly prefixListIds: string[];

• Type: string[]

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#prefix_list_ids SecurityGroupRule#prefix_list_ids}.

---

selfAttribute^Optional

public readonly selfAttribute: boolean | IResolvable;

• Type: boolean | cdktf.IResolvable

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#self SecurityGroupRule#self}.

---

sourceSecurityGroupId^Optional

public readonly sourceSecurityGroupId: string;

• Type: string

Docs at Terraform Registry: {@link https://registry.terraform.io/providers/hashicorp/aws/3.76.1/docs/resources/security_group_rule#source_security_group_id SecurityGroupRule#source_security_group_id}.

---