notification
notification smtpserver get
Usage
usage: symp notification smtpserver get
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
Description
Returns the Smtp server configuration.
Returns
Returns dict: OK
Optional
optional arguments:
-h, --help show this help message and exit
notification smtpserver update
Usage
usage: symp notification smtpserver update
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--server-name SERVER_NAME]
[--server-port SERVER_PORT]
[--username USERNAME]
[--password PASSWORD]
[--enable-tls ENABLE_TLS]
[--from-address FROM_ADDRESS]
Description
Set the configuration of the Smtp server.
Returns
Returns dict: OK
Optional
optional arguments:
-h, --help show this help message and exit
--server-name SERVER_NAME
The name of the Smtp server
--server-port SERVER_PORT
Set when the Smtp server is not using port 25/
--username USERNAME If the account requires authentication, this parameter is used to set the username.
--password PASSWORD If the account requires authentication, this parameter is used to set the password.
--enable-tls ENABLE_TLS
Determines if the connection to the server is encrypted.
--from-address FROM_ADDRESS
The email address that will appear in the from field of the emails sent by the notification service. The email address must have valid syntax (for example, notifications@symphony.com or noreply@symphony.com).
notification subscriptions delete
Usage
usage: symp notification subscriptions delete
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
subscription_id
Description
Deletes a subscription.
Mandatory
positional arguments:
subscription_id The unique identifier of the subscription.
Optional
optional arguments:
-h, --help show this help message and exit
notification subscriptions get-attributes
Usage
usage: symp notification subscriptions get-attributes
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
subscription_id
Description
Returns all of the properties of a subscription.
Returns
Returns dict: OK
Mandatory
positional arguments:
subscription_id The unique identifier of the subscription.
Optional
optional arguments:
-h, --help show this help message and exit
notification subscriptions list
Usage
usage: symp notification subscriptions list
[-f {adaptive_table,csv,json,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent]
[--quote {all,minimal,none,nonnumeric}]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--sort-column SORT_COLUMN]
[--order ORDER]
[--sort-by SORT_BY]
[--offset OFFSET] [--limit LIMIT]
[--account-id ACCOUNT_ID]
[--project-id PROJECT_ID]
[--user-id USER_ID]
[--topic-id TOPIC_ID]
Description
Returns a list of subscriptions.
Returns
Returns list: ok
Optional
optional arguments:
-h, --help show this help message and exit
--order ORDER The sorting order for get response
--sort-by SORT_BY The field by which to sort
--offset OFFSET Specify the first entity that you wan to retrieve
--limit LIMIT Specify the number of entities that you want to retrieve
--account-id ACCOUNT_ID
ID of an account
--project-id PROJECT_ID
ID of a project
--user-id USER_ID ID of a user
--topic-id TOPIC_ID The unique ID of a topic.
notification subscriptions set-attributes
Usage
usage: symp notification subscriptions set-attributes
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--value VALUE]
subscription_id name
Description
Allows a subscription owner to set an attribute of the topic to a new value.
Mandatory
positional arguments:
subscription_id The unique identifier of the subscription.
name The name of the attribute you want to set. Valid values are delivery_policy | raw_message_delivery
Optional
optional arguments:
-h, --help show this help message and exit
--value VALUE The value of the attribute.
notification topics add-permission
Usage
usage: symp notification topics add-permission
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--label LABEL]
[--project-ids [PROJECT_IDS [PROJECT_IDS ...]]]
[--actions [ACTIONS [ACTIONS ...]]]
topic_id
Description
Adds a statement to a topic’s access control policy, granting access for the specified project to the specified actions.
Mandatory
positional arguments:
topic_id The unique identifier of a topic
Optional
optional arguments:
-h, --help show this help message and exit
--label LABEL A unique identifier for the new policy statement.
--project-ids [PROJECT_IDS [PROJECT_IDS ...]]
The IDs of the projects who will be given access to the specified actions.
--actions [ACTIONS [ACTIONS ...]]
The action you want to allow for the specified principal(s).
notification topics confirm-subscription
Usage
usage: symp notification topics confirm-subscription
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
topic_id
Description
Verifies an endpoint owner’s intent to receive messages by validating the token sent to the endpoint by an earlier subscribe action. If the token is valid, the action creates a new subscription and returns its identifier.
Returns
Returns str: OK
Mandatory
positional arguments:
topic_id The unique identifier of a topic
Optional
optional arguments:
-h, --help show this help message and exit
notification topics create
Usage
usage: symp notification topics create
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
topic_name
Description
Creates a topic to which notifications can be published. This action is idempotent, so if the requester already owns a topic with the specified name, that topic’s ID is returned without creating a new topic.
Returns
Returns dict: OK
Mandatory
positional arguments:
topic_name
Optional
optional arguments:
-h, --help show this help message and exit
notification topics delete
Usage
usage: symp notification topics delete
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
topic_id
Description
Deletes a topic and all its subscriptions. Deleting a topic might prevent some messages previously sent to the topic from being delivered to subscribers. This action is idempotent, so deleting a topic that does not exist does not result in an error.
Mandatory
positional arguments:
topic_id The unique identifier of a topic
Optional
optional arguments:
-h, --help show this help message and exit
notification topics get-attributes
Usage
usage: symp notification topics get-attributes
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
topic_id
Description
Returns all of the properties of a topic.
Returns
Returns dict: OK
Mandatory
positional arguments:
topic_id None
Optional
optional arguments:
-h, --help show this help message and exit
notification topics get-subscriptions
Usage
usage: symp notification topics get-subscriptions
[-f {adaptive_table,csv,json,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty] [--noindent]
[--quote {all,minimal,none,nonnumeric}]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--sort-column SORT_COLUMN]
topic_id
Description
Returns all of the subscriptions of a topic.
Returns
Returns list: OK
Mandatory
positional arguments:
topic_id None
Optional
optional arguments:
-h, --help show this help message and exit
notification topics list
Usage
usage: symp notification topics list
[-f {adaptive_table,csv,json,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent]
[--quote {all,minimal,none,nonnumeric}]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--sort-column SORT_COLUMN]
[--order ORDER] [--sort-by SORT_BY]
[--offset OFFSET] [--limit LIMIT]
[--account-id ACCOUNT_ID]
[--project-id PROJECT_ID]
[--user-id USER_ID] [--name NAME]
[--id-eq ID_EQ]
Description
Returns
Returns list: ok
Optional
optional arguments:
-h, --help show this help message and exit
--order ORDER The sorting order for get response
--sort-by SORT_BY The field by which to sort
--offset OFFSET Specify the first entity that you want to retrieve
--limit LIMIT Specify the number of entities that you want to retrieve
--account-id ACCOUNT_ID
ID of an account
--project-id PROJECT_ID
ID of a project
--user-id USER_ID ID of a user
--name NAME The name of a topic.
--id-eq ID_EQ ids of topics to filter, for multilpe use commas (e.g 111,222,333)
notification topics publish
Usage
usage: symp notification topics publish
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--subject SUBJECT]
[--message-structure MESSAGE_STRUCTURE]
[--message-attributes [MESSAGE_ATTRIBUTES [MESSAGE_ATTRIBUTES ...]]]
topic_id message
Description
Sends a message to all of a topic’s subscribed endpoints. When a messageId is returned, the message has been saved and the notification service will attempt to deliver it to the topic’s subscribers shortly. The format of the outgoing message to each subscribed endpoint depends on the notification protocol.
Returns
Returns str: OK
Mandatory
positional arguments:
topic_id The unique identifier of a topic
message The message you want to send to the topic. If you want to send the same message to all transport protocols, include the text of the message as a target-arn value. If you want to send different messages for each transport protocol, set the value of the MessageStructure parameter to json and use a JSON object for the Message parameter constraints- Messages must be UTF-8 encoded strings at most 256 KB in size (262144 bytes, not 262144 characters).
Optional
optional arguments:
-h, --help show this help message and exit
--subject SUBJECT Optional parameter to be used as the "Subject" line when the message is delivered to email endpoints. This field will also be included, if present, in the standard JSON messages delivered to other endpoints. Subjects must be ASCII text that begins with a letter, number, or punctuation mark; must not include line breaks or control characters; and must be less than 100 characters long.
--message-structure MESSAGE_STRUCTURE
Set to json if you want to send a different message for each protocol.
--message-attributes [MESSAGE_ATTRIBUTES [MESSAGE_ATTRIBUTES ...]]
notification topics revoke-permissions
Usage
usage: symp notification topics revoke-permissions
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--noindent]
[--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
topic_id label
Description
Removes a statement from a topic’s access control policy.
Mandatory
positional arguments:
topic_id The unique identifier of a topic
label The unique label of the statement you want to remove.
Optional
optional arguments:
-h, --help show this help message and exit
notification topics set-attributes
Usage
usage: symp notification topics set-attributes
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
[--value VALUE]
topic_id name
Description
Allows a topic owner to set an attribute of the topic to a new value.
Mandatory
positional arguments:
topic_id None
name The name of the attribute. Supported names are policy, display_name, delivery_policy.
Optional
optional arguments:
-h, --help show this help message and exit
--value VALUE The value of the attribute.
notification topics subscribe
Usage
usage: symp notification topics subscribe
[-f {adaptive_table,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
[-m [NAME=VALUE [NAME=VALUE ...]]]
topic_id protocol endpoint
Description
Prepares to subscribe a notification-endpoint by sending the notification-endpoint a confirmation message. To actually create a subscription, the notification-endpoint owner must call the confirm-subscription action with the token from the confirmation message.
Returns
Returns str: OK
Mandatory
positional arguments:
topic_id The unique identifier of a topic
protocol The subscription's protocol.
endpoint The subscription's endpoint
Optional
optional arguments:
-h, --help show this help message and exit