Memodifikasi cluster Amazon DocumentDB

Untuk mengubah suatu klaster, klaster tersebut harus dalam kondisi tersedia. Anda tidak dapat mengubah klaster yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu hingga klaster tersedia, lalu buat modifikasi yang diinginkan. Untuk informasi selengkapnya, lihat Menghentikan dan memulai cluster Amazon DocumentDB.

Using the AWS Management Console

Gunakan prosedur berikut untuk memodifikasi klaster Amazon DocumentDB tertentu menggunakan konsol.

Cara memodifikasi klaster Amazon DocumentDB

1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di https://console.aws.amazon.com/docdb.

2. Di panel navigasi, pilih Klaster.

   Tip

   Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu () di pojok kiri atas halaman.

3. Tentukan klaster yang ingin Anda modifikasi dengan memilih tombol di sebelah kiri nama klaster.

4. Pilih Tindakan, lalu pilih Modifikasi.

5. Di Modifikasi klaster: panel <cluster-name>, buat perubahan yang Anda inginkan. Anda dapat membuat perubahan di bidang berikut:

   • Spesifikasi klaster—Nama klaster, grup keamanan, dan kata sandi.

   • Konfigurasi penyimpanan cluster —Mode penyimpanan data cluster. Pilih antara konfigurasi Standar dan I/O-Optimized.

   • Opsi klaster—Port klaster dan grup parameter.

   • Backup—Periode penyimpanan backup klaster dan jendela backup.

   • Ekspor log—Aktifkan atau nonaktifkan ekspor audit atau log pembuat profil.

   • Pemeliharaan—Atur jendela pemeliharaan klaster.

   • Perlindungan penghapusan—Aktifkan atau nonaktifkan perlindungan penghapusan pada klaster. Perlindungan penghapusan diaktifkan secara default.

6. Setelah selesai, pilih Lanjutkan untuk melihat ringkasan perubahan Anda.

7. Jika Anda puas dengan perubahan Anda, Anda dapat memilih Modifikasi klaster untuk memodifikasi klaster Anda. Sebagai alternatif, Anda dapat memilih Kembali atau Batalkan untuk mengedit atau membatalkan perubahan Anda, masing-masing.

Diperlukan waktu beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan klaster hanya ketika statusnya tersedia. Anda dapat memantau status klaster menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat Memantau status klaster Amazon DocumentDB.

Using the AWS CLI

Gunakan operasi modify-db-cluster untuk mengubah klaster yang ditentukan dengan menggunakan AWS CLI. Untuk informasi selengkapnya, lihat ModifyDBClusterdi Referensi Amazon API DocumentDB.

Parameter

• --db-cluster-identifier—Diperlukan. Pengenal klaster Amazon DocumentDB yang akan Anda modifikasi.

• --backup-retention-period—Opsional. Jumlah hari untuk penyimpanan cadangan otomatis dipertahankan. Nilai yang valid adalah 1–35.

• --storage-type—Opsional. Konfigurasi penyimpanan cluster. Nilai yang valid adalah standard (Standar) atau iopt1 (I/O dioptimalkan).

• --db-cluster-parameter-group-name—Opsional. Nama grup parameter klaster yang digunakan untuk klaster.

• --master-user-password—Opsional. Kata sandi baru untuk pengguna basis data utama.

  Aturan kata sandi:

  • Panjangnya adalah [8—100] karakter yang dapat dicetakASCII.

  • Dapat menggunakan ASCII karakter apa pun yang dapat dicetak kecuali untuk yang berikut:

    • / (garis miring ke depan)

    • " (tanda kutip ganda)

    • @ (simbol pada)

• --new-db-cluster-identifier—Opsional. Pengenal klaster baru untuk klaster ketika mengubah nama klaster. Nilai ini disimpan sebagai string huruf kecil.

  Aturan penamaan:

  • Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.

  • Karakter pertama harus berupa huruf.

  • Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.

  • Harus unik untuk semua cluster di AmazonRDS, Amazon Neptunus, dan Amazon DocumentDB per, per wilayah. Akun AWS

• --preferred-backup-window—Opsional. Rentang waktu harian selama pencadangan otomatis dibuat, di Universal Coordinated Time (). UTC

  • Format: hh24:mm-hh24:mm

• --preferred-maintenance-window—Opsional. Rentang waktu mingguan di mana pemeliharaan sistem dapat terjadi, diUTC.

  • Format: ddd:hh24:mm-ddd:hh24:mm

  • Hari yang sah: Sun, Mon, Tue, Wed, Thu, Fri, dan Sat.

• --deletion-protection atau --no-deletion-protection—Opsional. Apakah perlindungan penghapusan harus diaktifkan pada klaster ini. Perlindungan penghapusan mencegah sebuah klaster dari yang sengaja dihapus sampai klaster dimodifikasi untuk menonaktifkan perlindungan penghapusan. Untuk informasi selengkapnya, lihat Menghapus cluster Amazon DocumentDB.

• --apply-immediately atau --no-apply-immediately—Gunakan --apply-immediately untuk segera membuat perubahan. Gunakan --no-apply-immediately untuk membuat perubahan selama jendela pemeliharaan berikutnya pada klaster Anda.

Kode berikut mengubah periode penyimpanan cadangan untuk klaster sample-cluster.

Untuk Linux, macOS, atau Unix:

aws docdb modify-db-cluster \
       --db-cluster-identifier sample-cluster \
       --apply-immediately \
       --backup-retention-period 7

Untuk Windows:

aws docdb modify-db-cluster ^
       --db-cluster-identifier sample-cluster ^
       --apply-immediately ^
       --backup-retention-period 7

Output dari operasi ini terlihat seperti berikut ini.

{
    "DBCluster": {
        "BackupRetentionPeriod": 7,
        "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
        "Status": "available",
        "DBClusterMembers": [
            {
                "PromotionTier": 1,
                "DBClusterParameterGroupStatus": "in-sync",
                "DBInstanceIdentifier": "sample-cluster-instance",
                "IsClusterWriter": true
            }
        ],
        "ReadReplicaIdentifiers": [],
        "AvailabilityZones": [
            "us-east-1b",
            "us-east-1c",
            "us-east-1a"
        ],
        "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
        "PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
        "EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
        "StorageEncrypted": false,
        "MultiAZ": false,
        "AssociatedRoles": [],
        "MasterUsername": "<your-master-user-name>",
        "DBClusterIdentifier": "sample-cluster",
        "VpcSecurityGroups": [
            {
                "Status": "active",
                "VpcSecurityGroupId": "sg-77186e0d"
            }
        ],
        "HostedZoneId": "Z2SUY0A1719RZT",
        "LatestRestorableTime": "2018-06-18T21:17:05.737Z",
        "AllocatedStorage": 1,
        "Port": 27017,
        "Engine": "docdb",
        "DBClusterParameterGroup": "default.docdb3.4",
        "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBSubnetGroup": "default",
        "PreferredBackupWindow": "00:00-00:30",
        "EngineVersion": "3.4",
        "ClusterCreateTime": "2018-06-06T19:25:47.991Z",
        "IAMDatabaseAuthenticationEnabled": false
    }
}

Diperlukan waktu beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan klaster hanya ketika statusnya tersedia. Anda dapat memantau status klaster menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat Memantau status klaster Amazon DocumentDB.