
subscribe
*********


DESCRIPTION
===========

The subscribe action prepares to subscribe an endpoint by sending the
endpoint a confirmation message. To actually create a subscription,
the endpoint owner must call the confirm-subscription action with the
token from the confirmation message. Confirmation tokens are valid for
three days.


SYNOPSIS
========

   aws sns subscribe
     --notification-endpoint <value>
     --protocol <value>
     --topic-arn <value>


REQUIRED PARAMETERS
===================

"--notification-endpoint"  (string)
   The endpoint that you want to receive notifications. Endpoints vary
   by protocol:

   * For the http protocol, the endpoint is an URL beginning with
     "http://"

   * For the https protocol, the endpoint is a URL beginning with
     "https://"

   * For the email protocol, the endpoint is an e-mail address

   * For the email-json protocol, the endpoint is an e-mail address

   * For the sqs protocol, the endpoint is the ARN of an Amazon SQS
     queue

"--protocol"  (string)
   The protocol you want to use. Supported protocols include:

   * http -- delivery of JSON-encoded message via HTTP POST

   * https -- delivery of JSON-encoded message via HTTPS POST

   * email -- delivery of message via SMTP

   * email-json -- delivery of JSON-encoded message via SMTP

   * sqs -- delivery of JSON-encoded message to an Amazon SQS queue

"--topic-arn"  (string)
   The ARN of topic you want to subscribe to.


OPTIONAL PARAMETERS
===================

None
