Modifica di un cluster Amazon DocumentDB

Per modificare un cluster, il cluster deve essere nello stato disponibile. Non è possibile modificare un cluster arrestato. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi disponibile, quindi apportare le modifiche desiderate. Per ulteriori informazioni, consulta Arresto e avvio di un cluster Amazon DocumentDB.

Using the AWS Management Console

Utilizza la seguente procedura per modificare uno specifico cluster Amazon DocumentDB utilizzando la console.

Per modificare un cluster Amazon DocumentDB

1. Accedi a e apri AWS Management Console la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.

2. Nel pannello di navigazione scegliere Clusters (Cluster).

   Suggerimento

   Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu () nell'angolo in alto a sinistra della pagina.

3. Specifica il cluster da modificare scegliendo il pulsante a sinistra del nome del cluster.

4. Scegli Actions (Operazioni), quindi Modify (Modifica).

5. Nel riquadro Modify Cluster: cluster-name (Modifica cluster: cluster-name) apporta le modifiche desiderate. È possibile modificare le seguenti aree:

   • Specifiche del cluster: nome, gruppi di sicurezza e password del cluster.

   • Configurazione dello storage del cluster: la modalità di archiviazione dei dati del cluster. Scegli tra la configurazione standard e quella ottimizzata per l'I/O.

   • Opzioni del cluster: la porta e il gruppo di parametri del cluster.

   • Backup: il periodo di conservazione dei backup e la finestra di backup del cluster.

   • Esportazioni di log: abilita o disabilita l'esportazione dei log di controllo o del profiler.

   • Manutenzione: imposta la finestra di manutenzione del cluster.

   • Protezione dall'eliminazione: abilita o disabilita la protezione da eliminazione sul cluster. Per impostazione predefinita, la protezione da eliminazione è abilitata.

6. Al termine, scegli Continue (Continua) per visualizzare un riepilogo delle modifiche.

7. Se accetti le modifiche, puoi scegliere Modify cluster (Modifica cluster) per modificare il cluster. In alternativa, puoi scegliere Back (Indietro) o Cancel (Annulla) per modificare o annullare le modifiche, rispettivamente.

L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare il cluster solo quando ha lo stato disponibile. Puoi monitorare lo stato del cluster con la console o l' AWS CLI. Per ulteriori informazioni, consulta Monitoraggio dello stato di un cluster Amazon DocumentDB.

Using the AWS CLI

Utilizzare l'operazione modify-db-cluster per modificare il cluster specificato utilizzando il comando AWS CLI. Per ulteriori informazioni, consulta ModifyDBClusterAmazon DocumentDB API Reference.

Parametri

• --db-cluster-identifier: obbligatorio. L'identificatore del cluster Amazon DocumentDB che intendi modificare.

• --backup-retention-period—Facoltativo. Il numero di giorni durante i quali vengono conservati i backup automatici. I valori validi sono compresi tra 1 e 35.

• --storage-type—Facoltativo. La configurazione di archiviazione del cluster. I valori validi sono standard (Standard) o iopt1 (ottimizzato per l'I/O).

• --db-cluster-parameter-group-name—Facoltativo. Il nome del gruppo di parametri del cluster da utilizzare per il cluster.

• --master-user-password—Facoltativo. La nuova password per l'utente principale del database.

  Vincoli per la password:

  • La lunghezza è di [8—100] caratteri stampabiliASCII.

  • Può utilizzare qualsiasi ASCII carattere stampabile tranne i seguenti:

    • / (barra)

    • " (virgolette doppie)

    • @ (simbolo chiocciola)

• --new-db-cluster-identifier—Facoltativo. Il nuovo identificatore per il cluster quando un cluster viene rinominato. Questo valore è archiviato come stringa in caratteri minuscoli.

  Vincoli per la denominazione

  • La lunghezza è di [1—63] lettere, numeri o trattini.

  • Il primo carattere deve essere una lettera.

  • Non può terminare con un trattino o contenere due trattini consecutivi.

  • Deve essere unico per tutti i cluster di AmazonRDS, Amazon Neptune e Amazon DocumentDB per regione. Account AWS

• --preferred-backup-window—Facoltativo. L'intervallo di tempo giornaliero durante il quale vengono creati i backup automatici, in Universal Coordinated Time ()UTC.

  • Formato: hh24:mm-hh24:mm

• --preferred-maintenance-window—Facoltativo. L'intervallo di tempo settimanale durante il quale può avvenire la manutenzione del sistema, inUTC.

  • Formato: ddd:hh24:mm-ddd:hh24:mm

  • Giorni validi: Sun, Mon, Tue, Wed, Thu, Fri e Sat.

• --deletion-protectiono --no-deletion-protection —Facoltativo. Se la protezione dall'eliminazione deve essere abilitata su questo cluster. La protezione dall'eliminazione impedisce che un cluster venga accidentalmente eliminato finché il cluster non viene modificato per disabilitare la protezione dall'eliminazione. Per ulteriori informazioni, consulta Eliminazione di un cluster Amazon DocumentDB.

• --apply-immediatelyo--no-apply-immediately: --apply-immediately da utilizzare per apportare immediatamente la modifica. Utilizzare --no-apply-immediately per apportare la modifica durante la finestra di manutenzione successiva del cluster.

Il codice seguente cambia il periodo di retention dei backup per il cluster sample-cluster.

Per Linux, macOS o Unix:

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

Per Windows:

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

L'aspetto dell'output di questa operazione è simile al seguente.

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

L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare il cluster solo quando ha lo stato disponibile. Puoi monitorare lo stato del cluster con la console o l' AWS CLI. Per ulteriori informazioni, consulta Monitoraggio dello stato di un cluster Amazon DocumentDB.