Package software.amazon.awscdk.services.ec2

Class CfnSecurityGroupEgress

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.ec2.CfnSecurityGroupEgress
All Implemented Interfaces:
IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.93.0 (build 1706ca5)", date="2024-01-03T18:29:25.359Z") @Stability(Stable) public class CfnSecurityGroupEgress extends CfnResource implements IInspectable
Adds the specified egress rules to a security group.

An outbound rule permits instances to send traffic to the specified destination IPv4 or IPv6 CIDR address ranges, or to the specified destination security groups for the same VPC.

You specify a protocol for each rule (for example, TCP). For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

You must specify only one of the following properties: CidrIp , CidrIpv6 , DestinationPrefixListId , or DestinationSecurityGroupId .

You must specify a destination security group ( DestinationPrefixListId or DestinationSecurityGroupId ) or a CIDR range ( CidrIp or CidrIpv6 ). If you do not specify one of these parameters, the stack will launch successfully but the rule will not be added to the security group.

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

For more information about VPC security group limits, see Amazon VPC Limits .

Use AWS::EC2::SecurityGroupIngress and AWS::EC2::SecurityGroupEgress only when necessary, typically to allow security groups to reference each other in ingress and egress rules. Otherwise, use the embedded ingress and egress rules of the security group. For more information, see Amazon EC2 Security Groups .

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.ec2.*;
 CfnSecurityGroupEgress cfnSecurityGroupEgress = CfnSecurityGroupEgress.Builder.create(this, "MyCfnSecurityGroupEgress")
         .groupId("groupId")
         .ipProtocol("ipProtocol")
         // the properties below are optional
         .cidrIp("cidrIp")
         .cidrIpv6("cidrIpv6")
         .description("description")
         .destinationPrefixListId("destinationPrefixListId")
         .destinationSecurityGroupId("destinationSecurityGroupId")
         .fromPort(123)
         .toPort(123)
         .build();

See Also:

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnSecurityGroupEgress

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

    • CfnSecurityGroupEgress

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

    • CfnSecurityGroupEgress

      @Stability(Stable) public CfnSecurityGroupEgress(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CfnSecurityGroupEgressProps props)
      Parameters:
      scope - Scope in which this resource is defined. This parameter is required.
      id - Construct identifier for this resource (unique in its scope). This parameter is required.
      props - Resource properties. This parameter is required.

  • Method Details

    • inspect

      @Stability(Stable) public void inspect(@NotNull 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

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getAttrId

      @Stability(Stable) @NotNull public String getAttrId()
      The Security Group Rule Id.

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getGroupId

      @Stability(Stable) @NotNull public String getGroupId()
      The ID of the security group.

    • setGroupId

      @Stability(Stable) public void setGroupId(@NotNull String value)
      The ID of the security group.

    • getIpProtocol

      @Stability(Stable) @NotNull public String getIpProtocol()
      The IP protocol name ( tcp , udp , icmp , icmpv6 ) or number (see Protocol Numbers ).

    • setIpProtocol

      @Stability(Stable) public void setIpProtocol(@NotNull String value)
      The IP protocol name ( tcp , udp , icmp , icmpv6 ) or number (see Protocol Numbers ).

    • getCidrIp

      @Stability(Stable) @Nullable public String getCidrIp()
      The IPv4 address range, in CIDR format.

    • setCidrIp

      @Stability(Stable) public void setCidrIp(@Nullable String value)
      The IPv4 address range, in CIDR format.

    • getCidrIpv6

      @Stability(Stable) @Nullable public String getCidrIpv6()
      The IPv6 address range, in CIDR format.

    • setCidrIpv6

      @Stability(Stable) public void setCidrIpv6(@Nullable String value)
      The IPv6 address range, in CIDR format.

    • getDescription

      @Stability(Stable) @Nullable public String getDescription()
      The description of an egress (outbound) security group rule.

    • setDescription

      @Stability(Stable) public void setDescription(@Nullable String value)
      The description of an egress (outbound) security group rule.

    • getDestinationPrefixListId

      @Stability(Stable) @Nullable public String getDestinationPrefixListId()
      The prefix list IDs for an AWS service.

    • setDestinationPrefixListId

      @Stability(Stable) public void setDestinationPrefixListId(@Nullable String value)
      The prefix list IDs for an AWS service.

    • getDestinationSecurityGroupId

      @Stability(Stable) @Nullable public String getDestinationSecurityGroupId()
      The ID of the security group.

    • setDestinationSecurityGroupId

      @Stability(Stable) public void setDestinationSecurityGroupId(@Nullable String value)
      The ID of the security group.

    • getFromPort

      @Stability(Stable) @Nullable public Number getFromPort()
      If the protocol is TCP or UDP, this is the start of the port range.

    • setFromPort

      @Stability(Stable) public void setFromPort(@Nullable Number value)
      If the protocol is TCP or UDP, this is the start of the port range.

    • getToPort

      @Stability(Stable) @Nullable public Number getToPort()
      If the protocol is TCP or UDP, this is the end of the port range.

    • setToPort

      @Stability(Stable) public void setToPort(@Nullable Number value)
      If the protocol is TCP or UDP, this is the end of the port range.