As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Exemplos do Amazon DocumentDB usando 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 Amazon DocumentDB.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções 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, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.
Tópicos
Ações
O código de exemplo a seguir mostra como usar add-tags-to-resource
.
- AWS CLI
-
Para adicionar uma ou mais tags a um recurso especificado
O
add-tags-to-resource
exemplo a seguir adiciona três tagssample-cluster
a. Uma tag (CropB
) tem um nome de chave, mas nenhum valor.aws docdb add-tags-to-resource \ --resource-name
arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster
\ --tags Key="CropA",Value="Apple" Key="CropB" Key="CropC",Value="Corn"Este comando não produz saída.
Para obter mais informações, consulte Como marcar recursos do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte AddTagsToResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar apply-pending-maintenance-action
.
- AWS CLI
-
Para que as ações de manutenção pendentes ocorram durante a próxima janela de manutenção
O
apply-pending-maintenance-action
exemplo a seguir faz com que todas as ações de atualização do sistema sejam executadas durante a próxima janela de manutenção programada.aws docdb apply-pending-maintenance-action \ --resource-identifier
arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster
\ --apply-actionsystem-update
\ --opt-in-typenext-maintenance
Este comando não produz saída.
Para obter mais informações, consulte Aplicação de atualizações do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ApplyPendingMaintenanceAction
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar copy-db-cluster-parameter-group
.
- AWS CLI
-
Para duplicar um grupo de parâmetros de cluster de banco de dados existente
O
copy-db-cluster-parameter-group
exemplo a seguir faz uma cópia do grupo de parâmetroscustom-docdb3-6
chamadocustom-docdb3-6-copy
. Ao fazer a cópia, ele adiciona tags ao novo grupo de parâmetros.aws docdb copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier
custom-docdb3-6
\ --target-db-cluster-parameter-group-identifiercustom-docdb3-6-copy
\ --target-db-cluster-parameter-group-description"Copy of custom-docdb3-6"
\ --tags Key="CopyNumber",Value="1" Key="Modifiable",Value="Yes"Saída:
{ "DBClusterParameterGroup": { "DBParameterGroupFamily": "docdb3.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:12345678901:cluster-pg:custom-docdb3-6-copy", "DBClusterParameterGroupName": "custom-docdb3-6-copy", "Description": "Copy of custom-docdb3-6" } }
Para obter mais informações, consulte Cópia de um grupo de parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CopyDbClusterParameterGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar copy-db-cluster-snapshot
.
- AWS CLI
-
Para criar uma cópia de um snapshot
O exemplo da
copy-db-cluster-snapshot
a seguir faz uma cópia dosample-cluster-snapshot
denominadosample-cluster-snapshot-copy
. A cópia tem todas as tags do original, além de uma nova tag com o nome da chaveCopyNumber
.aws docdb copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier
sample-cluster-snapshot
\ --target-db-cluster-snapshot-identifiersample-cluster-snapshot-copy
\ --copy-tags \ --tags Key="CopyNumber",Value="1"Este comando não produz saída.
Para obter mais informações, consulte Cópia de um snapshot de cluster no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CopyDbClusterSnapshot
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-db-cluster-parameter-group
.
- AWS CLI
-
Para criar um grupo de parâmetros de cluster do Amazon DocumentDB
O
create-db-cluster-parameter-group
exemplo a seguir cria o grupo de parâmetros do cluster de banco de dadossample-parameter-group
usando adocdb3.6
família.aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name
sample-parameter-group
\ --db-parameter-group-familydocdb3.6
\ --description"Sample parameter group based on docdb3.6"
Saída:
{ "DBClusterParameterGroup": { "Description": "Sample parameter group based on docdb3.6", "DBParameterGroupFamily": "docdb3.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-west-2:123456789012:cluster-pg:sample-parameter-group", "DBClusterParameterGroupName": "sample-parameter-group" } }
Para obter mais informações, consulte Criação de um grupo de parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CreateDbClusterParameterGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-db-cluster-snapshot
.
- AWS CLI
-
Para criar um snapshot manual do cluster Amazon DocumentDB
O
create-db-cluster-snapshot
exemplo a seguir cria um snapshot de cluster de banco de dados da Amazon chamado sample-cluster-snapshot.aws docdb create-db-cluster-snapshot \ --db-cluster-identifier
sample-cluster
\ --db-cluster-snapshot-identifiersample-cluster-snapshot
Saída:
{ "DBClusterSnapshot": { "MasterUsername": "master-user", "SnapshotCreateTime": "2019-03-18T18:27:14.794Z", "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c", "us-west-2d", "us-west-2e", "us-west-2f" ], "SnapshotType": "manual", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", "EngineVersion": "3.6.0", "PercentProgress": 0, "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "Engine": "docdb", "DBClusterIdentifier": "sample-cluster", "Status": "creating", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "Port": 0, "StorageEncrypted": false, "VpcId": "vpc-91280df6" } }
Para obter mais informações, consulte Criação manual de um snapshot de cluster no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CreateDbClusterSnapshot
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-db-cluster
.
- AWS CLI
-
Para criar um cluster Amazon DocumentDB
O
create-db-cluster
exemplo a seguir cria um cluster Amazon DocumentDB chamadosample-cluster
com a janela de manutenção preferencial aos domingos, entre 20:30 e 11:00.aws docdb create-db-cluster \ --db-cluster-identifier
sample-cluster
\ --enginedocdb
\ --master-user
name master-user \ --master-user-password
password \ --preferred-maintenance-windowSun:20:30-Sun:21:00
Saída:
{ "DBCluster": { "DBClusterParameterGroup": "default.docdb3.6", "AssociatedRoles": [], "DBSubnetGroup": "default", "ClusterCreateTime": "2019-03-18T18:06:34.616Z", "Status": "creating", "Port": 27017, "PreferredMaintenanceWindow": "sun:20:30-sun:21:00", "HostedZoneId": "ZNKXH85TT8WVW", "DBClusterMembers": [], "Engine": "docdb", "DBClusterIdentifier": "sample-cluster", "PreferredBackupWindow": "10:12-10:42", "AvailabilityZones": [ "us-west-2d", "us-west-2f", "us-west-2e" ], "MasterUsername": "master-user", "BackupRetentionPeriod": 1, "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "StorageEncrypted": false, "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "DbClusterResourceId": "cluster-L3R4YRSBUYDP4GLMTJ2WF5GH5Q", "MultiAZ": false, "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "EngineVersion": "3.6.0" } }
Para obter mais informações, consulte Criação de um cluster Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CreateDbCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-db-instance
.
- AWS CLI
-
Para criar uma instância de cluster do Amazon DocumentDB
O código de
create-db-instance
exemplo a seguir cria a instânciasample-cluster-instance-2
no cluster Amazon DocumentDB.sample-cluster
aws docdb create-db-instance \ --db-cluster-identifier
sample-cluster
\ --db-instance-classdb.r4.xlarge
\ --db-instance-identifiersample-cluster-instance-2
\ --enginedocdb
Saída:
{ "DBInstance": { "DBInstanceStatus": "creating", "PendingModifiedValues": { "PendingCloudwatchLogsExports": { "LogTypesToEnable": [ "audit" ] } }, "PubliclyAccessible": false, "PreferredBackupWindow": "00:00-00:30", "PromotionTier": 1, "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "DBInstanceIdentifier": "sample-cluster-instance-2", "PreferredMaintenanceWindow": "tue:10:28-tue:10:58", "StorageEncrypted": false, "Engine": "docdb", "DBClusterIdentifier": "sample-cluster", "DBSubnetGroup": { "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" } ], "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete", "VpcId": "vpc-91280df6", "DBSubnetGroupName": "default" }, "DBInstanceClass": "db.r4.xlarge", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster-instance-2", "DbiResourceId": "db-XEKJLEMGRV5ZKCARUVA4HO3ITE" } }
Para obter mais informações, consulte Adicionar uma instância do Amazon DocumentDB a um cluster no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CreateDbInstance
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-db-subnet-group
.
- AWS CLI
-
Para criar um grupo de sub-redes do Amazon DocumentDB
O
create-db-subnet-group
exemplo a seguir cria um grupo de sub-rede Amazon DocumentDB chamado.sample-subnet-group
aws docdb create-db-subnet-group \ --db-subnet-group-description
"a sample subnet group"
\ --db-subnet-group-namesample-subnet-group
\ --subnet-ids"subnet-29ab1025"
"subnet-991cb8d0"
"subnet-53ab3636"
Saída:
{ "DBSubnetGroup": { "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "sample-subnet-group", "DBSubnetGroupDescription": "a sample subnet group", "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:sample-subnet-group", "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-west-2b" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-29ab1025", "SubnetAvailabilityZone": { "Name": "us-west-2c" } } ] } }
Para obter mais informações, consulte Criação de um grupo de sub-rede do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte CreateDbSubnetGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-db-cluster-parameter-group
.
- AWS CLI
-
Para excluir um grupo de parâmetros de cluster do Amazon DocumentDB
O
delete-db-cluster-parameter-group
exemplo a seguir exclui o grupo de parâmetros do Amazon DocumentDB.sample-parameter-group
aws docdb delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name
sample-parameter-group
Este comando não produz saída.
Para obter mais informações, consulte Excluir um grupo de parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DeleteDbClusterParameterGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-db-cluster-snapshot
.
- AWS CLI
-
Para excluir um snapshot de cluster do Amazon DocumentDB
O
delete-db-cluster-snapshot
exemplo a seguir exclui o snapshot do cluster Amazon DocumentDB.sample-cluster-snapshot
aws docdb delete-db-cluster-snapshot \ --db-cluster-snapshot-identifier
sample-cluster-snapshot
Saída:
{ "DBClusterSnapshot": { "DBClusterIdentifier": "sample-cluster", "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c", "us-west-2d" ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "VpcId": "vpc-91280df6", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", "EngineVersion": "3.6.0", "Engine": "docdb", "SnapshotCreateTime": "2019-03-18T18:27:14.794Z", "Status": "available", "MasterUsername": "master-user", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "PercentProgress": 100, "StorageEncrypted": false, "SnapshotType": "manual", "Port": 0 } }
Para obter mais informações, consulte Excluindo um snapshot de cluster no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DeleteDbClusterSnapshot
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-db-cluster
.
- AWS CLI
-
Para excluir um cluster do Amazon DocumentDB
O
delete-db-cluster
exemplo a seguir exclui o cluster Amazonsample-cluster
DocumentDB. Nenhum backup do cluster é feito antes de excluí-lo. NOTE: você deve excluir todas as instâncias associadas ao cluster antes de poder excluí-lo.aws docdb delete-db-cluster \ --db-cluster-identifier
sample-cluster
\ --skip-final-snapshotSaída:
{ "DBCluster": { "DBClusterIdentifier": "sample-cluster", "DBSubnetGroup": "default", "EngineVersion": "3.6.0", "Engine": "docdb", "LatestRestorableTime": "2019-03-18T18:07:24.610Z", "PreferredMaintenanceWindow": "sun:20:30-sun:21:00", "StorageEncrypted": false, "EarliestRestorableTime": "2019-03-18T18:07:24.610Z", "Port": 27017, "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "MultiAZ": false, "MasterUsername": "master-user", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "Status": "available", "PreferredBackupWindow": "10:12-10:42", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "AvailabilityZones": [ "us-west-2c", "us-west-2b", "us-west-2a" ], "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DbClusterResourceId": "cluster-L3R4YRSBUYDP4GLMTJ2WF5GH5Q", "ClusterCreateTime": "2019-03-18T18:06:34.616Z", "AssociatedRoles": [], "DBClusterParameterGroup": "default.docdb3.6", "HostedZoneId": "ZNKXH85TT8WVW", "BackupRetentionPeriod": 1, "DBClusterMembers": [] } }
Para obter mais informações, consulte Excluir um cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DeleteDbCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-db-instance
.
- AWS CLI
-
Para excluir uma instância do Amazon DocumentDB
O
delete-db-instance
exemplo a seguir exclui a instância do Amazonsample-cluster-instance-2
DocumentDB.aws docdb delete-db-instance \ --db-instance-identifier
sample-cluster-instance-2
Saída:
{ "DBInstance": { "DBSubnetGroup": { "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" } ], "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-91280df6", "SubnetGroupStatus": "Complete" }, "PreferredBackupWindow": "00:00-00:30", "InstanceCreateTime": "2019-03-18T18:37:33.709Z", "DBInstanceClass": "db.r4.xlarge", "DbiResourceId": "db-XEKJLEMGRV5ZKCARUVA4HO3ITE", "BackupRetentionPeriod": 3, "Engine": "docdb", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "AutoMinorVersionUpgrade": true, "PromotionTier": 1, "EngineVersion": "3.6.0", "Endpoint": { "Address": "sample-cluster-instance-2.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "HostedZoneId": "ZNKXH85TT8WVW", "Port": 27017 }, "DBInstanceIdentifier": "sample-cluster-instance-2", "PreferredMaintenanceWindow": "tue:10:28-tue:10:58", "EnabledCloudwatchLogsExports": [ "audit" ], "PendingModifiedValues": {}, "DBInstanceStatus": "deleting", "PubliclyAccessible": false, "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster-instance-2", "DBClusterIdentifier": "sample-cluster", "AvailabilityZone": "us-west-2c", "StorageEncrypted": false } }
Para obter mais informações, consulte Excluir uma instância do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DeleteDbInstance
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-db-subnet-group
.
- AWS CLI
-
Para excluir um grupo de sub-redes do Amazon DocumentDB
O
delete-db-subnet-group
exemplo a seguir exclui o grupo de sub-rede Amazon DocumentDB.sample-subnet-group
aws docdb delete-db-subnet-group \ --db-subnet-group-name
sample-subnet-group
Este comando não produz saída.
Para obter mais informações, consulte Excluir um grupo de sub-rede do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DeleteDbSubnetGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-cluster-parameter-groups
.
- AWS CLI
-
Para ver os detalhes de um ou mais grupos de parâmetros de cluster do Amazon DocumentDB
O
describe-db-cluster-parameter-groups
exemplo a seguir exibe detalhes do grupo de parâmetros do cluster Amazon DocumentDB.custom3-6-param-grp
aws docdb describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name
custom3-6-param-grp
Saída:
{ "DBClusterParameterGroups": [ { "DBParameterGroupFamily": "docdb3.6", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp", "Description": "Custom docdb3.6 parameter group", "DBClusterParameterGroupName": "custom3-6-param-grp" } ] }
Para obter mais informações, consulte Visualização dos grupos de parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbClusterParameterGroups
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-cluster-parameters
.
- AWS CLI
-
Para visualizar a lista detalhada de parâmetros de um grupo de parâmetros do cluster Amazon DocumentDB.
O
describe-db-cluster-parameters
exemplo a seguir lista os parâmetros do grupo de parâmetros custom3-6-param-grp do Amazon DocumentDB.aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name
custom3-6-param-grp
Saída:
{ "Parameters": [ { "DataType": "string", "ParameterName": "audit_logs", "IsModifiable": true, "ApplyMethod": "pending-reboot", "Source": "system", "ApplyType": "dynamic", "AllowedValues": "enabled,disabled", "Description": "Enables auditing on cluster.", "ParameterValue": "disabled" }, { "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "ApplyMethod": "pending-reboot", "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "Description": "Config to enable/disable TLS", "ParameterValue": "enabled" }, { "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "ApplyMethod": "pending-reboot", "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "Description": "Enables TTL Monitoring", "ParameterValue": "enabled" } ] }
Para obter mais informações, consulte Visualização dos parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbClusterParameters
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-cluster-snapshot-attributes
.
- AWS CLI
-
Para listar os nomes e valores de atributos de um snapshot do Amazon DocumentDB
O
describe-db-cluster-snapshot-attributes
exemplo a seguir lista os nomes e valores dos atributos para o snapshot do Amazon DocumentDB.sample-cluster-snapshot
aws docdb describe-db-cluster-snapshot-attributes \ --db-cluster-snapshot-identifier
sample-cluster-snapshot
Saída:
{ "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } }
Para obter mais informações, consulte D escribeDBCluster SnapshotAttributes no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbClusterSnapshotAttributes
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-cluster-snapshots
.
- AWS CLI
-
Para descrever os snapshots do Amazon DocumentDB
O
describe-db-cluster-snapshots
exemplo a seguir exibe detalhes do snapshot do Amazon DocumentDB.sample-cluster-snapshot
aws docdb describe-db-cluster-snapshots \ --db-cluster-snapshot-identifier
sample-cluster-snapshot
Saída:
{ "DBClusterSnapshots": [ { "AvailabilityZones": [ "us-west-2a", "us-west-2b", "us-west-2c", "us-west-2d" ], "Status": "available", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", "SnapshotCreateTime": "2019-03-15T20:41:26.515Z", "SnapshotType": "manual", "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "DBClusterIdentifier": "sample-cluster", "MasterUsername": "master-user", "StorageEncrypted": false, "VpcId": "vpc-91280df6", "EngineVersion": "3.6.0", "PercentProgress": 100, "Port": 0, "Engine": "docdb", "ClusterCreateTime": "2019-03-15T20:29:58.836Z" } ] }
Para obter mais informações, consulte D escribeDBCluster Snapshots no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbClusterSnapshots
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-clusters
.
- AWS CLI
-
Para obter informações detalhadas sobre um ou mais clusters do Amazon DocumentDB.
O
describe-db-clusters
exemplo a seguir exibe detalhes do cluster Amazon DocumentDB.sample-cluster
Ao omitir o--db-cluster-identifier
parâmetro, você pode obter informações de até 100 clusters.aws docdb describe-db-clusters --db-cluster-identifier
sample-cluster
Saída:
{ "DBClusters": [ { "DBClusterParameterGroup": "default.docdb3.6", "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "PreferredBackupWindow": "00:00-00:30", "DBClusterIdentifier": "sample-cluster", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "LatestRestorableTime": "2019-03-18T20:28:03.239Z", "MasterUsername": "master-user", "DBClusterMembers": [ { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": false, "DBInstanceIdentifier": "sample-cluster" }, { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": true, "DBInstanceIdentifier": "sample-cluster2" } ], "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "Engine": "docdb", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DBSubnetGroup": "default", "MultiAZ": true, "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "EarliestRestorableTime": "2019-03-15T20:30:47.020Z", "DbClusterResourceId": "cluster-UP4EF2PVDDFVHHDJQTYDAIGHLE", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "BackupRetentionPeriod": 3, "HostedZoneId": "ZNKXH85TT8WVW", "StorageEncrypted": false, "EnabledCloudwatchLogsExports": [ "audit" ], "AssociatedRoles": [], "EngineVersion": "3.6.0", "Port": 27017, "Status": "available" } ] }
Para obter mais informações, consulte Descrição dos clusters do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbClusters
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-engine-versions
.
- AWS CLI
-
Para listar as versões disponíveis do mecanismo Amazon DocumentDB
O
describe-db-engine-versions
exemplo a seguir lista todas as versões disponíveis do mecanismo Amazon DocumentDB.aws
docdb
describe-db-engine-versions \ --engine docdbSaída:
{ "DBEngineVersions": [ { "DBEngineVersionDescription": "DocDB version 1.0.200837", "DBParameterGroupFamily": "docdb3.6", "EngineVersion": "3.6.0", "ValidUpgradeTarget": [], "DBEngineDescription": "Amazon DocumentDB (with MongoDB compatibility)", "SupportsLogExportsToCloudwatchLogs": true, "Engine": "docdb", "ExportableLogTypes": [ "audit" ] } ] }
Para obter mais informações, consulte escribeDBEngineVersões D no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbEngineVersions
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-instances
.
- AWS CLI
-
Para encontrar informações sobre instâncias provisionadas do Amazon DocumentDB
O
describe-db-instances
exemplo a seguir exibe detalhes sobre a instância do Amazon DocumentDB.sample-cluster-instance
Ao omitir o--db-instance-identifier
parâmetro, você obtém informações sobre até 100 instâncias.aws docdb describe-db-instances \ --db-instance-identifier
sample-cluster-instance
Saída:
{ "DBInstances": [ { "Endpoint": { "HostedZoneId": "ZNKXH85TT8WVW", "Address": "sample-cluster-instance.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Port": 27017 }, "PreferredBackupWindow": "00:00-00:30", "DBInstanceStatus": "available", "DBInstanceClass": "db.r4.large", "EnabledCloudwatchLogsExports": [ "audit" ], "DBInstanceIdentifier": "sample-cluster-instance", "DBSubnetGroup": { "Subnets": [ { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-west-2a" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-west-2b" } } ], "DBSubnetGroupName": "default", "SubnetGroupStatus": "Complete", "DBSubnetGroupDescription": "default", "VpcId": "vpc-91280df6" }, "InstanceCreateTime": "2019-03-15T20:36:06.338Z", "Engine": "docdb", "StorageEncrypted": false, "AutoMinorVersionUpgrade": true, "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster-instance", "PreferredMaintenanceWindow": "tue:08:39-tue:09:09", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "DBClusterIdentifier": "sample-cluster", "PendingModifiedValues": {}, "BackupRetentionPeriod": 3, "PubliclyAccessible": false, "EngineVersion": "3.6.0", "PromotionTier": 1, "AvailabilityZone": "us-west-2c", "DbiResourceId": "db-A2GIKUV6KPOHITGGKI2NHVISZA" } ] }
Para obter mais informações, consulte Descrição das instâncias do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbInstances
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-db-subnet-groups
.
- AWS CLI
-
Para recuperar uma lista de descrições de sub-rede do Amazon DocumentDB
O
describe-db-subnet-groups
exemplo a seguir descreve os detalhes da sub-rede Amazon DocumentDB chamada.default
aws docdb describe-db-subnet-groups \ --db-subnet-group-name
default
Saída:
{ "DBSubnetGroups": [ { "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:default", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2a" } }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2d" } }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2b" } } ], "DBSubnetGroupName": "default", "SubnetGroupStatus": "Complete", "DBSubnetGroupDescription": "default" } ] }
Para obter mais informações, consulte Descrevendo grupos de sub-redes no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeDbSubnetGroups
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-engine-default-cluster-parameters
.
- AWS CLI
-
Para descrever o mecanismo padrão e as informações de parâmetros do sistema para o Amazon DocumentDB
O
describe-engine-default-cluster-parameters
exemplo a seguir exibe detalhes do mecanismo padrão e das informações de parâmetros do sistema para o grupo de parâmetros do Amazon DocumentDB.docdb3.6
aws docdb describe-engine-default-cluster-parameters \ --db-parameter-group-family
docdb3.6
Saída:
{ "EngineDefaults": { "DBParameterGroupFamily": "docdb3.6", "Parameters": [ { "ApplyType": "dynamic", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "DataType": "string", "MinimumEngineVersion": "3.6.0", "AllowedValues": "enabled,disabled", "ParameterName": "audit_logs", "IsModifiable": true }, { "ApplyType": "static", "ParameterValue": "enabled", "Description": "Config to enable/disable TLS", "Source": "system", "DataType": "string", "MinimumEngineVersion": "3.6.0", "AllowedValues": "disabled,enabled", "ParameterName": "tls", "IsModifiable": true }, { "ApplyType": "dynamic", "ParameterValue": "enabled", "Description": "Enables TTL Monitoring", "Source": "system", "DataType": "string", "MinimumEngineVersion": "3.6.0", "AllowedValues": "disabled,enabled", "ParameterName": "ttl_monitor", "IsModifiable": true } ] } }
Para obter mais informações, consulte o DescribeEngineDefaultClusterParametersGuia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeEngineDefaultClusterParameters
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-event-categories
.
- AWS CLI
-
Para descrever todas as categorias de eventos do Amazon DocumentDB
O
describe-event-categories
exemplo a seguir lista todas as categorias do tipo de fonte de eventos Amazon DocumentDB.db-instance
aws docdb describe-event-categories \ --source-type
db-cluster
Saída:
{ "EventCategoriesMapList": [ { "SourceType": "db-cluster", "EventCategories": [ "failover", "maintenance", "notification", "failure" ] } ] }
Para obter mais informações, consulte Visualização de categorias de eventos no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeEventCategories
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-events
.
- AWS CLI
-
Para listar eventos do Amazon DocumentDB
O
describe-events
exemplo a seguir lista todos os eventos do Amazon DocumentDB nas últimas 24 horas (1440 minutos).aws docdb describe-events \ --duration
1440
Este comando não produz saída. Saída:
{ "Events": [ { "EventCategories": [ "failover" ], "Message": "Started cross AZ failover to DB instance: sample-cluster", "Date": "2019-03-18T21:36:29.807Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "SourceIdentifier": "sample-cluster", "SourceType": "db-cluster" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-18T21:36:40.793Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster", "SourceIdentifier": "sample-cluster", "SourceType": "db-instance" }, { "EventCategories": [], "Message": "A new writer was promoted. Restarting database as a reader.", "Date": "2019-03-18T21:36:43.873Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-18T21:36:51.257Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "failover" ], "Message": "Completed failover to DB instance: sample-cluster", "Date": "2019-03-18T21:36:53.462Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "SourceIdentifier": "sample-cluster", "SourceType": "db-cluster" }, { "Date": "2019-03-19T16:51:48.847Z", "EventCategories": [ "configuration change" ], "Message": "Updated parameter audit_logs to enabled with apply method pending-reboot", "SourceIdentifier": "custom3-6-param-grp", "SourceType": "db-parameter-group" }, { "EventCategories": [ "configuration change" ], "Message": "Applying modification to database instance class", "Date": "2019-03-19T17:55:20.095Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance shutdown", "Date": "2019-03-19T17:56:31.127Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "configuration change" ], "Message": "Finished applying modification to DB instance class", "Date": "2019-03-19T18:00:45.822Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-19T18:00:53.397Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance shutdown", "Date": "2019-03-19T18:23:36.045Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "EventCategories": [ "availability" ], "Message": "DB instance restarted", "Date": "2019-03-19T18:23:46.209Z", "SourceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "SourceIdentifier": "sample-cluster2", "SourceType": "db-instance" }, { "Date": "2019-03-19T18:39:05.822Z", "EventCategories": [ "configuration change" ], "Message": "Updated parameter ttl_monitor to enabled with apply method immediate", "SourceIdentifier": "custom3-6-param-grp", "SourceType": "db-parameter-group" }, { "Date": "2019-03-19T18:39:48.067Z", "EventCategories": [ "configuration change" ], "Message": "Updated parameter audit_logs to disabled with apply method immediate", "SourceIdentifier": "custom3-6-param-grp", "SourceType": "db-parameter-group" } ] }
Para obter mais informações, consulte Visualização de eventos do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeEvents
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-orderable-db-instance-options
.
- AWS CLI
-
Para encontrar as opções de instância do Amazon DocumentDB, você pode solicitar
O
describe-orderable-db-instance-options
exemplo a seguir lista todas as opções de instância do Amazon DocumentDB para uma região.aws
docdb
describe-orderable-db-instance-options \ --engine docdb \ --regionus-east-1
Saída:
{ "OrderableDBInstanceOptions": [ { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.16xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.2xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.4xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.8xlarge", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.large", "LicenseModel": "na", "Engine": "docdb" }, { "Vpc": true, "AvailabilityZones": [ { "Name": "us-east-1a" }, { "Name": "us-east-1b" }, { "Name": "us-east-1c" }, { "Name": "us-east-1d" } ], "EngineVersion": "3.6.0", "DBInstanceClass": "db.r4.xlarge", "LicenseModel": "na", "Engine": "docdb" } ] }
Para obter mais informações, consulte Adicionar uma instância do Amazon DocumentDB a um cluster no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribeOrderableDbInstanceOptions
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-pending-maintenance-actions
.
- AWS CLI
-
Para listar suas ações pendentes de manutenção do Amazon DocumentDB
O
describe-pending-maintenance-actions
exemplo a seguir lista todas as suas ações pendentes de manutenção do Amazon DocumentDB.aws docdb describe-pending-maintenance-actions
Saída:
{ "PendingMaintenanceActions": [] }
Para obter mais informações, consulte Manutenção do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte DescribePendingMaintenanceActions
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar failover-db-cluster
.
- AWS CLI
-
Para forçar o failover de um cluster do Amazon DocumentDB para uma réplica
O
failover-db-cluster
exemplo a seguir faz com que a instância primária no cluster de amostra do cluster Amazon DocumentDB passe por failover para uma réplica.aws docdb failover-db-cluster \ --db-cluster-identifier
sample-cluster
Saída:
{ "DBCluster": { "AssociatedRoles": [], "DBClusterIdentifier": "sample-cluster", "EngineVersion": "3.6.0", "DBSubnetGroup": "default", "MasterUsername": "master-user", "EarliestRestorableTime": "2019-03-15T20:30:47.020Z", "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "LatestRestorableTime": "2019-03-18T21:35:23.548Z", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "PreferredBackupWindow": "00:00-00:30", "Port": 27017, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "StorageEncrypted": false, "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "MultiAZ": true, "Status": "available", "DBClusterMembers": [ { "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": false, "DBInstanceIdentifier": "sample-cluster", "PromotionTier": 1 }, { "DBClusterParameterGroupStatus": "in-sync", "IsClusterWriter": true, "DBInstanceIdentifier": "sample-cluster2", "PromotionTier": 2 } ], "EnabledCloudwatchLogsExports": [ "audit" ], "DBClusterParameterGroup": "default.docdb3.6", "HostedZoneId": "ZNKXH85TT8WVW", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "BackupRetentionPeriod": 3, "DbClusterResourceId": "cluster-UP4EF2PVDDFVHHDJQTYDAIGHLE", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Engine": "docdb" } }
Para obter mais informações, consulte Amazon DocumentDB Failover no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte FailoverDbCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-tags-for-resource
.
- AWS CLI
-
Para listar todas as tags em um recurso do Amazon DocumentDB
O
list-tags-for-resource
exemplo a seguir lista todas as tags no cluster Amazon DocumentDB.sample-cluster
aws docdb list-tags-for-resource \ --resource-name
arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster
Saída:
{ "TagList": [ { "Key": "A", "Value": "ALPHA" }, { "Key": "B", "Value": "" }, { "Key": "C", "Value": "CHARLIE" } ] }
Para obter mais informações, consulte Listar tags em um recurso do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ListTagsForResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar modify-db-cluster-parameter-group
.
- AWS CLI
-
Para modificar um grupo de parâmetros do cluster de banco de dados Amazon DocumentDB
O
modify-db-cluster-parameter-group
exemplo a seguir modifica ocustom3-6-param-grp
grupo de parâmetros do cluster Amazon DocumentDB definindo os doisaudit_logs
parâmetrosttl_monitor
e como habilitado. As alterações serão aplicadas na próxima reinicialização.aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name
custom3-6-param-grp
\ --parametersParameterName=audit_logs,ParameterValue=enabled,ApplyMethod=pending-reboot
\ParameterName=ttl_monitor,ParameterValue=enabled,ApplyMethod=pending-reboot
Saída:
{ "DBClusterParameterGroupName": "custom3-6-param-grp" }
Para obter mais informações, consulte Modificação de um grupo de parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ModifyDbClusterParameterGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar modify-db-cluster-snapshot-attribute
.
- AWS CLI
-
Exemplo 1: Para adicionar um atributo a um snapshot do Amazon DocumentDB
O
modify-db-cluster-snapshot-attribute
exemplo a seguir adiciona quatro valores de atributos a um snapshot do cluster Amazon DocumentDB.aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier
sample-cluster-snapshot
\ --attribute-namerestore
\ --values-to-add123456789011
123456789012
123456789013
Saída:
{ "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789011", "123456789012", "123456789013" ] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } }
Exemplo 2: Para remover atributos de um snapshot do Amazon DocumentDB
O
modify-db-cluster-snapshot-attribute
exemplo a seguir remove dois valores de atributos de um snapshot do cluster Amazon DocumentDB.aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier
sample-cluster-snapshot
\ --attribute-namerestore
\ --values-to-remove123456789012
Saída:
{ "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789011", "123456789013" ] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } }
Para obter mais informações, consulte M odifyDBCluster SnapshotAttribute no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ModifyDbClusterSnapshotAttribute
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar modify-db-cluster
.
- AWS CLI
-
Para modificar um cluster do Amazon DocumentDB
O
modify-db-cluster
exemplo a seguir modifica osample-cluster
cluster Amazon DocumentDB fazendo com que o período de retenção dos backups automáticos seja de 7 dias e alterando as janelas preferenciais para backups e manutenção. Todas as alterações são aplicadas na próxima janela de manutenção.aws docdb modify-db-cluster \ --db-cluster-identifier
sample-cluster
\ --no-apply-immediately \ --backup-retention-period7
\ --preferred-backup-window18:00-18:30
\ --preferred-maintenance-windowsun:20:00-sun:20:30
Saída:
{ "DBCluster": { "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DBClusterMembers": [ { "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster", "IsClusterWriter": true, "PromotionTier": 1 }, { "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster2", "IsClusterWriter": false, "PromotionTier": 2 } ], "HostedZoneId": "ZNKXH85TT8WVW", "StorageEncrypted": false, "PreferredBackupWindow": "18:00-18:30", "MultiAZ": true, "EngineVersion": "3.6.0", "MasterUsername": "master-user", "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DBSubnetGroup": "default", "LatestRestorableTime": "2019-03-18T22:08:13.408Z", "EarliestRestorableTime": "2019-03-15T20:30:47.020Z", "PreferredMaintenanceWindow": "sun:20:00-sun:20:30", "AssociatedRoles": [], "EnabledCloudwatchLogsExports": [ "audit" ], "Engine": "docdb", "DBClusterParameterGroup": "default.docdb3.6", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster", "BackupRetentionPeriod": 7, "DBClusterIdentifier": "sample-cluster", "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "Status": "available", "DbClusterResourceId": "cluster-UP4EF2PVDDFVHHDJQTYDAIGHLE", "ClusterCreateTime": "2019-03-15T20:29:58.836Z", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "Port": 27017 } }
Para obter mais informações, consulte Modificação de um cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ModifyDbCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar modify-db-instance
.
- AWS CLI
-
Para modificar uma instância do Amazon DocumentDB
O
modify-db-instance
exemplo a seguir modifica asample-cluster2
instância do Amazon DocumentDB alterando sua classe de instânciadb.r4.4xlarge
para e seu nível de promoção para.5
As alterações são aplicadas imediatamente, mas só podem ser vistas depois que o status da instância estiver disponível.aws docdb modify-db-instance \ --db-instance-identifier
sample-cluster2
\ --apply-immediately \ --db-instance-classdb.r4.4xlarge
\ --promotion-tier5
Saída:
{ "DBInstance": { "EngineVersion": "3.6.0", "StorageEncrypted": false, "DBInstanceClass": "db.r4.large", "PreferredMaintenanceWindow": "mon:08:39-mon:09:09", "AutoMinorVersionUpgrade": true, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "PreferredBackupWindow": "18:00-18:30", "EnabledCloudwatchLogsExports": [ "audit" ], "AvailabilityZone": "us-west-2f", "DBInstanceIdentifier": "sample-cluster2", "InstanceCreateTime": "2019-03-15T20:36:06.338Z", "Engine": "docdb", "BackupRetentionPeriod": 7, "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6" }, "PromotionTier": 2, "Endpoint": { "Address": "sample-cluster2.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "HostedZoneId": "ZNKXH85TT8WVW", "Port": 27017 }, "DbiResourceId": "db-A2GIKUV6KPOHITGGKI2NHVISZA", "DBClusterIdentifier": "sample-cluster", "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "PendingModifiedValues": { "DBInstanceClass": "db.r4.4xlarge" }, "PubliclyAccessible": false, "DBInstanceStatus": "available" } }
Para obter mais informações, consulte Modificar uma instância do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ModifyDbInstance
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar modify-db-subnet-group
.
- AWS CLI
-
Para modificar um grupo de sub-redes do Amazon DocumentDB
O
modify-db-subnet-group
exemplo a seguir modifica o grupo de sub-redessample-subnet-group
adicionando as sub-redes especificadas e uma nova descrição.aws docdb modify-db-subnet-group \ --db-subnet-group-name
sample-subnet-group
\ --subnet-idssubnet-b3806e8f
subnet-53ab3636
subnet-991cb8d0
\ --db-subnet-group-description"New subnet description"
Saída:
{ "DBSubnetGroup": { "DBSubnetGroupName": "sample-subnet-group", "SubnetGroupStatus": "Complete", "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:sample-subnet-group", "VpcId": "vpc-91280df6", "DBSubnetGroupDescription": "New subnet description", "Subnets": [ { "SubnetIdentifier": "subnet-b3806e8f", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2a" } }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2c" } }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2b" } } ] } }
Para obter mais informações, consulte Modificação de um grupo de sub-redes do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ModifyDbSubnetGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar reboot-db-instance
.
- AWS CLI
-
Para reinicializar uma instância do Amazon DocumentDB
O
reboot-db-instance
exemplo a seguir reinicia a instância do Amazonsample-cluster2
DocumentDB.aws docdb reboot-db-instance \ --db-instance-identifier
sample-cluster2
Este comando não produz saída. Saída:
{ "DBInstance": { "PreferredBackupWindow": "18:00-18:30", "DBInstanceIdentifier": "sample-cluster2", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "DBSubnetGroup": { "VpcId": "vpc-91280df6", "Subnets": [ { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2c" }, "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2d" }, "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetStatus": "Active", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetIdentifier": "subnet-991cb8d0" } ], "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default" }, "PendingModifiedValues": {}, "Endpoint": { "Address": "sample-cluster2.corcjozrlsfc.us-west-2.docdb.amazonaws.com", "HostedZoneId": "ZNKXH85TT8WVW", "Port": 27017 }, "EnabledCloudwatchLogsExports": [ "audit" ], "StorageEncrypted": false, "DbiResourceId": "db-A2GIKUV6KPOHITGGKI2NHVISZA", "AutoMinorVersionUpgrade": true, "Engine": "docdb", "InstanceCreateTime": "2019-03-15T20:36:06.338Z", "EngineVersion": "3.6.0", "PromotionTier": 5, "BackupRetentionPeriod": 7, "DBClusterIdentifier": "sample-cluster", "PreferredMaintenanceWindow": "mon:08:39-mon:09:09", "PubliclyAccessible": false, "DBInstanceClass": "db.r4.4xlarge", "AvailabilityZone": "us-west-2d", "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:sample-cluster2", "DBInstanceStatus": "rebooting" } }
Para obter mais informações, consulte Reinicializando um Amazon ILnstance DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte RebootDbInstance
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar remove-tags-from-resource
.
- AWS CLI
-
Para remover tags de um recurso do Amazon DocumentDB
O
remove-tags-from-resource
exemplo a seguir remove a tag com a chave nomeadaB
do cluster Amazon DocumentDB.sample-cluster
aws docdb remove-tags-from-resource \ --resource-name
arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster
\ --tag-keysB
Este comando não produz saída.
Para obter mais informações, consulte Removendo tags de um Amazon D ocumentDBResource no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte RemoveTagsFromResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar reset-db-cluster-parameter-group
.
- AWS CLI
-
Para redefinir o valor do parâmetro especificado para seus padrões em um grupo de parâmetros do Amazon DocumentDB
O
reset-db-cluster-parameter-group
exemplo a seguir redefine o parâmetrottl_monitor
nocustom3-6-param-grp
grupo de parâmetros Amazon DocumentDB para seu valor padrão.aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name
custom3-6-param-grp
\ --parametersParameterName=ttl_monitor,ApplyMethod=immediate
Saída:
{ "DBClusterParameterGroupName": "custom3-6-param-grp" }
Para obter mais informações, consulte o título no Guia do desenvolvedor do Amazon DocumentDB.
Para redefinir os valores especificados ou todos os parâmetros para seus padrões em um grupo de parâmetros do Amazon DocumentDB
O
reset-db-cluster-parameter-group
exemplo a seguir redefine todos os parâmetros nocustom3-6-param-grp
grupo de parâmetros Amazon DocumentDB para seu valor padrão.aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name
custom3-6-param-grp
\ --reset-all-parametersSaída:
{ "DBClusterParameterGroupName": "custom3-6-param-grp" }
Para obter mais informações, consulte Redefinição de um grupo de parâmetros de cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte ResetDbClusterParameterGroup
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar restore-db-cluster-from-snapshot
.
- AWS CLI
-
Para restaurar um cluster do Amazon DocumentDB a partir de um snapshot automático ou manual
O
restore-db-cluster-from-snapshot
exemplo a seguir cria um novo cluster Amazon DocumentDB chamado asample-cluster-2019-03-16-00-01-restored
partir do snapshot.rds:sample-cluster-2019-03-16-00-01
aws docdb restore-db-cluster-from-snapshot \ --db-cluster-identifier
sample-cluster-2019-03-16-00-01-restored
\ --enginedocdb
\ --snapshot-identifierrds:sample-cluster-2019-03-16-00-01
Saída:
{ "DBCluster": { "ClusterCreateTime": "2019-03-19T18:45:01.857Z", "HostedZoneId": "ZNKXH85TT8WVW", "Engine": "docdb", "DBClusterMembers": [], "MultiAZ": false, "AvailabilityZones": [ "us-west-2a", "us-west-2c", "us-west-2b" ], "StorageEncrypted": false, "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Port": 27017, "PreferredBackupWindow": "00:00-00:30", "DBSubnetGroup": "default", "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored", "DBClusterParameterGroup": "default.docdb3.6", "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU", "MasterUsername": "master-user", "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "AssociatedRoles": [], "Status": "creating", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ] } }
Para obter mais informações, consulte Restauração a partir de um snapshot de cluster no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte RestoreDbClusterFromSnapshot
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar restore-db-cluster-to-point-in-time
.
- AWS CLI
-
Para restaurar um cluster Amazon DocumentDB para um a point-in-time partir de um snapshot manual
O
restore-db-cluster-to-point-in-time
exemplo a seguir usa osample-cluster-snapshot
para criar um novo cluster Amazon DocumentDB,sample-cluster-pit
, usando o tempo restaurável mais recente.aws docdb restore-db-cluster-to-point-in-time \ --db-cluster-identifier
sample-cluster-pit
\ --source-db-cluster-identifierarn:aws:rds:us-west-2:123456789012:cluster:sample-cluster
\ --use-latest-restorable-timeSaída:
{ "DBCluster": { "StorageEncrypted": false, "BackupRetentionPeriod": 3, "MasterUsername": "master-user", "HostedZoneId": "ZNKXH85TT8WVW", "PreferredBackupWindow": "00:00-00:30", "MultiAZ": false, "DBClusterIdentifier": "sample-cluster-pit", "DBSubnetGroup": "default", "ClusterCreateTime": "2019-04-03T15:55:21.320Z", "AssociatedRoles": [], "DBClusterParameterGroup": "default.docdb3.6", "DBClusterMembers": [], "Status": "creating", "AvailabilityZones": [ "us-west-2a", "us-west-2d", "us-west-2b" ], "ReaderEndpoint": "sample-cluster-pit.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "Port": 27017, "Engine": "docdb", "EngineVersion": "3.6.0", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "Endpoint": "sample-cluster-pit.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com", "DbClusterResourceId": "cluster-NLCABBXOSE2QPQ4GOLZIFWEPLM", "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster-pit" } }
Para obter mais informações, consulte Restauração de um snapshot em um ponto no tempo no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte RestoreDbClusterToPointInTime
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar start-db-cluster
.
- AWS CLI
-
Para iniciar um cluster Amazon DocumentDB parado
O
start-db-cluster
exemplo a seguir inicia o cluster Amazon DocumentDB especificado.aws docdb start-db-cluster \ --db-cluster-identifier
sample-cluster
Saída:
{ "DBCluster": { "ClusterCreateTime": "2019-03-19T18:45:01.857Z", "HostedZoneId": "ZNKXH85TT8WVW", "Engine": "docdb", "DBClusterMembers": [], "MultiAZ": false, "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1f" ], "StorageEncrypted": false, "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Port": 27017, "PreferredBackupWindow": "00:00-00:30", "DBSubnetGroup": "default", "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored", "DBClusterParameterGroup": "default.docdb3.6", "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU", "MasterUsername": "master-user", "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "AssociatedRoles": [], "Status": "creating", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ] } }
Para obter mais informações, consulte Como interromper e iniciar um cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte StartDbCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar stop-db-cluster
.
- AWS CLI
-
Para interromper a execução de um cluster Amazon DocumentDB
O
stop-db-cluster
exemplo a seguir interrompe o cluster Amazon DocumentDB especificado.aws docdb stop-db-cluster \ --db-cluster-identifier
sample-cluster
Saída:
{ "DBCluster": { "ClusterCreateTime": "2019-03-19T18:45:01.857Z", "HostedZoneId": "ZNKXH85TT8WVW", "Engine": "docdb", "DBClusterMembers": [], "MultiAZ": false, "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1f" ], "StorageEncrypted": false, "ReaderEndpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-ro-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Endpoint": "sample-cluster-2019-03-16-00-01-restored.cluster-corcjozrlsfc.us-east-1.docdb.amazonaws.com", "Port": 27017, "PreferredBackupWindow": "00:00-00:30", "DBSubnetGroup": "default", "DBClusterIdentifier": "sample-cluster-2019-03-16-00-01-restored", "PreferredMaintenanceWindow": "sat:04:30-sat:05:00", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster-2019-03-16-00-01-restored", "DBClusterParameterGroup": "default.docdb3.6", "DbClusterResourceId": "cluster-XOO46Q3RH4LWSYNH3NMZKXPISU", "MasterUsername": "master-user", "EngineVersion": "3.6.0", "BackupRetentionPeriod": 3, "AssociatedRoles": [], "Status": "creating", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ] } }
Para obter mais informações, consulte Como interromper e iniciar um cluster do Amazon DocumentDB no Guia do desenvolvedor do Amazon DocumentDB.
-
Para API obter detalhes, consulte StopDbCluster
na Referência de AWS CLI Comandos.
-