# AWS DMS Exemplos do usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS DMS.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `add-tags-to-resource`
O código de exemplo a seguir mostra como usar `add-tags-to-resource`.
**AWS CLI**
**Para adicionar tags a um recurso**
O exemplo `add-tags-to-resource` a seguir adiciona tags a uma instância de replicação.
```
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
```
Este comando não produz saída.
Para ter mais informações, consulte [Marcação de recursos](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tagging.html) no *Guia do usuário do AWS Database Migration Service*.
+ Consulte detalhes da API em [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/add-tags-to-resource.html) na *Referência de comandos da AWS CLI*.
### `create-endpoint`
O código de exemplo a seguir mostra como usar `create-endpoint`.
**AWS CLI**
**Para criar um endpoint**
O exemplo `create-endpoint` a seguir cria um endpoint para uma origem do Amazon S3.
```
aws dms create-endpoint \
--endpoint-type source \
--engine-name s3 \
--endpoint-identifier src-endpoint \
--s3-settings file://s3-settings.json
```
Conteúdo de `s3-settings.json`:
```
{
"BucketName":"my-corp-data",
"BucketFolder":"sourcedata",
"ServiceAccessRoleArn":"arn:aws:iam::123456789012:role/my-s3-access-role"
}
```
Resultado:
```
{
"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
}
}
}
```
Para obter mais informações, consulte [Como trabalhar com endpoints do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [CreateEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-endpoint.html) na *Referência de comandos da AWS CLI*.
### `create-event-subscription`
O código de exemplo a seguir mostra como usar `create-event-subscription`.
**AWS CLI**
**Para listar assinaturas de eventos**
O exemplo `create-event-subscription` a seguir cria uma assinatura de evento para um tópico do 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
```
Resultado:
```
{
"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
}
}
```
Para obter mais informações, consulte [Como trabalhar com eventos e notificações](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) no *Guia do usuário do AWS Database Migration Service.*
+ Para ver detalhes da API, consulte [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-event-subscription.html) na *Referência de comandos da AWS CLI*.
### `create-replication-instance`
O código de exemplo a seguir mostra como usar `create-replication-instance`.
**AWS CLI**
**Para criar uma instância de replicação**
O exemplo `create-replication-instance` a seguir cria uma instância de replicação.
```
aws dms create-replication-instance \
--replication-instance-identifier my-repl-instance \
--replication-instance-class dms.t2.micro \
--allocated-storage 5
```
Resultado:
```
{
"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
}
}
```
Para obter mais informações, consulte [Trabalhar com uma instância de replicação do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [CreateReplicationInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-instance.html) na *Referência de comandos da AWS CLI*.
### `create-replication-subnet-group`
O código de exemplo a seguir mostra como usar `create-replication-subnet-group`.
**AWS CLI**
**Para criar um grupo de sub-redes**
O exemplo `create-replication-subnet-group` a seguir cria um grupo que consiste em 3 sub-redes.
```
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
```
Resultado:
```
{
"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"
}
]
}
}
```
Para obter mais informações, consulte [Configurar uma rede para uma instância de replicação](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [CreateReplicationSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-subnet-group.html) na *Referência de comandos da AWS CLI*.
### `create-replication-task`
O código de exemplo a seguir mostra como usar `create-replication-task`.
**AWS CLI**
**Para criar uma tarefa de replicação**
O exemplo `create-replication-task` a seguir cria uma tarefa de replicação.
```
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
```
Conteúdo 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": []
}
]
}
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Como trabalhar com tarefas do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [CreateReplicationTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/create-replication-task.html) na *Referência de comandos da AWS CLI*.
### `delete-connection`
O código de exemplo a seguir mostra como usar `delete-connection`.
**AWS CLI**
**Para excluir uma conexão**
O exemplo `delete-connection` a seguir dissocia um endpoint de uma instância de replicação.
```
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
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [https://docs.aws.amazon.com/dms/latest/userguide/CHAP\$1Endpoints.Creating.html](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-connection.html) na *Referência de comandos da AWS CLI*.
### `delete-endpoint`
O código de exemplo a seguir mostra como usar `delete-endpoint`.
**AWS CLI**
**Para excluir um endpoint**
O exemplo `delete-endpoint` a seguir exclui um endpoint.
```
aws dms delete-endpoint \
--endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y
```
Resultado:
```
{
"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
}
}
}
```
Para obter mais informações, consulte [Como trabalhar com endpoints do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DeleteEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-endpoint.html) na *Referência de comandos da AWS CLI*.
### `delete-event-subscription`
O código de exemplo a seguir mostra como usar `delete-event-subscription`.
**AWS CLI**
**Para excluir uma assinatura de evento**
O exemplo `delete-event-subscription` a seguir exclui uma assinatura de um tópico do Amazon SNS.
```
aws dms delete-event-subscription \
--subscription-name "my-dms-events"
```
Resultado:
```
{
"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
}
}
```
Para obter mais informações, consulte [Como trabalhar com eventos e notificações](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) no *Guia do usuário do AWS Database Migration Service.*
+ Para ver detalhes da API, consulte [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-event-subscription.html) na *Referência de comandos da AWS CLI*.
### `delete-replication-instance`
O código de exemplo a seguir mostra como usar `delete-replication-instance`.
**AWS CLI**
**Para excluir uma instância de replicação**
O exemplo da `delete-replication-instance` a seguir exclui uma instância de replicação.
```
aws dms delete-replication-instance \
--replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Trabalhar com uma instância de replicação do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DeleteReplicationInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-replication-instance.html) na *Referência de comandos da AWS CLI*.
### `delete-replication-subnet-group`
O código de exemplo a seguir mostra como usar `delete-replication-subnet-group`.
**AWS CLI**
**Para excluir um grupo de sub-redes**
O exemplo `delete-replication-subnet-group` a seguir exclui um grupo de sub-redes.
```
aws dms delete-replication-subnet-group \
--replication-subnet-group-identifier my-subnet-group
```
Resultado:
```
(none)
```
Para obter mais informações, consulte [Configurar uma rede para uma instância de replicação](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DeleteReplicationSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-replication-subnet-group.html) na *Referência de comandos da AWS CLI*.
### `delete-replication-task`
O código de exemplo a seguir mostra como usar `delete-replication-task`.
**AWS CLI**
**Para excluir uma tarefa de replicação**
O exemplo `delete-replication-task` a seguir exclui uma tarefa de replicação.
```
aws dms delete-replication-task \
--replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Como trabalhar com tarefas do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DeleteReplicationTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/delete-replication-task.html) na *Referência de comandos da AWS CLI*.
### `describe-account-attributes`
O código de exemplo a seguir mostra como usar `describe-account-attributes`.
**AWS CLI**
**Como descrever os atributos da conta**
O exemplo `describe-account-attributes` a seguir lista os atributos da sua conta da AWS.
```
aws dms describe-account-attributes
```
Resultado:
```
{
"AccountQuotas": [
{
"AccountQuotaName": "ReplicationInstances",
"Used": 1,
"Max": 20
},
{
"AccountQuotaName": "AllocatedStorage",
"Used": 5,
"Max": 10000
},
...remaining output omitted...
],
"UniqueAccountIdentifier": "cqahfbfy5xee"
}
```
+ Consulte detalhes da API em [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-account-attributes.html) na *Referência de comandos da AWS CLI*.
### `describe-certificates`
O código de exemplo a seguir mostra como usar `describe-certificates`.
**AWS CLI**
**Para listar os certificados disponíveis**
O exemplo `describe-certificates` a seguir lista os certificados disponíveis em sua conta da AWS.
```
aws dms describe-certificates
```
Resultado:
```
{
"Certificates": [
{
"CertificateIdentifier": "my-cert",
"CertificateCreationDate": 1543259542.506,
"CertificatePem": "-----BEGIN CERTIFICATE-----\nMIID9DCCAtygAwIBAgIBQjANBgkqhkiG9w0BAQ ...U"
... remaining output omittted ...
}
]
}
```
Para ter mais informações, consulte [Como usar o SSL](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Security.html#CHAP_Security.SSL) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-certificates.html) na *Referência de comandos da AWS CLI*.
### `describe-connections`
O código de exemplo a seguir mostra como usar `describe-connections`.
**AWS CLI**
**Para descrever conexões**
O exemplo `describe-connections` a seguir lista as conexões que você testou entre uma instância de replicação e um endpoint.
```
aws dms describe-connections
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Criação de endpoints de origem e destino](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-connections.html) na *Referência de comandos da AWS CLI*.
### `describe-endpoint-types`
O código de exemplo a seguir mostra como usar `describe-endpoint-types`.
**AWS CLI**
**Para listar os tipos de endpoint disponíveis**
O exemplo `describe-endpoint-types` a seguir lista os tipos de endpoint do MySQL que estão disponíveis.
```
aws dms describe-endpoint-types \
--filters "Name=engine-name,Values=mysql"
```
Resultado:
```
{
"SupportedEndpointTypes": [
{
"EngineName": "mysql",
"SupportsCDC": true,
"EndpointType": "source",
"EngineDisplayName": "MySQL"
},
{
"EngineName": "mysql",
"SupportsCDC": true,
"EndpointType": "target",
"EngineDisplayName": "MySQL"
}
]
}
```
Para obter mais informações, consulte Como trabalhar com endpoints do AWS DMS `\$1\$1 no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeEndpointTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-endpoint-types.html) na *Referência de comandos da AWS CLI*.
### `describe-endpoints`
O código de exemplo a seguir mostra como usar `describe-endpoints`.
**AWS CLI**
**Para descrever endpoints**
O exemplo `describe-endpoints` a seguir lista os endpoints em sua conta da AWS.
```
aws dms describe-endpoints
```
Resultado:
```
{
"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
}
]
}
```
Para obter mais informações, consulte [Como trabalhar com endpoints do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-endpoints.html) na *Referência de comandos da AWS CLI*.
### `describe-event-categories`
O código de exemplo a seguir mostra como usar `describe-event-categories`.
**AWS CLI**
**Para descrever categorias de eventos**
O exemplo `describe-event-categories` a seguir lista as categorias de eventos disponíveis.
```
aws dms describe-event-categories
```
Resultado:
```
{
"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"
]
}
]
}
```
Para obter mais informações, consulte [Como trabalhar com eventos e notificações](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) no *Guia do usuário do AWS Database Migration Service.*
+ Para ver detalhes da API, consulte [DescribeEventCategories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-event-categories.html) na *Referência de comandos da AWS CLI*.
### `describe-event-subscriptions`
O código de exemplo a seguir mostra como usar `describe-event-subscriptions`.
**AWS CLI**
**Para descrever assinaturas de eventos**
O exemplo `describe-event-subscriptions` a seguir lista as assinaturas para um evento para um tópico do Amazon SNS.
```
aws dms describe-event-subscriptions
```
Resultado:
```
{
"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
}
]
}
```
Para obter mais informações, consulte [Como trabalhar com eventos e notificações](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) no *Guia do usuário do AWS Database Migration Service.*
+ Para ver detalhes da API, consulte [DescribeEventSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-event-subscriptions.html) na *Referência de comandos da AWS CLI*.
### `describe-events`
O código de exemplo a seguir mostra como usar `describe-events`.
**AWS CLI**
**Para listar eventos do DMS**
O exemplo `describe-events` a seguir lista os eventos que se originaram de uma instância de replicação.
```
aws dms describe-events \
--source-type "replication-instance"
```
Resultado:
```
{
"Events": [
{
"SourceIdentifier": "my-repl-instance",
"SourceType": "replication-instance",
"Message": "Replication application shutdown",
"EventCategories": [],
"Date": 1590771645.776
}
]
}
```
Para obter mais informações, consulte [Como trabalhar com eventos e notificações](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) no *Guia do usuário do AWS Database Migration Service.*
+ Para ver detalhes da API, consulte [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-events.html) na *Referência de comandos da AWS CLI*.
### `describe-orderable-replication-instances`
O código de exemplo a seguir mostra como usar `describe-orderable-replication-instances`.
**AWS CLI**
**Para descrever instâncias de replicação solicitáveis**
O exemplo `describe-orderable-replication-instances` a seguir lista os tipos de instância de replicação que você pode solicitar.
```
aws dms describe-orderable-replication-instances
```
Resultado:
```
{
"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...
}
```
Para obter mais informações, consulte [Trabalhar com uma instância de replicação do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeOrderableReplicationInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-orderable-replication-instances.html) na *Referência de comandos da AWS CLI*.
### `describe-refresh-schemas-status`
O código de exemplo a seguir mostra como usar `describe-refresh-schemas-status`.
**AWS CLI**
**Para listar o status de atualização de um endpoint**
O exemplo `describe-refresh-schemas-status` a seguir retorna o status de uma solicitação de atualização anterior.
```
aws dms describe-refresh-schemas-status \
--endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA
```
Resultado:
```
{
"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
}
}
```
+ Para ver detalhes da API, consulte [DescribeRefreshSchemasStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-refresh-schemas-status.html) na *Referência de comandos da AWS CLI*.
### `describe-replication-instances`
O código de exemplo a seguir mostra como usar `describe-replication-instances`.
**AWS CLI**
**Para descrever instâncias de replicação**
O exemplo `describe-replication-instances` a seguir lista as instâncias de replicação na sua conta da AWS.
```
aws dms describe-replication-instances
```
Resultado:
```
{
"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
}
]
}
```
Para obter mais informações, consulte [Trabalhar com uma instância de replicação do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeReplicationInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-instances.html) na *Referência de comandos da AWS CLI*.
### `describe-replication-subnet-groups`
O código de exemplo a seguir mostra como usar `describe-replication-subnet-groups`.
**AWS CLI**
**Para exibir os grupos de sub-redes disponíveis**
O exemplo `describe-replication-subnet-groups` a seguir lista os grupos de sub-redes disponíveis.
```
aws dms describe-replication-subnet-groups \
--filter "Name=replication-subnet-group-id,Values=my-subnet-group"
```
Resultado:
```
{
"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"
}
]
}
]
}
```
Para obter mais informações, consulte [Configurar uma rede para uma instância de replicação](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeReplicationSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-subnet-groups.html) na *Referência de comandos da AWS CLI*.
### `describe-replication-task-assessment-results`
O código de exemplo a seguir mostra como usar `describe-replication-task-assessment-results`.
**AWS CLI**
**Para listar os resultados das avaliações de tarefas de replicação**
O exemplo `describe-replication-task-assessment-results` a seguir lista os resultados de uma avaliação anterior da tarefa.
```
aws dms describe-replication-task-assessment-results
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Criação de um relatório de avaliação de tarefas](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.AssessmentReport.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeReplicationTaskAssessmentResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-task-assessment-results.html) na *Referência de comandos da AWS CLI*.
### `describe-replication-tasks`
O código de exemplo a seguir mostra como usar `describe-replication-tasks`.
**AWS CLI**
**Para descrever uma tarefa de replicação**
O exemplo `describe-replication-tasks` a seguir descreve as tarefas de replicação atuais.
```
aws dms describe-replication-tasks
```
Resultado:
```
{
"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
}
}
]
}
```
Para obter mais informações, consulte [Como trabalhar com tarefas do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeReplicationTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-replication-tasks.html) na *Referência de comandos da AWS CLI*.
### `describe-schemas`
O código de exemplo a seguir mostra como usar `describe-schemas`.
**AWS CLI**
**Como descrever esquemas de banco de dados**
O exemplo `describe-schemas` a seguir lista as tabelas disponíveis em um endpoint.
```
aws dms describe-schemas \
--endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA"
```
Resultado:
```
{
"Schemas": [
"prodrep"
]
}
```
Para ter mais informações, consulte [Este é o título do tópico](https://link.to.the/topic/page) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [DescribeSchemas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/describe-schemas.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar as tags de um recurso**
O exemplo `list-tags-for-resource` a seguir lista as tags de uma instância de replicação.
```
aws dms list-tags-for-resource \
--resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE
```
Resultado:
```
{
"TagList": [
{
"Key": "Project",
"Value": "dbMigration"
},
{
"Key": "Environment",
"Value": "PROD"
}
]
}
```
Para ter mais informações, consulte [Marcação de recursos](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tagging.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `modify-endpoint`
O código de exemplo a seguir mostra como usar `modify-endpoint`.
**AWS CLI**
**Para modificar um endpoint**
O exemplo `modify-endpoint` a seguir adiciona um atributo de conexão adicional a um endpoint.
```
aws dms modify-endpoint \
--endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U" \
--extra-connection-attributes "compressionType=GZIP"
```
Resultado:
```
{
"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
}
}
}
```
Para obter mais informações, consulte Como trabalhar com endpoints do AWS DMS `\$1\$1 no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [ModifyEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-endpoint.html) na *Referência de comandos da AWS CLI*.
### `modify-event-subscription`
O código de exemplo a seguir mostra como usar `modify-event-subscription`.
**AWS CLI**
**Para modificar a assinatura de um evento**
O exemplo `modify-event-subscription` a seguir altera o tipo de origem de uma assinatura de evento.
```
aws dms modify-event-subscription \
--subscription-name "my-dms-events" \
--source-type replication-task
```
Resultado:
```
{
"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
}
}
```
Para obter mais informações, consulte [Como trabalhar com eventos e notificações](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Events.html) no *Guia do usuário do AWS Database Migration Service.*
+ Para ver detalhes da API, consulte [ModifyEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-event-subscription.html) na *Referência de comandos da AWS CLI*.
### `modify-replication-instance`
O código de exemplo a seguir mostra como usar `modify-replication-instance`.
**AWS CLI**
**Para modificar uma instância de replicação**
O exemplo `modify-replication-instance` a seguir modifica uma instância de replicação para que ela use uma implantação Multi-AZ.
```
aws dms modify-replication-instance \
--replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
--multi-az
```
Resultado:
```
{
"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...
}
}
```
Para obter mais informações, consulte [Trabalhar com uma instância de replicação do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [ModifyReplicationInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-replication-instance.html) na *Referência de comandos da AWS CLI*.
### `modify-replication-subnet-group`
O código de exemplo a seguir mostra como usar `modify-replication-subnet-group`.
**AWS CLI**
**Para modificar um grupo de sub-redes**
O exemplo `modify-replication-subnet-group` a seguir altera as listas de sub-redes associadas a um grupo de sub-redes.
```
aws dms modify-replication-subnet-group \
--replication-subnet-group-identifier my-subnet-group \
--subnet-id subnet-da327bf6 subnet-bac383e0
```
Resultado:
```
{
"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"
}
]
}
}
```
Para obter mais informações, consulte [Configurar uma rede para uma instância de replicação](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.VPC.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [ModifyReplicationSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-replication-subnet-group.html) na *Referência de comandos da AWS CLI*.
### `modify-replication-task`
O código de exemplo a seguir mostra como usar `modify-replication-task`.
**AWS CLI**
**Para modificar uma tarefa de replicação**
O exemplo `modify-replication-task` a seguir altera os mapeamentos de tabela de uma tarefa.
```
aws dms modify-replication-task \
--replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \
--table-mappings file://table-mappings.json
```
Conteúdo 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": []
}
]
}
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Como trabalhar com tarefas do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [ModifyReplicationTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/modify-replication-task.html) na *Referência de comandos da AWS CLI*.
### `reboot-replication-instance`
O código de exemplo a seguir mostra como usar `reboot-replication-instance`.
**AWS CLI**
**Para reiniciar uma instância de replicação**
O exemplo da `reboot-replication-instance` a seguir reinicializa uma instância de replicação.
```
aws dms reboot-replication-instance \
--replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE
```
Resultado:
```
{
"ReplicationInstance": {
"ReplicationInstanceIdentifier": "my-repl-instance",
"ReplicationInstanceClass": "dms.t2.micro",
"ReplicationInstanceStatus": "rebooting",
"AllocatedStorage": 5,
"InstanceCreateTime": 1590011235.952,
... output omitted ...
}
}
```
Para obter mais informações, consulte [Trabalhar com uma instância de replicação do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_ReplicationInstance.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [RebootReplicationInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/reboot-replication-instance.html) na *Referência de comandos da AWS CLI*.
### `refresh-schemas`
O código de exemplo a seguir mostra como usar `refresh-schemas`.
**AWS CLI**
**Para atualizar esquemas de banco de dados**
O exemplo `refresh-schemas` a seguir solicita que o AWS DMS atualize a lista de esquemas em um endpoint.
```
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"
```
Resultado:
```
{
"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
}
}
```
+ Para ver detalhes da API, consulte [RefreshSchemas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/refresh-schemas.html) na *Referência de comandos da AWS CLI*.
### `reload-tables`
O código de exemplo a seguir mostra como usar `reload-tables`.
**AWS CLI**
**Para atualizar a lista de tabelas disponíveis em um endpoint**
O exemplo `reload-tables` a seguir recarrega a lista de tabelas disponíveis em um endpoint.
```
aws dms reload-tables \
--replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \
--tables-to-reload "SchemaName=prodrep,TableName=ACCT_BAL"
```
Resultado:
```
{
"ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
}
```
+ Para ver detalhes da API, consulte [ReloadTables](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/reload-tables.html) na *Referência de comandos da AWS CLI*.
### `remove-tags-from-resource`
O código de exemplo a seguir mostra como usar `remove-tags-from-resource`.
**AWS CLI**
**Para remover tags de uma instância de replicação**
O exemplo `remove-tags-from-resource` a seguir remove tags de uma instância de replicação.
```
aws dms remove-tags-from-resource \
--resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
--tag-keys Environment Project
```
Este comando não produz saída.
Para ter mais informações, consulte [Marcação de recursos](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tagging.html) no *Guia do usuário do AWS Database Migration Service*.
+ Consulte detalhes da API em [RemoveTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/remove-tags-from-resource.html) na *Referência de comandos da AWS CLI*.
### `start-replication-task-assessment`
O código de exemplo a seguir mostra como usar `start-replication-task-assessment`.
**AWS CLI**
**Para iniciar uma avaliação de tarefas**
O exemplo `start-replication-task-assessment` a seguir inicia uma avaliação da tarefa de replicação.
```
aws dms start-replication-task-assessment \
--replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Criação de um relatório de avaliação de tarefas](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.AssessmentReport.html) no *Guia do Usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [StartReplicationTaskAssessment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/start-replication-task-assessment.html) na *Referência de comandos da AWS CLI*.
### `start-replication-task`
O código de exemplo a seguir mostra como usar `start-replication-task`.
**AWS CLI**
**Para iniciar uma tarefa de replicação**
O exemplo `command-name` a seguir lista os widgets disponíveis na sua conta da AWS.
```
aws dms start-replication-task \
--replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII \
--start-replication-task-type reload-target
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Como trabalhar com tarefas do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para obter detalhes sobre a API, consulte [StartReplicationTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/start-replication-task.html) na *Referência de comandos da AWS CLI*.
### `stop-replication-task`
O código de exemplo a seguir mostra como usar `stop-replication-task`.
**AWS CLI**
**Para interromper uma tarefa**
O exemplo `stop-replication-task` a seguir interrompe uma tarefa.
```
aws dms stop-replication-task \
--replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Como trabalhar com tarefas do AWS DMS](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [StopReplicationTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/stop-replication-task.html) na *Referência de comandos da AWS CLI*.
### `test-connection`
O código de exemplo a seguir mostra como usar `test-connection`.
**AWS CLI**
**Para testar uma conexão com um endpoint**
O exemplo `test-connection` a seguir testa se um endpoint pode ser acessado a partir de uma instância de replicação.
```
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
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Criação de endpoints de origem e destino](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html) no *Guia do usuário do AWS Database Migration Service*.
+ Para ver detalhes da API, consulte [TestConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dms/test-connection.html) na *Referência de comandos da AWS CLI*.