aws-cdk-lib 2.189.1__py3-none-any.whl → 2.191.0__py3-none-any.whl

aws_cdk/aws_apigatewayv2/__init__.py

@@ -16,6 +16,7 @@ r'''
   * [VPC Link](#vpc-link)
   * [Private Integration](#private-integration)
   * [Generating ARN for Execute API](#generating-arn-for-execute-api)
+  * [Access Logging](#access-logging)
 * [WebSocket API](#websocket-api)
 
   * [Manage Connections Permission](#manage-connections-permission)
@@ -366,6 +367,66 @@ arn = api.arn_for_execute_api("GET", "/myApiPath", "dev")
 * The 'ANY' method can be used for matching any HTTP methods not explicitly defined.
 * The function gracefully handles undefined parameters by using wildcards, making it flexible for various API configurations.
 
+## Access Logging
+
+You can turn on logging to write logs to CloudWatch Logs.
+Read more at [Configure logging for HTTP APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging.html)
+
+```python
+import aws_cdk.aws_logs as logs
+
+# api: apigwv2.HttpApi
+# log_group: logs.LogGroup
+
+
+stage = apigwv2.HttpStage(self, "Stage",
+    http_api=api,
+    access_log_settings={
+        "destination": apigwv2.LogGroupLogDestination(log_group)
+    }
+)
+```
+
+The following code will generate the access log in the [CLF format](https://en.wikipedia.org/wiki/Common_Log_Format).
+
+```python
+import aws_cdk.aws_apigateway as apigw
+import aws_cdk.aws_logs as logs
+
+# api: apigwv2.HttpApi
+# log_group: logs.LogGroup
+
+
+stage = apigwv2.HttpStage(self, "Stage",
+    http_api=api,
+    access_log_settings={
+        "destination": apigwv2.LogGroupLogDestination(log_group),
+        "format": apigw.AccessLogFormat.clf()
+    }
+)
+```
+
+You can also configure your own access log format by using the `AccessLogFormat.custom()` API.
+`AccessLogField` provides commonly used fields. The following code configures access log to contain.
+
+```python
+import aws_cdk.aws_apigateway as apigw
+import aws_cdk.aws_logs as logs
+
+# api: apigwv2.HttpApi
+# log_group: logs.LogGroup
+
+
+stage = apigwv2.HttpStage(self, "Stage",
+    http_api=api,
+    access_log_settings={
+        "destination": apigwv2.LogGroupLogDestination(log_group),
+        "format": apigw.AccessLogFormat.custom(f"""{apigw.AccessLogField.contextRequestId()} {apigw.AccessLogField.contextErrorMessage()} {apigw.AccessLogField.contextErrorMessageString()}
+                  {apigw.AccessLogField.contextAuthorizerError()} {apigw.AccessLogField.contextAuthorizerIntegrationStatus()}""")
+    }
+)
+```
+
 ## WebSocket API
 
 A WebSocket API in API Gateway is a collection of WebSocket routes that are integrated with backend HTTP endpoints,
@@ -572,6 +633,7 @@ from .. import (
     TagManager as _TagManager_0a598cb3,
     TreeInspector as _TreeInspector_488e0dd5,
 )
+from ..aws_apigateway import AccessLogFormat as _AccessLogFormat_07733b91
 from ..aws_certificatemanager import ICertificate as _ICertificate_c194c70b
 from ..aws_cloudwatch import (
     Metric as _Metric_e396a4dc,
@@ -589,9 +651,59 @@ from ..aws_iam import (
     IGrantable as _IGrantable_71c4f5de,
     IRole as _IRole_235f5d8e,
 )
+from ..aws_logs import ILogGroup as _ILogGroup_3c4fa718
 from ..aws_s3 import IBucket as _IBucket_42e086fd
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.AccessLogDestinationConfig",
+    jsii_struct_bases=[],
+    name_mapping={"destination_arn": "destinationArn"},
+)
+class AccessLogDestinationConfig:
+    def __init__(self, *, destination_arn: builtins.str) -> None:
+        '''Options when binding a log destination to a HttpApi Stage.
+
+        :param destination_arn: The Amazon Resource Name (ARN) of the destination resource.
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_apigatewayv2 as apigatewayv2
+            
+            access_log_destination_config = apigatewayv2.AccessLogDestinationConfig(
+                destination_arn="destinationArn"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__8b68ef5fb39547463ffa4e3d85b867bf69e399a3812672f092c1af8a4605f33b)
+            check_type(argname="argument destination_arn", value=destination_arn, expected_type=type_hints["destination_arn"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "destination_arn": destination_arn,
+        }
+
+    @builtins.property
+    def destination_arn(self) -> builtins.str:
+        '''The Amazon Resource Name (ARN) of the destination resource.'''
+        result = self._values.get("destination_arn")
+        assert result is not None, "Required property 'destination_arn' is missing"
+        return typing.cast(builtins.str, result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "AccessLogDestinationConfig(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_apigatewayv2.ApiMappingAttributes",
     jsii_struct_bases=[],
@@ -10746,6 +10858,99 @@ class HttpRouteProps(BatchHttpRouteOptions):
         )
 
 
+@jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IAccessLogDestination")
+class IAccessLogDestination(typing_extensions.Protocol):
+    '''Access log destination for a HttpApi Stage.'''
+
+    @jsii.member(jsii_name="bind")
+    def bind(self, stage: "IStage") -> AccessLogDestinationConfig:
+        '''Binds this destination to the HttpApi Stage.
+
+        :param stage: -
+        '''
+        ...
+
+
+class _IAccessLogDestinationProxy:
+    '''Access log destination for a HttpApi Stage.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_apigatewayv2.IAccessLogDestination"
+
+    @jsii.member(jsii_name="bind")
+    def bind(self, stage: "IStage") -> AccessLogDestinationConfig:
+        '''Binds this destination to the HttpApi Stage.
+
+        :param stage: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__534fc78204353b3af484df3c3dbcbe29516f616aa5df0e356e600f12ba8ac536)
+            check_type(argname="argument stage", value=stage, expected_type=type_hints["stage"])
+        return typing.cast(AccessLogDestinationConfig, jsii.invoke(self, "bind", [stage]))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, IAccessLogDestination).__jsii_proxy_class__ = lambda : _IAccessLogDestinationProxy
+
+
+@jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IAccessLogSettings")
+class IAccessLogSettings(typing_extensions.Protocol):
+    '''Settings for access logging.'''
+
+    @builtins.property
+    @jsii.member(jsii_name="destination")
+    def destination(self) -> IAccessLogDestination:
+        '''The destination where to write access logs.
+
+        :default: - No destination
+        '''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="format")
+    def format(self) -> typing.Optional[_AccessLogFormat_07733b91]:
+        '''A single line format of access logs of data, as specified by selected $context variables.
+
+        The format must include either ``AccessLogFormat.contextRequestId()``
+        or ``AccessLogFormat.contextExtendedRequestId()``.
+
+        :default: - Common Log Format
+
+        :see: https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging-variables.html
+        '''
+        ...
+
+
+class _IAccessLogSettingsProxy:
+    '''Settings for access logging.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_apigatewayv2.IAccessLogSettings"
+
+    @builtins.property
+    @jsii.member(jsii_name="destination")
+    def destination(self) -> IAccessLogDestination:
+        '''The destination where to write access logs.
+
+        :default: - No destination
+        '''
+        return typing.cast(IAccessLogDestination, jsii.get(self, "destination"))
+
+    @builtins.property
+    @jsii.member(jsii_name="format")
+    def format(self) -> typing.Optional[_AccessLogFormat_07733b91]:
+        '''A single line format of access logs of data, as specified by selected $context variables.
+
+        The format must include either ``AccessLogFormat.contextRequestId()``
+        or ``AccessLogFormat.contextExtendedRequestId()``.
+
+        :default: - Common Log Format
+
+        :see: https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-logging-variables.html
+        '''
+        return typing.cast(typing.Optional[_AccessLogFormat_07733b91], jsii.get(self, "format"))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, IAccessLogSettings).__jsii_proxy_class__ = lambda : _IAccessLogSettingsProxy
+
+
 @jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IApi")
 class IApi(_IResource_c80c4260, typing_extensions.Protocol):
     '''Represents a API Gateway HTTP/WebSocket API.'''
@@ -12308,6 +12513,54 @@ class IpAddressType(enum.Enum):
     '''IPv4 and IPv6 address type.'''
 
 
+@jsii.implements(IAccessLogDestination)
+class LogGroupLogDestination(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.LogGroupLogDestination",
+):
+    '''Use CloudWatch Logs as a custom access log destination for API Gateway.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_apigateway as apigw
+        import aws_cdk.aws_logs as logs
+        
+        # api: apigwv2.HttpApi
+        # log_group: logs.LogGroup
+        
+        
+        stage = apigwv2.HttpStage(self, "Stage",
+            http_api=api,
+            access_log_settings={
+                "destination": apigwv2.LogGroupLogDestination(log_group),
+                "format": apigw.AccessLogFormat.clf()
+            }
+        )
+    '''
+
+    def __init__(self, log_group: _ILogGroup_3c4fa718) -> None:
+        '''
+        :param log_group: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__673df4a47de472e4a214f42838d3f75aa1fbd64c7cfebf6aabca85f720757892)
+            check_type(argname="argument log_group", value=log_group, expected_type=type_hints["log_group"])
+        jsii.create(self.__class__, self, [log_group])
+
+    @jsii.member(jsii_name="bind")
+    def bind(self, _stage: IStage) -> AccessLogDestinationConfig:
+        '''Binds this destination to the CloudWatch Logs.
+
+        :param _stage: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__24adabd8038382382256c380e34d36079494808b554f1161a31a58eb7a2d3f08)
+            check_type(argname="argument _stage", value=_stage, expected_type=type_hints["_stage"])
+        return typing.cast(AccessLogDestinationConfig, jsii.invoke(self, "bind", [_stage]))
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_apigatewayv2.MTLSConfig",
     jsii_struct_bases=[],
@@ -12832,6 +13085,7 @@ class StageAttributes:
     jsii_type="aws-cdk-lib.aws_apigatewayv2.StageOptions",
     jsii_struct_bases=[],
     name_mapping={
+        "access_log_settings": "accessLogSettings",
         "auto_deploy": "autoDeploy",
         "description": "description",
         "detailed_metrics_enabled": "detailedMetricsEnabled",
@@ -12843,6 +13097,7 @@ class StageOptions:
     def __init__(
         self,
         *,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -12853,6 +13108,7 @@ class StageOptions:
 
         Options that are common between HTTP and Websocket APIs.
 
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -12867,9 +13123,11 @@ class StageOptions:
             # The values are placeholders you should change.
             from aws_cdk import aws_apigatewayv2 as apigatewayv2
             
+            # access_log_settings: apigatewayv2.IAccessLogSettings
             # domain_name: apigatewayv2.DomainName
             
             stage_options = apigatewayv2.StageOptions(
+                access_log_settings=access_log_settings,
                 auto_deploy=False,
                 description="description",
                 detailed_metrics_enabled=False,
@@ -12891,12 +13149,15 @@ class StageOptions:
             throttle = ThrottleSettings(**throttle)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7d1ab9a2efdde27ab3aff279b986e4a558573396d5100c22c5a48bcbee4f320a)
+            check_type(argname="argument access_log_settings", value=access_log_settings, expected_type=type_hints["access_log_settings"])
             check_type(argname="argument auto_deploy", value=auto_deploy, expected_type=type_hints["auto_deploy"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument detailed_metrics_enabled", value=detailed_metrics_enabled, expected_type=type_hints["detailed_metrics_enabled"])
             check_type(argname="argument domain_mapping", value=domain_mapping, expected_type=type_hints["domain_mapping"])
             check_type(argname="argument throttle", value=throttle, expected_type=type_hints["throttle"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if access_log_settings is not None:
+            self._values["access_log_settings"] = access_log_settings
         if auto_deploy is not None:
             self._values["auto_deploy"] = auto_deploy
         if description is not None:
@@ -12908,6 +13169,15 @@ class StageOptions:
         if throttle is not None:
             self._values["throttle"] = throttle
 
+    @builtins.property
+    def access_log_settings(self) -> typing.Optional[IAccessLogSettings]:
+        '''Settings for access logging.
+
+        :default: - No access logging
+        '''
+        result = self._values.get("access_log_settings")
+        return typing.cast(typing.Optional[IAccessLogSettings], result)
+
     @builtins.property
     def auto_deploy(self) -> typing.Optional[builtins.bool]:
         '''Whether updates to an API automatically trigger a new deployment.
@@ -15446,6 +15716,7 @@ class WebSocketStage(
         *,
         stage_name: builtins.str,
         web_socket_api: IWebSocketApi,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -15457,6 +15728,7 @@ class WebSocketStage(
         :param id: -
         :param stage_name: The name of the stage.
         :param web_socket_api: The WebSocket API to which this stage is associated.
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -15470,6 +15742,7 @@ class WebSocketStage(
         props = WebSocketStageProps(
             stage_name=stage_name,
             web_socket_api=web_socket_api,
+            access_log_settings=access_log_settings,
             auto_deploy=auto_deploy,
             description=description,
             detailed_metrics_enabled=detailed_metrics_enabled,
@@ -15665,6 +15938,7 @@ class WebSocketStageAttributes(StageAttributes):
     jsii_type="aws-cdk-lib.aws_apigatewayv2.WebSocketStageProps",
     jsii_struct_bases=[StageOptions],
     name_mapping={
+        "access_log_settings": "accessLogSettings",
         "auto_deploy": "autoDeploy",
         "description": "description",
         "detailed_metrics_enabled": "detailedMetricsEnabled",
@@ -15678,6 +15952,7 @@ class WebSocketStageProps(StageOptions):
     def __init__(
         self,
         *,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -15688,6 +15963,7 @@ class WebSocketStageProps(StageOptions):
     ) -> None:
         '''Properties to initialize an instance of ``WebSocketStage``.
 
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -15721,6 +15997,7 @@ class WebSocketStageProps(StageOptions):
             throttle = ThrottleSettings(**throttle)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__42c328a8780899b5d1949986febb2d9e9b3f4f2f6b8e4f03561cb02e5b407e77)
+            check_type(argname="argument access_log_settings", value=access_log_settings, expected_type=type_hints["access_log_settings"])
             check_type(argname="argument auto_deploy", value=auto_deploy, expected_type=type_hints["auto_deploy"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument detailed_metrics_enabled", value=detailed_metrics_enabled, expected_type=type_hints["detailed_metrics_enabled"])
@@ -15732,6 +16009,8 @@ class WebSocketStageProps(StageOptions):
             "stage_name": stage_name,
             "web_socket_api": web_socket_api,
         }
+        if access_log_settings is not None:
+            self._values["access_log_settings"] = access_log_settings
         if auto_deploy is not None:
             self._values["auto_deploy"] = auto_deploy
         if description is not None:
@@ -15743,6 +16022,15 @@ class WebSocketStageProps(StageOptions):
         if throttle is not None:
             self._values["throttle"] = throttle
 
+    @builtins.property
+    def access_log_settings(self) -> typing.Optional[IAccessLogSettings]:
+        '''Settings for access logging.
+
+        :default: - No access logging
+        '''
+        result = self._values.get("access_log_settings")
+        return typing.cast(typing.Optional[IAccessLogSettings], result)
+
     @builtins.property
     def auto_deploy(self) -> typing.Optional[builtins.bool]:
         '''Whether updates to an API automatically trigger a new deployment.
@@ -16508,6 +16796,7 @@ class HttpApi(
         id: builtins.str,
         *,
         stage_name: typing.Optional[builtins.str] = None,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -16518,6 +16807,7 @@ class HttpApi(
 
         :param id: -
         :param stage_name: The name of the stage. See ``StageName`` class for more details. Default: '$default' the default stage of the API. This stage will have the URL at the root of the API endpoint.
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -16529,6 +16819,7 @@ class HttpApi(
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         options = HttpStageOptions(
             stage_name=stage_name,
+            access_log_settings=access_log_settings,
             auto_deploy=auto_deploy,
             description=description,
             detailed_metrics_enabled=detailed_metrics_enabled,
@@ -17225,6 +17516,7 @@ class HttpStageAttributes(StageAttributes):
     jsii_type="aws-cdk-lib.aws_apigatewayv2.HttpStageOptions",
     jsii_struct_bases=[StageOptions],
     name_mapping={
+        "access_log_settings": "accessLogSettings",
         "auto_deploy": "autoDeploy",
         "description": "description",
         "detailed_metrics_enabled": "detailedMetricsEnabled",
@@ -17237,6 +17529,7 @@ class HttpStageOptions(StageOptions):
     def __init__(
         self,
         *,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -17246,6 +17539,7 @@ class HttpStageOptions(StageOptions):
     ) -> None:
         '''The options to create a new Stage for an HTTP API.
 
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -17277,6 +17571,7 @@ class HttpStageOptions(StageOptions):
             throttle = ThrottleSettings(**throttle)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__70c0bb0779b1636661ab1c2d695953c6dda7a5247d18a4bd7e045cc96d717a8a)
+            check_type(argname="argument access_log_settings", value=access_log_settings, expected_type=type_hints["access_log_settings"])
             check_type(argname="argument auto_deploy", value=auto_deploy, expected_type=type_hints["auto_deploy"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument detailed_metrics_enabled", value=detailed_metrics_enabled, expected_type=type_hints["detailed_metrics_enabled"])
@@ -17284,6 +17579,8 @@ class HttpStageOptions(StageOptions):
             check_type(argname="argument throttle", value=throttle, expected_type=type_hints["throttle"])
             check_type(argname="argument stage_name", value=stage_name, expected_type=type_hints["stage_name"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if access_log_settings is not None:
+            self._values["access_log_settings"] = access_log_settings
         if auto_deploy is not None:
             self._values["auto_deploy"] = auto_deploy
         if description is not None:
@@ -17297,6 +17594,15 @@ class HttpStageOptions(StageOptions):
         if stage_name is not None:
             self._values["stage_name"] = stage_name
 
+    @builtins.property
+    def access_log_settings(self) -> typing.Optional[IAccessLogSettings]:
+        '''Settings for access logging.
+
+        :default: - No access logging
+        '''
+        result = self._values.get("access_log_settings")
+        return typing.cast(typing.Optional[IAccessLogSettings], result)
+
     @builtins.property
     def auto_deploy(self) -> typing.Optional[builtins.bool]:
         '''Whether updates to an API automatically trigger a new deployment.
@@ -17369,6 +17675,7 @@ class HttpStageOptions(StageOptions):
     jsii_type="aws-cdk-lib.aws_apigatewayv2.HttpStageProps",
     jsii_struct_bases=[HttpStageOptions],
     name_mapping={
+        "access_log_settings": "accessLogSettings",
         "auto_deploy": "autoDeploy",
         "description": "description",
         "detailed_metrics_enabled": "detailedMetricsEnabled",
@@ -17382,6 +17689,7 @@ class HttpStageProps(HttpStageOptions):
     def __init__(
         self,
         *,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -17392,6 +17700,7 @@ class HttpStageProps(HttpStageOptions):
     ) -> None:
         '''Properties to initialize an instance of ``HttpStage``.
 
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -17404,13 +17713,17 @@ class HttpStageProps(HttpStageOptions):
 
         Example::
 
+            import aws_cdk.aws_logs as logs
+            
             # api: apigwv2.HttpApi
+            # log_group: logs.LogGroup
             
             
-            apigwv2.HttpStage(self, "Stage",
+            stage = apigwv2.HttpStage(self, "Stage",
                 http_api=api,
-                stage_name="beta",
-                description="My Stage"
+                access_log_settings={
+                    "destination": apigwv2.LogGroupLogDestination(log_group)
+                }
             )
         '''
         if isinstance(domain_mapping, dict):
@@ -17419,6 +17732,7 @@ class HttpStageProps(HttpStageOptions):
             throttle = ThrottleSettings(**throttle)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__77d8b0adbb783021a6c7e33999d2a3a80e2414824d202954599bb4ad7f291721)
+            check_type(argname="argument access_log_settings", value=access_log_settings, expected_type=type_hints["access_log_settings"])
             check_type(argname="argument auto_deploy", value=auto_deploy, expected_type=type_hints["auto_deploy"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument detailed_metrics_enabled", value=detailed_metrics_enabled, expected_type=type_hints["detailed_metrics_enabled"])
@@ -17429,6 +17743,8 @@ class HttpStageProps(HttpStageOptions):
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "http_api": http_api,
         }
+        if access_log_settings is not None:
+            self._values["access_log_settings"] = access_log_settings
         if auto_deploy is not None:
             self._values["auto_deploy"] = auto_deploy
         if description is not None:
@@ -17442,6 +17758,15 @@ class HttpStageProps(HttpStageOptions):
         if stage_name is not None:
             self._values["stage_name"] = stage_name
 
+    @builtins.property
+    def access_log_settings(self) -> typing.Optional[IAccessLogSettings]:
+        '''Settings for access logging.
+
+        :default: - No access logging
+        '''
+        result = self._values.get("access_log_settings")
+        return typing.cast(typing.Optional[IAccessLogSettings], result)
+
     @builtins.property
     def auto_deploy(self) -> typing.Optional[builtins.bool]:
         '''Whether updates to an API automatically trigger a new deployment.
@@ -18384,13 +18709,17 @@ class HttpStage(
 
     Example::
 
+        import aws_cdk.aws_logs as logs
+        
         # api: apigwv2.HttpApi
+        # log_group: logs.LogGroup
         
         
-        apigwv2.HttpStage(self, "Stage",
+        stage = apigwv2.HttpStage(self, "Stage",
             http_api=api,
-            stage_name="beta",
-            description="My Stage"
+            access_log_settings={
+                "destination": apigwv2.LogGroupLogDestination(log_group)
+            }
         )
     '''
 
@@ -18401,6 +18730,7 @@ class HttpStage(
         *,
         http_api: IHttpApi,
         stage_name: typing.Optional[builtins.str] = None,
+        access_log_settings: typing.Optional[IAccessLogSettings] = None,
         auto_deploy: typing.Optional[builtins.bool] = None,
         description: typing.Optional[builtins.str] = None,
         detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -18412,6 +18742,7 @@ class HttpStage(
         :param id: -
         :param http_api: The HTTP API to which this stage is associated.
         :param stage_name: The name of the stage. See ``StageName`` class for more details. Default: '$default' the default stage of the API. This stage will have the URL at the root of the API endpoint.
+        :param access_log_settings: Settings for access logging. Default: - No access logging
         :param auto_deploy: Whether updates to an API automatically trigger a new deployment. Default: false
         :param description: The description for the API stage. Default: - no description
         :param detailed_metrics_enabled: Specifies whether detailed metrics are enabled. Default: false
@@ -18425,6 +18756,7 @@ class HttpStage(
         props = HttpStageProps(
             http_api=http_api,
             stage_name=stage_name,
+            access_log_settings=access_log_settings,
             auto_deploy=auto_deploy,
             description=description,
             detailed_metrics_enabled=detailed_metrics_enabled,
@@ -18801,6 +19133,7 @@ class HttpStage(
 
 
 __all__ = [
+    "AccessLogDestinationConfig",
     "AddRoutesOptions",
     "ApiMapping",
     "ApiMappingAttributes",
@@ -18869,6 +19202,8 @@ __all__ = [
     "HttpStageAttributes",
     "HttpStageOptions",
     "HttpStageProps",
+    "IAccessLogDestination",
+    "IAccessLogSettings",
     "IApi",
     "IApiMapping",
     "IAuthorizer",
@@ -18892,6 +19227,7 @@ __all__ = [
     "IWebSocketStage",
     "IntegrationCredentials",
     "IpAddressType",
+    "LogGroupLogDestination",
     "MTLSConfig",
     "MappingValue",
     "ParameterMapping",
@@ -18931,6 +19267,13 @@ __all__ = [
 
 publication.publish()
 
+def _typecheckingstub__8b68ef5fb39547463ffa4e3d85b867bf69e399a3812672f092c1af8a4605f33b(
+    *,
+    destination_arn: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__87e51f8314eb457688965754ef962ccc6b34cd3477e30e0b5c48927231e6e450(
     *,
     api_mapping_id: builtins.str,
@@ -20501,6 +20844,12 @@ def _typecheckingstub__01a95593431af244579bfa1874fdfecb297826dc468c06ee6143c4435
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__534fc78204353b3af484df3c3dbcbe29516f616aa5df0e356e600f12ba8ac536(
+    stage: IStage,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__c88a55b08f170ef03ef7ee65891d47150923f5d517c30630b947b1c7469a5c45(
     metric_name: builtins.str,
     *,
@@ -20549,6 +20898,18 @@ def _typecheckingstub__331fd0db1f61e3b086b38ed9cad76e580f9f7392bb87bb910e5961df8
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__673df4a47de472e4a214f42838d3f75aa1fbd64c7cfebf6aabca85f720757892(
+    log_group: _ILogGroup_3c4fa718,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__24adabd8038382382256c380e34d36079494808b554f1161a31a58eb7a2d3f08(
+    _stage: IStage,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__acdcc456821493a765c0b63f8b403ae0d0c70126d944e7fb885479d1fa8ebbc1(
     *,
     bucket: _IBucket_42e086fd,
@@ -20680,6 +21041,7 @@ def _typecheckingstub__6e40657661365d1f987be571ab8023633c7e4116f50e9a7122d3a476e
 
 def _typecheckingstub__7d1ab9a2efdde27ab3aff279b986e4a558573396d5100c22c5a48bcbee4f320a(
     *,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -21016,6 +21378,7 @@ def _typecheckingstub__64b576b4eaac9e08a38566f9968efb8de351df1daf6fe46d0fe7787da
     *,
     stage_name: builtins.str,
     web_socket_api: IWebSocketApi,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -21068,6 +21431,7 @@ def _typecheckingstub__66ef15ad422b243bd7d761fe83ba5889c94c75b085fc8898f13f5fdbd
 
 def _typecheckingstub__42c328a8780899b5d1949986febb2d9e9b3f4f2f6b8e4f03561cb02e5b407e77(
     *,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -21183,6 +21547,7 @@ def _typecheckingstub__f8917ad3a680cbc2c8ade65728d8549bf69f03ea4c9d0752e5dae7263
     id: builtins.str,
     *,
     stage_name: typing.Optional[builtins.str] = None,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -21255,6 +21620,7 @@ def _typecheckingstub__14605c3383d1d699194e37511d84f3f4da8c64b724b0eacc42f7bff95
 
 def _typecheckingstub__70c0bb0779b1636661ab1c2d695953c6dda7a5247d18a4bd7e045cc96d717a8a(
     *,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -21267,6 +21633,7 @@ def _typecheckingstub__70c0bb0779b1636661ab1c2d695953c6dda7a5247d18a4bd7e045cc96
 
 def _typecheckingstub__77d8b0adbb783021a6c7e33999d2a3a80e2414824d202954599bb4ad7f291721(
     *,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,
@@ -21333,6 +21700,7 @@ def _typecheckingstub__4573d7530f36463b1b12875197f2c49f968925d114c4ed7ac6b9ab04e
     *,
     http_api: IHttpApi,
     stage_name: typing.Optional[builtins.str] = None,
+    access_log_settings: typing.Optional[IAccessLogSettings] = None,
     auto_deploy: typing.Optional[builtins.bool] = None,
     description: typing.Optional[builtins.str] = None,
     detailed_metrics_enabled: typing.Optional[builtins.bool] = None,