Skip to content

MethodSetting

Source code in docs_src/capo_api_gateway/types/method_setting.py
class MethodSetting(TypedDict, closed=True):
    metrics_enabled: "capo_api_gateway.types.boolean.Boolean"
    """<p>Specifies whether Amazon CloudWatch metrics are enabled for this method.</p>"""
    logging_level: NotRequired["capo_api_gateway.types.string.String"]
    """<p>Specifies the logging level for this method, which affects the log entries pushed to Amazon CloudWatch Logs. Valid values are <code>OFF</code>, <code>ERROR</code>, and <code>INFO</code>. Choose <code>ERROR</code> to write only error-level entries to CloudWatch Logs, or choose <code>INFO</code> to include all <code>ERROR</code> events as well as extra informational events.</p>"""
    data_trace_enabled: "capo_api_gateway.types.boolean.Boolean"
    """<p>Specifies whether data trace logging is enabled for this method, which affects the log entries pushed to Amazon CloudWatch Logs. This can be useful to troubleshoot APIs, but can result in logging sensitive data. We recommend that you don't enable this option for production APIs.</p>"""
    throttling_burst_limit: "capo_api_gateway.types.integer.Integer"
    """<p>Specifies the throttling burst limit.</p>"""
    throttling_rate_limit: "capo_api_gateway.types.double.Double"
    """<p>Specifies the throttling rate limit.</p>"""
    caching_enabled: "capo_api_gateway.types.boolean.Boolean"
    """<p>Specifies whether responses should be cached and returned for requests. A cache cluster must be enabled on the stage for responses to be cached.</p>"""
    cache_ttl_in_seconds: "capo_api_gateway.types.integer.Integer"
    """<p>Specifies the time to live (TTL), in seconds, for cached responses. The higher the TTL, the longer the response will be cached.</p>"""
    cache_data_encrypted: "capo_api_gateway.types.boolean.Boolean"
    """<p>Specifies whether the cached responses are encrypted.</p>"""
    require_authorization_for_cache_control: "capo_api_gateway.types.boolean.Boolean"
    """<p>Specifies whether authorization is required for a cache invalidation request.</p>"""
    unauthorized_cache_control_header_strategy: NotRequired[
        "capo_api_gateway.types.unauthorized_cache_control_header_strategy.UnauthorizedCacheControlHeaderStrategy"
    ]
    """<p>Specifies how to handle unauthorized requests for cache invalidation.</p>"""

cache_data_encrypted instance-attribute

cache_data_encrypted: Boolean

Specifies whether the cached responses are encrypted.

cache_ttl_in_seconds instance-attribute

cache_ttl_in_seconds: Integer

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

caching_enabled instance-attribute

caching_enabled: Boolean

Specifies whether responses should be cached and returned for requests. A cache cluster must be enabled on the stage for responses to be cached.

data_trace_enabled instance-attribute

data_trace_enabled: Boolean

Specifies whether data trace logging is enabled for this method, which affects the log entries pushed to Amazon CloudWatch Logs. This can be useful to troubleshoot APIs, but can result in logging sensitive data. We recommend that you don't enable this option for production APIs.

logging_level instance-attribute

logging_level: NotRequired[String]

Specifies the logging level for this method, which affects the log entries pushed to Amazon CloudWatch Logs. Valid values are OFF, ERROR, and INFO. Choose ERROR to write only error-level entries to CloudWatch Logs, or choose INFO to include all ERROR events as well as extra informational events.

metrics_enabled instance-attribute

metrics_enabled: Boolean

Specifies whether Amazon CloudWatch metrics are enabled for this method.

require_authorization_for_cache_control instance-attribute

require_authorization_for_cache_control: Boolean

Specifies whether authorization is required for a cache invalidation request.

throttling_burst_limit instance-attribute

throttling_burst_limit: Integer

Specifies the throttling burst limit.

throttling_rate_limit instance-attribute

throttling_rate_limit: Double

Specifies the throttling rate limit.

unauthorized_cache_control_header_strategy instance-attribute

unauthorized_cache_control_header_strategy: NotRequired[
    UnauthorizedCacheControlHeaderStrategy
]

Specifies how to handle unauthorized requests for cache invalidation.