Copyright | (c) 2013-2021 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Updates an existing MethodResponse resource.
Synopsis
- data UpdateMethodResponse = UpdateMethodResponse' {
- patchOperations :: Maybe [PatchOperation]
- restApiId :: Text
- resourceId :: Text
- httpMethod :: Text
- statusCode :: Text
- newUpdateMethodResponse :: Text -> Text -> Text -> Text -> UpdateMethodResponse
- updateMethodResponse_patchOperations :: Lens' UpdateMethodResponse (Maybe [PatchOperation])
- updateMethodResponse_restApiId :: Lens' UpdateMethodResponse Text
- updateMethodResponse_resourceId :: Lens' UpdateMethodResponse Text
- updateMethodResponse_httpMethod :: Lens' UpdateMethodResponse Text
- updateMethodResponse_statusCode :: Lens' UpdateMethodResponse Text
- data MethodResponse = MethodResponse' {
- responseModels :: Maybe (HashMap Text Text)
- statusCode :: Maybe Text
- responseParameters :: Maybe (HashMap Text Bool)
- newMethodResponse :: MethodResponse
- methodResponse_responseModels :: Lens' MethodResponse (Maybe (HashMap Text Text))
- methodResponse_statusCode :: Lens' MethodResponse (Maybe Text)
- methodResponse_responseParameters :: Lens' MethodResponse (Maybe (HashMap Text Bool))
Creating a Request
data UpdateMethodResponse Source #
A request to update an existing MethodResponse resource.
See: newUpdateMethodResponse
smart constructor.
UpdateMethodResponse' | |
|
Instances
newUpdateMethodResponse Source #
:: Text | |
-> Text | |
-> Text | |
-> Text | |
-> UpdateMethodResponse |
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.
MethodResponse' | |
|
Instances
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.)