AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginModifyDBInstance and EndModifyDBInstance.

Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<ModifyDBInstanceResponse> ModifyDBInstanceAsync(
         ModifyDBInstanceRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.RDS.Model.ModifyDBInstanceRequest

Container for the necessary parameters to execute the ModifyDBInstance service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the ModifyDBInstance service method, as returned by RDS.

Exceptions

ExceptionCondition
AuthorizationNotFoundException The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group. Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
BackupPolicyNotFoundException
CertificateNotFoundException CertificateIdentifier doesn't refer to an existing certificate.
DBInstanceAlreadyExistsException The user already has a DB instance with the given identifier.
DBInstanceNotFoundException DBInstanceIdentifier doesn't refer to an existing DB instance.
DBParameterGroupNotFoundException DBParameterGroupName doesn't refer to an existing DB parameter group.
DBSecurityGroupNotFoundException DBSecurityGroupName doesn't refer to an existing DB security group.
DBUpgradeDependencyFailureException The DB upgrade failed because a resource the DB depends on can't be modified.
DomainNotFoundException Domain doesn't refer to an existing Active Directory domain.
InsufficientDBInstanceCapacityException The specified DB instance class isn't available in the specified Availability Zone.
InvalidDBClusterStateException The requested operation can't be performed while the cluster is in this state.
InvalidDBInstanceStateException The DB instance isn't in a valid state.
InvalidDBSecurityGroupStateException The state of the DB security group doesn't allow deletion.
InvalidVPCNetworkStateException The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.
KMSKeyNotAccessibleException An error occurred accessing an Amazon Web Services KMS key.
NetworkTypeNotSupportedException The network type is invalid for the DB instance. Valid nework type values are IPV4 and DUAL.
OptionGroupNotFoundException The specified option group could not be found.
ProvisionedIopsNotAvailableInAZException Provisioned IOPS not available in the specified Availability Zone.
StorageQuotaExceededException The request would result in the user exceeding the allowed amount of storage available across all DB instances.
StorageTypeNotSupportedException The specified StorageType can't be associated with the DB instance.
TenantDatabaseQuotaExceededException You attempted to create more tenant databases than are permitted in your Amazon Web Services account.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also