Network.AWS.SNS.Subscribe

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

Creating a Request

subscribe

Arguments

:: Text

subTopicARN

-> Text

subProtocol

-> Subscribe

Creates a value of Subscribe with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• subEndpoint
• subTopicARN
• subProtocol

data Subscribe

Input for Subscribe action.

See: subscribe smart constructor.

Instances

Eq Subscribe

Methods

(==) :: Subscribe -> Subscribe -> Bool

(/=) :: Subscribe -> Subscribe -> Bool

Data Subscribe

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Subscribe -> c Subscribe

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Subscribe

toConstr :: Subscribe -> Constr

dataTypeOf :: Subscribe -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c Subscribe)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Subscribe)

gmapT :: (forall b. Data b => b -> b) -> Subscribe -> Subscribe

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Subscribe -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Subscribe -> r

gmapQ :: (forall d. Data d => d -> u) -> Subscribe -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> Subscribe -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> Subscribe -> m Subscribe

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Subscribe -> m Subscribe

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Subscribe -> m Subscribe

Read Subscribe

Methods

readsPrec :: Int -> ReadS Subscribe

readList :: ReadS [Subscribe]

readPrec :: ReadPrec Subscribe

readListPrec :: ReadPrec [Subscribe]

Show Subscribe

Methods

showsPrec :: Int -> Subscribe -> ShowS

show :: Subscribe -> String

showList :: [Subscribe] -> ShowS

Generic Subscribe

Associated Types

type Rep Subscribe :: * -> *

Methods

from :: Subscribe -> Rep Subscribe x

to :: Rep Subscribe x -> Subscribe

Hashable Subscribe

Methods

hashWithSalt :: Int -> Subscribe -> Int

hash :: Subscribe -> Int

NFData Subscribe

Methods

rnf :: Subscribe -> ()

AWSRequest Subscribe

Associated Types

type Rs Subscribe :: *

Methods

request :: Subscribe -> Request Subscribe

response :: MonadResource m => Logger -> Service -> Proxy * Subscribe -> ClientResponse -> m (Response Subscribe)

ToPath Subscribe

Methods

toPath :: Subscribe -> ByteString

ToHeaders Subscribe

Methods

toHeaders :: Subscribe -> [Header]

ToQuery Subscribe

Methods

toQuery :: Subscribe -> QueryString

type Rep Subscribe

type Rep Subscribe = D1 (MetaData "Subscribe" "Network.AWS.SNS.Subscribe" "amazonka-sns-1.4.2-A3Nk9Q4F36AEpOtIgXp4xy" False) (C1 (MetaCons "Subscribe'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_subEndpoint") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_subTopicARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_subProtocol") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs Subscribe

type Rs Subscribe = SubscribeResponse

Request Lenses

subEndpoint :: Lens' Subscribe (Maybe Text)

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 email address
• For the 'email-json' protocol, the endpoint is an email address
• For the sms protocol, the endpoint is a phone number of an SMS-enabled device
• For the sqs protocol, the endpoint is the ARN of an Amazon SQS queue
• For the application protocol, the endpoint is the EndpointArn of a mobile app and device.

subTopicARN :: Lens' Subscribe Text

The ARN of the topic you want to subscribe to.

subProtocol :: Lens' Subscribe Text

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
• sms -- delivery of message via SMS
• sqs -- delivery of JSON-encoded message to an Amazon SQS queue
• application -- delivery of JSON-encoded message to an EndpointArn for a mobile app and device.

Destructuring the Response

subscribeResponse

Arguments

:: Int

srsResponseStatus

-> SubscribeResponse

Creates a value of SubscribeResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• srsSubscriptionARN
• srsResponseStatus

data SubscribeResponse

Response for Subscribe action.

See: subscribeResponse smart constructor.

Instances

Eq SubscribeResponse

Methods

(==) :: SubscribeResponse -> SubscribeResponse -> Bool

(/=) :: SubscribeResponse -> SubscribeResponse -> Bool

Data SubscribeResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> SubscribeResponse -> c SubscribeResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c SubscribeResponse

toConstr :: SubscribeResponse -> Constr

dataTypeOf :: SubscribeResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c SubscribeResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c SubscribeResponse)

gmapT :: (forall b. Data b => b -> b) -> SubscribeResponse -> SubscribeResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> SubscribeResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> SubscribeResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> SubscribeResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> SubscribeResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> SubscribeResponse -> m SubscribeResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> SubscribeResponse -> m SubscribeResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> SubscribeResponse -> m SubscribeResponse

Read SubscribeResponse

Methods

readsPrec :: Int -> ReadS SubscribeResponse

readList :: ReadS [SubscribeResponse]

readPrec :: ReadPrec SubscribeResponse

readListPrec :: ReadPrec [SubscribeResponse]

Show SubscribeResponse

Methods

showsPrec :: Int -> SubscribeResponse -> ShowS

show :: SubscribeResponse -> String

showList :: [SubscribeResponse] -> ShowS

Generic SubscribeResponse

Associated Types

type Rep SubscribeResponse :: * -> *

Methods

from :: SubscribeResponse -> Rep SubscribeResponse x

to :: Rep SubscribeResponse x -> SubscribeResponse

NFData SubscribeResponse

Methods

rnf :: SubscribeResponse -> ()

type Rep SubscribeResponse

type Rep SubscribeResponse = D1 (MetaData "SubscribeResponse" "Network.AWS.SNS.Subscribe" "amazonka-sns-1.4.2-A3Nk9Q4F36AEpOtIgXp4xy" False) (C1 (MetaCons "SubscribeResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_srsSubscriptionARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_srsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

srsSubscriptionARN :: Lens' SubscribeResponse (Maybe Text)

The ARN of the subscription, if the service was able to create a subscription immediately (without requiring endpoint owner confirmation).

srsResponseStatus :: Lens' SubscribeResponse Int

The response status code.