Skip to content

Subscription

  • Implements: ros_cdk_mns.datasource.ISubscription

This class encapsulates and extends the ROS resource type DATASOURCE::MNS::Subscription.

Initializers

from ros_cdk_mns import datasource
datasource.Subscription(
  scope: Construct,
  id: str,
  subscription_name: typing.Union[str, IResolvable],
  topic_name: typing.Union[str, IResolvable],
  refresh_options: typing.Union[str, IResolvable] = None,
  enable_resource_property_constraint: bool = None
)
Name Type Description
scope ros_cdk_core.Construct No description.
id str No description.
subscription_name typing.Union[str, ros_cdk_core.IResolvable] Property subscriptionName: The name of the subscription.
topic_name typing.Union[str, ros_cdk_core.IResolvable] Property topicName: The name of the topic.
refresh_options typing.Union[str, ros_cdk_core.IResolvable] Property refreshOptions: The refresh strategy for the datasource resource when the stack is updated.
enable_resource_property_constraint bool No description.

scopeRequired

  • Type: ros_cdk_core.Construct

idRequired

  • Type: str

subscription_nameRequired

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

Property subscriptionName: The name of the subscription.


topic_nameRequired

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

Property topicName: The name of the topic.


refresh_optionsOptional

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

Property refreshOptions: The refresh strategy for the datasource resource when the stack is updated.

Valid values:

  • Never: Never refresh the datasource resource when the stack is updated.
  • Always: Always refresh the datasource resource when the stack is updated. Default is Never.

enable_resource_property_constraintOptional

  • 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.
add_condition No description.
add_count No description.
add_dependency No description.
add_resource_desc No description.
apply_removal_policy No description.
fetch_condition No description.
fetch_dependency No description.
fetch_resource_desc No description.
get_att No description.
set_metadata No description.

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.

sessionRequired

  • Type: ros_cdk_core.ISynthesisSession

The synthesis session.


add_condition

def add_condition(
  condition: RosCondition
) -> None

conditionRequired

  • Type: ros_cdk_core.RosCondition

add_count

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

countRequired

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

add_dependency

def add_dependency(
  resource: Resource
) -> None

resourceRequired

  • Type: ros_cdk_core.Resource

add_resource_desc

def add_resource_desc(
  desc: str
) -> None

descRequired

  • Type: str

apply_removal_policy

def apply_removal_policy(
  policy: RemovalPolicy
) -> None

policyRequired

  • Type: ros_cdk_core.RemovalPolicy

fetch_condition

def fetch_condition() -> RosCondition

fetch_dependency

def fetch_dependency() -> typing.List[str]

fetch_resource_desc

def fetch_resource_desc() -> str

get_att

def get_att(
  name: str
) -> IResolvable

nameRequired

  • Type: str

set_metadata

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

keyRequired

  • Type: str

valueRequired

  • Type: typing.Any

Static Functions

Name Description
is_construct Return whether the given object is a Construct.

is_construct

from ros_cdk_mns import datasource
datasource.Subscription.is_construct(
  x: typing.Any
)

Return whether the given object is a Construct.

xRequired

  • Type: typing.Any

Properties

Name Type Description
node ros_cdk_core.ConstructNode The construct tree node associated with this construct.
env ros_cdk_core.IResourceEnvironment The environment this resource belongs to.
ref str No description.
stack ros_cdk_core.Stack The stack in which this resource is defined.
resource ros_cdk_core.RosResource No description.
attr_create_time typing.Union[str, ros_cdk_core.IResolvable] Attribute CreateTime: The time when the subscription was created.
attr_endpoint typing.Union[str, ros_cdk_core.IResolvable] Attribute Endpoint: The endpoint that is used by the subscriber to receive messages.
attr_filter_tag typing.Union[str, ros_cdk_core.IResolvable] Attribute FilterTag: Describes the labels by which messages are filtered in this subscription (only messages with consistent labels are pushed).
attr_last_modify_time typing.Union[str, ros_cdk_core.IResolvable] Attribute LastModifyTime: The time when the subscription was last modified.
attr_notify_content_format typing.Union[str, ros_cdk_core.IResolvable] Attribute NotifyContentFormat: The format of the message that is pushed to the endpoint.
attr_notify_strategy typing.Union[str, ros_cdk_core.IResolvable] Attribute NotifyStrategy: The retry policy that is applied if an error occurs when Message Service (MNS) pushes messages to the endpoint.
attr_subscription_name typing.Union[str, ros_cdk_core.IResolvable] Attribute SubscriptionName: The name of the subscription.
attr_subscription_url typing.Union[str, ros_cdk_core.IResolvable] Attribute SubscriptionURL: TThe URL of the subscription.
attr_topic_name typing.Union[str, ros_cdk_core.IResolvable] Attribute TopicName: The name of the topic.
attr_topic_owner typing.Union[str, ros_cdk_core.IResolvable] Attribute TopicOwner: The owner of the topic.
props SubscriptionProps No description.

nodeRequired

node: ConstructNode
  • Type: ros_cdk_core.ConstructNode

The construct tree node associated with this construct.


envRequired

env: IResourceEnvironment
  • Type: ros_cdk_core.IResourceEnvironment

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.


refRequired

ref: str
  • Type: str

stackRequired

stack: Stack
  • Type: ros_cdk_core.Stack

The stack in which this resource is defined.


resourceOptional

resource: RosResource
  • Type: ros_cdk_core.RosResource

attr_create_timeRequired

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

Attribute CreateTime: The time when the subscription was created.


attr_endpointRequired

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

Attribute Endpoint: The endpoint that is used by the subscriber to receive messages.


attr_filter_tagRequired

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

Attribute FilterTag: Describes the labels by which messages are filtered in this subscription (only messages with consistent labels are pushed).


attr_last_modify_timeRequired

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

Attribute LastModifyTime: The time when the subscription was last modified.


attr_notify_content_formatRequired

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

Attribute NotifyContentFormat: The format of the message that is pushed to the endpoint.


attr_notify_strategyRequired

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

Attribute NotifyStrategy: The retry policy that is applied if an error occurs when Message Service (MNS) pushes messages to the endpoint.


attr_subscription_nameRequired

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

Attribute SubscriptionName: The name of the subscription.


attr_subscription_urlRequired

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

Attribute SubscriptionURL: TThe URL of the subscription.


attr_topic_nameRequired

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

Attribute TopicName: The name of the topic.


attr_topic_ownerRequired

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

Attribute TopicOwner: The owner of the topic.


propsRequired

props: SubscriptionProps