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

Amazonka.APIGateway.UpdateMethodResponse

Description

Updates an existing MethodResponse resource.

Synopsis

Creating a Request

data UpdateMethodResponse Source #

A request to update an existing MethodResponse resource.

See: newUpdateMethodResponse smart constructor.

Constructors

UpdateMethodResponse' 

Fields

Instances

Instances details
Eq UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

Read UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

Show UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

Generic UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

Associated Types

type Rep UpdateMethodResponse :: Type -> Type #

NFData UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

Methods

rnf :: UpdateMethodResponse -> () #

Hashable UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

ToJSON UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

AWSRequest UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

Associated Types

type AWSResponse UpdateMethodResponse #

ToHeaders UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

ToPath UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

ToQuery UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

type Rep UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

type Rep UpdateMethodResponse = D1 ('MetaData "UpdateMethodResponse" "Amazonka.APIGateway.UpdateMethodResponse" "libZSservicesZSamazonka-apigatewayZSamazonka-apigateway" 'False) (C1 ('MetaCons "UpdateMethodResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "patchOperations") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [PatchOperation])) :*: S1 ('MetaSel ('Just "restApiId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :*: (S1 ('MetaSel ('Just "resourceId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: (S1 ('MetaSel ('Just "httpMethod") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "statusCode") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))
type AWSResponse UpdateMethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.UpdateMethodResponse

newUpdateMethodResponse Source #

Create a value of UpdateMethodResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:patchOperations:UpdateMethodResponse', updateMethodResponse_patchOperations - A list of update operations to be applied to the specified resource and in the order specified in this list.

$sel:restApiId:UpdateMethodResponse', updateMethodResponse_restApiId - [Required] The string identifier of the associated RestApi.

$sel:resourceId:UpdateMethodResponse', updateMethodResponse_resourceId - [Required] The Resource identifier for the MethodResponse resource.

$sel:httpMethod:UpdateMethodResponse', updateMethodResponse_httpMethod - [Required] The HTTP verb of the Method resource.

$sel:statusCode:UpdateMethodResponse', updateMethodResponse_statusCode - [Required] The status code for the MethodResponse resource.

Request Lenses

updateMethodResponse_patchOperations :: Lens' UpdateMethodResponse (Maybe [PatchOperation]) Source #

A list of update operations to be applied to the specified resource and in the order specified in this list.

updateMethodResponse_restApiId :: Lens' UpdateMethodResponse Text Source #

Required
The string identifier of the associated RestApi.

updateMethodResponse_resourceId :: Lens' UpdateMethodResponse Text Source #

Required
The Resource identifier for the MethodResponse resource.

updateMethodResponse_httpMethod :: Lens' UpdateMethodResponse Text Source #

Required
The HTTP verb of the Method resource.

updateMethodResponse_statusCode :: Lens' UpdateMethodResponse Text Source #

Required
The status code for the MethodResponse resource.

Destructuring the Response

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 /restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200 HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160603T222952Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/20160603/us-east-1/apigateway/aws4_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": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-{rel}.html", "name": "methodresponse", "templated": true }, "self": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" }, "methodresponse:delete": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" }, "methodresponse:update": { "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" } }, "responseModels": { "application/json": "Empty" }, "responseParameters": { "method.response.header.Content-Type": false }, "statusCode": "200" }

Method, IntegrationResponse, Integration Creating an API

See: newMethodResponse smart constructor.

Constructors

MethodResponse' 

Fields

  • responseModels :: Maybe (HashMap Text Text)

    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.

  • statusCode :: Maybe Text

    The method response's status code.

  • responseParameters :: Maybe (HashMap Text Bool)

    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.)

Instances

Instances details
Eq MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

Read MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

Show MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

Generic MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

Associated Types

type Rep MethodResponse :: Type -> Type #

NFData MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

Methods

rnf :: MethodResponse -> () #

Hashable MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

FromJSON MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

type Rep MethodResponse Source # 
Instance details

Defined in Amazonka.APIGateway.Types.MethodResponse

type Rep MethodResponse = D1 ('MetaData "MethodResponse" "Amazonka.APIGateway.Types.MethodResponse" "libZSservicesZSamazonka-apigatewayZSamazonka-apigateway" 'False) (C1 ('MetaCons "MethodResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "responseModels") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))) :*: (S1 ('MetaSel ('Just "statusCode") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "responseParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Bool))))))

newMethodResponse :: MethodResponse Source #

Create a value of MethodResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:responseModels:MethodResponse', methodResponse_responseModels - 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.

$sel:statusCode:MethodResponse', methodResponse_statusCode - The method response's status code.

$sel:responseParameters:MethodResponse', methodResponse_responseParameters - 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.)

Response Lenses

methodResponse_responseModels :: Lens' MethodResponse (Maybe (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.

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

The method response's status code.

methodResponse_responseParameters :: Lens' MethodResponse (Maybe (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.)