Package-level declarations

Types

Link copied to clipboard
class RdsAuthTokenGenerator(val credentialsProvider: CredentialsProvider = DefaultChainCredentialsProvider(), val signer: AwsSigner = DefaultAwsSigner, val clock: Clock = Clock.System)

Generates an IAM authentication token for use with RDS databases

Link copied to clipboard
interface RdsClient : SdkClient

Amazon Relational Database Service (Amazon RDS) is a web service that makes it easier to set up, operate, and scale a relational database in the cloud. It provides cost-efficient, resizeable capacity for an industry-standard relational database and manages common database administration tasks, freeing up developers to focus on what makes their applications and businesses unique.

Properties

Link copied to clipboard
const val SdkVersion: String
Link copied to clipboard
Link copied to clipboard
const val ServiceId: String

Functions

Link copied to clipboard

Associates an Identity and Access Management (IAM) role with a DB cluster.

Link copied to clipboard

Associates an Amazon Web Services Identity and Access Management (IAM) role with a DB instance.

Link copied to clipboard

Adds a source identifier to an existing RDS event notification subscription.

Link copied to clipboard

Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.

Link copied to clipboard

Applies a pending maintenance action to a resource (for example, to a DB instance).

Link copied to clipboard

Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your database is running on the internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).

Link copied to clipboard

Backtracks a DB cluster to a specific time, without creating a new DB cluster.

Link copied to clipboard

Cancels an export task in progress that is exporting a snapshot or cluster to Amazon S3. Any data that has already been written to the S3 bucket isn't removed.

Link copied to clipboard

Copies the specified DB cluster parameter group.

Link copied to clipboard

Copies a snapshot of a DB cluster.

Link copied to clipboard

Copies the specified DB parameter group.

Link copied to clipboard

Copies the specified DB snapshot. The source DB snapshot must be in the available state.

Link copied to clipboard

Copies the specified option group.

Link copied to clipboard

Creates a blue/green deployment.

Link copied to clipboard

Creates a custom DB engine version (CEV).

Link copied to clipboard

Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.

Link copied to clipboard

Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.

Link copied to clipboard

Creates a new DB cluster parameter group.

Link copied to clipboard

Creates a snapshot of a DB cluster.

Link copied to clipboard

Creates a new DB instance.

Link copied to clipboard

Creates a new DB instance that acts as a read replica for an existing source DB instance or Multi-AZ DB cluster. You can create a read replica for a DB instance running MariaDB, MySQL, Oracle, PostgreSQL, or SQL Server. You can create a read replica for a Multi-AZ DB cluster running MySQL or PostgreSQL. For more information, see Working with read replicas and Migrating from a Multi-AZ DB cluster to a DB instance using a read replica in the Amazon RDS User Guide.

Link copied to clipboard

Creates a new DB parameter group.

Link copied to clipboard
inline suspend fun RdsClient.createDbProxy(crossinline block: CreateDbProxyRequest.Builder.() -> Unit): CreateDbProxyResponse

Creates a new DB proxy.

Link copied to clipboard

Creates a DBProxyEndpoint. Only applies to proxies that are associated with Aurora DB clusters. You can use DB proxy endpoints to specify read/write or read-only access to the DB cluster. You can also use DB proxy endpoints to access a DB proxy through a different VPC than the proxy's default VPC.

Link copied to clipboard

Creates a new DB security group. DB security groups control access to a DB instance.

Link copied to clipboard

Creates a new DB shard group for Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

Link copied to clipboard

Creates a snapshot of a DB instance. The source DB instance must be in the available or storage-optimization state.

Link copied to clipboard

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Web Services Region.

Link copied to clipboard

Creates an RDS event notification subscription. This operation requires a topic Amazon Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

Link copied to clipboard

Creates an Aurora global database spread across multiple Amazon Web Services Regions. The global database contains a single primary cluster with read-write capability, and a read-only secondary cluster that receives data from the primary cluster through high-speed replication performed by the Aurora storage subsystem.

Link copied to clipboard

Creates a zero-ETL integration with Amazon Redshift.

Link copied to clipboard

Creates a new option group. You can create up to 20 option groups.

Link copied to clipboard

Creates a tenant database in a DB instance that uses the multi-tenant configuration. Only RDS for Oracle container database (CDB) instances are supported.

Link copied to clipboard

Deletes a blue/green deployment.

Link copied to clipboard

Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:

Link copied to clipboard

The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.

Link copied to clipboard

Deletes automated backups using the DbClusterResourceId value of the source DB cluster or the Amazon Resource Name (ARN) of the automated backups.

Link copied to clipboard

Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.

Link copied to clipboard

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.

Link copied to clipboard

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

Link copied to clipboard

Deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. However, manual DB snapshots of the DB instance aren't deleted.

Link copied to clipboard

Deletes automated backups using the DbiResourceId value of the source DB instance or the Amazon Resource Name (ARN) of the automated backups.

Link copied to clipboard

Deletes a specified DB parameter group. The DB parameter group to be deleted can't be associated with any DB instances.

Link copied to clipboard
inline suspend fun RdsClient.deleteDbProxy(crossinline block: DeleteDbProxyRequest.Builder.() -> Unit): DeleteDbProxyResponse

Deletes an existing DB proxy.

Link copied to clipboard

Deletes a DBProxyEndpoint. Doing so removes the ability to access the DB proxy using the endpoint that you defined. The endpoint that you delete might have provided capabilities such as read/write or read-only operations, or using a different VPC than the DB proxy's default VPC.

Link copied to clipboard

Deletes a DB security group.

Link copied to clipboard

Deletes an Aurora Limitless Database DB shard group.

Link copied to clipboard

Deletes a DB snapshot. If the snapshot is being copied, the copy operation is terminated.

Link copied to clipboard

Deletes a DB subnet group.

Link copied to clipboard

Deletes an RDS event notification subscription.

Link copied to clipboard

Deletes a global database cluster. The primary and secondary clusters must already be detached or destroyed first.

Link copied to clipboard

Deletes a zero-ETL integration with Amazon Redshift.

Link copied to clipboard

Deletes an existing option group.

Link copied to clipboard

Deletes a tenant database from your DB instance. This command only applies to RDS for Oracle container database (CDB) instances.

Link copied to clipboard

Remove the association between one or more DBProxyTarget data structures and a DBProxyTargetGroup.

Link copied to clipboard

Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.

Link copied to clipboard

Describes one or more blue/green deployments.

Link copied to clipboard

Lists the set of certificate authority (CA) certificates provided by Amazon RDS for this Amazon Web Services account.

Link copied to clipboard

Displays backups for both current and deleted DB clusters. For example, use this operation to find details about automated backups for previously deleted clusters. Current clusters are returned for both the DescribeDBClusterAutomatedBackups and DescribeDBClusters operations.

Link copied to clipboard

Returns information about backtracks for a DB cluster.

Link copied to clipboard

Returns information about endpoints for an Amazon Aurora DB cluster.

Link copied to clipboard

Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list will contain only the description of the specified DB cluster parameter group.

Link copied to clipboard

Returns the detailed parameter list for a particular DB cluster parameter group.

Link copied to clipboard

Describes existing Amazon Aurora DB clusters and Multi-AZ DB clusters. This API supports pagination.

Link copied to clipboard

Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.

Link copied to clipboard

Returns information about DB cluster snapshots. This API action supports pagination.

Link copied to clipboard

Describes the properties of specific versions of DB engines.

Link copied to clipboard

Displays backups for both current and deleted instances. For example, use this operation to find details about automated backups for previously deleted instances. Current instances with retention periods greater than zero (0) are returned for both the DescribeDBInstanceAutomatedBackups and DescribeDBInstances operations.

Link copied to clipboard

Describes provisioned RDS instances. This API supports pagination.

Link copied to clipboard

Returns a list of DB log files for the DB instance.

Link copied to clipboard

Describes the properties of specific major versions of DB engines.

Link copied to clipboard

Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.

Link copied to clipboard

Returns the detailed parameter list for a particular DB parameter group.

Link copied to clipboard

Returns information about DB proxies.

Link copied to clipboard

Returns information about DB proxy endpoints.

Link copied to clipboard

Returns information about DB proxy target groups, represented by DBProxyTargetGroup data structures.

Link copied to clipboard

Returns information about DBProxyTarget objects. This API supports pagination.

Link copied to clipboard

Describes the recommendations to resolve the issues for your DB instances, DB clusters, and DB parameter groups.

Link copied to clipboard

Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, the list will contain only the descriptions of the specified DB security group.

Link copied to clipboard

Describes existing Aurora Limitless Database DB shard groups.

Link copied to clipboard

Returns a list of DB snapshot attribute names and values for a manual DB snapshot.

Link copied to clipboard

Returns information about DB snapshots. This API action supports pagination.

Link copied to clipboard

Describes the tenant databases that exist in a DB snapshot. This command only applies to RDS for Oracle DB instances in the multi-tenant configuration.

Link copied to clipboard

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.

Link copied to clipboard

Returns the default engine and system parameter information for the cluster database engine.

Link copied to clipboard

Returns the default engine and system parameter information for the specified database engine.

Link copied to clipboard

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can also see this list in the "Amazon RDS event categories and event messages" section of the Amazon RDS User Guide or the Amazon Aurora User Guide.

Link copied to clipboard

Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days. Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by providing the name as a parameter.

Link copied to clipboard

Lists all the subscription descriptions for a customer account. The description for a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

Link copied to clipboard

Returns information about a snapshot or cluster export to Amazon S3. This API operation supports pagination.

Link copied to clipboard

Returns information about Aurora global database clusters. This API supports pagination.

Link copied to clipboard

Describe one or more zero-ETL integrations with Amazon Redshift.

Link copied to clipboard

Describes all available options for the specified engine.

Link copied to clipboard

Describes the available option groups.

Link copied to clipboard

Describes the orderable DB instance options for a specified DB engine.

Link copied to clipboard

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

Link copied to clipboard

Returns information about reserved DB instances for this account, or about a specified reserved DB instance.

Link copied to clipboard

Lists available reserved DB instance offerings.

Link copied to clipboard

Returns a list of the source Amazon Web Services Regions where the current Amazon Web Services Region can create a read replica, copy a DB snapshot from, or replicate automated backups from.

Link copied to clipboard

Describes the tenant databases in a DB instance that uses the multi-tenant configuration. Only RDS for Oracle CDB instances are supported.

Link copied to clipboard

You can call DescribeValidDBInstanceModifications to learn what modifications you can make to your DB instance. You can use this information when you call ModifyDBInstance.

Link copied to clipboard

Disables the HTTP endpoint for the specified DB cluster. Disabling this endpoint disables RDS Data API.

Link copied to clipboard

Downloads all or a portion of the specified log file, up to 1 MB in size.

Link copied to clipboard

Enables the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled.

Link copied to clipboard

Forces a failover for a DB cluster.

Link copied to clipboard

Promotes the specified secondary DB cluster to be the primary DB cluster in the global database cluster to fail over or switch over a global database. Switchover operations were previously called "managed planned failovers."

Link copied to clipboard

Lists all tags on an Amazon RDS resource.

Link copied to clipboard

Changes the audit policy state of a database activity stream to either locked (default) or unlocked. A locked policy is read-only, whereas an unlocked policy is read/write. If your activity stream is started and locked, you can unlock it, customize your audit policy, and then lock your activity stream. Restarting the activity stream isn't required. For more information, see Modifying a database activity stream in the Amazon RDS User Guide.

Link copied to clipboard

Override the system-default Secure Sockets Layer/Transport Layer Security (SSL/TLS) certificate for Amazon RDS for new DB instances, or remove the override.

Link copied to clipboard

Set the capacity of an Aurora Serverless v1 DB cluster to a specific value.

Link copied to clipboard

Modifies the status of a custom engine version (CEV). You can find CEVs to modify by calling DescribeDBEngineVersions.

Link copied to clipboard

Modifies the settings of an Amazon Aurora DB cluster or a Multi-AZ DB cluster. You can change one or more settings by specifying these parameters and the new values in the request.

Link copied to clipboard

Modifies the properties of an endpoint in an Amazon Aurora DB cluster.

Link copied to clipboard

Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Link copied to clipboard

Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.

Link copied to clipboard

Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call DescribeValidDBInstanceModifications before you call ModifyDBInstance.

Link copied to clipboard

Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Link copied to clipboard
inline suspend fun RdsClient.modifyDbProxy(crossinline block: ModifyDbProxyRequest.Builder.() -> Unit): ModifyDbProxyResponse

Changes the settings for an existing DB proxy.

Link copied to clipboard

Changes the settings for an existing DB proxy endpoint.

Link copied to clipboard

Modifies the properties of a DBProxyTargetGroup.

Link copied to clipboard

Updates the recommendation status and recommended action status for the specified recommendation.

Link copied to clipboard

Modifies the settings of an Aurora Limitless Database DB shard group. You can change one or more settings by specifying these parameters and the new values in the request.

Link copied to clipboard

Updates a manual DB snapshot with a new engine version. The snapshot can be encrypted or unencrypted, but not shared or public.

Link copied to clipboard

Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.

Link copied to clipboard

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Web Services Region.

Link copied to clipboard

Modifies an existing RDS event notification subscription. You can't modify the source identifiers using this call. To change source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

Link copied to clipboard

Modifies a setting for an Amazon Aurora global database cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.

Link copied to clipboard

Modifies a zero-ETL integration with Amazon Redshift.

Link copied to clipboard

Modifies an existing option group.

Link copied to clipboard

Modifies an existing tenant database in a DB instance. You can change the tenant database name or the master user password. This operation is supported only for RDS for Oracle CDB instances using the multi-tenant configuration.

Link copied to clipboard

Promotes a read replica DB instance to a standalone DB instance.

Link copied to clipboard

Promotes a read replica DB cluster to a standalone DB cluster.

Link copied to clipboard
Link copied to clipboard

You might need to reboot your DB cluster, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB cluster parameter group associated with the DB cluster, reboot the DB cluster for the changes to take effect.

Link copied to clipboard

You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.

Link copied to clipboard

You might need to reboot your DB shard group, usually for maintenance reasons. For example, if you make certain modifications, reboot the DB shard group for the changes to take effect.

Link copied to clipboard

Associate one or more DBProxyTarget data structures with a DBProxyTargetGroup.

Link copied to clipboard

Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary cluster in a different Region.

Link copied to clipboard

Removes the asssociation of an Amazon Web Services Identity and Access Management (IAM) role from a DB cluster.

Link copied to clipboard

Disassociates an Amazon Web Services Identity and Access Management (IAM) role from a DB instance.

Link copied to clipboard

Removes a source identifier from an existing RDS event notification subscription.

Link copied to clipboard

Removes metadata tags from an Amazon RDS resource.

Link copied to clipboard

Modifies the parameters of a DB cluster parameter group to the default value. To reset specific parameters submit a list of the following: ParameterName and ApplyMethod. To reset the entire DB cluster parameter group, specify the DBClusterParameterGroupName and ResetAllParameters parameters.

Link copied to clipboard

Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters, provide a list of the following: ParameterName and ApplyMethod. To reset the entire DB parameter group, specify the DBParameterGroup name and ResetAllParameters parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request.

Link copied to clipboard

Creates an Amazon Aurora DB cluster from MySQL data stored in an Amazon S3 bucket. Amazon RDS must be authorized to access the Amazon S3 bucket and the data must be created using the Percona XtraBackup utility as described in Migrating Data from MySQL by Using an Amazon S3 Bucket in the Amazon Aurora User Guide.

Link copied to clipboard

Creates a new DB cluster from a DB snapshot or DB cluster snapshot.

Link copied to clipboard

Restores a DB cluster to an arbitrary point in time. Users can restore to any point in time before LatestRestorableTime for up to BackupRetentionPeriod days. The target DB cluster is created from the source DB cluster with the same configuration as the original DB cluster, except that the new DB cluster is created with the default DB security group. Unless the RestoreType is set to copy-on-write, the restore may occur in a different Availability Zone (AZ) from the original DB cluster. The AZ where RDS restores the DB cluster depends on the AZs in the specified subnet group.

Link copied to clipboard

Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with most of the source's original configuration, including the default security group and DB parameter group. By default, the new DB instance is created as a Single-AZ deployment, except when the instance is a SQL Server instance that has an option group associated with mirroring. In this case, the instance becomes a Multi-AZ deployment, not a Single-AZ deployment.

Link copied to clipboard

Amazon Relational Database Service (Amazon RDS) supports importing MySQL databases by using backup files. You can create a backup of your on-premises database, store it on Amazon Simple Storage Service (Amazon S3), and then restore the backup file onto a new Amazon RDS DB instance running MySQL. For more information, see Importing Data into an Amazon RDS MySQL DB Instance in the Amazon RDS User Guide.

Link copied to clipboard

Restores a DB instance to an arbitrary point in time. You can restore to any point in time before the time identified by the LatestRestorableTime property. You can restore to a point up to the number of days specified by the BackupRetentionPeriod property.

Link copied to clipboard

Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC security groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId).

Link copied to clipboard

Starts a database activity stream to monitor activity on the database. For more information, see Monitoring Amazon Aurora with Database Activity Streams in the Amazon Aurora User Guide or Monitoring Amazon RDS with Database Activity Streams in the Amazon RDS User Guide.

Link copied to clipboard

Starts an Amazon Aurora DB cluster that was stopped using the Amazon Web Services console, the stop-db-cluster CLI command, or the StopDBCluster operation.

Link copied to clipboard

Starts an Amazon RDS DB instance that was stopped using the Amazon Web Services console, the stop-db-instance CLI command, or the StopDBInstance operation.

Enables replication of automated backups to a different Amazon Web Services Region.

Link copied to clipboard

Starts an export of DB snapshot or DB cluster data to Amazon S3. The provided IAM role must have access to the S3 bucket.

Link copied to clipboard

Stops a database activity stream that was started using the Amazon Web Services console, the start-activity-stream CLI command, or the StartActivityStream operation.

Link copied to clipboard
inline suspend fun RdsClient.stopDbCluster(crossinline block: StopDbClusterRequest.Builder.() -> Unit): StopDbClusterResponse

Stops an Amazon Aurora DB cluster. When you stop a DB cluster, Aurora retains the DB cluster's metadata, including its endpoints and DB parameter groups. Aurora also retains the transaction logs so you can do a point-in-time restore if necessary.

Link copied to clipboard

Stops an Amazon RDS DB instance temporarily. When you stop a DB instance, Amazon RDS retains the DB instance's metadata, including its endpoint, DB parameter group, and option group membership. Amazon RDS also retains the transaction logs so you can do a point-in-time restore if necessary. The instance restarts automatically after 7 days.

Link copied to clipboard

Switches over a blue/green deployment.

Link copied to clipboard

Switches over the specified secondary DB cluster to be the new primary DB cluster in the global database cluster. Switchover operations were previously called "managed planned failovers."

Link copied to clipboard

Switches over an Oracle standby database in an Oracle Data Guard environment, making it the new primary database. Issue this command in the Region that hosts the current standby database.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.