View a markdown version of this page

Contoh Amazon DocumentDB menggunakan AWS CLI - AWS Command Line Interface

Dokumentasi ini AWS CLI hanya untuk Versi 1.

Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat pengumuman. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Amazon DocumentDB menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Amazon DocumentDB.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanadd-tags-to-resource.

AWS CLI

Untuk menambahkan satu atau lebih tag ke sumber daya tertentu

add-tags-to-resourceContoh berikut menambahkan tiga tag kesample-cluster. Satu tag (CropB) memiliki nama kunci tetapi tidak ada nilai.

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"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Men andai Sumber Daya Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanapply-pending-maintenance-action.

AWS CLI

Agar tindakan pemeliharaan tertunda berlangsung selama jendela pemeliharaan berikutnya

apply-pending-maintenance-actionContoh berikut menyebabkan semua tindakan pembaruan sistem dilakukan selama jendela pemeliharaan terjadwal berikutnya.

aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --apply-action system-update \ --opt-in-type next-maintenance

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat M enerapkan Pembaruan Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancopy-db-cluster-parameter-group.

AWS CLI

Untuk menduplikasi grup parameter cluster DB yang ada

copy-db-cluster-parameter-groupContoh berikut membuat salinan dari grup parameter custom-docdb3-6 bernamacustom-docdb3-6-copy. Saat membuat salinan itu menambahkan tag ke grup parameter baru.

aws docdb copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier custom-docdb3-6 \ --target-db-cluster-parameter-group-identifier custom-docdb3-6-copy \ --target-db-cluster-parameter-group-description "Copy of custom-docdb3-6" \ --tags Key="CopyNumber",Value="1" Key="Modifiable",Value="Yes"

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Men yal in Grup Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancopy-db-cluster-snapshot.

AWS CLI

Untuk membuat salinan snapshot

copy-db-cluster-snapshotContoh berikut membuat salinan sample-cluster-snapshot bernamasample-cluster-snapshot-copy. Salinan memiliki semua tag asli ditambah tag baru dengan nama kunciCopyNumber.

aws docdb copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \ --copy-tags \ --tags Key="CopyNumber",Value="1"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menyal in Snapshot Cluster di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancreate-db-cluster-parameter-group.

AWS CLI

Cara membuat grup parameter cluster Amazon DocumentDB

create-db-cluster-parameter-groupContoh berikut membuat grup parameter cluster DB sample-parameter-group menggunakan docdb3.6 keluarga.

aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --db-parameter-group-family docdb3.6 \ --description "Sample parameter group based on docdb3.6"

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Membuat Grup Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancreate-db-cluster-snapshot.

AWS CLI

Cara membuat snapshot cluster Amazon DocumentDB manual

create-db-cluster-snapshotContoh berikut membuat snapshot cluster Amazon DB bernama sample-cluster-snapshot.

aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Membuat Snapshot Cluster Manual di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancreate-db-cluster.

AWS CLI

Cara membuat cluster Amazon DocumentDB

create-db-clusterContoh berikut membuat cluster Amazon DocumentDB bernama sample-cluster dengan jendela pemeliharaan pilihan pada hari Minggu antara pukul 20:30 dan 11:00.

aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --master-username master-user \ --master-user-password password \ --preferred-maintenance-window Sun:20:30-Sun:21:00

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Membuat Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancreate-db-instance.

AWS CLI

Cara membuat instance cluster Amazon DocumentDB

Kode create-db-instance contoh berikut membuat instance sample-cluster-instance-2 di cluster sample-cluster Amazon DocumentDB.

aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-class db.r4.xlarge \ --db-instance-identifier sample-cluster-instance-2 \ --engine docdb

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Menambahkan Instans Amazon DocumentDB ke Cluster di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakancreate-db-subnet-group.

AWS CLI

Cara membuat grup subnet Amazon DocumentDB

create-db-subnet-groupContoh berikut membuat grup subnet Amazon DocumentDB bernama. sample-subnet-group

aws docdb create-db-subnet-group \ --db-subnet-group-description "a sample subnet group" \ --db-subnet-group-name sample-subnet-group \ --subnet-ids "subnet-29ab1025" "subnet-991cb8d0" "subnet-53ab3636"

Output:

{ "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" } } ] } }

Untuk informasi selengkapnya, lihat Membuat Grup Subnet Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandelete-db-cluster-parameter-group.

AWS CLI

Untuk menghapus grup parameter cluster Amazon DocumentDB

delete-db-cluster-parameter-groupContoh berikut menghapus grup parameter Amazon DocumentDB. sample-parameter-group

aws docdb delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus Grup Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandelete-db-cluster-snapshot.

AWS CLI

Untuk menghapus snapshot cluster Amazon DocumentDB

delete-db-cluster-snapshotContoh berikut menghapus snapshot cluster Amazon DocumentDB. sample-cluster-snapshot

aws docdb delete-db-cluster-snapshot \ --db-cluster-snapshot-identifier sample-cluster-snapshot

Output:

{ "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 } }

Untuk informasi selengkapnya, lihat Menghapus Snapshot Cluster di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandelete-db-cluster.

AWS CLI

Untuk menghapus cluster Amazon DocumentDB

delete-db-clusterContoh berikut menghapus cluster Amazon DocumentDB. sample-cluster Tidak ada cadangan cluster yang dibuat sebelum menghapusnya. CATATAN: Anda harus menghapus semua instance yang terkait dengan cluster sebelum Anda dapat menghapusnya.

aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot

Output:

{ "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": [] } }

Untuk informasi selengkapnya, lihat Menghapus Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandelete-db-instance.

AWS CLI

Untuk menghapus instans Amazon DocumentDB

delete-db-instanceContoh berikut menghapus instans Amazon DocumentDB. sample-cluster-instance-2

aws docdb delete-db-instance \ --db-instance-identifier sample-cluster-instance-2

Output:

{ "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 } }

Untuk informasi selengkapnya, lihat Menghapus Instans Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandelete-db-subnet-group.

AWS CLI

Untuk menghapus grup subnet Amazon DocumentDB

delete-db-subnet-groupContoh berikut menghapus grup subnet Amazon DocumentDB. sample-subnet-group

aws docdb delete-db-subnet-group \ --db-subnet-group-name sample-subnet-group

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus Grup Subnet Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-cluster-parameter-groups.

AWS CLI

Untuk melihat detail satu atau beberapa grup parameter cluster Amazon DocumentDB

describe-db-cluster-parameter-groupsContoh berikut menampilkan detail untuk grup custom3-6-param-grp parameter cluster Amazon DocumentDB.

aws docdb describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name custom3-6-param-grp

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Melihat Grup Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-cluster-parameters.

AWS CLI

Untuk melihat daftar parameter terperinci untuk grup parameter cluster Amazon DocumentDB.

describe-db-cluster-parametersContoh berikut mencantumkan parameter untuk grup parameter Amazon DocumentDB custom3-6-param-grp.

aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Melihat Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-cluster-snapshot-attributes.

AWS CLI

Untuk mencantumkan nama dan nilai atribut snapshot Amazon DocumentDB

describe-db-cluster-snapshot-attributesContoh berikut mencantumkan nama atribut dan nilai untuk snapshot sample-cluster-snapshot Amazon DocumentDB.

aws docdb describe-db-cluster-snapshot-attributes \ --db-cluster-snapshot-identifier sample-cluster-snapshot

Output:

{ "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } }

Untuk informasi selengkapnya, lihat DescribeDBClusterSnapshotAttributes di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-cluster-snapshots.

AWS CLI

Untuk mendeskripsikan snapshot Amazon DocumentDB

describe-db-cluster-snapshotsContoh berikut menampilkan detail untuk snapshot sample-cluster-snapshot Amazon DocumentDB.

aws docdb describe-db-cluster-snapshots \ --db-cluster-snapshot-identifier sample-cluster-snapshot

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat DescribeDBClusterSnapshots di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-clusters.

AWS CLI

Untuk mendapatkan informasi terperinci tentang satu atau beberapa cluster Amazon DocumentDB.

describe-db-clustersContoh berikut menampilkan detail untuk cluster sample-cluster Amazon DocumentDB. Dengan menghilangkan --db-cluster-identifier parameter Anda bisa mendapatkan informasi hingga 100 cluster.

aws docdb describe-db-clusters --db-cluster-identifier sample-cluster

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Men jelaskan Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-engine-versions.

AWS CLI

Untuk daftar versi mesin Amazon DocumentDB yang tersedia

describe-db-engine-versionsContoh berikut mencantumkan semua versi mesin Amazon DocumentDB yang tersedia.

aws docdb describe-db-engine-versions \ --engine docdb

Output:

{ "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" ] } ] }

Untuk informasi selengkapnya, lihat DescribeDBEngineVersions di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-instances.

AWS CLI

Untuk menemukan informasi tentang instans Amazon DocumentDB yang disediakan

describe-db-instancesContoh berikut menampilkan detail tentang inst sample-cluster-instance ans Amazon DocumentDB. Dengan menghilangkan --db-instance-identifier parameter Anda mendapatkan informasi hingga 100 instance.

aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Men jelaskan Instans Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-db-subnet-groups.

AWS CLI

Untuk mengambil daftar deskripsi subnet Amazon DocumentDB

describe-db-subnet-groupsContoh berikut menjelaskan detail untuk subnet Amazon DocumentDB bernama. default

aws docdb describe-db-subnet-groups \ --db-subnet-group-name default

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Menjelaskan Grup Subnet di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-engine-default-cluster-parameters.

AWS CLI

Untuk menjelaskan informasi parameter mesin dan sistem default untuk Amazon DocumentDB

describe-engine-default-cluster-parametersContoh berikut menampilkan detail untuk mesin default dan informasi parameter sistem untuk grup docdb3.6 parameter Amazon DocumentDB.

aws docdb describe-engine-default-cluster-parameters \ --db-parameter-group-family docdb3.6

Output:

{ "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 } ] } }

Untuk informasi selengkapnya, lihat DescribeEngineDefaultClusterParameters di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-event-categories.

AWS CLI

Untuk menjelaskan semua kategori acara Amazon DocumentDB

describe-event-categoriesContoh berikut mencantumkan semua kategori untuk jenis db-instance sumber peristiwa Amazon DocumentDB.

aws docdb describe-event-categories \ --source-type db-cluster

Output:

{ "EventCategoriesMapList": [ { "SourceType": "db-cluster", "EventCategories": [ "failover", "maintenance", "notification", "failure" ] } ] }

Untuk informasi selengkapnya, lihat Melihat Kategori A cara di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-events.

AWS CLI

Untuk membuat daftar acara Amazon DocumentDB

describe-eventsContoh berikut mencantumkan semua peristiwa Amazon DocumentDB selama 24 jam terakhir (1440 menit).

aws docdb describe-events \ --duration 1440

Perintah ini tidak menghasilkan output. Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Melihat Acara Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-orderable-db-instance-options.

AWS CLI

Untuk menemukan opsi instance Amazon DocumentDB, Anda dapat memesan

describe-orderable-db-instance-optionsContoh berikut mencantumkan semua opsi instance untuk Amazon DocumentDB untuk suatu wilayah.

aws docdb describe-orderable-db-instance-options \ --engine docdb \ --region us-east-1

Output:

{ "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" } ] }

Untuk informasi selengkapnya, lihat Menambahkan Instans Amazon DocumentDB ke Cluster di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-pending-maintenance-actions.

AWS CLI

Untuk membuat daftar tindakan pemeliharaan Amazon DocumentDB Anda yang tertunda

describe-pending-maintenance-actionsContoh berikut mencantumkan semua tindakan pemeliharaan Amazon DocumentDB Anda yang tertunda.

aws docdb describe-pending-maintenance-actions

Output:

{ "PendingMaintenanceActions": [] }

Untuk informasi selengkapnya, lihat Mem elihara Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanfailover-db-cluster.

AWS CLI

Untuk memaksa cluster Amazon DocumentDB untuk failover ke replika

failover-db-clusterContoh berikut menyebabkan instance utama di cluster sampel cluster Amazon DocumentDB mengalami failover ke replika.

aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Failover Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan semua tag pada sumber daya Amazon DocumentDB

list-tags-for-resourceContoh berikut mencantumkan semua tag pada cluster sample-cluster Amazon DocumentDB.

aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster

Output:

{ "TagList": [ { "Key": "A", "Value": "ALPHA" }, { "Key": "B", "Value": "" }, { "Key": "C", "Value": "CHARLIE" } ] }

Untuk informasi selengkapnya, lihat Daftar Tag pada Sumber Daya Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanmodify-db-cluster-parameter-group.

AWS CLI

Untuk memodifikasi grup parameter cluster DB Amazon DocumentDB

modify-db-cluster-parameter-groupContoh berikut memodifikasi grup parameter cluster Amazon DocumentDB custom3-6-param-grp dengan menyetel dua parameter audit_logs dan ttl_monitor diaktifkan. Perubahan diterapkan pada reboot berikutnya.

aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name custom3-6-param-grp \ --parameters ParameterName=audit_logs,ParameterValue=enabled,ApplyMethod=pending-reboot \ ParameterName=ttl_monitor,ParameterValue=enabled,ApplyMethod=pending-reboot

Output:

{ "DBClusterParameterGroupName": "custom3-6-param-grp" }

Untuk informasi selengkapnya, lihat M emodifikasi Grup Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanmodify-db-cluster-snapshot-attribute.

AWS CLI

Contoh 1: Untuk menambahkan atribut ke snapshot Amazon DocumentDB

modify-db-cluster-snapshot-attributeContoh berikut menambahkan empat nilai atribut ke snapshot cluster Amazon DocumentDB.

aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier sample-cluster-snapshot \ --attribute-name restore \ --values-to-add 123456789011 123456789012 123456789013

Output:

{ "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789011", "123456789012", "123456789013" ] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } }

Contoh 2: Untuk menghapus atribut dari snapshot Amazon DocumentDB

modify-db-cluster-snapshot-attributeContoh berikut menghapus dua nilai atribut dari snapshot cluster Amazon DocumentDB.

aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier sample-cluster-snapshot \ --attribute-name restore \ --values-to-remove 123456789012

Output:

{ "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123456789011", "123456789013" ] } ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot" } }

Untuk informasi selengkapnya, lihat ModifyDBClusterSnapshotAttribute di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanmodify-db-cluster.

AWS CLI

Untuk memodifikasi cluster Amazon DocumentDB

modify-db-clusterContoh berikut memodifikasi cluster Amazon DocumentDB sample-cluster dengan membuat periode retensi untuk pencadangan otomatis 7 hari, dan mengubah jendela pilihan untuk pencadangan dan pemeliharaan. Semua perubahan diterapkan pada jendela pemeliharaan berikutnya.

aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --no-apply-immediately \ --backup-retention-period 7 \ --preferred-backup-window 18:00-18:30 \ --preferred-maintenance-window sun:20:00-sun:20:30

Output:

{ "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 } }

Untuk informasi selengkapnya, lihat M emodifikasi Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanmodify-db-instance.

AWS CLI

Untuk memodifikasi instance Amazon DocumentDB

modify-db-instanceContoh berikut memodifikasi instance Amazon DocumentDB sample-cluster2 dengan mengubah kelas instansnya menjadi db.r4.4xlarge dan tingkat promosinya menjadi. 5 Perubahan diterapkan segera tetapi hanya dapat dilihat setelah status instance tersedia.

aws docdb modify-db-instance \ --db-instance-identifier sample-cluster2 \ --apply-immediately \ --db-instance-class db.r4.4xlarge \ --promotion-tier 5

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat M emodifikasi Instans Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanmodify-db-subnet-group.

AWS CLI

Cara memodifikasi grup subnet Amazon DocumentDB

modify-db-subnet-groupContoh berikut memodifikasi grup subnet sample-subnet-group dengan menambahkan subnet yang ditentukan dan deskripsi baru.

aws docdb modify-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --subnet-ids subnet-b3806e8f subnet-53ab3636 subnet-991cb8d0 \ --db-subnet-group-description "New subnet description"

Output:

{ "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" } } ] } }

Untuk informasi selengkapnya, lihat M emodifikasi Grup Subnet Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanreboot-db-instance.

AWS CLI

Untuk me-reboot instans Amazon DocumentDB

reboot-db-instanceContoh berikut me-reboot instance Amazon DocumentDB. sample-cluster2

aws docdb reboot-db-instance \ --db-instance-identifier sample-cluster2

Perintah ini tidak menghasilkan output. Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Mem- boot ulang Amazon DocumentDB ILNStance di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanremove-tags-from-resource.

AWS CLI

Untuk menghapus tag dari sumber daya Amazon DocumentDB

remove-tags-from-resourceContoh berikut menghapus tag dengan kunci bernama B dari cluster sample-cluster Amazon DocumentDB.

aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --tag-keys B

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus Tag dari Amazon DocumentDBRessource di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanreset-db-cluster-parameter-group.

AWS CLI

Untuk mengatur ulang nilai parameter yang ditentukan ke defaultnya di grup parameter Amazon DocumentDB

reset-db-cluster-parameter-groupContoh berikut mengatur ulang parameter ttl_monitor dalam grup parameter Amazon DocumentDB custom3-6-param-grp ke nilai defaultnya.

aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name custom3-6-param-grp \ --parameters ParameterName=ttl_monitor,ApplyMethod=immediate

Output:

{ "DBClusterParameterGroupName": "custom3-6-param-grp" }

Untuk informasi selengkapnya, lihat judul di Panduan Pengembang Amazon DocumentDB.

Untuk mengatur ulang nilai parameter tertentu atau semua ke defaultnya di grup parameter Amazon DocumentDB

reset-db-cluster-parameter-groupContoh berikut mengatur ulang semua parameter dalam grup parameter Amazon DocumentDB custom3-6-param-grp ke nilai defaultnya.

aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name custom3-6-param-grp \ --reset-all-parameters

Output:

{ "DBClusterParameterGroupName": "custom3-6-param-grp" }

Untuk informasi selengkapnya, lihat Meng atur Ulang Grup Parameter Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanrestore-db-cluster-from-snapshot.

AWS CLI

Untuk memulihkan cluster Amazon DocumentDB dari snapshot otomatis atau manual

restore-db-cluster-from-snapshotContoh berikut membuat cluster Amazon DocumentDB baru yang dinamai sample-cluster-2019-03-16-00-01-restored dari snapshotrds: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 \ --engine docdb \ --snapshot-identifier rds:sample-cluster-2019-03-16-00-01

Output:

{ "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" } ] } }

Untuk informasi selengkapnya, lihat Memulihkan dari Snapshot Cluster di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanrestore-db-cluster-to-point-in-time.

AWS CLI

Untuk mengembalikan cluster Amazon DocumentDB ke titik waktu dari snapshot manual

restore-db-cluster-to-point-in-timeContoh berikut menggunakan sample-cluster-snapshot untuk membuat cluster Amazon DocumentDB baru,sample-cluster-pit, menggunakan waktu pemulihan terbaru.

aws docdb restore-db-cluster-to-point-in-time \ --db-cluster-identifier sample-cluster-pit \ --source-db-cluster-identifier arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster \ --use-latest-restorable-time

Output:

{ "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" } }

Untuk informasi selengkapnya, lihat Memulihkan Snapshot ke Titik Waktu di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanstart-db-cluster.

AWS CLI

Untuk memulai cluster Amazon DocumentDB yang dihentikan

start-db-clusterContoh berikut memulai cluster Amazon DocumentDB yang ditentukan.

aws docdb start-db-cluster \ --db-cluster-identifier sample-cluster

Output:

{ "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" } ] } }

Untuk informasi selengkapnya, lihat Menghentikan dan Memulai Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.

Contoh kode berikut menunjukkan cara menggunakanstop-db-cluster.

AWS CLI

Untuk menghentikan cluster Amazon DocumentDB yang sedang berjalan

stop-db-clusterContoh berikut menghentikan cluster Amazon DocumentDB yang ditentukan.

aws docdb stop-db-cluster \ --db-cluster-identifier sample-cluster

Output:

{ "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" } ] } }

Untuk informasi selengkapnya, lihat Menghentikan dan Memulai Cluster Amazon DocumentDB di Panduan Pengembang Amazon DocumentDB.