Skip to content

RDS  >  Operations  >  modify_db_proxy

modify_db_proxy

Operation

modify_db_proxy async

modify_db_proxy(input: ModifyDBProxyInput, plugins: list[Plugin] | None = None) -> ModifyDBProxyOutput

Changes the settings for an existing DB proxy.

Parameters:

Name Type Description Default
input ModifyDBProxyInput

An instance of ModifyDBProxyInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
ModifyDBProxyOutput

An instance of ModifyDBProxyOutput.

Input

ModifyDBProxyInput dataclass

Bases: _SerdeShape

Dataclass for ModifyDBProxyInput structure.

Attributes

auth class-attribute instance-attribute
auth: list[UserAuthConfig] | None = ...

The new authentication settings for the DBProxy.

db_proxy_name class-attribute instance-attribute
db_proxy_name: str | None = ...

The identifier for the DBProxy to modify.

debug_logging class-attribute instance-attribute
debug_logging: bool | None = ...

Specifies whether the proxy logs detailed connection and query information. When you enable DebugLogging, the proxy captures connection details and connection pool behavior from your queries. Debug logging increases CloudWatch costs and can impact proxy performance. Enable this option only when you need to troubleshoot connection or performance issues.

default_auth_scheme class-attribute instance-attribute
default_auth_scheme: str | None = ...

The default authentication scheme that the proxy uses for client connections to the proxy and connections from the proxy to the underlying database. Valid values are NONE and IAM_AUTH. When set to IAM_AUTH, the proxy uses end-to-end IAM authentication to connect to the database.

idle_client_timeout class-attribute instance-attribute
idle_client_timeout: int | None = ...

The number of seconds that a connection to the proxy can be inactive before the proxy disconnects it. You can set this value higher or lower than the connection timeout limit for the associated database.

new_db_proxy_name class-attribute instance-attribute
new_db_proxy_name: str | None = ...

The new identifier for the DBProxy. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it can't end with a hyphen or contain two consecutive hyphens.

require_tls class-attribute instance-attribute
require_tls: bool | None = ...

Whether Transport Layer Security (TLS) encryption is required for connections to the proxy. By enabling this setting, you can enforce encrypted TLS connections to the proxy, even if the associated database doesn't use TLS.

role_arn class-attribute instance-attribute
role_arn: str | None = ...

The Amazon Resource Name (ARN) of the IAM role that the proxy uses to access secrets in Amazon Web Services Secrets Manager.

security_groups class-attribute instance-attribute
security_groups: list[str] | None = ...

The new list of security groups for the DBProxy.

Output

ModifyDBProxyOutput dataclass

Bases: _SerdeShape

Dataclass for ModifyDBProxyOutput structure.

Attributes

db_proxy class-attribute instance-attribute
db_proxy: DBProxy | None = ...

The DBProxy object representing the new settings for the proxy.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.