# ErrorResponse

Options for configuring custom error responses.

- Source: [`aws-cloudfront/lib/distribution.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-cloudfront/lib/distribution.ts#L1050)

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_cloudfront as cloudfront } from 'aws-cdk-lib';
const errorResponse: cloudfront.ErrorResponse = {
  httpStatus: 123,

  // the properties below are optional
  responseHttpStatus: 123,
  responsePagePath: 'responsePagePath',
  ttl: cdk.Duration.minutes(30),
};
```

## Properties

- `httpStatus`: number (required) — The HTTP status code for which you want to specify a custom error page and/or a caching duration.

- `responseHttpStatus`: number — The HTTP status code that you want CloudFront to return to the viewer along with the custom error page.

  **Default:** the error code will be returned as the response code.

  If you specify a value for `responseHttpStatus`, you must also specify a value for `responsePagePath`.

- `responsePagePath`: string — The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the `httpStatus`, for example, /4xx-errors/403-forbidden.html.

  **Default:** the default CloudFront response is shown.

- `ttl`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode.

  **Default:** the default caching TTL behavior applies