Client
sns | R Documentation |
Amazon Simple Notification Service¶
Description¶
Amazon Simple Notification Service (Amazon SNS) is a web service that enables you to build distributed web-enabled applications. Applications can use Amazon SNS to easily push real-time notification messages to interested subscribers over multiple delivery protocols. For more information about this product see the Amazon SNS product page. For detailed information about Amazon SNS features and their associated API calls, see the Amazon SNS Developer Guide.
For information on the permissions you need to use this API, see Identity and access management in Amazon SNS in the Amazon SNS Developer Guide.
We also provide SDKs that enable you to access Amazon SNS from your preferred programming language. The SDKs contain functionality that automatically takes care of tasks such as: cryptographically signing your service requests, retrying requests, and handling error responses. For a list of available SDKs, go to Tools for Amazon Web Services.
Usage¶
Arguments¶
config
Optional configuration of credentials, endpoint, and/or region.
credentials:
creds:
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint: The complete URL to use for the constructed client.
region: The AWS Region used in instantiating the client.
close_connection: Immediately close all HTTP connections.
timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
s3_force_path_style: Set this to
true
to force the request to use path-style addressing, i.e.http://s3.amazonaws.com/BUCKET/KEY
.sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
credentials
Optional credentials shorthand for the config parameter
creds:
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint
Optional shorthand for complete URL to use for the constructed client.
region
Optional shorthand for AWS Region used in instantiating the client.
Value¶
A client for the service. You can call the service's operations using
syntax like svc$operation(...)
, where svc
is the name you've
assigned to the client. The available operations are listed in the
Operations section.
Service syntax¶
svc <- sns(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string",
close_connection = "logical",
timeout = "numeric",
s3_force_path_style = "logical",
sts_regional_endpoint = "string"
),
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string"
)
Operations¶
- add_permission
- Adds a statement to a topic's access control policy, granting access for the specified Amazon Web Services accounts to the specified actions
- check_if_phone_number_is_opted_out
- Accepts a phone number and indicates whether the phone holder has opted out of receiving SMS messages from your Amazon Web Services account
- confirm_subscription
- Verifies an endpoint owner's intent to receive messages by validating the token sent to the endpoint by an earlier Subscribe action
- create_platform_application
- Creates a platform application object for one of the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging), to which devices and mobile apps may register
- create_platform_endpoint
- Creates an endpoint for a device and mobile app on one of the supported push notification services, such as GCM (Firebase Cloud Messaging) and APNS
- create_sms_sandbox_phone_number
- Adds a destination phone number to an Amazon Web Services account in the SMS sandbox and sends a one-time password (OTP) to that phone number
- create_topic
- Creates a topic to which notifications can be published
- delete_endpoint
- Deletes the endpoint for a device and mobile app from Amazon SNS
- delete_platform_application
- Deletes a platform application object for one of the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging)
- delete_sms_sandbox_phone_number
- Deletes an Amazon Web Services account's verified or pending phone number from the SMS sandbox
- delete_topic
- Deletes a topic and all its subscriptions
- get_data_protection_policy
- Retrieves the specified inline DataProtectionPolicy document that is stored in the specified Amazon SNS topic
- get_endpoint_attributes
- Retrieves the endpoint attributes for a device on one of the supported push notification services, such as GCM (Firebase Cloud Messaging) and APNS
- get_platform_application_attributes
- Retrieves the attributes of the platform application object for the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging)
- get_sms_attributes
- Returns the settings for sending SMS messages from your Amazon Web Services account
- get_sms_sandbox_account_status
- Retrieves the SMS sandbox status for the calling Amazon Web Services account in the target Amazon Web Services Region
- get_subscription_attributes
- Returns all of the properties of a subscription
- get_topic_attributes
- Returns all of the properties of a topic
- Lists the endpoints and endpoint attributes for devices in a supported push notification service, such as GCM (Firebase Cloud Messaging) and APNS
- list_origination_numbers
- Lists the calling Amazon Web Services account's dedicated origination numbers and their metadata
- list_phone_numbers_opted_out
- Returns a list of phone numbers that are opted out, meaning you cannot send SMS messages to them
- list_platform_applications
- Lists the platform application objects for the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging)
- list_sms_sandbox_phone_numbers
- Lists the calling Amazon Web Services account's current verified and pending destination phone numbers in the SMS sandbox
- list_subscriptions
- Returns a list of the requester's subscriptions
- list_subscriptions_by_topic
- Returns a list of the subscriptions to a specific topic
- list_tags_for_resource
- List all tags added to the specified Amazon SNS topic
- list_topics
- Returns a list of the requester's topics
- opt_in_phone_number
- Use this request to opt in a phone number that is opted out, which enables you to resume sending SMS messages to the number
- publish
- Sends a message to an Amazon SNS topic, a text message (SMS message) directly to a phone number, or a message to a mobile platform endpoint (when you specify the TargetArn)
- publish_batch
- Publishes up to ten messages to the specified topic
- put_data_protection_policy
- Adds or updates an inline policy document that is stored in the specified Amazon SNS topic
- remove_permission
- Removes a statement from a topic's access control policy
- set_endpoint_attributes
- Sets the attributes for an endpoint for a device on one of the supported push notification services, such as GCM (Firebase Cloud Messaging) and APNS
- set_platform_application_attributes
- Sets the attributes of the platform application object for the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging)
- set_sms_attributes
- Use this request to set the default settings for sending SMS messages and receiving daily SMS usage reports
- set_subscription_attributes
- Allows a subscription owner to set an attribute of the subscription to a new value
- set_topic_attributes
- Allows a topic owner to set an attribute of the topic to a new value
- subscribe
- Subscribes an endpoint to an Amazon SNS topic
- tag_resource
- Add tags to the specified Amazon SNS topic
- unsubscribe
- Deletes a subscription
- untag_resource
- Remove tags from the specified Amazon SNS topic
- verify_sms_sandbox_phone_number
- Verifies a destination phone number with a one-time password (OTP) for the calling Amazon Web Services account