Exemples d’utilisation de l’AWS CLI avec AWS DMS - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec AWS DMS

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec AWS DMS.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser add-tags-to-resource.

AWS CLI

Pour ajouter des balises à une ressource

L’exemple add-tags-to-resource suivant ajoute des balises à une instance de réplication.

aws dms add-tags-to-resource \
    --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --tags Key=Environment,Value=PROD Key=Project,Value=dbMigration

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage des ressources dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez AddTagsToResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-endpoint.

AWS CLI

Pour créer un point de terminaison

L’exemple create-endpoint suivant crée un point de terminaison pour une source Amazon S3.

aws dms create-endpoint \
    --endpoint-type source \
    --engine-name s3 \
    --endpoint-identifier src-endpoint \
    --s3-settings file://s3-settings.json

Contenu de s3-settings.json :

{
    "BucketName":"my-corp-data",
    "BucketFolder":"sourcedata",
    "ServiceAccessRoleArn":"arn:aws:iam::123456789012:role/my-s3-access-role"
}

Sortie :

{
    "Endpoint": {
        "EndpointIdentifier": "src-endpoint",
        "EndpointType": "SOURCE",
        "EngineName": "s3",
        "EngineDisplayName": "Amazon S3",
        "ExtraConnectionAttributes": "bucketFolder=sourcedata;bucketName=my-corp-data;compressionType=NONE;csvDelimiter=,;csvRowDelimiter=\\n;",
        "Status": "active",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U",
        "SslMode": "none",
        "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
        "S3Settings": {
            "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
            "CsvRowDelimiter": "\\n",
            "CsvDelimiter": ",",
            "BucketFolder": "sourcedata",
            "BucketName": "my-corp-data",
            "CompressionType": "NONE",
            "EnableStatistics": true
        }
    }
}

Pour plus d’informations, consultez Utilisation des points de terminaison AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez CreateEndpoint dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-event-subscription.

AWS CLI

Pour répertorier les abonnements aux événements

L’exemple create-event-subscription suivant crée un abonnement aux événements d’une rubrique Amazon SNS (my-sns-topic).

aws dms create-event-subscription \
    --subscription-name my-dms-events \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:my-sns-topic

Sortie :

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "my-dms-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
        "Status": "creating",
        "SubscriptionCreationTime": "2020-05-21 21:58:38.598",
        "Enabled": true
    }
}

Pour plus d’informations, consultez Utilisation d’événements et notifications dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez CreateEventSubscription dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-replication-instance.

AWS CLI

Pour créer une instance de réplication

L’exemple create-replication-instance suivant crée une instance de réplication.

aws dms create-replication-instance \
    --replication-instance-identifier my-repl-instance \
    --replication-instance-class dms.t2.micro \
    --allocated-storage 5

Sortie :

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "creating",
        "AllocatedStorage": 5,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-f839b688",
                "Status": "active"
            }
        ],
        "ReplicationSubnetGroup": {
            "ReplicationSubnetGroupIdentifier": "default",
            "ReplicationSubnetGroupDescription": "default",
            "VpcId": "vpc-136a4c6a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-da327bf6",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-42599426",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1d"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-bac383e0",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-6746046b",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1f"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-d7c825e8",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1e"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-cbfff283",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sat:12:35-sat:13:05",
        "PendingModifiedValues": {},
        "MultiAZ": false,
        "EngineVersion": "3.3.2",
        "AutoMinorVersionUpgrade": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:ZK2VQBUWFDBAWHIXHAYG5G2PKY",
        "PubliclyAccessible": true
    }
}

Pour plus d’informations, consultez Utilisation d’une instance de réplication AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser create-replication-subnet-group.

AWS CLI

Pour créer un groupe de sous-réseaux

L’exemple create-replication-subnet-group suivant crée un groupe composé de trois sous-réseaux.

aws dms create-replication-subnet-group \
    --replication-subnet-group-identifier my-subnet-group \
    --replication-subnet-group-description "my subnet group" \
    --subnet-ids subnet-da327bf6 subnet-bac383e0 subnet-d7c825e8

Sortie :

{
    "ReplicationSubnetGroup": {
        "ReplicationSubnetGroupIdentifier": "my-subnet-group",
        "ReplicationSubnetGroupDescription": "my subnet group",
        "VpcId": "vpc-136a4c6a",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-da327bf6",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1a"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-bac383e0",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1c"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-d7c825e8",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1e"
                },
                "SubnetStatus": "Active"
            }
        ]
    }
}

Pour plus d’informations, consultez Configuration d’un réseau pour une instance de réplication dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser create-replication-task.

AWS CLI

Pour créer une tâche de réplication

L’exemple create-replication-task suivant crée une tâche de réplication.

aws dms create-replication-task \
    --replication-task-identifier movedata \
    --source-endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA \
    --target-endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U \
    --replication-instance-arn $RI_ARN \
    --migration-type full-load \
    --table-mappings file://table-mappings.json

Contenu de table-mappings.json :

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "prodrep",
                "table-name": "%"
            },
            "rule-action": "include",
            "filters": []
        }
    ]
}

Sortie :

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted... ,
        "ReplicationTaskSettings": ...output omitted... ,
        "Status": "creating",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

Pour plus d’informations, consultez Utilisation de tâches AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez CreateReplicationTask dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-connection.

AWS CLI

Pour supprimer une connexion

L’exemple delete-connection suivant dissocie un point de terminaison d’une instance de réplication.

aws dms delete-connection \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

Sortie :

{
    "Connection": {
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "Status": "deleting",
        "EndpointIdentifier": "src-database-1",
        "ReplicationInstanceIdentifier": "my-repl-instance"
    }
}

Pour plus d’informations, consultez https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DeleteConnection dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-endpoint.

AWS CLI

Pour supprimer un point de terminaison

L’exemple delete-endpoint suivant supprime un point de terminaison.

aws dms delete-endpoint \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y

Sortie :

{
    "Endpoint": {
        "EndpointIdentifier": "src-endpoint",
        "EndpointType": "SOURCE",
        "EngineName": "s3",
        "EngineDisplayName": "Amazon S3",
        "ExtraConnectionAttributes": "bucketFolder=sourcedata;bucketName=my-corp-data;compressionType=NONE;csvDelimiter=,;csvRowDelimiter=\\n;",
        "Status": "deleting",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y",
        "SslMode": "none",
        "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
        "S3Settings": {
            "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
            "CsvRowDelimiter": "\\n",
            "CsvDelimiter": ",",
            "BucketFolder": "sourcedata",
            "BucketName": "my-corp-data",
            "CompressionType": "NONE",
            "EnableStatistics": true
        }
    }
}

Pour plus d’informations, consultez Utilisation des points de terminaison AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DeleteEndpoint dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-event-subscription.

AWS CLI

Pour supprimer un abonnement à un événement

L’exemple delete-event-subscription suivant supprime un abonnement à une rubrique Amazon SNS.

aws dms delete-event-subscription \
    --subscription-name "my-dms-events"

Sortie :

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "my-dms-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
        "Status": "deleting",
        "SubscriptionCreationTime": "2020-05-21 21:58:38.598",
        "Enabled": true
    }
}

Pour plus d’informations, consultez Utilisation d’événements et notifications dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DeleteEventSubscription dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-replication-instance.

AWS CLI

Pour supprimer une instance de réplication

L’exemple de delete-replication-instance suivant supprime une instance de réplication.

aws dms delete-replication-instance \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

Sortie :

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "deleting",
        "AllocatedStorage": 5,
        "InstanceCreateTime": 1590011235.952,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-f839b688",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1e",
        "ReplicationSubnetGroup": {
            "ReplicationSubnetGroupIdentifier": "default",
            "ReplicationSubnetGroupDescription": "default",
            "VpcId": "vpc-136a4c6a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-da327bf6",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-42599426",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1d"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-bac383e0",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-6746046b",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1f"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-d7c825e8",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1e"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-cbfff283",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "wed:11:42-wed:12:12",
        "PendingModifiedValues": {},
        "MultiAZ": true,
        "EngineVersion": "3.3.2",
        "AutoMinorVersionUpgrade": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "ReplicationInstancePublicIpAddress": "54.225.120.92",
        "ReplicationInstancePrivateIpAddress": "172.31.30.121",
        "ReplicationInstancePublicIpAddresses": [
            "54.225.120.92",
            "3.230.18.248"
        ],
        "ReplicationInstancePrivateIpAddresses": [
            "172.31.30.121",
            "172.31.75.90"
        ],
        "PubliclyAccessible": true,
        "SecondaryAvailabilityZone": "us-east-1b"
    }
}

Pour plus d’informations, consultez Utilisation d’une instance de réplication AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser delete-replication-subnet-group.

AWS CLI

Pour supprimer un groupe de sous-réseaux

L’exemple delete-replication-subnet-group suivant supprime un groupe de sous-réseaux.

aws dms delete-replication-subnet-group \
--replication-subnet-group-identifier my-subnet-group

Sortie :

(none)

Pour plus d’informations, consultez Configuration d’un réseau pour une instance de réplication dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser delete-replication-task.

AWS CLI

Pour supprimer une tâche de réplication

L’exemple delete-replication-task suivant supprime une tâche de réplication.

aws dms delete-replication-task \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII

Sortie :

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "deleting",
        "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789988.677,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

Pour plus d’informations, consultez Utilisation de tâches AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DeleteReplicationTask dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-account-attributes.

AWS CLI

Pour décrire les attributs d’un compte

L’exemple describe-account-attributes suivant répertorie les attributs de votre compte AWS.

aws dms describe-account-attributes

Sortie :

{
    "AccountQuotas": [
        {
            "AccountQuotaName": "ReplicationInstances",
            "Used": 1,
            "Max": 20
        },
        {
            "AccountQuotaName": "AllocatedStorage",
            "Used": 5,
            "Max": 10000
        },

        ...remaining output omitted...

    ],
    "UniqueAccountIdentifier": "cqahfbfy5xee"
}

L’exemple de code suivant montre comment utiliser describe-certificates.

AWS CLI

Pour répertorier les certificats disponibles

L’exemple describe-certificates suivant répertorie les certificats disponibles dans votre compte AWS.

aws dms describe-certificates

Sortie :

{
    "Certificates": [
        {
            "CertificateIdentifier": "my-cert",
            "CertificateCreationDate": 1543259542.506,
            "CertificatePem": "-----BEGIN CERTIFICATE-----\nMIID9DCCAtygAwIBAgIBQjANBgkqhkiG9w0BAQ ...U"

            ... remaining output omittted ...

        }
    ]
}

Pour plus d’informations, consultez Utilisation de SSL dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeCertificates dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-connections.

AWS CLI

Pour décrire des connexions

L’exemple describe-connections suivant répertorie les connexions que vous avez testées entre une instance de réplication et un point de terminaison.

aws dms describe-connections

Sortie :

{
    "Connections": [
        {
            "Status": "successful",
            "ReplicationInstanceIdentifier": "test",
            "EndpointArn": "arn:aws:dms:us-east-arn:aws:dms:us-east-1:123456789012:endpoint:ZW5UAN6P4E77EC7YWHK4RZZ3BE",
            "EndpointIdentifier": "testsrc1",
            "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ"
        }
    ]
}

Pour plus d’informations, consultez Création de points de terminaison source et cible dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeConnections dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-endpoint-types.

AWS CLI

Pour répertorier les types de point de terminaison disponibles

L’exemple describe-endpoint-types suivant répertorie les types de points de terminaison MySQL disponibles.

aws dms describe-endpoint-types \
    --filters "Name=engine-name,Values=mysql"

Sortie :

{
    "SupportedEndpointTypes": [
        {
            "EngineName": "mysql",
            "SupportsCDC": true,
            "EndpointType": "source",
            "EngineDisplayName": "MySQL"
        },
        {
            "EngineName": "mysql",
            "SupportsCDC": true,
            "EndpointType": "target",
            "EngineDisplayName": "MySQL"
        }
    ]
}

Pour plus d’informations, consultez Utilisation des points de terminaison AWS DMS <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html>`__ dans le Guide de l’utilisateur Database AWS Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeEndpointTypes dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-endpoints.

AWS CLI

Pour décrire les points de terminaison

L’exemple describe-endpoints suivant répertorie les points de terminaison dans votre compte AWS.

aws dms describe-endpoints

Sortie :

{
    "Endpoints": [
        {
            "Username": "dms",
            "Status": "active",
            "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:SF2WOFLWYWKVEOHID2EKLP3SJI",
            "ServerName": "ec2-52-32-48-61.us-west-2.compute.amazonaws.com",
            "EndpointType": "SOURCE",
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/94d5c4e7-4e4c-44be-b58a-c8da7adf57cd",
            "DatabaseName": "test",
            "EngineName": "mysql",
            "EndpointIdentifier": "pri100",
            "Port": 8193
        },
        {
            "Username": "admin",
            "Status": "active",
            "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:TJJZCIH3CJ24TJRU4VC32WEWFR",
            "ServerName": "test.example.com",
            "EndpointType": "SOURCE",
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/2431021b-1cf2-a2d4-77b2-59a9e4bce323",
            "DatabaseName": "EMPL",
            "EngineName": "oracle",
            "EndpointIdentifier": "test",
            "Port": 1521
        }
    ]
}

Pour plus d’informations, consultez Utilisation des points de terminaison AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeEndpoints dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-event-categories.

AWS CLI

Pour décrire les catégories d’événements

L’exemple describe-event-categories suivant répertorie les catégories d’événements disponibles.

aws dms describe-event-categories

Sortie :

{
    "EventCategoryGroupList": [
        {
            "SourceType": "replication-instance",
            "EventCategories": [
                "low storage",
                "configuration change",
                "maintenance",
                "deletion",
                "creation",
                "failover",
                "failure"
            ]
        },
        {
            "SourceType": "replication-task",
            "EventCategories": [
                "configuration change",
                "state change",
                "deletion",
                "creation",
                "failure"
            ]
        }
    ]
}

Pour plus d’informations, consultez Utilisation d’événements et notifications dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeEventCategories dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-event-subscriptions.

AWS CLI

Pour décrire les abonnements aux événements

L’exemple describe-event-subscriptions suivant répertorie les abonnements aux événements d’une rubrique Amazon SNS.

aws dms describe-event-subscriptions

Sortie :

{
    "EventSubscriptionsList": [
        {
            "CustomerAwsId": "123456789012",
            "CustSubscriptionId": "my-dms-events",
            "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
            "Status": "deleting",
            "SubscriptionCreationTime": "2020-05-21 22:28:51.924",
            "Enabled": true
        }
    ]
}

Pour plus d’informations, consultez Utilisation d’événements et notifications dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser describe-events.

AWS CLI

Pour répertorier les événements DMS

L’exemple describe-events suivant répertorie les événements issus d’une instance de réplication.

aws dms describe-events \
    --source-type "replication-instance"

Sortie :

{
    "Events": [
        {
            "SourceIdentifier": "my-repl-instance",
            "SourceType": "replication-instance",
            "Message": "Replication application shutdown",
            "EventCategories": [],
            "Date": 1590771645.776
        }
    ]
}

Pour plus d’informations, consultez Utilisation d’événements et notifications dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeEvents dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-orderable-replication-instances.

AWS CLI

Pour décrire les instances de réplication organisables

L’exemple describe-orderable-replication-instances suivant répertorie les types d’instances de réplication que vous pouvez organiser.

aws dms describe-orderable-replication-instances

Sortie :

{
    "OrderableReplicationInstances": [
        {
            "EngineVersion": "3.3.2",
            "ReplicationInstanceClass": "dms.c4.2xlarge",
            "StorageType": "gp2",
            "MinAllocatedStorage": 5,
            "MaxAllocatedStorage": 6144,
            "DefaultAllocatedStorage": 100,
            "IncludedAllocatedStorage": 100,
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
                "us-east-1f"
            ]
        },
        {
            "EngineVersion": "3.3.2",
            "ReplicationInstanceClass": "dms.c4.4xlarge",
            "StorageType": "gp2",
            "MinAllocatedStorage": 5,
            "MaxAllocatedStorage": 6144,
            "DefaultAllocatedStorage": 100,
            "IncludedAllocatedStorage": 100,
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
                "us-east-1f"
            ]
        },

        ...remaining output omitted...

    }

Pour plus d’informations, consultez Utilisation d’une instance de réplication AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser describe-refresh-schemas-status.

AWS CLI

Pour répertorier le statut d’actualisation d’un point de terminaison

L’exemple describe-refresh-schemas-status suivant renvoie le statut d’une demande d’actualisation précédente.

aws dms describe-refresh-schemas-status \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA

Sortie :

{
    "RefreshSchemasStatus": {
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "Status": "successful",
        "LastRefreshDate": 1590786544.605
    }
}

L’exemple de code suivant montre comment utiliser describe-replication-instances.

AWS CLI

Pour décrire les instances de réplication

L’exemple describe-replication-instances suivant répertorie les instances de réplication dans votre compte AWS.

aws dms describe-replication-instances

Sortie :

{
    "ReplicationInstances": [
        {
            "ReplicationInstanceIdentifier": "my-repl-instance",
            "ReplicationInstanceClass": "dms.t2.micro",
            "ReplicationInstanceStatus": "available",
            "AllocatedStorage": 5,
            "InstanceCreateTime": 1590011235.952,
            "VpcSecurityGroups": [
                {
                    "VpcSecurityGroupId": "sg-f839b688",
                    "Status": "active"
                }
            ],
            "AvailabilityZone": "us-east-1e",
            "ReplicationSubnetGroup": {
                "ReplicationSubnetGroupIdentifier": "default",
                "ReplicationSubnetGroupDescription": "default",
                "VpcId": "vpc-136a4c6a",
                "SubnetGroupStatus": "Complete",
                "Subnets": [
                    {
                        "SubnetIdentifier": "subnet-da327bf6",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1a"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-42599426",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1d"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-bac383e0",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1c"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-6746046b",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1f"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-d7c825e8",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1e"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-cbfff283",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1b"
                        },
                        "SubnetStatus": "Active"
                    }
                ]
            },
            "PreferredMaintenanceWindow": "wed:11:42-wed:12:12",
            "PendingModifiedValues": {
                "MultiAZ": true
            },
            "MultiAZ": false,
            "EngineVersion": "3.3.2",
            "AutoMinorVersionUpgrade": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",
            "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
            "ReplicationInstancePublicIpAddress": "3.230.18.248",
            "ReplicationInstancePrivateIpAddress": "172.31.75.90",
            "ReplicationInstancePublicIpAddresses": [
                "3.230.18.248"
            ],
            "ReplicationInstancePrivateIpAddresses": [
                "172.31.75.90"
            ],
            "PubliclyAccessible": true,
            "FreeUntil": 1590194829.267
        }
    ]
}

Pour plus d’informations, consultez Utilisation d’une instance de réplication AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser describe-replication-subnet-groups.

AWS CLI

Pour afficher les groupes de sous-réseaux disponibles

L’exemple describe-replication-subnet-groups suivant répertorie les groupes de sous-réseaux disponibles.

aws dms describe-replication-subnet-groups \
    --filter "Name=replication-subnet-group-id,Values=my-subnet-group"

Sortie :

{
    "ReplicationSubnetGroups": [
        {
            "ReplicationSubnetGroupIdentifier": "my-subnet-group",
            "ReplicationSubnetGroupDescription": "my subnet group",
            "VpcId": "vpc-136a4c6a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-da327bf6",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-bac383e0",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-d7c825e8",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1e"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        }
    ]
}

Pour plus d’informations, consultez Configuration d’un réseau pour une instance de réplication dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser describe-replication-task-assessment-results.

AWS CLI

Pour répertorier les résultats des évaluations des tâches de réplication

L’exemple describe-replication-task-assessment-results suivant répertorie les résultats d’évaluation d’une tâche précédente.

aws dms describe-replication-task-assessment-results

Sortie :

{
    "ReplicationTaskAssessmentResults": [
        {
            "ReplicationTaskIdentifier": "moveit2",
            "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII",
            "ReplicationTaskLastAssessmentDate": 1590790230.0,
            "AssessmentStatus": "No issues found",
            "AssessmentResultsFile": "moveit2/2020-05-29-22-10"
        }
    ]
}

Pour plus d’informations, consultez Création d’un rapport d’évaluation de tâche dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser describe-replication-tasks.

AWS CLI

Pour décrire une tâche de réplication

L’exemple describe-replication-tasks suivant décrit les tâches de réplication actuelles.

aws dms describe-replication-tasks

Sortie :

{
    "ReplicationTasks": [
        {
            "ReplicationTaskIdentifier": "moveit2",
            "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
            "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
            "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
            "MigrationType": "full-load",
            "TableMappings": ...output omitted... ,
            "ReplicationTaskSettings": ...output omitted... ,
            "Status": "stopped",
            "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
            "ReplicationTaskCreationDate": 1590524772.505,
            "ReplicationTaskStartDate": 1590619805.212,
            "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII",
            "ReplicationTaskStats": {
                "FullLoadProgressPercent": 100,
                "ElapsedTimeMillis": 0,
                "TablesLoaded": 0,
                "TablesLoading": 0,
                "TablesQueued": 0,
                "TablesErrored": 0,
                "FreshStartDate": 1590619811.528,
                "StartDate": 1590619811.528,
                "StopDate": 1590619842.068
            }
        }
    ]
}

Pour plus d’informations, consultez Utilisation de tâches AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez DescribeReplicationTasks dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-schemas.

AWS CLI

Pour décrire les schémas de base de données

L’exemple describe-schemas suivant répertorie les tables disponibles à un point de terminaison.

aws dms describe-schemas \
    --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA"

Sortie :

{
    "Schemas": [
        "prodrep"
    ]
}

Pour plus d’informations, consultez cette rubrique dans le Guide de l’utilisateur AWS Database Migration.

  • Pour plus de détails sur l’API, consultez DescribeSchemas dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Pour répertorier les balises d’une ressource

L’exemple list-tags-for-resource suivant répertorie les balises d’une instance de réplication.

aws dms list-tags-for-resource \
    --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

Sortie :

{
    "TagList": [
        {
            "Key": "Project",
            "Value": "dbMigration"
        },
        {
            "Key": "Environment",
            "Value": "PROD"
        }
    ]
}

Pour plus d’informations, consultez Balisage des ressources dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser modify-endpoint.

AWS CLI

Pour modifier un point de terminaison

L’exemple modify-endpoint suivant ajoute un attribut de connexion supplémentaire à un point de terminaison.

aws dms modify-endpoint \
    --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U" \
    --extra-connection-attributes "compressionType=GZIP"

Sortie :

{
    "Endpoint": {
        "EndpointIdentifier": "src-endpoint",
        "EndpointType": "SOURCE",
        "EngineName": "s3",
        "EngineDisplayName": "Amazon S3",
        "ExtraConnectionAttributes": "compressionType=GZIP;csvDelimiter=,;csvRowDelimiter=\\n;",
        "Status": "active",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U",
        "SslMode": "none",
        "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
        "S3Settings": {
            "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
            "CsvRowDelimiter": "\\n",
            "CsvDelimiter": ",",
            "BucketFolder": "",
            "BucketName": "",
            "CompressionType": "GZIP",
            "EnableStatistics": true
        }
    }
}

Pour plus d’informations, consultez Utilisation des points de terminaison AWS DMS <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html>`__ dans le Guide de l’utilisateur Database AWS Migration Service.

  • Pour plus de détails sur l’API, consultez ModifyEndpoint dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser modify-event-subscription.

AWS CLI

Pour modifier un abonnement à un événement

L’exemple modify-event-subscription suivant modifie le type de source d’un abonnement à un événement.

aws dms modify-event-subscription \
    --subscription-name "my-dms-events" \
    --source-type replication-task

Sortie :

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "my-dms-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
        "Status": "modifying",
        "SubscriptionCreationTime": "2020-05-29 17:04:40.262",
        "SourceType": "replication-task",
        "Enabled": true
    }
}

Pour plus d’informations, consultez Utilisation d’événements et notifications dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez ModifyEventSubscription dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser modify-replication-instance.

AWS CLI

Pour modifier une instance de réplication

L’exemple modify-replication-instance suivant modifie une instance de réplication afin qu’elle utilise un déploiement multi-AZ.

aws dms modify-replication-instance \
     --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
     --multi-az

Sortie :

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "available",
        "AllocatedStorage": 5,
        "InstanceCreateTime": 1590011235.952,

        ...output omitted...

        "PendingModifiedValues": {
            "MultiAZ": true
        },
        "MultiAZ": false,
        "EngineVersion": "3.3.2",
        "AutoMinorVersionUpgrade": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",

        ...output omitted...

    }
}

Pour plus d’informations, consultez Utilisation d’une instance de réplication AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser modify-replication-subnet-group.

AWS CLI

Pour modifier un groupe de sous-réseaux

L’exemple modify-replication-subnet-group suivant modifie les listes de sous-réseaux associées à un groupe de sous-réseaux.

aws dms modify-replication-subnet-group \
    --replication-subnet-group-identifier my-subnet-group \
    --subnet-id subnet-da327bf6 subnet-bac383e0

Sortie :

{
    "ReplicationSubnetGroup": {
        "ReplicationSubnetGroupIdentifier": "my-subnet-group",
        "ReplicationSubnetGroupDescription": "my subnet group",
        "VpcId": "vpc-136a4c6a",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-da327bf6",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1a"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-bac383e0",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1c"
                },
                "SubnetStatus": "Active"
            }
        ]
    }
}

Pour plus d’informations, consultez Configuration d’un réseau pour une instance de réplication dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser modify-replication-task.

AWS CLI

Pour modifier une tâche de réplication

L’exemplemodify-replication-task suivant modifie les mappages de tables pour une tâche.

aws dms modify-replication-task \
    --replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \
    --table-mappings file://table-mappings.json

Contenu de table-mappings.json :

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "prodrep",
                "table-name": "ACCT_%"
            },
            "rule-action": "include",
            "filters": []
        }
    ]
}

Sortie :

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "modifying",
        "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789424.653,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

Pour plus d’informations, consultez Utilisation de tâches AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez ModifyReplicationTask dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser reboot-replication-instance.

AWS CLI

Pour redémarrer une instance de réplication

L’exemple de reboot-replication-instance suivant redémarre une instance de réplication.

aws dms reboot-replication-instance \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

Sortie :

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "rebooting",
        "AllocatedStorage": 5,
        "InstanceCreateTime": 1590011235.952,
    ... output omitted ...
    }
}

Pour plus d’informations, consultez Utilisation d’une instance de réplication AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser refresh-schemas.

AWS CLI

Pour actualiser les schémas de base de données

L’exemple refresh-schemas suivant demande à AWS DMS d’actualiser la liste des schémas d’un point de terminaison.

aws dms refresh-schemas \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA"

Sortie :

{
    "RefreshSchemasStatus": {
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "Status": "refreshing",
        "LastRefreshDate": 1590019949.103
    }
}

  • Pour plus de détails sur l’API, consultez RefreshSchemas dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser reload-tables.

AWS CLI

Pour actualiser la liste des tables disponibles à un point de terminaison

L’exemple reload-tables suivant recharge la liste des tables disponibles à un point de terminaison.

aws dms reload-tables \
    --replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \
    --tables-to-reload "SchemaName=prodrep,TableName=ACCT_BAL"

Sortie :

{
    "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
}

  • Pour plus de détails sur l’API, consultez ReloadTables dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser remove-tags-from-resource.

AWS CLI

Pour supprimer des balises d’une instance de réplication

L’exemple remove-tags-from-resource suivant supprime les balises d’une instance de réplication.

aws dms remove-tags-from-resource \
    --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --tag-keys Environment Project

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage des ressources dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez RemoveTagsFromResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser start-replication-task-assessment.

AWS CLI

Pour lancer une évaluation des tâches

L’exemple start-replication-task-assessment suivant lance une évaluation des tâches de réplication.

aws dms start-replication-task-assessment \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII

Sortie :

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "testing",
        "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789988.677,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

Pour plus d’informations, consultez Création d’un rapport d’évaluation de tâche dans le Guide de l’utilisateur AWS Database Migration Service.

L’exemple de code suivant montre comment utiliser start-replication-task.

AWS CLI

Pour démarrer une tâche de réplication

L’exemple command-name suivant répertorie les widgets disponibles dans votre compte AWS.

aws dms start-replication-task \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII \
    --start-replication-task-type reload-target

Sortie :

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted... ,
        "ReplicationTaskSettings": ...output omitted... ,
        "Status": "starting",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590619805.212,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

Pour plus d’informations, consultez Utilisation de tâches AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez StartReplicationTask dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser stop-replication-task.

AWS CLI

Pour arrêter une tâche

L’exemple stop-replication-task suivant arrête une tâche.

aws dms stop-replication-task \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII

Sortie :

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "stopping",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789424.653,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

Pour plus d’informations, consultez Utilisation de tâches AWS DMS dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez StopReplicationTask dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser test-connection.

AWS CLI

Pour tester une connexion à un point de terminaison

L’exemple test-connection suivant teste si un point de terminaison est accessible depuis une instance de réplication.

aws dms test-connection \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA

Sortie :

{
    "Connection": {
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "Status": "testing",
        "EndpointIdentifier": "src-database-1",
        "ReplicationInstanceIdentifier": "my-repl-instance"
    }
}

Pour plus d’informations, consultez Création de points de terminaison source et cible dans le Guide de l’utilisateur AWS Database Migration Service.

  • Pour plus de détails sur l’API, consultez TestConnection dans la Référence des commandes de l’AWS CLI.