IAmazonDatabaseMigrationService.CreateEndpoint Method (CreateEndpointRequest)

Creates an endpoint using the provided settings.

For a MySQL source or target endpoint, don't explicitly specify the database using the DatabaseName request parameter on the CreateEndpoint API call. Specifying DatabaseName when you create a MySQL endpoint replicates all the task tables to this single database. For MySQL endpoints, you specify the database only when you specify the schema in the table-mapping rules of the DMS task.

Note:

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

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

Syntax

public abstract CreateEndpointResponse CreateEndpoint(
         CreateEndpointRequest request
)

Parameters

request: Type: Amazon.DatabaseMigrationService.Model.CreateEndpointRequest

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

Return Value

Type: CreateEndpointResponse

The response from the CreateEndpoint service method, as returned by DatabaseMigrationService.

Exceptions

Exception	Condition
AccessDeniedException	DMS was denied access to the endpoint. Check that the role is correctly configured.
InvalidResourceStateException	The resource is in a state that prevents it from being used for database migration.
KMSKeyNotAccessibleException	DMS cannot access the KMS key.
ResourceAlreadyExistsException	The resource you are attempting to create already exists.
ResourceNotFoundException	The resource could not be found.
ResourceQuotaExceededException	The quota for this resource quota has been exceeded.
S3AccessDeniedException	Insufficient privileges are preventing access to an Amazon S3 object.

Examples

Creates an endpoint using the provided settings.

Create endpoint


var client = new AmazonDatabaseMigrationServiceClient();
var response = client.CreateEndpoint(new CreateEndpointRequest 
{
    CertificateArn = "",
    DatabaseName = "testdb",
    EndpointIdentifier = "test-endpoint-1",
    EndpointType = "source",
    EngineName = "mysql",
    ExtraConnectionAttributes = "",
    KmsKeyId = "arn:aws:kms:us-east-1:123456789012:key/4c1731d6-5435-ed4d-be13-d53411a7cfbd",
    Password = "pasword",
    Port = 3306,
    ServerName = "mydb.cx1llnox7iyx.us-west-2.rds.amazonaws.com",
    SslMode = "require",
    Tags = new List<Tag> {
        new Tag {
            Key = "Acount",
            Value = "143327655"
        }
    },
    Username = "username"
});

Endpoint endpoint = response.Endpoint;

Version Information

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

IAmazonDatabaseMigrationService.CreateEndpoint (CreateEndpointRequest)

Method