amazonka-apigateway-1.6.0: Amazon API Gateway SDK.

Copyright(c) 2013-2018 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.APIGateway.PutMethodResponse

Contents

Description

Adds a MethodResponse to an existing Method resource.

Synopsis

Creating a Request

putMethodResponse Source #

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

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

  • pmResponseModels - Specifies the Model resources used for the response's content type. Response models are represented as a key/value map, with a content type as the key and a Model name as the value.
  • pmResponseParameters - A key-value map specifying required or optional response parameters that API Gateway can send back to the caller. A key defines a method response header name and the associated value is a Boolean flag indicating whether the method response parameter is required or not. The method response header names must match the pattern of method.response.header.{name} , where name is a valid and unique header name. The response parameter names defined here are available in the integration response to be mapped from an integration response header expressed in integration.response.header.{name} , a static value enclosed within a pair of single quotes (e.g., 'application/json' ), or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression} , where JSON-expression is a valid JSON expression without the > prefix.)
  • pmRestAPIId - [Required] The string identifier of the associated RestApi .
  • pmResourceId - [Required] The Resource identifier for the Method resource.
  • pmHttpMethod - [Required] The HTTP verb of the Method resource.
  • pmStatusCode - [Required] The method response's status code.

data PutMethodResponse Source #

Request to add a MethodResponse to an existing Method resource.

See: putMethodResponse smart constructor.

Instances

Eq PutMethodResponse Source # 
Data PutMethodResponse Source # 

Methods

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

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

toConstr :: PutMethodResponse -> Constr #

dataTypeOf :: PutMethodResponse -> DataType #

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

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

gmapT :: (forall b. Data b => b -> b) -> PutMethodResponse -> PutMethodResponse #

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

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

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

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

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

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

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

Read PutMethodResponse Source # 
Show PutMethodResponse Source # 
Generic PutMethodResponse Source # 
Hashable PutMethodResponse Source # 
ToJSON PutMethodResponse Source # 
NFData PutMethodResponse Source # 

Methods

rnf :: PutMethodResponse -> () #

AWSRequest PutMethodResponse Source # 
ToHeaders PutMethodResponse Source # 
ToPath PutMethodResponse Source # 
ToQuery PutMethodResponse Source # 
type Rep PutMethodResponse Source # 
type Rep PutMethodResponse = D1 * (MetaData "PutMethodResponse" "Network.AWS.APIGateway.PutMethodResponse" "amazonka-apigateway-1.6.0-JJ9NJtNe0aRBcVRYpJCEA2" False) (C1 * (MetaCons "PutMethodResponse'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_pmResponseModels") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map Text Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_pmResponseParameters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map Text Bool)))) (S1 * (MetaSel (Just Symbol "_pmRestAPIId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_pmResourceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) ((:*:) * (S1 * (MetaSel (Just Symbol "_pmHttpMethod") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_pmStatusCode") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))))
type Rs PutMethodResponse Source # 

Request Lenses

pmResponseModels :: Lens' PutMethodResponse (HashMap Text Text) Source #

Specifies the Model resources used for the response's content type. Response models are represented as a key/value map, with a content type as the key and a Model name as the value.

pmResponseParameters :: Lens' PutMethodResponse (HashMap Text Bool) Source #

A key-value map specifying required or optional response parameters that API Gateway can send back to the caller. A key defines a method response header name and the associated value is a Boolean flag indicating whether the method response parameter is required or not. The method response header names must match the pattern of method.response.header.{name} , where name is a valid and unique header name. The response parameter names defined here are available in the integration response to be mapped from an integration response header expressed in integration.response.header.{name} , a static value enclosed within a pair of single quotes (e.g., 'application/json' ), or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression} , where JSON-expression is a valid JSON expression without the > prefix.)

pmRestAPIId :: Lens' PutMethodResponse Text Source #

Required
The string identifier of the associated RestApi .

pmResourceId :: Lens' PutMethodResponse Text Source #

Required
The Resource identifier for the Method resource.

pmHttpMethod :: Lens' PutMethodResponse Text Source #

Required
The HTTP verb of the Method resource.

pmStatusCode :: Lens' PutMethodResponse Text Source #

Required
The method response's status code.

Destructuring the Response

methodResponse :: MethodResponse Source #

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

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

  • mResponseModels - Specifies the Model resources used for the response's content-type. Response models are represented as a key/value map, with a content-type as the key and a Model name as the value.
  • mStatusCode - The method response's status code.
  • mResponseParameters - A key-value map specifying required or optional response parameters that API Gateway can send back to the caller. A key defines a method response header and the value specifies whether the associated method response header is required or not. The expression of the key must match the pattern method.response.header.{name} , where name is a valid and unique header name. API Gateway passes certain integration response data to the method response headers specified here according to the mapping you prescribe in the API's IntegrationResponse . The integration response data that can be mapped include an integration response header expressed in integration.response.header.{name} , a static value enclosed within a pair of single quotes (e.g., 'application/json' ), or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression} , where JSON-expression is a valid JSON expression without the > prefix.)

data MethodResponse Source #

Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integration response that can be transformed using a mapping template.

Example: A MethodResponse instance of an API Request The example request retrieves a MethodResponse of the 200 status code.

@GET restapisfugvjdxtriresources3kzxbg5sa2methodsGETresponses200 HTTP1.1 Content-Type: applicationjson Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}20160603us-east-1apigatewayaws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash} Response The successful response returns 200 OK@ status and a payload as follows:

@{ "_links": { "curies": { "href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true }, "self": { "href": "restapisfugvjdxtriresources3kzxbg5sa2methodsGETresponses200", "title": "200" }, "methodresponse:delete": { "href": "restapisfugvjdxtriresources3kzxbg5sa2methodsGETresponses200" }, "methodresponse:update": { "href": "restapisfugvjdxtriresources3kzxbg5sa2methodsGETresponses200" } }, "responseModels": { "application/json": Empty }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" } @

Method , IntegrationResponse , Integration Creating an API

See: methodResponse smart constructor.

Instances

Eq MethodResponse Source # 
Data MethodResponse Source # 

Methods

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

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

toConstr :: MethodResponse -> Constr #

dataTypeOf :: MethodResponse -> DataType #

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

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

gmapT :: (forall b. Data b => b -> b) -> MethodResponse -> MethodResponse #

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

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

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

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

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

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

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

Read MethodResponse Source # 
Show MethodResponse Source # 
Generic MethodResponse Source # 

Associated Types

type Rep MethodResponse :: * -> * #

Hashable MethodResponse Source # 
FromJSON MethodResponse Source # 
NFData MethodResponse Source # 

Methods

rnf :: MethodResponse -> () #

type Rep MethodResponse Source # 
type Rep MethodResponse = D1 * (MetaData "MethodResponse" "Network.AWS.APIGateway.Types.Product" "amazonka-apigateway-1.6.0-JJ9NJtNe0aRBcVRYpJCEA2" False) (C1 * (MetaCons "MethodResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_mResponseModels") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map Text Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_mStatusCode") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_mResponseParameters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map Text Bool)))))))

Response Lenses

mResponseModels :: Lens' MethodResponse (HashMap Text Text) Source #

Specifies the Model resources used for the response's content-type. Response models are represented as a key/value map, with a content-type as the key and a Model name as the value.

mStatusCode :: Lens' MethodResponse (Maybe Text) Source #

The method response's status code.

mResponseParameters :: Lens' MethodResponse (HashMap Text Bool) Source #

A key-value map specifying required or optional response parameters that API Gateway can send back to the caller. A key defines a method response header and the value specifies whether the associated method response header is required or not. The expression of the key must match the pattern method.response.header.{name} , where name is a valid and unique header name. API Gateway passes certain integration response data to the method response headers specified here according to the mapping you prescribe in the API's IntegrationResponse . The integration response data that can be mapped include an integration response header expressed in integration.response.header.{name} , a static value enclosed within a pair of single quotes (e.g., 'application/json' ), or a JSON expression from the back-end response payload in the form of integration.response.body.{JSON-expression} , where JSON-expression is a valid JSON expression without the > prefix.)