Skip to content

AwsApiGatewayMethodSettings

Source code in docs_src/capo_securityhub/types/aws_api_gateway_method_settings.py
class AwsApiGatewayMethodSettings(TypedDict, closed=True):
    metrics_enabled: NotRequired["capo_securityhub.types.boolean.Boolean"]
    """<p>Indicates whether CloudWatch metrics are enabled for the method. </p>"""
    logging_level: NotRequired["capo_securityhub.types.non_empty_string.NonEmptyString"]
    """<p>The logging level for this method. The logging level affects the log entries that are pushed to CloudWatch Logs.</p> <p>If the logging level is <code>ERROR</code>, then the logs only include error-level entries.</p> <p>If the logging level is <code>INFO</code>, then the logs include both <code>ERROR</code> events and extra informational events.</p> <p>Valid values: <code>OFF</code> | <code>ERROR</code> | <code>INFO</code> </p>"""
    data_trace_enabled: NotRequired["capo_securityhub.types.boolean.Boolean"]
    """<p>Indicates whether data trace logging is enabled for the method. Data trace logging affects the log entries that are pushed to CloudWatch Logs.</p>"""
    throttling_burst_limit: NotRequired["capo_securityhub.types.integer.Integer"]
    """<p>The throttling burst limit for the method.</p>"""
    throttling_rate_limit: NotRequired["capo_securityhub.types.double.Double"]
    """<p>The throttling rate limit for the method.</p>"""
    caching_enabled: NotRequired["capo_securityhub.types.boolean.Boolean"]
    """<p>Indicates whether responses are cached and returned for requests. For responses to be cached, a cache cluster must be enabled on the stage.</p>"""
    cache_ttl_in_seconds: NotRequired["capo_securityhub.types.integer.Integer"]
    """<p>Specifies the time to live (TTL), in seconds, for cached responses. The higher the TTL, the longer the response is cached.</p>"""
    cache_data_encrypted: NotRequired["capo_securityhub.types.boolean.Boolean"]
    """<p>Indicates whether the cached responses are encrypted. </p>"""
    require_authorization_for_cache_control: NotRequired[
        "capo_securityhub.types.boolean.Boolean"
    ]
    """<p>Indicates whether authorization is required for a cache invalidation request.</p>"""
    unauthorized_cache_control_header_strategy: NotRequired[
        "capo_securityhub.types.non_empty_string.NonEmptyString"
    ]
    """<p>Indicates how to handle unauthorized requests for cache invalidation.</p> <p>Valid values: <code>FAIL_WITH_403</code> | <code>SUCCEED_WITH_RESPONSE_HEADER</code> | <code>SUCCEED_WITHOUT_RESPONSE_HEADER</code> </p>"""
    http_method: NotRequired["capo_securityhub.types.non_empty_string.NonEmptyString"]
    """<p>The HTTP method. You can use an asterisk (*) as a wildcard to apply method settings to multiple methods.</p>"""
    resource_path: NotRequired["capo_securityhub.types.non_empty_string.NonEmptyString"]
    """<p>The resource path for this method. Forward slashes (/) are encoded as ~1 . The initial slash must include a forward slash.</p> <p>For example, the path value <code>/resource/subresource</code> must be encoded as <code>/~1resource~1subresource</code>.</p> <p>To specify the root path, use only a slash (/). You can use an asterisk (*) as a wildcard to apply method settings to multiple methods.</p>"""

cache_data_encrypted instance-attribute

cache_data_encrypted: NotRequired[Boolean]

Indicates whether the cached responses are encrypted.

cache_ttl_in_seconds instance-attribute

cache_ttl_in_seconds: NotRequired[Integer]

Specifies the time to live (TTL), in seconds, for cached responses. The higher the TTL, the longer the response is cached.

caching_enabled instance-attribute

caching_enabled: NotRequired[Boolean]

Indicates whether responses are cached and returned for requests. For responses to be cached, a cache cluster must be enabled on the stage.

data_trace_enabled instance-attribute

data_trace_enabled: NotRequired[Boolean]

Indicates whether data trace logging is enabled for the method. Data trace logging affects the log entries that are pushed to CloudWatch Logs.

http_method instance-attribute

http_method: NotRequired[NonEmptyString]

The HTTP method. You can use an asterisk (*) as a wildcard to apply method settings to multiple methods.

logging_level instance-attribute

logging_level: NotRequired[NonEmptyString]

The logging level for this method. The logging level affects the log entries that are pushed to CloudWatch Logs.

If the logging level is ERROR, then the logs only include error-level entries.

If the logging level is INFO, then the logs include both ERROR events and extra informational events.

Valid values: OFF | ERROR | INFO

metrics_enabled instance-attribute

metrics_enabled: NotRequired[Boolean]

Indicates whether CloudWatch metrics are enabled for the method.

require_authorization_for_cache_control instance-attribute

require_authorization_for_cache_control: NotRequired[Boolean]

Indicates whether authorization is required for a cache invalidation request.

resource_path instance-attribute

resource_path: NotRequired[NonEmptyString]

The resource path for this method. Forward slashes (/) are encoded as ~1 . The initial slash must include a forward slash.

For example, the path value /resource/subresource must be encoded as /~1resource~1subresource.

To specify the root path, use only a slash (/). You can use an asterisk (*) as a wildcard to apply method settings to multiple methods.

throttling_burst_limit instance-attribute

throttling_burst_limit: NotRequired[Integer]

The throttling burst limit for the method.

throttling_rate_limit instance-attribute

throttling_rate_limit: NotRequired[Double]

The throttling rate limit for the method.

unauthorized_cache_control_header_strategy instance-attribute

unauthorized_cache_control_header_strategy: NotRequired[NonEmptyString]

Indicates how to handle unauthorized requests for cache invalidation.

Valid values: FAIL_WITH_403 | SUCCEED_WITH_RESPONSE_HEADER | SUCCEED_WITHOUT_RESPONSE_HEADER