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.

Creates a new DB instance.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateDBInstanceAsync.

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

Syntax

C#
public abstract CreateDBInstanceResponse CreateDBInstance(
         CreateDBInstanceRequest request
)

Parameters

request
Type: Amazon.Neptune.Model.CreateDBInstanceRequest

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

Return Value


The response from the CreateDBInstance service method, as returned by Neptune.

Exceptions

ExceptionCondition
AuthorizationNotFoundException Specified CIDRIP or EC2 security group is not authorized for the specified DB security group. Neptune may not also be authorized via IAM to perform necessary actions on your behalf.
DBClusterNotFoundException DBClusterIdentifier does not refer to an existing DB cluster.
DBInstanceAlreadyExistsException User already has a DB instance with the given identifier.
DBParameterGroupNotFoundException DBParameterGroupName does not refer to an existing DB parameter group.
DBSecurityGroupNotFoundException DBSecurityGroupName does not refer to an existing DB security group.
DBSubnetGroupDoesNotCoverEnoughAZsException Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
DBSubnetGroupNotFoundException DBSubnetGroupName does not refer to an existing DB subnet group.
DomainNotFoundException Domain does not refer to an existing Active Directory Domain.
InstanceQuotaExceededException Request would result in user exceeding the allowed number of DB instances.
InsufficientDBInstanceCapacityException Specified DB instance class is not available in the specified Availability Zone.
InvalidDBClusterStateException The DB cluster is not in a valid state.
InvalidSubnetException The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.
InvalidVPCNetworkStateException DB subnet group does not cover all Availability Zones after it is created because users' change.
KMSKeyNotAccessibleException Error accessing KMS key.
OptionGroupNotFoundException The designated option group could not be found.
ProvisionedIopsNotAvailableInAZException Provisioned IOPS not available in the specified Availability Zone.
StorageQuotaExceededException Request would result in user exceeding the allowed amount of storage available across all DB instances.
StorageTypeNotSupportedException StorageType specified cannot be associated with the DB Instance.

Examples

This example creates a DB instance.

To create a DB instance.


var response = client.CreateDBInstance(new CreateDBInstanceRequest 
{
    AllocatedStorage = 5,
    DBInstanceClass = "db.t2.micro",
    DBInstanceIdentifier = "mymysqlinstance",
    Engine = "MySQL",
    MasterUserPassword = "MyPassword",
    MasterUsername = "MyUser"
});

DBInstance dbInstance = response.DBInstance;

            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also