Modifica di un cluster Amazon DocumentDB - Amazon DocumentDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 (Hamburger menu icon with three horizontal lines.) 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 gestione delle credenziali 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.

  • --manage-master-user-password—Facoltativo. Amazon DocumentDB genera la password dell'utente principale e la gestisce per tutto il suo ciclo di vita in Secrets Manager.

  • --rotate-master-user-password—Facoltativo. Secrets Manager genera una nuova versione segreta per il segreto esistente. La nuova versione del segreto contiene la nuova password dell'utente principale. Amazon DocumentDB modifica la password dell'utente principale per il cluster in modo che corrisponda alla password della nuova versione segreta.

    È necessario specificare l'--apply-immediatelyopzione quando si ruota la password principale.

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

    Vincoli per la password:

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

    • È possibile utilizzare qualsiasi carattere ASCII stampabile eccetto 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 Amazon RDS, Amazon Neptune e Amazon DocumentDB per regione. Account AWS

  • --preferred-backup-window—Facoltativo. L'intervallo temporale giornaliero durante il quale vengono creati i backup automatici, in UTC.

    • Formato: hh24:mm-hh24:mm

  • --preferred-maintenance-window—Facoltativo. L'intervallo temporale settimanale durante il quale può avvenire la manutenzione dei sistemi, in UTC.

    • 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.