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>
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]
func LookupGatewayPluginServiceProtection(ctx *Context, args *LookupGatewayPluginServiceProtectionArgs, opts ...InvokeOption) (*LookupGatewayPluginServiceProtectionResult, error)
func LookupGatewayPluginServiceProtectionOutput(ctx *Context, args *LookupGatewayPluginServiceProtectionOutputArgs, opts ...InvokeOption) LookupGatewayPluginServiceProtectionResultOutput
> 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)
}
public static CompletableFuture<GetGatewayPluginServiceProtectionResult> getGatewayPluginServiceProtection(GetGatewayPluginServiceProtectionArgs args, InvokeOptions options)
public static Output<GetGatewayPluginServiceProtectionResult> getGatewayPluginServiceProtection(GetGatewayPluginServiceProtectionArgs args, InvokeOptions options)
fn::invoke:
function: konnect:index/getGatewayPluginServiceProtection:getGatewayPluginServiceProtection
arguments:
# arguments dictionary
The following arguments are supported:
- Control
Plane Id This property is required. string
- Control
Plane Id This property is required. string
- control
Plane Id This property is required. String
- control
Plane Id This property is required. string
- control_
plane_ id This property is required. str
- control
Plane Id This property is required. String
getGatewayPluginServiceProtection Result
The following output properties are available:
- Config
Get
Gateway Plugin Service Protection Config - Control
Plane stringId - Created
At double - Enabled bool
- Id string
- Instance
Name string - Ordering
Get
Gateway Plugin Service Protection Ordering - Protocols List<string>
- Service
Get
Gateway Plugin Service Protection Service - List<string>
- Updated
At double
- Config
Get
Gateway Plugin Service Protection Config - Control
Plane stringId - Created
At float64 - Enabled bool
- Id string
- Instance
Name string - Ordering
Get
Gateway Plugin Service Protection Ordering - Protocols []string
- Service
Get
Gateway Plugin Service Protection Service - []string
- Updated
At float64
- config
Get
Gateway Plugin Service Protection Config - control
Plane StringId - created
At Double - enabled Boolean
- id String
- instance
Name String - ordering
Get
Gateway Plugin Service Protection Ordering - protocols List<String>
- service
Get
Gateway Plugin Service Protection Service - List<String>
- updated
At Double
- config
Get
Gateway Plugin Service Protection Config - control
Plane stringId - created
At number - enabled boolean
- id string
- instance
Name string - ordering
Get
Gateway Plugin Service Protection Ordering - protocols string[]
- service
Get
Gateway Plugin Service Protection Service - string[]
- updated
At number
- config
Get
Gateway Plugin Service Protection Config - control_
plane_ strid - created_
at float - enabled bool
- id str
- instance_
name str - ordering
Get
Gateway Plugin Service Protection Ordering - protocols Sequence[str]
- service
Get
Gateway Plugin Service Protection Service - Sequence[str]
- updated_
at float
- config Property Map
- control
Plane StringId - created
At Number - enabled Boolean
- id String
- instance
Name String - ordering Property Map
- protocols List<String>
- service Property Map
- List<String>
- updated
At Number
Supporting Types
GetGatewayPluginServiceProtectionConfig
- Dictionary
Name 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
iscluster
orredis
andconfig.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 tofalse
, all requests, including denied ones, are counted. This parameter only affects thesliding
window_type. - Error
Code This property is required. double - Set a custom error code to return when the rate limit is exceeded.
- Error
Message This property is required. string - 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. List<double> - 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. 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. GetGateway Plugin Service Protection Config Redis - Retry
After Jitter Max 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 is0
; in this case, theRetry-After
header is equal to theRateLimit-Reset
header. - Strategy
This property is required. string - The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are:
local
andcluster
. - Sync
Rate 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).
- Window
Sizes 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.
- Window
Type This property is required. string - Sets the time window type to either
sliding
(default) orfixed
. 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. string - The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is
config.strategy
iscluster
orredis
andconfig.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 tofalse
, all requests, including denied ones, are counted. This parameter only affects thesliding
window_type. - Error
Code This property is required. float64 - Set a custom error code to return when the rate limit is exceeded.
- Error
Message This property is required. string - 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. []float64 - 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. 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. GetGateway Plugin Service Protection Config Redis - Retry
After Jitter Max 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 is0
; in this case, theRetry-After
header is equal to theRateLimit-Reset
header. - Strategy
This property is required. string - The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are:
local
andcluster
. - Sync
Rate 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).
- Window
Sizes 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.
- Window
Type This property is required. string - Sets the time window type to either
sliding
(default) orfixed
. 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. String - The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is
config.strategy
iscluster
orredis
andconfig.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. Boolean - If set to
true
, this doesn't count denied requests (status =429
). If set tofalse
, all requests, including denied ones, are counted. This parameter only affects thesliding
window_type. - error
Code This property is required. Double - Set a custom error code to return when the rate limit is exceeded.
- error
Message This property is required. String - Set a custom error message to return when the rate limit is exceeded.
- hide
Client Headers 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.
- lock
Dictionary Name 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. GetGateway Plugin Service Protection Config Redis - retry
After Jitter Max 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 is0
; in this case, theRetry-After
header is equal to theRateLimit-Reset
header. - strategy
This property is required. String - The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are:
local
andcluster
. - sync
Rate 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).
- window
Sizes 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.
- window
Type This property is required. String - Sets the time window type to either
sliding
(default) orfixed
. 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. string - The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is
config.strategy
iscluster
orredis
andconfig.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. boolean - If set to
true
, this doesn't count denied requests (status =429
). If set tofalse
, all requests, including denied ones, are counted. This parameter only affects thesliding
window_type. - error
Code This property is required. number - Set a custom error code to return when the rate limit is exceeded.
- error
Message This property is required. string - Set a custom error message to return when the rate limit is exceeded.
- hide
Client Headers 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.
- lock
Dictionary Name 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. GetGateway Plugin Service Protection Config Redis - retry
After Jitter Max 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 is0
; in this case, theRetry-After
header is equal to theRateLimit-Reset
header. - strategy
This property is required. string - The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are:
local
andcluster
. - sync
Rate 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).
- window
Sizes 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.
- window
Type This property is required. string - Sets the time window type to either
sliding
(default) orfixed
. 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
iscluster
orredis
andconfig.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 tofalse
, all requests, including denied ones, are counted. This parameter only affects thesliding
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. GetGateway Plugin Service Protection Config Redis - 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 is0
; in this case, theRetry-After
header is equal to theRateLimit-Reset
header. - strategy
This property is required. str - The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are:
local
andcluster
. - 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) orfixed
. 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. String - The shared dictionary where counters are stored. When the plugin is configured to synchronize counter data externally (that is
config.strategy
iscluster
orredis
andconfig.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. Boolean - If set to
true
, this doesn't count denied requests (status =429
). If set tofalse
, all requests, including denied ones, are counted. This parameter only affects thesliding
window_type. - error
Code This property is required. Number - Set a custom error code to return when the rate limit is exceeded.
- error
Message This property is required. String - Set a custom error message to return when the rate limit is exceeded.
- hide
Client Headers 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.
- lock
Dictionary Name 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 - retry
After Jitter Max 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 is0
; in this case, theRetry-After
header is equal to theRateLimit-Reset
header. - strategy
This property is required. String - The rate-limiting strategy to use for retrieving and incrementing the limits. Available values are:
local
andcluster
. - sync
Rate 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).
- window
Sizes 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.
- window
Type This property is required. String - Sets the time window type to either
sliding
(default) orfixed
. 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
- Cluster
Max Redirections This property is required. double - Maximum retry attempts for redirection.
- Cluster
Nodes This property is required. List<GetGateway Plugin Service Protection Config Redis Cluster Node> - 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. double - 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 thehost
andport
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.
- Keepalive
Backlog 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 thankeepalive_pool_size
. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger thankeepalive_pool_size
. - Keepalive
Pool Size 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
norkeepalive_backlog
is specified, no pool is created. Ifkeepalive_pool_size
isn't specified butkeepalive_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.
- Read
Timeout This property is required. double - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- Send
Timeout This property is required. double - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- Sentinel
Master This property is required. string - Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
- Sentinel
Nodes This property is required. List<GetGateway Plugin Service Protection Config Redis Sentinel Node> - 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. string - 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. string - 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. string - 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. 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.
- 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
inkong.conf
to specify the CA (or server) certificate used by your Redis server. You may also need to configurelua_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. float64 - Maximum retry attempts for redirection.
- Cluster
Nodes This property is required. []GetGateway Plugin Service Protection Config Redis Cluster Node - 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. float64 - 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 thehost
andport
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.
- Keepalive
Backlog 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 thankeepalive_pool_size
. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger thankeepalive_pool_size
. - Keepalive
Pool Size 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
norkeepalive_backlog
is specified, no pool is created. Ifkeepalive_pool_size
isn't specified butkeepalive_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.
- Read
Timeout This property is required. float64 - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- Send
Timeout This property is required. float64 - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- Sentinel
Master This property is required. string - Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
- Sentinel
Nodes This property is required. []GetGateway Plugin Service Protection Config Redis Sentinel Node - 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. string - 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. string - 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. string - 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. 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.
- 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
inkong.conf
to specify the CA (or server) certificate used by your Redis server. You may also need to configurelua_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. Double - Maximum retry attempts for redirection.
- cluster
Nodes This property is required. List<GetGateway Plugin Service Protection Config Redis Cluster Node> - 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. Double - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- connection
Is Proxied This property is required. Boolean - If the connection to Redis is proxied (e.g. Envoy), set it
true
. Set thehost
andport
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.
- keepalive
Backlog 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 thankeepalive_pool_size
. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger thankeepalive_pool_size
. - keepalive
Pool Size 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
norkeepalive_backlog
is specified, no pool is created. Ifkeepalive_pool_size
isn't specified butkeepalive_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.
- read
Timeout This property is required. Double - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- send
Timeout This property is required. Double - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- sentinel
Master This property is required. String - Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
- sentinel
Nodes This property is required. List<GetGateway Plugin Service Protection Config Redis Sentinel Node> - 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. String - 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. String - 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. String - 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. 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.
- ssl
Verify 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
inkong.conf
to specify the CA (or server) certificate used by your Redis server. You may also need to configurelua_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. number - Maximum retry attempts for redirection.
- cluster
Nodes This property is required. GetGateway Plugin Service Protection Config Redis Cluster Node[] - 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. number - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- connection
Is Proxied This property is required. boolean - If the connection to Redis is proxied (e.g. Envoy), set it
true
. Set thehost
andport
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.
- keepalive
Backlog 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 thankeepalive_pool_size
. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger thankeepalive_pool_size
. - keepalive
Pool Size 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
norkeepalive_backlog
is specified, no pool is created. Ifkeepalive_pool_size
isn't specified butkeepalive_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.
- read
Timeout This property is required. number - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- send
Timeout This property is required. number - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- sentinel
Master This property is required. string - Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
- sentinel
Nodes This property is required. GetGateway Plugin Service Protection Config Redis Sentinel Node[] - 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. string - 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. string - 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. string - 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. 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.
- ssl
Verify 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
inkong.conf
to specify the CA (or server) certificate used by your Redis server. You may also need to configurelua_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[GetGateway Plugin Service Protection Config Redis Cluster Node] - 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 thehost
andport
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 thankeepalive_pool_size
. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger thankeepalive_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
norkeepalive_backlog
is specified, no pool is created. Ifkeepalive_pool_size
isn't specified butkeepalive_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[GetGateway Plugin Service Protection Config Redis Sentinel Node] - 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
inkong.conf
to specify the CA (or server) certificate used by your Redis server. You may also need to configurelua_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
.
- cluster
Max Redirections This property is required. Number - Maximum retry attempts for redirection.
- cluster
Nodes 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. - connect
Timeout This property is required. Number - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- connection
Is Proxied This property is required. Boolean - If the connection to Redis is proxied (e.g. Envoy), set it
true
. Set thehost
andport
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.
- keepalive
Backlog 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 thankeepalive_pool_size
. If latency is high or throughput is low, try increasing this value. Empirically, this value is larger thankeepalive_pool_size
. - keepalive
Pool Size 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
norkeepalive_backlog
is specified, no pool is created. Ifkeepalive_pool_size
isn't specified butkeepalive_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.
- read
Timeout This property is required. Number - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- send
Timeout This property is required. Number - An integer representing a timeout in milliseconds. Must be between 0 and 2^31-2.
- sentinel
Master This property is required. String - Sentinel master to use for Redis connections. Defining this value implies using Redis Sentinel.
- sentinel
Nodes 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. - sentinel
Password This property is required. String - 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. String - 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. String - 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. 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.
- ssl
Verify 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
inkong.conf
to specify the CA (or server) certificate used by your Redis server. You may also need to configurelua_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
GetGatewayPluginServiceProtectionConfigRedisSentinelNode
GetGatewayPluginServiceProtectionOrdering
- After
This property is required. GetGateway Plugin Service Protection Ordering After - Before
This property is required. GetGateway Plugin Service Protection Ordering Before
- After
This property is required. GetGateway Plugin Service Protection Ordering After - Before
This property is required. GetGateway Plugin Service Protection Ordering Before
- after
This property is required. GetGateway Plugin Service Protection Ordering After - before
This property is required. GetGateway Plugin Service Protection Ordering Before
- after
This property is required. GetGateway Plugin Service Protection Ordering After - before
This property is required. GetGateway Plugin Service Protection Ordering Before
- after
This property is required. GetGateway Plugin Service Protection Ordering After - before
This property is required. GetGateway Plugin Service Protection Ordering Before
- 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.