1. Packages
  2. Konnect Provider
  3. API Docs
  4. getGatewayPluginServiceProtection
konnect 2.5.0 published on Tuesday, Apr 15, 2025 by kong

konnect.getGatewayPluginServiceProtection

Explore with Pulumi AI

Using getGatewayPluginServiceProtection

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getGatewayPluginServiceProtection(args: GetGatewayPluginServiceProtectionArgs, opts?: InvokeOptions): Promise<GetGatewayPluginServiceProtectionResult>
function getGatewayPluginServiceProtectionOutput(args: GetGatewayPluginServiceProtectionOutputArgs, opts?: InvokeOptions): Output<GetGatewayPluginServiceProtectionResult>
Copy
def get_gateway_plugin_service_protection(control_plane_id: Optional[str] = None,
                                          opts: Optional[InvokeOptions] = None) -> GetGatewayPluginServiceProtectionResult
def get_gateway_plugin_service_protection_output(control_plane_id: Optional[pulumi.Input[str]] = None,
                                          opts: Optional[InvokeOptions] = None) -> Output[GetGatewayPluginServiceProtectionResult]
Copy
func LookupGatewayPluginServiceProtection(ctx *Context, args *LookupGatewayPluginServiceProtectionArgs, opts ...InvokeOption) (*LookupGatewayPluginServiceProtectionResult, error)
func LookupGatewayPluginServiceProtectionOutput(ctx *Context, args *LookupGatewayPluginServiceProtectionOutputArgs, opts ...InvokeOption) LookupGatewayPluginServiceProtectionResultOutput
Copy

> Note: This function is named LookupGatewayPluginServiceProtection in the Go SDK.

public static class GetGatewayPluginServiceProtection 
{
    public static Task<GetGatewayPluginServiceProtectionResult> InvokeAsync(GetGatewayPluginServiceProtectionArgs args, InvokeOptions? opts = null)
    public static Output<GetGatewayPluginServiceProtectionResult> Invoke(GetGatewayPluginServiceProtectionInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetGatewayPluginServiceProtectionResult> getGatewayPluginServiceProtection(GetGatewayPluginServiceProtectionArgs args, InvokeOptions options)
public static Output<GetGatewayPluginServiceProtectionResult> getGatewayPluginServiceProtection(GetGatewayPluginServiceProtectionArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: konnect:index/getGatewayPluginServiceProtection:getGatewayPluginServiceProtection
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

ControlPlaneId This property is required. string
ControlPlaneId This property is required. string
controlPlaneId This property is required. String
controlPlaneId This property is required. string
control_plane_id This property is required. str
controlPlaneId This property is required. String

getGatewayPluginServiceProtection Result

The following output properties are available:

Supporting Types

GetGatewayPluginServiceProtectionConfig

DictionaryName This property is required. string
The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is config.strategy is cluster or redis and config.sync_rate isn't -1), this dictionary serves as a buffer to populate counters in the data store on each synchronization cycle.
DisablePenalty This property is required. bool
If set to true, this doesn't count denied requests (status = 429). If set to false, all requests, including denied ones, are counted. This parameter only affects the sliding window_type.
ErrorCode This property is required. double
Set a custom error code to return when the rate limit is exceeded.
ErrorMessage This property is required. string
Set a custom error message to return when the rate limit is exceeded.
HideClientHeaders This property is required. bool
Optionally hide informative response headers that would otherwise provide information about the current status of limits and counters.
Limits This property is required. List<double>
One or more requests-per-window limits to apply. There must be a matching number of window limits and sizes specified.
LockDictionaryName This property is required. string
The shared dictionary where concurrency control locks are stored. The default shared dictionary is kong_locks. The shared dictionary should be declared in nginx-kong.conf.
Namespace This property is required. string
The rate limiting library namespace to use for this plugin instance. Counter data and sync configuration is isolated in each namespace. NOTE: For the plugin instances sharing the same namespace, all the configurations that are required for synchronizing counters, e.g. strategy, redis, sync_rate, dictionary_name, need to be the same.
Redis This property is required. GetGatewayPluginServiceProtectionConfigRedis
RetryAfterJitterMax This property is required. double
The upper bound of a jitter (random delay) in seconds to be added to the Retry-After header of denied requests (status = 429) in order to prevent all the clients from coming back at the same time. The lower bound of the jitter is 0; in this case, the Retry-After header is equal to the RateLimit-Reset header.
Strategy This property is required. string
The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are: local and cluster.
SyncRate This property is required. double
How often to sync counter data to the central data store. A value of 0 results in synchronous behavior; a value of -1 ignores sync behavior entirely and only stores counters in node memory. A value greater than 0 will sync the counters in the specified number of seconds. The minimum allowed interval is 0.02 seconds (20ms).
WindowSizes This property is required. List<double>
One or more window sizes to apply a limit to (defined in seconds). There must be a matching number of window limits and sizes specified.
WindowType This property is required. string
Sets the time window type to either sliding (default) or fixed. Sliding windows apply the rate limiting logic while taking into account previous hit rates (from the window that immediately precedes the current) using a dynamic weight. Fixed windows consist of buckets that are statically assigned to a definitive time range, each request is mapped to only one fixed window based on its timestamp and will affect only that window's counters.
DictionaryName This property is required. string
The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is config.strategy is cluster or redis and config.sync_rate isn't -1), this dictionary serves as a buffer to populate counters in the data store on each synchronization cycle.
DisablePenalty This property is required. bool
If set to true, this doesn't count denied requests (status = 429). If set to false, all requests, including denied ones, are counted. This parameter only affects the sliding window_type.
ErrorCode This property is required. float64
Set a custom error code to return when the rate limit is exceeded.
ErrorMessage This property is required. string
Set a custom error message to return when the rate limit is exceeded.
HideClientHeaders This property is required. bool
Optionally hide informative response headers that would otherwise provide information about the current status of limits and counters.
Limits This property is required. []float64
One or more requests-per-window limits to apply. There must be a matching number of window limits and sizes specified.
LockDictionaryName This property is required. string
The shared dictionary where concurrency control locks are stored. The default shared dictionary is kong_locks. The shared dictionary should be declared in nginx-kong.conf.
Namespace This property is required. string
The rate limiting library namespace to use for this plugin instance. Counter data and sync configuration is isolated in each namespace. NOTE: For the plugin instances sharing the same namespace, all the configurations that are required for synchronizing counters, e.g. strategy, redis, sync_rate, dictionary_name, need to be the same.
Redis This property is required. GetGatewayPluginServiceProtectionConfigRedis
RetryAfterJitterMax This property is required. float64
The upper bound of a jitter (random delay) in seconds to be added to the Retry-After header of denied requests (status = 429) in order to prevent all the clients from coming back at the same time. The lower bound of the jitter is 0; in this case, the Retry-After header is equal to the RateLimit-Reset header.
Strategy This property is required. string
The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are: local and cluster.
SyncRate This property is required. float64
How often to sync counter data to the central data store. A value of 0 results in synchronous behavior; a value of -1 ignores sync behavior entirely and only stores counters in node memory. A value greater than 0 will sync the counters in the specified number of seconds. The minimum allowed interval is 0.02 seconds (20ms).
WindowSizes This property is required. []float64
One or more window sizes to apply a limit to (defined in seconds). There must be a matching number of window limits and sizes specified.
WindowType This property is required. string
Sets the time window type to either sliding (default) or fixed. Sliding windows apply the rate limiting logic while taking into account previous hit rates (from the window that immediately precedes the current) using a dynamic weight. Fixed windows consist of buckets that are statically assigned to a definitive time range, each request is mapped to only one fixed window based on its timestamp and will affect only that window's counters.
dictionaryName This property is required. String
The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is config.strategy is cluster or redis and config.sync_rate isn't -1), this dictionary serves as a buffer to populate counters in the data store on each synchronization cycle.
disablePenalty This property is required. Boolean
If set to true, this doesn't count denied requests (status = 429). If set to false, all requests, including denied ones, are counted. This parameter only affects the sliding window_type.
errorCode This property is required. Double
Set a custom error code to return when the rate limit is exceeded.
errorMessage This property is required. String
Set a custom error message to return when the rate limit is exceeded.
hideClientHeaders This property is required. Boolean
Optionally hide informative response headers that would otherwise provide information about the current status of limits and counters.
limits This property is required. List<Double>
One or more requests-per-window limits to apply. There must be a matching number of window limits and sizes specified.
lockDictionaryName This property is required. String
The shared dictionary where concurrency control locks are stored. The default shared dictionary is kong_locks. The shared dictionary should be declared in nginx-kong.conf.
namespace This property is required. String
The rate limiting library namespace to use for this plugin instance. Counter data and sync configuration is isolated in each namespace. NOTE: For the plugin instances sharing the same namespace, all the configurations that are required for synchronizing counters, e.g. strategy, redis, sync_rate, dictionary_name, need to be the same.
redis This property is required. GetGatewayPluginServiceProtectionConfigRedis
retryAfterJitterMax This property is required. Double
The upper bound of a jitter (random delay) in seconds to be added to the Retry-After header of denied requests (status = 429) in order to prevent all the clients from coming back at the same time. The lower bound of the jitter is 0; in this case, the Retry-After header is equal to the RateLimit-Reset header.
strategy This property is required. String
The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are: local and cluster.
syncRate This property is required. Double
How often to sync counter data to the central data store. A value of 0 results in synchronous behavior; a value of -1 ignores sync behavior entirely and only stores counters in node memory. A value greater than 0 will sync the counters in the specified number of seconds. The minimum allowed interval is 0.02 seconds (20ms).
windowSizes This property is required. List<Double>
One or more window sizes to apply a limit to (defined in seconds). There must be a matching number of window limits and sizes specified.
windowType This property is required. String
Sets the time window type to either sliding (default) or fixed. Sliding windows apply the rate limiting logic while taking into account previous hit rates (from the window that immediately precedes the current) using a dynamic weight. Fixed windows consist of buckets that are statically assigned to a definitive time range, each request is mapped to only one fixed window based on its timestamp and will affect only that window's counters.
dictionaryName This property is required. string
The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is config.strategy is cluster or redis and config.sync_rate isn't -1), this dictionary serves as a buffer to populate counters in the data store on each synchronization cycle.
disablePenalty This property is required. boolean
If set to true, this doesn't count denied requests (status = 429). If set to false, all requests, including denied ones, are counted. This parameter only affects the sliding window_type.
errorCode This property is required. number
Set a custom error code to return when the rate limit is exceeded.
errorMessage This property is required. string
Set a custom error message to return when the rate limit is exceeded.
hideClientHeaders This property is required. boolean
Optionally hide informative response headers that would otherwise provide information about the current status of limits and counters.
limits This property is required. number[]
One or more requests-per-window limits to apply. There must be a matching number of window limits and sizes specified.
lockDictionaryName This property is required. string
The shared dictionary where concurrency control locks are stored. The default shared dictionary is kong_locks. The shared dictionary should be declared in nginx-kong.conf.
namespace This property is required. string
The rate limiting library namespace to use for this plugin instance. Counter data and sync configuration is isolated in each namespace. NOTE: For the plugin instances sharing the same namespace, all the configurations that are required for synchronizing counters, e.g. strategy, redis, sync_rate, dictionary_name, need to be the same.
redis This property is required. GetGatewayPluginServiceProtectionConfigRedis
retryAfterJitterMax This property is required. number
The upper bound of a jitter (random delay) in seconds to be added to the Retry-After header of denied requests (status = 429) in order to prevent all the clients from coming back at the same time. The lower bound of the jitter is 0; in this case, the Retry-After header is equal to the RateLimit-Reset header.
strategy This property is required. string
The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are: local and cluster.
syncRate This property is required. number
How often to sync counter data to the central data store. A value of 0 results in synchronous behavior; a value of -1 ignores sync behavior entirely and only stores counters in node memory. A value greater than 0 will sync the counters in the specified number of seconds. The minimum allowed interval is 0.02 seconds (20ms).
windowSizes This property is required. number[]
One or more window sizes to apply a limit to (defined in seconds). There must be a matching number of window limits and sizes specified.
windowType This property is required. string
Sets the time window type to either sliding (default) or fixed. Sliding windows apply the rate limiting logic while taking into account previous hit rates (from the window that immediately precedes the current) using a dynamic weight. Fixed windows consist of buckets that are statically assigned to a definitive time range, each request is mapped to only one fixed window based on its timestamp and will affect only that window's counters.
dictionary_name This property is required. str
The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is config.strategy is cluster or redis and config.sync_rate isn't -1), this dictionary serves as a buffer to populate counters in the data store on each synchronization cycle.
disable_penalty This property is required. bool
If set to true, this doesn't count denied requests (status = 429). If set to false, all requests, including denied ones, are counted. This parameter only affects the sliding window_type.
error_code This property is required. float
Set a custom error code to return when the rate limit is exceeded.
error_message This property is required. str
Set a custom error message to return when the rate limit is exceeded.
hide_client_headers This property is required. bool
Optionally hide informative response headers that would otherwise provide information about the current status of limits and counters.
limits This property is required. Sequence[float]
One or more requests-per-window limits to apply. There must be a matching number of window limits and sizes specified.
lock_dictionary_name This property is required. str
The shared dictionary where concurrency control locks are stored. The default shared dictionary is kong_locks. The shared dictionary should be declared in nginx-kong.conf.
namespace This property is required. str
The rate limiting library namespace to use for this plugin instance. Counter data and sync configuration is isolated in each namespace. NOTE: For the plugin instances sharing the same namespace, all the configurations that are required for synchronizing counters, e.g. strategy, redis, sync_rate, dictionary_name, need to be the same.
redis This property is required. GetGatewayPluginServiceProtectionConfigRedis
retry_after_jitter_max This property is required. float
The upper bound of a jitter (random delay) in seconds to be added to the Retry-After header of denied requests (status = 429) in order to prevent all the clients from coming back at the same time. The lower bound of the jitter is 0; in this case, the Retry-After header is equal to the RateLimit-Reset header.
strategy This property is required. str
The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are: local and cluster.
sync_rate This property is required. float
How often to sync counter data to the central data store. A value of 0 results in synchronous behavior; a value of -1 ignores sync behavior entirely and only stores counters in node memory. A value greater than 0 will sync the counters in the specified number of seconds. The minimum allowed interval is 0.02 seconds (20ms).
window_sizes This property is required. Sequence[float]
One or more window sizes to apply a limit to (defined in seconds). There must be a matching number of window limits and sizes specified.
window_type This property is required. str
Sets the time window type to either sliding (default) or fixed. Sliding windows apply the rate limiting logic while taking into account previous hit rates (from the window that immediately precedes the current) using a dynamic weight. Fixed windows consist of buckets that are statically assigned to a definitive time range, each request is mapped to only one fixed window based on its timestamp and will affect only that window's counters.
dictionaryName This property is required. String
The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is config.strategy is cluster or redis and config.sync_rate isn't -1), this dictionary serves as a buffer to populate counters in the data store on each synchronization cycle.
disablePenalty This property is required. Boolean
If set to true, this doesn't count denied requests (status = 429). If set to false, all requests, including denied ones, are counted. This parameter only affects the sliding window_type.
errorCode This property is required. Number
Set a custom error code to return when the rate limit is exceeded.
errorMessage This property is required. String
Set a custom error message to return when the rate limit is exceeded.
hideClientHeaders This property is required. Boolean
Optionally hide informative response headers that would otherwise provide information about the current status of limits and counters.
limits This property is required. List<Number>
One or more requests-per-window limits to apply. There must be a matching number of window limits and sizes specified.
lockDictionaryName This property is required. String
The shared dictionary where concurrency control locks are stored. The default shared dictionary is kong_locks. The shared dictionary should be declared in nginx-kong.conf.
namespace This property is required. String
The rate limiting library namespace to use for this plugin instance. Counter data and sync configuration is isolated in each namespace. NOTE: For the plugin instances sharing the same namespace, all the configurations that are required for synchronizing counters, e.g. strategy, redis, sync_rate, dictionary_name, need to be the same.
redis This property is required. Property Map
retryAfterJitterMax This property is required. Number
The upper bound of a jitter (random delay) in seconds to be added to the Retry-After header of denied requests (status = 429) in order to prevent all the clients from coming back at the same time. The lower bound of the jitter is 0; in this case, the Retry-After header is equal to the RateLimit-Reset header.
strategy This property is required. String
The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are: local and cluster.
syncRate This property is required. Number
How often to sync counter data to the central data store. A value of 0 results in synchronous behavior; a value of -1 ignores sync behavior entirely and only stores counters in node memory. A value greater than 0 will sync the counters in the specified number of seconds. The minimum allowed interval is 0.02 seconds (20ms).
windowSizes This property is required. List<Number>
One or more window sizes to apply a limit to (defined in seconds). There must be a matching number of window limits and sizes specified.
windowType This property is required. String
Sets the time window type to either sliding (default) or fixed. Sliding windows apply the rate limiting logic while taking into account previous hit rates (from the window that immediately precedes the current) using a dynamic weight. Fixed windows consist of buckets that are statically assigned to a definitive time range, each request is mapped to only one fixed window based on its timestamp and will affect only that window's counters.

GetGatewayPluginServiceProtectionConfigRedis

ClusterMaxRedirections This property is required. double
Maximum retry attempts for redirection.
ClusterNodes This property is required. List<GetGatewayPluginServiceProtectionConfigRedisClusterNode>
Cluster addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Cluster. The minimum length of the array is 1 element.
ConnectTimeout This property is required. double
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
ConnectionIsProxied This property is required. bool
If the connection to Redis is proxied (e.g. Envoy), set it true. Set the host and port to point to the proxy address.
Database This property is required. double
Database to use for the Redis connection when using the redis strategy
Host This property is required. string
A string representing a host name, such as example.com.
KeepaliveBacklog This property is required. double
Limits the total number of opened connections for a pool. If the connection pool is full, connection queues above the limit go into the backlog queue. If the backlog queue is full, subsequent connect operations fail and return nil. Queued operations (subject to set timeouts) resume once the number of connections in the pool is less than keepalive_pool_size. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger than keepalive_pool_size.
KeepalivePoolSize This property is required. double
The size limit for every cosocket connection pool associated with every remote server, per worker process. If neither keepalive_pool_size nor keepalive_backlog is specified, no pool is created. If keepalive_pool_size isn't specified but keepalive_backlog is specified, then the pool uses the default value. Try to increase (e.g. 512) this value if latency is high or throughput is low.
Password This property is required. string
Password to use for Redis connections. If undefined, no AUTH commands are sent to Redis.
Port This property is required. double
An integer representing a port number between 0 and 65535, inclusive.
ReadTimeout This property is required. double
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
SendTimeout This property is required. double
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
SentinelMaster This property is required. string
Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
SentinelNodes This property is required. List<GetGatewayPluginServiceProtectionConfigRedisSentinelNode>
Sentinel node addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Sentinel. The minimum length of the array is 1 element.
SentinelPassword This property is required. string
Sentinel password to authenticate with a Redis Sentinel instance. If undefined, no AUTH commands are sent to Redis Sentinels.
SentinelRole This property is required. string
Sentinel role to use for Redis connections when the redis strategy is defined. Defining this value implies using Redis Sentinel.
SentinelUsername This property is required. string
Sentinel username to authenticate with a Redis Sentinel instance. If undefined, ACL authentication won't be performed. This requires Redis v6.2.0+.
ServerName This property is required. string
A string representing an SNI (server name indication) value for TLS.
Ssl This property is required. bool
If set to true, uses SSL to connect to Redis.
SslVerify This property is required. bool
If set to true, verifies the validity of the server SSL certificate. If setting this parameter, also configure lua_ssl_trusted_certificate in kong.conf to specify the CA (or server) certificate used by your Redis server. You may also need to configure lua_ssl_verify_depth accordingly.
Username This property is required. string
Username to use for Redis connections. If undefined, ACL authentication won't be performed. This requires Redis v6.0.0+. To be compatible with Redis v5.x.y, you can set it to default.
ClusterMaxRedirections This property is required. float64
Maximum retry attempts for redirection.
ClusterNodes This property is required. []GetGatewayPluginServiceProtectionConfigRedisClusterNode
Cluster addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Cluster. The minimum length of the array is 1 element.
ConnectTimeout This property is required. float64
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
ConnectionIsProxied This property is required. bool
If the connection to Redis is proxied (e.g. Envoy), set it true. Set the host and port to point to the proxy address.
Database This property is required. float64
Database to use for the Redis connection when using the redis strategy
Host This property is required. string
A string representing a host name, such as example.com.
KeepaliveBacklog This property is required. float64
Limits the total number of opened connections for a pool. If the connection pool is full, connection queues above the limit go into the backlog queue. If the backlog queue is full, subsequent connect operations fail and return nil. Queued operations (subject to set timeouts) resume once the number of connections in the pool is less than keepalive_pool_size. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger than keepalive_pool_size.
KeepalivePoolSize This property is required. float64
The size limit for every cosocket connection pool associated with every remote server, per worker process. If neither keepalive_pool_size nor keepalive_backlog is specified, no pool is created. If keepalive_pool_size isn't specified but keepalive_backlog is specified, then the pool uses the default value. Try to increase (e.g. 512) this value if latency is high or throughput is low.
Password This property is required. string
Password to use for Redis connections. If undefined, no AUTH commands are sent to Redis.
Port This property is required. float64
An integer representing a port number between 0 and 65535, inclusive.
ReadTimeout This property is required. float64
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
SendTimeout This property is required. float64
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
SentinelMaster This property is required. string
Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
SentinelNodes This property is required. []GetGatewayPluginServiceProtectionConfigRedisSentinelNode
Sentinel node addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Sentinel. The minimum length of the array is 1 element.
SentinelPassword This property is required. string
Sentinel password to authenticate with a Redis Sentinel instance. If undefined, no AUTH commands are sent to Redis Sentinels.
SentinelRole This property is required. string
Sentinel role to use for Redis connections when the redis strategy is defined. Defining this value implies using Redis Sentinel.
SentinelUsername This property is required. string
Sentinel username to authenticate with a Redis Sentinel instance. If undefined, ACL authentication won't be performed. This requires Redis v6.2.0+.
ServerName This property is required. string
A string representing an SNI (server name indication) value for TLS.
Ssl This property is required. bool
If set to true, uses SSL to connect to Redis.
SslVerify This property is required. bool
If set to true, verifies the validity of the server SSL certificate. If setting this parameter, also configure lua_ssl_trusted_certificate in kong.conf to specify the CA (or server) certificate used by your Redis server. You may also need to configure lua_ssl_verify_depth accordingly.
Username This property is required. string
Username to use for Redis connections. If undefined, ACL authentication won't be performed. This requires Redis v6.0.0+. To be compatible with Redis v5.x.y, you can set it to default.
clusterMaxRedirections This property is required. Double
Maximum retry attempts for redirection.
clusterNodes This property is required. List<GetGatewayPluginServiceProtectionConfigRedisClusterNode>
Cluster addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Cluster. The minimum length of the array is 1 element.
connectTimeout This property is required. Double
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
connectionIsProxied This property is required. Boolean
If the connection to Redis is proxied (e.g. Envoy), set it true. Set the host and port to point to the proxy address.
database This property is required. Double
Database to use for the Redis connection when using the redis strategy
host This property is required. String
A string representing a host name, such as example.com.
keepaliveBacklog This property is required. Double
Limits the total number of opened connections for a pool. If the connection pool is full, connection queues above the limit go into the backlog queue. If the backlog queue is full, subsequent connect operations fail and return nil. Queued operations (subject to set timeouts) resume once the number of connections in the pool is less than keepalive_pool_size. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger than keepalive_pool_size.
keepalivePoolSize This property is required. Double
The size limit for every cosocket connection pool associated with every remote server, per worker process. If neither keepalive_pool_size nor keepalive_backlog is specified, no pool is created. If keepalive_pool_size isn't specified but keepalive_backlog is specified, then the pool uses the default value. Try to increase (e.g. 512) this value if latency is high or throughput is low.
password This property is required. String
Password to use for Redis connections. If undefined, no AUTH commands are sent to Redis.
port This property is required. Double
An integer representing a port number between 0 and 65535, inclusive.
readTimeout This property is required. Double
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sendTimeout This property is required. Double
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sentinelMaster This property is required. String
Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
sentinelNodes This property is required. List<GetGatewayPluginServiceProtectionConfigRedisSentinelNode>
Sentinel node addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Sentinel. The minimum length of the array is 1 element.
sentinelPassword This property is required. String
Sentinel password to authenticate with a Redis Sentinel instance. If undefined, no AUTH commands are sent to Redis Sentinels.
sentinelRole This property is required. String
Sentinel role to use for Redis connections when the redis strategy is defined. Defining this value implies using Redis Sentinel.
sentinelUsername This property is required. String
Sentinel username to authenticate with a Redis Sentinel instance. If undefined, ACL authentication won't be performed. This requires Redis v6.2.0+.
serverName This property is required. String
A string representing an SNI (server name indication) value for TLS.
ssl This property is required. Boolean
If set to true, uses SSL to connect to Redis.
sslVerify This property is required. Boolean
If set to true, verifies the validity of the server SSL certificate. If setting this parameter, also configure lua_ssl_trusted_certificate in kong.conf to specify the CA (or server) certificate used by your Redis server. You may also need to configure lua_ssl_verify_depth accordingly.
username This property is required. String
Username to use for Redis connections. If undefined, ACL authentication won't be performed. This requires Redis v6.0.0+. To be compatible with Redis v5.x.y, you can set it to default.
clusterMaxRedirections This property is required. number
Maximum retry attempts for redirection.
clusterNodes This property is required. GetGatewayPluginServiceProtectionConfigRedisClusterNode[]
Cluster addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Cluster. The minimum length of the array is 1 element.
connectTimeout This property is required. number
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
connectionIsProxied This property is required. boolean
If the connection to Redis is proxied (e.g. Envoy), set it true. Set the host and port to point to the proxy address.
database This property is required. number
Database to use for the Redis connection when using the redis strategy
host This property is required. string
A string representing a host name, such as example.com.
keepaliveBacklog This property is required. number
Limits the total number of opened connections for a pool. If the connection pool is full, connection queues above the limit go into the backlog queue. If the backlog queue is full, subsequent connect operations fail and return nil. Queued operations (subject to set timeouts) resume once the number of connections in the pool is less than keepalive_pool_size. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger than keepalive_pool_size.
keepalivePoolSize This property is required. number
The size limit for every cosocket connection pool associated with every remote server, per worker process. If neither keepalive_pool_size nor keepalive_backlog is specified, no pool is created. If keepalive_pool_size isn't specified but keepalive_backlog is specified, then the pool uses the default value. Try to increase (e.g. 512) this value if latency is high or throughput is low.
password This property is required. string
Password to use for Redis connections. If undefined, no AUTH commands are sent to Redis.
port This property is required. number
An integer representing a port number between 0 and 65535, inclusive.
readTimeout This property is required. number
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sendTimeout This property is required. number
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sentinelMaster This property is required. string
Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
sentinelNodes This property is required. GetGatewayPluginServiceProtectionConfigRedisSentinelNode[]
Sentinel node addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Sentinel. The minimum length of the array is 1 element.
sentinelPassword This property is required. string
Sentinel password to authenticate with a Redis Sentinel instance. If undefined, no AUTH commands are sent to Redis Sentinels.
sentinelRole This property is required. string
Sentinel role to use for Redis connections when the redis strategy is defined. Defining this value implies using Redis Sentinel.
sentinelUsername This property is required. string
Sentinel username to authenticate with a Redis Sentinel instance. If undefined, ACL authentication won't be performed. This requires Redis v6.2.0+.
serverName This property is required. string
A string representing an SNI (server name indication) value for TLS.
ssl This property is required. boolean
If set to true, uses SSL to connect to Redis.
sslVerify This property is required. boolean
If set to true, verifies the validity of the server SSL certificate. If setting this parameter, also configure lua_ssl_trusted_certificate in kong.conf to specify the CA (or server) certificate used by your Redis server. You may also need to configure lua_ssl_verify_depth accordingly.
username This property is required. string
Username to use for Redis connections. If undefined, ACL authentication won't be performed. This requires Redis v6.0.0+. To be compatible with Redis v5.x.y, you can set it to default.
cluster_max_redirections This property is required. float
Maximum retry attempts for redirection.
cluster_nodes This property is required. Sequence[GetGatewayPluginServiceProtectionConfigRedisClusterNode]
Cluster addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Cluster. The minimum length of the array is 1 element.
connect_timeout This property is required. float
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
connection_is_proxied This property is required. bool
If the connection to Redis is proxied (e.g. Envoy), set it true. Set the host and port to point to the proxy address.
database This property is required. float
Database to use for the Redis connection when using the redis strategy
host This property is required. str
A string representing a host name, such as example.com.
keepalive_backlog This property is required. float
Limits the total number of opened connections for a pool. If the connection pool is full, connection queues above the limit go into the backlog queue. If the backlog queue is full, subsequent connect operations fail and return nil. Queued operations (subject to set timeouts) resume once the number of connections in the pool is less than keepalive_pool_size. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger than keepalive_pool_size.
keepalive_pool_size This property is required. float
The size limit for every cosocket connection pool associated with every remote server, per worker process. If neither keepalive_pool_size nor keepalive_backlog is specified, no pool is created. If keepalive_pool_size isn't specified but keepalive_backlog is specified, then the pool uses the default value. Try to increase (e.g. 512) this value if latency is high or throughput is low.
password This property is required. str
Password to use for Redis connections. If undefined, no AUTH commands are sent to Redis.
port This property is required. float
An integer representing a port number between 0 and 65535, inclusive.
read_timeout This property is required. float
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
send_timeout This property is required. float
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sentinel_master This property is required. str
Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
sentinel_nodes This property is required. Sequence[GetGatewayPluginServiceProtectionConfigRedisSentinelNode]
Sentinel node addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Sentinel. The minimum length of the array is 1 element.
sentinel_password This property is required. str
Sentinel password to authenticate with a Redis Sentinel instance. If undefined, no AUTH commands are sent to Redis Sentinels.
sentinel_role This property is required. str
Sentinel role to use for Redis connections when the redis strategy is defined. Defining this value implies using Redis Sentinel.
sentinel_username This property is required. str
Sentinel username to authenticate with a Redis Sentinel instance. If undefined, ACL authentication won't be performed. This requires Redis v6.2.0+.
server_name This property is required. str
A string representing an SNI (server name indication) value for TLS.
ssl This property is required. bool
If set to true, uses SSL to connect to Redis.
ssl_verify This property is required. bool
If set to true, verifies the validity of the server SSL certificate. If setting this parameter, also configure lua_ssl_trusted_certificate in kong.conf to specify the CA (or server) certificate used by your Redis server. You may also need to configure lua_ssl_verify_depth accordingly.
username This property is required. str
Username to use for Redis connections. If undefined, ACL authentication won't be performed. This requires Redis v6.0.0+. To be compatible with Redis v5.x.y, you can set it to default.
clusterMaxRedirections This property is required. Number
Maximum retry attempts for redirection.
clusterNodes This property is required. List<Property Map>
Cluster addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Cluster. The minimum length of the array is 1 element.
connectTimeout This property is required. Number
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
connectionIsProxied This property is required. Boolean
If the connection to Redis is proxied (e.g. Envoy), set it true. Set the host and port to point to the proxy address.
database This property is required. Number
Database to use for the Redis connection when using the redis strategy
host This property is required. String
A string representing a host name, such as example.com.
keepaliveBacklog This property is required. Number
Limits the total number of opened connections for a pool. If the connection pool is full, connection queues above the limit go into the backlog queue. If the backlog queue is full, subsequent connect operations fail and return nil. Queued operations (subject to set timeouts) resume once the number of connections in the pool is less than keepalive_pool_size. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger than keepalive_pool_size.
keepalivePoolSize This property is required. Number
The size limit for every cosocket connection pool associated with every remote server, per worker process. If neither keepalive_pool_size nor keepalive_backlog is specified, no pool is created. If keepalive_pool_size isn't specified but keepalive_backlog is specified, then the pool uses the default value. Try to increase (e.g. 512) this value if latency is high or throughput is low.
password This property is required. String
Password to use for Redis connections. If undefined, no AUTH commands are sent to Redis.
port This property is required. Number
An integer representing a port number between 0 and 65535, inclusive.
readTimeout This property is required. Number
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sendTimeout This property is required. Number
An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
sentinelMaster This property is required. String
Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
sentinelNodes This property is required. List<Property Map>
Sentinel node addresses to use for Redis connections when the redis strategy is defined. Defining this field implies using a Redis Sentinel. The minimum length of the array is 1 element.
sentinelPassword This property is required. String
Sentinel password to authenticate with a Redis Sentinel instance. If undefined, no AUTH commands are sent to Redis Sentinels.
sentinelRole This property is required. String
Sentinel role to use for Redis connections when the redis strategy is defined. Defining this value implies using Redis Sentinel.
sentinelUsername This property is required. String
Sentinel username to authenticate with a Redis Sentinel instance. If undefined, ACL authentication won't be performed. This requires Redis v6.2.0+.
serverName This property is required. String
A string representing an SNI (server name indication) value for TLS.
ssl This property is required. Boolean
If set to true, uses SSL to connect to Redis.
sslVerify This property is required. Boolean
If set to true, verifies the validity of the server SSL certificate. If setting this parameter, also configure lua_ssl_trusted_certificate in kong.conf to specify the CA (or server) certificate used by your Redis server. You may also need to configure lua_ssl_verify_depth accordingly.
username This property is required. String
Username to use for Redis connections. If undefined, ACL authentication won't be performed. This requires Redis v6.0.0+. To be compatible with Redis v5.x.y, you can set it to default.

GetGatewayPluginServiceProtectionConfigRedisClusterNode

Ip This property is required. string
A string representing a host name, such as example.com.
Port This property is required. double
An integer representing a port number between 0 and 65535, inclusive.
Ip This property is required. string
A string representing a host name, such as example.com.
Port This property is required. float64
An integer representing a port number between 0 and 65535, inclusive.
ip This property is required. String
A string representing a host name, such as example.com.
port This property is required. Double
An integer representing a port number between 0 and 65535, inclusive.
ip This property is required. string
A string representing a host name, such as example.com.
port This property is required. number
An integer representing a port number between 0 and 65535, inclusive.
ip This property is required. str
A string representing a host name, such as example.com.
port This property is required. float
An integer representing a port number between 0 and 65535, inclusive.
ip This property is required. String
A string representing a host name, such as example.com.
port This property is required. Number
An integer representing a port number between 0 and 65535, inclusive.

GetGatewayPluginServiceProtectionConfigRedisSentinelNode

Host This property is required. string
A string representing a host name, such as example.com.
Port This property is required. double
An integer representing a port number between 0 and 65535, inclusive.
Host This property is required. string
A string representing a host name, such as example.com.
Port This property is required. float64
An integer representing a port number between 0 and 65535, inclusive.
host This property is required. String
A string representing a host name, such as example.com.
port This property is required. Double
An integer representing a port number between 0 and 65535, inclusive.
host This property is required. string
A string representing a host name, such as example.com.
port This property is required. number
An integer representing a port number between 0 and 65535, inclusive.
host This property is required. str
A string representing a host name, such as example.com.
port This property is required. float
An integer representing a port number between 0 and 65535, inclusive.
host This property is required. String
A string representing a host name, such as example.com.
port This property is required. Number
An integer representing a port number between 0 and 65535, inclusive.

GetGatewayPluginServiceProtectionOrdering

after This property is required. Property Map
before This property is required. Property Map

GetGatewayPluginServiceProtectionOrderingAfter

Accesses This property is required. List<string>
Accesses This property is required. []string
accesses This property is required. List<String>
accesses This property is required. string[]
accesses This property is required. Sequence[str]
accesses This property is required. List<String>

GetGatewayPluginServiceProtectionOrderingBefore

Accesses This property is required. List<string>
Accesses This property is required. []string
accesses This property is required. List<String>
accesses This property is required. string[]
accesses This property is required. Sequence[str]
accesses This property is required. List<String>

GetGatewayPluginServiceProtectionService

Id This property is required. string
Id This property is required. string
id This property is required. String
id This property is required. string
id This property is required. str
id This property is required. String

Package Details

Repository
konnect kong/terraform-provider-konnect
License
Notes
This Pulumi package is based on the konnect Terraform Provider.