RosListener

This class is a base encapsulation around the ROS resource type ALIYUN::SLB::Listener, which is used to create a Server Load Balancer (SLB) listener.

Initializers

import ros_cdk_slb
ros_cdk_slb.RosListener(
  scope: Construct,
  id: str,
  bandwidth: typing.Union[typing.Union[int, float], IResolvable],
  listener_port: typing.Union[typing.Union[int, float], IResolvable],
  load_balancer_id: typing.Union[str, IResolvable],
  protocol: typing.Union[str, IResolvable],
  acl_id: typing.Union[str, IResolvable] = None,
  acl_ids: typing.Union[IResolvable, typing.List[typing.Union[str, IResolvable]]] = None,
  acl_status: typing.Union[str, IResolvable] = None,
  acl_type: typing.Union[str, IResolvable] = None,
  backend_server_port: typing.Union[typing.Union[int, float], IResolvable] = None,
  ca_certificate_id: typing.Union[str, IResolvable] = None,
  connection_drain: typing.Union[str, IResolvable] = None,
  connection_drain_timeout: typing.Union[typing.Union[int, float], IResolvable] = None,
  description: typing.Union[str, IResolvable] = None,
  enable_http2: typing.Union[str, IResolvable] = None,
  gzip: typing.Union[str, IResolvable] = None,
  health_check: typing.Union[IResolvable, HealthCheckProperty] = None,
  http_config: typing.Union[IResolvable, HttpConfigProperty] = None,
  idle_timeout: typing.Union[typing.Union[int, float], IResolvable] = None,
  master_slave_server_group_id: typing.Union[str, IResolvable] = None,
  persistence: typing.Union[IResolvable, PersistenceProperty] = None,
  port_range: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, PortRangeProperty]]] = None,
  proxy_protocol_v2_enabled: typing.Union[bool, IResolvable] = None,
  request_timeout: typing.Union[typing.Union[int, float], IResolvable] = None,
  scheduler: typing.Union[str, IResolvable] = None,
  server_certificate_id: typing.Union[str, IResolvable] = None,
  start_listener: typing.Union[bool, IResolvable] = None,
  tags: typing.List[TagsProperty] = None,
  tls_cipher_policy: typing.Union[str, IResolvable] = None,
  v_server_group_id: typing.Union[str, IResolvable] = None,
  enable_resource_property_constraint: bool
)

Name	Type	Description
scope	ros_cdk_core.Construct	- scope in which this resource is defined.
id	str	- scoped id of the resource.
bandwidth	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
listener_port	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
load_balancer_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
protocol	typing.Union[str, ros_cdk_core.IResolvable]	No description.
acl_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
acl_ids	typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[str, ros_cdk_core.IResolvable]]]	No description.
acl_status	typing.Union[str, ros_cdk_core.IResolvable]	No description.
acl_type	typing.Union[str, ros_cdk_core.IResolvable]	No description.
backend_server_port	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
ca_certificate_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
connection_drain	typing.Union[str, ros_cdk_core.IResolvable]	No description.
connection_drain_timeout	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
description	typing.Union[str, ros_cdk_core.IResolvable]	No description.
enable_http2	typing.Union[str, ros_cdk_core.IResolvable]	No description.
gzip	typing.Union[str, ros_cdk_core.IResolvable]	No description.
health_check	typing.Union[ros_cdk_core.IResolvable, HealthCheckProperty]	No description.
http_config	typing.Union[ros_cdk_core.IResolvable, HttpConfigProperty]	No description.
idle_timeout	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
master_slave_server_group_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
persistence	typing.Union[ros_cdk_core.IResolvable, PersistenceProperty]	No description.
port_range	typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, PortRangeProperty]]]	No description.
proxy_protocol_v2_enabled	typing.Union[bool, ros_cdk_core.IResolvable]	No description.
request_timeout	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
scheduler	typing.Union[str, ros_cdk_core.IResolvable]	No description.
server_certificate_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
start_listener	typing.Union[bool, ros_cdk_core.IResolvable]	No description.
tags	typing.List[TagsProperty]	No description.
tls_cipher_policy	typing.Union[str, ros_cdk_core.IResolvable]	No description.
v_server_group_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
enable_resource_property_constraint	bool	No description.

---

scope^Required

• Type: ros_cdk_core.Construct

scope in which this resource is defined.

---

id^Required

• Type: str

scoped id of the resource.

---

bandwidth^Required

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

listener_port^Required

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

load_balancer_id^Required

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

protocol^Required

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

acl_id^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

acl_ids^Optional

• Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[str, ros_cdk_core.IResolvable]]]

---

acl_status^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

acl_type^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

backend_server_port^Optional

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

ca_certificate_id^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

connection_drain^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

connection_drain_timeout^Optional

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

description^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

enable_http2^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

gzip^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

health_check^Optional

• Type: typing.Union[ros_cdk_core.IResolvable, HealthCheckProperty]

---

http_config^Optional

• Type: typing.Union[ros_cdk_core.IResolvable, HttpConfigProperty]

---

idle_timeout^Optional

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

master_slave_server_group_id^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

persistence^Optional

• Type: typing.Union[ros_cdk_core.IResolvable, PersistenceProperty]

---

port_range^Optional

• Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, PortRangeProperty]]]

---

proxy_protocol_v2_enabled^Optional

• Type: typing.Union[bool, ros_cdk_core.IResolvable]

---

request_timeout^Optional

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

scheduler^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

server_certificate_id^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

start_listener^Optional

• Type: typing.Union[bool, ros_cdk_core.IResolvable]

---

tags^Optional

• Type: typing.List[TagsProperty]

---

tls_cipher_policy^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

v_server_group_id^Optional

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

enable_resource_property_constraint^Required

• Type: bool

---

Methods

Name	Description
to_string	Returns a string representation of this construct.
synthesize	Allows this construct to emit artifacts into the cloud assembly during synthesis.
override_logical_id	Overrides the auto-generated logical ID with a specific ID.
add_condition	No description.
add_count	No description.
add_deletion_override	Syntactic sugar for addOverride(path, undefined).
add_depends_on	Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
add_desc	No description.
add_meta_data	No description.
add_override	Adds an override to the synthesized ROS resource.
add_property_deletion_override	Adds an override that deletes the value of a property from the resource definition.
add_property_override	Adds an override to a resource property.
add_ros_dependency	No description.
apply_removal_policy	Sets the deletion policy of the resource based on the removal policy specified.
get_att	Returns a token for an runtime attribute of this resource.

---

to_string

def to_string() -> str

Returns a string representation of this construct.

synthesize

def synthesize(
  session: ISynthesisSession
) -> None

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.

session^Required

• Type: ros_cdk_core.ISynthesisSession

The synthesis session.

---

override_logical_id

def override_logical_id(
  new_logical_id: str
) -> None

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

new_logical_id^Required

• Type: str

The new logical ID to use for this stack element.

---

add_condition

def add_condition(
  con: RosCondition
) -> None

con^Required

• Type: ros_cdk_core.RosCondition

---

add_count

def add_count(
  count: typing.Union[typing.Union[int, float], IResolvable]
) -> None

count^Required

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

add_deletion_override

def add_deletion_override(
  path: str
) -> None

Syntactic sugar for addOverride(path, undefined).

path^Required

• Type: str

The path of the value to delete.

---

add_depends_on

def add_depends_on(
  target: RosResource
) -> None

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.

target^Required

• Type: ros_cdk_core.RosResource

---

add_desc

def add_desc(
  desc: str
) -> None

desc^Required

• Type: str

---

add_meta_data

def add_meta_data(
  key: str,
  value: typing.Any
) -> None

key^Required

• Type: str

---

value^Required

• Type: typing.Any

---

add_override

def add_override(
  path: str,
  value: typing.Any
) -> None

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"
       ...
     },
   ]
   ...
}

path^Required

• Type: str

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

Any intermdediate keys will be created as needed.

---

value^Required

• Type: typing.Any

The value.

Could be primitive or complex.

---

add_property_deletion_override

def add_property_deletion_override(
  property_path: str
) -> None

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

property_path^Required

• Type: str

The path to the property.

---

add_property_override

def add_property_override(
  property_path: str,
  value: typing.Any
) -> None

Adds an override to a resource property.

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

property_path^Required

• Type: str

The path of the property.

---

value^Required

• Type: typing.Any

The value.

---

add_ros_dependency

def add_ros_dependency(
  target: str
) -> None

target^Required

• Type: str

---

apply_removal_policy

def apply_removal_policy(
  policy: RemovalPolicy = None,
  apply_to_update_replace_policy: bool = None,
  default_policy: RemovalPolicy = None
) -> None

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

policy^Optional

• Type: ros_cdk_core.RemovalPolicy

---

apply_to_update_replace_policy^Optional

• Type: bool

---

default_policy^Optional

• Type: ros_cdk_core.RemovalPolicy

---

get_att

def get_att(
  attribute_name: str
) -> Reference

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.

attribute_name^Required

• Type: str

The name of the attribute.

---

Static Functions

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

---

is_construct

import ros_cdk_slb
ros_cdk_slb.RosListener.is_construct(
  x: typing.Any
)

Return whether the given object is a Construct.

x^Required

• Type: typing.Any

---

is_ros_element

import ros_cdk_slb
ros_cdk_slb.RosListener.is_ros_element(
  x: typing.Any
)

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.

x^Required

• Type: typing.Any

---

is_ros_resource

import ros_cdk_slb
ros_cdk_slb.RosListener.is_ros_resource(
  construct: IConstruct
)

Check whether the given construct is a RosResource.

construct^Required

• Type: ros_cdk_core.IConstruct

---

Properties

Name	Type	Description
node	ros_cdk_core.ConstructNode	The construct tree node associated with this construct.
creation_stack	typing.List[str]	No description.
logical_id	str	The logical ID for this stack element.
stack	ros_cdk_core.Stack	The stack in which this element is defined.
ref	str	Return a string that will be resolved to a RosTemplate { Ref } for this element.
ros_options	ros_cdk_core.IRosResourceOptions	Options for this resource, such as condition, update policy etc.
ros_resource_type	str	ROS resource type.
attr_listener_ports_and_protocol	ros_cdk_core.IResolvable	No description.
attr_load_balancer_id	ros_cdk_core.IResolvable	No description.
bandwidth	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
enable_resource_property_constraint	bool	No description.
listener_port	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
load_balancer_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
protocol	typing.Union[str, ros_cdk_core.IResolvable]	No description.
acl_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
acl_ids	typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[str, ros_cdk_core.IResolvable]]]	No description.
acl_status	typing.Union[str, ros_cdk_core.IResolvable]	No description.
acl_type	typing.Union[str, ros_cdk_core.IResolvable]	No description.
backend_server_port	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
ca_certificate_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
connection_drain	typing.Union[str, ros_cdk_core.IResolvable]	No description.
connection_drain_timeout	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
description	typing.Union[str, ros_cdk_core.IResolvable]	No description.
enable_http2	typing.Union[str, ros_cdk_core.IResolvable]	No description.
gzip	typing.Union[str, ros_cdk_core.IResolvable]	No description.
health_check	typing.Union[ros_cdk_core.IResolvable, HealthCheckProperty]	No description.
http_config	typing.Union[ros_cdk_core.IResolvable, HttpConfigProperty]	No description.
idle_timeout	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
master_slave_server_group_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
persistence	typing.Union[ros_cdk_core.IResolvable, PersistenceProperty]	No description.
port_range	typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, PortRangeProperty]]]	No description.
proxy_protocol_v2_enabled	typing.Union[bool, ros_cdk_core.IResolvable]	No description.
request_timeout	typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]	No description.
scheduler	typing.Union[str, ros_cdk_core.IResolvable]	No description.
server_certificate_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.
start_listener	typing.Union[bool, ros_cdk_core.IResolvable]	No description.
tags	typing.List[TagsProperty]	No description.
tls_cipher_policy	typing.Union[str, ros_cdk_core.IResolvable]	No description.
v_server_group_id	typing.Union[str, ros_cdk_core.IResolvable]	No description.

---

node^Required

node: ConstructNode

• Type: ros_cdk_core.ConstructNode

The construct tree node associated with this construct.

---

creation_stack^Required

creation_stack: typing.List[str]

• Type: typing.List[str]

---

logical_id^Required

logical_id: str

• Type: str

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).

---

stack^Required

stack: Stack

• Type: ros_cdk_core.Stack

The stack in which this element is defined.

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

---

ref^Required

ref: str

• Type: str

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 }).

---

ros_options^Required

ros_options: IRosResourceOptions

• Type: ros_cdk_core.IRosResourceOptions

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

---

ros_resource_type^Required

ros_resource_type: str

• Type: str

ROS resource type.

---

attr_listener_ports_and_protocol^Required

attr_listener_ports_and_protocol: IResolvable

• Type: ros_cdk_core.IResolvable

---

attr_load_balancer_id^Required

attr_load_balancer_id: IResolvable

• Type: ros_cdk_core.IResolvable

---

bandwidth^Required

bandwidth: typing.Union[typing.Union[int, float], IResolvable]

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

enable_resource_property_constraint^Required

enable_resource_property_constraint: bool

• Type: bool

---

listener_port^Required

listener_port: typing.Union[typing.Union[int, float], IResolvable]

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

load_balancer_id^Required

load_balancer_id: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

protocol^Required

protocol: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

acl_id^Optional

acl_id: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

acl_ids^Optional

acl_ids: typing.Union[IResolvable, typing.List[typing.Union[str, IResolvable]]]

• Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[str, ros_cdk_core.IResolvable]]]

---

acl_status^Optional

acl_status: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

acl_type^Optional

acl_type: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

backend_server_port^Optional

backend_server_port: typing.Union[typing.Union[int, float], IResolvable]

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

ca_certificate_id^Optional

ca_certificate_id: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

connection_drain^Optional

connection_drain: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

connection_drain_timeout^Optional

connection_drain_timeout: typing.Union[typing.Union[int, float], IResolvable]

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

description^Optional

description: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

enable_http2^Optional

enable_http2: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

gzip^Optional

gzip: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

health_check^Optional

health_check: typing.Union[IResolvable, HealthCheckProperty]

• Type: typing.Union[ros_cdk_core.IResolvable, HealthCheckProperty]

---

http_config^Optional

http_config: typing.Union[IResolvable, HttpConfigProperty]

• Type: typing.Union[ros_cdk_core.IResolvable, HttpConfigProperty]

---

idle_timeout^Optional

idle_timeout: typing.Union[typing.Union[int, float], IResolvable]

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

master_slave_server_group_id^Optional

master_slave_server_group_id: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

persistence^Optional

persistence: typing.Union[IResolvable, PersistenceProperty]

• Type: typing.Union[ros_cdk_core.IResolvable, PersistenceProperty]

---

port_range^Optional

port_range: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, PortRangeProperty]]]

• Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, PortRangeProperty]]]

---

proxy_protocol_v2_enabled^Optional

proxy_protocol_v2_enabled: typing.Union[bool, IResolvable]

• Type: typing.Union[bool, ros_cdk_core.IResolvable]

---

request_timeout^Optional

request_timeout: typing.Union[typing.Union[int, float], IResolvable]

• Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

---

scheduler^Optional

scheduler: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

server_certificate_id^Optional

server_certificate_id: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

start_listener^Optional

start_listener: typing.Union[bool, IResolvable]

• Type: typing.Union[bool, ros_cdk_core.IResolvable]

---

tags^Optional

tags: typing.List[TagsProperty]

• Type: typing.List[TagsProperty]

---

tls_cipher_policy^Optional

tls_cipher_policy: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

v_server_group_id^Optional

v_server_group_id: typing.Union[str, IResolvable]

• Type: typing.Union[str, ros_cdk_core.IResolvable]

---

Constants

Name	Type	Description
ROS_RESOURCE_TYPE_NAME	str	The resource type name for this resource class.

---

ROS_RESOURCE_TYPE_NAME^Required

ROS_RESOURCE_TYPE_NAME: str

• Type: str

The resource type name for this resource class.

---