API per i cluster di database Neptune

• CreateDBCluster (operazione)

• DeleteDBCluster (operazione)

• ModifyDBCluster (operazione)

• StartDbCluster (operazione)

• StopDBCluster (operazione)

• AddRoleToDBCluster (operazione)

• RemoveRoleFromDBCluster (operazione)

• FailoverDBCluster (operazione)

• PromoteReadReplicaDBCluster (operazione)

• DescribeDBClusters (operazione)

• DBCluster (struttura)

• DBClusterMember (struttura)

• DBClusterRole (struttura)

• CloudwatchLogsExportConfiguration (struttura)

• PendingCloudwatchLogsExports (struttura)

• ClusterPendingModifiedValues (struttura)

• AvailabilityZones (nella CLI: --availability-zones): una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco delle zone di disponibilità EC2 in cui possono essere create istanze nel cluster di database.

• BackupRetentionPeriod (nella CLI: --backup-retention-period): un valore IntegerOptional di tipo integer (numero intero a 32 bit con segno).

  Il numero di giorni durante i quali vengono conservati i backup automatici. È necessario specificare un valore minimo pari a 1.

  Impostazione predefinita: 1

  Vincoli:

  • Il valore deve essere compreso tra 1 e 35

• CopyTagsToSnapshot (nella CLI: --copy-tags-to-snapshot): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• DatabaseName (nella CLI: --database-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Nome per il database, composto da un massimo di 64 caratteri alfanumerici. Se non specifichi un nome, Amazon Neptune non creerà un database nel cluster di database che stai creando.

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  L'identificatore del cluster di database. Questo parametro è archiviato come stringa in minuscolo.

  Vincoli:

  • Deve contenere da 1 a 63 lettere, numeri o trattini.

  • Il primo carattere deve essere una lettera.

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

  Esempio: my-cluster1

• DBClusterParameterGroupName (nella CLI: --db-cluster-parameter-group-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Nome del gruppo di parametri del cluster di database che desideri associare al cluster di database. Se questo argomento viene omesso, viene utilizzato il valore predefinito.

  Vincoli:

  • Se viene specificato, deve corrispondere al nome di un oggetto DBClusterParameterGroup esistente.

• DBSubnetGroupName (nella CLI: --db-subnet-group-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Gruppo di sottoreti database da associare al cluster di database.

  Vincoli: deve corrispondere al nome di un oggetto DBSubnetGroup esistente. Non deve essere predefinito.

  Esempio: mySubnetgroup

• DeletionProtection (nella CLI: --deletion-protection): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Un valore che indica se per il cluster di database è abilitata la protezione dall'eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione. Per impostazione predefinita, la protezione da eliminazione è abilitata.

• EnableCloudwatchLogsExports (nella CLI: --enable-cloudwatch-logs-exports): una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database deve esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit) e slowquery (per pubblicare log di slow query). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• EnableIAMDatabaseAuthentication (nella CLI: --enable-iam-database-authentication): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, abilita l'autenticazione Amazon Identity and Access Management (IAM) per l'intero cluster database (non può essere impostato a livello di istanza).

  Default: false.

• Engine (nella CLI: --engine): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Nome del motore di database da utilizzare per il cluster di database.

  Valori validi: neptune

• EngineVersion (nella CLI: --engine-version): una stringa di tipo string (una stringa con codifica UTF-8).

  Il numero della versione del motore di database da utilizzare per il nuovo cluster di database.

  Esempio: 1.2.1.0

• GlobalClusterIdentifier (nella CLI: --global-cluster-identifier): un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  L'ID del database globale Neptune a cui aggiungere questo nuovo cluster database.

• KmsKeyId (nella CLI: --kms-key-id): una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore della chiave Amazon KMS per un cluster database crittografato.

  L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai creando un cluster database con lo stesso account Amazon che possiede la chiave di crittografia KMS utilizzata per crittografare il nuovo cluster database, puoi utilizzare l'alias della chiave KMS al posto dell'ARN per la chiave di crittografia KMS.

  Se non è specificata una chiave di crittografia in KmsKeyId:

  • Se ReplicationSourceIdentifier identifica un'origine crittografata, Amazon Neptune utilizzerà la chiave di crittografia utilizzata per crittografare l'origine. In caso contrario, Amazon Neptune utilizzerà la chiave di crittografia predefinita.

  • Se il parametro StorageEncrypted è true e l'oggetto ReplicationSourceIdentifier non è specificato, Amazon Neptune utilizzerà la chiave di crittografia predefinita.

  Amazon KMS crea la chiave di crittografia predefinita per l'account Amazon. L'account Amazon ha una chiave crittografica predefinita diversa per ogni regione Amazon.

  Se crei una replica di lettura di un cluster database crittografato in un'altra regione Amazon, devi impostare KmsKeyId su un ID di chiave KMS valido nella regione Amazon di destinazione. Questa chiave viene utilizzata per crittografare la replica di lettura nella regione Amazon.

• Port (nella CLI: --port): un valore IntegerOptional di tipo integer (numero intero a 32 bit con segno).

  Numero della porta su cui le istanze nel cluster di database accettano le connessioni.

  Impostazione predefinita: 8182

• PreferredBackupWindow (nella CLI: --preferred-backup-window): una stringa di tipo string (una stringa con codifica UTF-8).

  Intervallo di tempo giornaliero durante il quale vengono creati i backup automatici se sono abilitati tramite il parametro BackupRetentionPeriod.

  Il valore predefinito è una finestra di 30 minuti selezionata in modo casuale in un blocco di 8 ore per ogni regione Amazon. Per informazioni sui blocchi di tempo disponibili, consulta Finestra di manutenzione Neptune nella Guida per l'utente di Amazon Neptune.

  Vincoli:

  • Il valore deve essere nel formato hh24:mi-hh24:mi.

  • Il valore deve essere nel fuso orario UTC (Universal Coordinated Time).

  • Il valore non deve essere in conflitto con la finestra di manutenzione preferita.

  • Il valore deve essere almeno di 30 minuti.

• PreferredMaintenanceWindow (nella CLI: --preferred-maintenance-window): una stringa di tipo string (una stringa con codifica UTF-8).

  Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

  Formato: ddd:hh24:mi-ddd:hh24:mi

  Il valore predefinito è una finestra di 30 minuti selezionata in modo casuale in un blocco di 8 ore per ogni regione Amazon, in un giorno casuale della settimana. Per informazioni sui blocchi di tempo disponibili, consulta Finestra di manutenzione Neptune nella Guida per l'utente di Amazon Neptune.

  Giorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica.

  Vincoli: finestra di un minimo di 30 minuti.

• PreSignedUrl (nella CLI: --pre-signed-url): una stringa di tipo string (una stringa con codifica UTF-8).

  Questo parametro non è attualmente supportato.

• ReplicationSourceIdentifier (nella CLI: --replication-source-identifier): una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) dell'istanza database di origine o del cluster di database, se questo viene creato come replica di lettura.

• ServerlessV2ScalingConfiguration (nella CLI: --serverless-v2-scaling-configuration): un oggetto ServerlessV2ScalingConfiguration.

  Contiene la configurazione di dimensionamento di un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• StorageEncrypted (nella CLI: --storage-encrypted): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType (nella CLI: --storage-type): una stringa di tipo string (una stringa con codifica UTF-8).

  Tipo di archiviazione per il nuovo cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) consente di configurare archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso. Se impostato su standard, il tipo di archiviazione non viene restituito nella risposta.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• Tags (nella CLI: --tags): un array di oggetti Tag.

  Tag da assegnare al nuovo cluster di database.

• VpcSecurityGroupIds (nella CLI: --vpc-security-group-ids): una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco dei gruppi di sicurezza VPC EC2 da associare al cluster di database.

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterAlreadyExistsFault

• InsufficientStorageClusterCapacityFault

• DBClusterQuotaExceededFault

• StorageQuotaExceededFault

• DBSubnetGroupNotFoundFault

• InvalidVPCNetworkStateFault

• InvalidDBClusterStateFault

• InvalidDBSubnetGroupStateFault

• InvalidSubnet

• InvalidDBInstanceStateFault

• DBClusterParameterGroupNotFoundFault

• KMSKeyNotAccessibleFault

• DBClusterNotFoundFault

• DBInstanceNotFoundFault

• DBSubnetGroupDoesNotCoverEnoughAZs

• GlobalClusterNotFoundFault

• InvalidGlobalClusterStateFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore del cluster di database da eliminare. Questo parametro non fa distinzione tra maiuscole e minuscole.

  Vincoli:

  • Deve corrispondere a un oggetto DBClusterIdentifier esistente.

• FinalDBSnapshotIdentifier (nella CLI: --final-db-snapshot-identifier): una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore dello snapshot del cluster di database per il nuovo snapshot creato quando l'impostazione di SkipFinalSnapshot è false.

  Nota

  Se specifichi questo parametro e imposti anche il parametro SkipFinalShapshot su true, viene generato un errore.

  Vincoli:

  • Deve contenere da 1 a 255 lettere, numeri o trattini.

  • Il primo carattere deve essere una lettera

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

• SkipFinalSnapshot (nella CLI: --skip-final-snapshot): un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Determina se viene creato uno snapshot del cluster di database finale prima dell'eliminazione del cluster di database. Se viene specificato true, non viene creato alcuno snapshot del cluster di database. Se viene specificato false, viene creato uno snapshot del cluster di database prima dell'eliminazione del cluster di database.

  Nota

  È necessario specificare un parametro FinalDBSnapshotIdentifier se SkipFinalSnapshot è false.

  Impostazione predefinita: false

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterNotFoundFault

• InvalidDBClusterStateFault

• DBClusterSnapshotAlreadyExistsFault

• SnapshotQuotaExceededFault

• InvalidDBClusterSnapshotStateFault

• AllowMajorVersionUpgrade (nella CLI: --allow-major-version-upgrade): un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Un valore che indica che gli aggiornamenti tra versioni principali diverse sono permessi.

  Vincoli: devi impostare il flag allow-major-version-upgrade quando fornisci un EngineVersion parametro che utilizza una versione principale diversa rispetto a quella attuale del cluster database.

• ApplyImmediately (nella CLI: --apply-immediately): un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Valore che specifica se le modifiche in questa richiesta e le eventuali modifiche in sospeso vengono applicate in modo asincrono appena possibile, indipendentemente dall'impostazione di PreferredMaintenanceWindow per il cluster di database. Se questo parametro è impostato su false, le modifiche al cluster di database vengono applicate durante la finestra di manutenzione successiva.

  Il parametro ApplyImmediately influisce solo sui valori di NewDBClusterIdentifier. Se imposti il valore del parametro ApplyImmediately su false, le modifiche ai valori di NewDBClusterIdentifier vengono applicate durante la finestra di manutenzione successiva. Tutte le altre modifiche vengono applicate immediatamente, indipendentemente dal valore del parametro ApplyImmediately.

  Impostazione predefinita: false

• BackupRetentionPeriod (nella CLI: --backup-retention-period): un valore IntegerOptional di tipo integer (numero intero a 32 bit con segno).

  Il numero di giorni durante i quali vengono conservati i backup automatici. È necessario specificare un valore minimo pari a 1.

  Impostazione predefinita: 1

  Vincoli:

  • Il valore deve essere compreso tra 1 e 35

• CloudwatchLogsExportConfiguration (nella CLI: --cloudwatch-logs-export-configuration): un oggetto CloudwatchLogsExportConfiguration.

  L'impostazione di configurazione per i tipi di log per consentire l'esportazione in CloudWatch Logs per un determinato cluster di database. Vedi Utilizzo della CLI per pubblicare i log di audit di Neptune su CloudWatch Logs.

• CopyTagsToSnapshot (nella CLI: --copy-tags-to-snapshot): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore del cluster di database da modificare. Questo parametro non fa distinzione tra maiuscole e minuscole.

  Vincoli:

  • Deve corrispondere all'identificatore di un oggetto DBCluster esistente.

• DBClusterParameterGroupName (nella CLI: --db-cluster-parameter-group-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Nome del gruppo di parametri del cluster di database da utilizzare per il cluster di database.

• DBInstanceParameterGroupName (nella CLI: --db-instance-parameter-group-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Il nome del gruppo di parametri del database da applicare a tutte le istanze del cluster di database.

  Nota

  Se applichi un gruppo di parametri utilizzando DBInstanceParameterGroupName, le modifiche ai parametri non vengono applicate durante la finestra di manutenzione successiva, ma immediatamente.

  Impostazione predefinita: impostazione del nome esistente

  Vincoli:

  • Il gruppo di parametri del database deve trovarsi nella stessa famiglia del gruppo di parametri della versione del cluster database di destinazione.

  • Il parametro DBInstanceParameterGroupName è valido solo in combinazione con il parametro AllowMajorVersionUpgrade.

• DeletionProtection (nella CLI: --deletion-protection): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Un valore che indica se per il cluster di database è abilitata la protezione dall'eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione. Per impostazione predefinita, la protezione da eliminazione è disabilitata.

• EnableIAMDatabaseAuthentication (nella CLI: --enable-iam-database-authentication): un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  True per abilitare la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database, in caso contrario false.

  Impostazione predefinita: false

• EngineVersion (nella CLI: --engine-version): una stringa di tipo string (una stringa con codifica UTF-8).

  Numero di versione del motore di database a cui eseguire l'aggiornamento. La modifica di questo parametro provoca un'interruzione. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che il parametro ApplyImmediately non sia impostato su true.

  Per un elenco di versioni valide del motore, consulta le versioni del motore per Amazon Neptune, oppure chiama DescribeDBEngineVersions (operazione).

• NewDBClusterIdentifier (nella CLI: --new-db-cluster-identifier): una stringa di tipo string (una stringa con codifica UTF-8).

  Nuovo identificatore del cluster di database quando un cluster di database viene rinominato. Questo valore è archiviato come stringa in caratteri minuscoli.

  Vincoli:

  • Deve contenere da 1 a 63 lettere, numeri o trattini

  • Il primo carattere deve essere una lettera

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

  Esempio: my-cluster2

• Port (nella CLI: --port): un valore IntegerOptional di tipo integer (numero intero a 32 bit con segno).

  Il numero della porta sulla quale il cluster di database accetta connessioni.

  Vincoli: il valore deve essere compreso nell'intervallo 1150-65535

  Impostazione predefinita: la stessa porta del cluster di database originale.

• PreferredBackupWindow (nella CLI: --preferred-backup-window): una stringa di tipo string (una stringa con codifica UTF-8).

  Intervallo di tempo giornaliero durante il quale vengono creati i backup automatici, se sono abilitati tramite il parametro BackupRetentionPeriod.

  Il valore predefinito è una finestra di 30 minuti selezionata in modo casuale in un blocco di 8 ore per ogni regione Amazon.

  Vincoli:

  • Il valore deve essere nel formato hh24:mi-hh24:mi.

  • Il valore deve essere nel fuso orario UTC (Universal Coordinated Time).

  • Il valore non deve essere in conflitto con la finestra di manutenzione preferita.

  • Il valore deve essere almeno di 30 minuti.

• PreferredMaintenanceWindow (nella CLI: --preferred-maintenance-window): una stringa di tipo string (una stringa con codifica UTF-8).

  Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

  Formato: ddd:hh24:mi-ddd:hh24:mi

  Il valore predefinito è una finestra di 30 minuti selezionata in modo casuale in un blocco di 8 ore per ogni regione Amazon, in un giorno casuale della settimana.

  Giorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica.

  Vincoli: finestra di un minimo di 30 minuti.

• ServerlessV2ScalingConfiguration (nella CLI: --serverless-v2-scaling-configuration): un oggetto ServerlessV2ScalingConfiguration.

  Contiene la configurazione di dimensionamento di un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• StorageType (nella CLI: --storage-type): una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione da associare al cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) consente di configurare archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroupIds (nella CLI: --vpc-security-group-ids): una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterNotFoundFault

• InvalidDBClusterStateFault

• StorageQuotaExceededFault

• DBSubnetGroupNotFoundFault

• InvalidVPCNetworkStateFault

• InvalidDBSubnetGroupStateFault

• InvalidSubnet

• DBClusterParameterGroupNotFoundFault

• InvalidDBSecurityGroupStateFault

• InvalidDBInstanceStateFault

• DBClusterAlreadyExistsFault

• StorageTypeNotSupportedFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore del cluster di database del cluster di database Neptune da avviare. Questo parametro è archiviato come stringa in minuscolo.

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterNotFoundFault

• InvalidDBClusterStateFault

• InvalidDBInstanceStateFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  L'identificatore del cluster di database del cluster di database Neptune da arrestare. Questo parametro è archiviato come stringa in minuscolo.

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterNotFoundFault

• InvalidDBClusterStateFault

• InvalidDBInstanceStateFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Nome del cluster di database a cui associare il ruolo IAM.

• FeatureName (nella CLI: --feature-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Il nome della funzionalità per il cluster database Neptune a cui associare il ruolo IAM. Per l'elenco dei nomi delle caratteristiche supportate, consulta DBEngineVersion (struttura).

• RoleArn (nella CLI: --role-arn): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) del ruolo IAM da associare al cluster di database Neptune, ad esempio arn:aws:iam::123456789012:role/NeptuneAccessRole.

Risposta

• Nessun parametro di risposta.

Errori

• DBClusterNotFoundFault

• DBClusterRoleAlreadyExistsFault

• InvalidDBClusterStateFault

• DBClusterRoleQuotaExceededFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Nome del cluster di database di cui annullare l'associazione dal ruolo IAM.

• FeatureName (nella CLI: --feature-name): una stringa di tipo string (una stringa con codifica UTF-8).

  Il nome della funzionalità per il cluster database da cui si desidera dissociare il ruolo IAM. Per l'elenco dei nomi delle caratteristiche supportate, consulta DescribeDBEngineVersions (operazione).

• RoleArn (nella CLI: --role-arn): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) del ruolo IAM di cui annullare l'associazione dal cluster di database, ad esempio arn:aws:iam::123456789012:role/NeptuneAccessRole.

Risposta

• Nessun parametro di risposta.

Errori

• DBClusterNotFoundFault

• DBClusterRoleNotFoundFault

• InvalidDBClusterStateFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore del cluster di database per cui forzare un failover. Questo parametro non fa distinzione tra maiuscole e minuscole.

  Vincoli:

  • Deve corrispondere all'identificatore di un oggetto DBCluster esistente.

• TargetDBInstanceIdentifier (nella CLI: --target-db-instance-identifier): una stringa di tipo string (una stringa con codifica UTF-8).

  Nome dell'istanza da promuovere a istanza primaria.

  È necessario specificare l'identificatore di istanza per una replica di lettura nel cluster di database. Ad esempio, mydbcluster-replica1.

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterNotFoundFault

• InvalidDBClusterStateFault

• InvalidDBInstanceStateFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato.

• AllocatedStorage: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: una matrice di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: una matrice di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: una matrice di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

Errori

• DBClusterNotFoundFault

• InvalidDBClusterStateFault

• DBClusterIdentifier (nella CLI: --db-cluster-identifier): una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore del cluster di database fornito dall'utente. Se questo parametro viene specificato, vengono restituite solo le informazioni del cluster di database specifico. Questo parametro non fa distinzione tra maiuscole e minuscole.

  Vincoli:

  • Se viene specificato, deve corrispondere a un oggetto DBClusterIdentifier esistente.

• Filters (nella CLI: --filters): un array di oggetti Filtro.

  Filtro che specifica uno o più cluster di database da descrivere.

  Filtri supportati:

  • db-cluster-id: accetta identificatori e Amazon Resource Name (ARN) di cluster di database. L'elenco di risultati includerà solo le informazioni sui cluster di database identificati da questi ARN.

  • engine: accetta un nome del motore (ad esempio neptune) e limita l'elenco dei risultati ai cluster database creati da tale motore.

  Ad esempio, per richiamare questa API dall'interfaccia della riga di comando Amazon e filtrare in modo che vengano restituiti solo i cluster database Neptune, potresti utilizzare il seguente comando:

  aws neptune describe-db-clusters \
              --filters  Name=engine,Values=neptune

• Marker (nella CLI: --marker): una stringa di tipo string (una stringa con codifica UTF-8).

  Token di paginazione opzionale fornito da una richiesta DescribeDBClusters (operazione) precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da MaxRecords.

• MaxRecords (nella CLI: --max-records): un valore IntegerOptional di tipo integer (numero intero a 32 bit con segno).

  Numero massimo di record da includere nella risposta. Se sono presenti più record rispetto al valore di MaxRecords specificato, nella risposta viene incluso un token di paginazione detto contrassegno (oggetto Marker), per permettere di recuperare i risultati rimanenti.

  Impostazione predefinita: 100

  Vincoli: minimo 20, massimo 100.

• DBClusters: una matrice di oggetti DBCluster.

  Contiene un elenco di cluster di database per l'utente.

• Marker: una stringa di tipo string (una stringa con codifica UTF-8).

  Token di paginazione che è possibile utilizzare in una richiesta DescribeDBClusters successiva.

Errori

• DBClusterNotFoundFault

Campi

• AllocatedStorage: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  AllocatedStorage restituisce sempre 1, perché le dimensioni di storage dei cluster di database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• AssociatedRoles: questo è un array di oggetti DBClusterRole.

  Fornisce un elenco dei ruoli Amazon Identity and Access Management (IAM) associati al cluster di database. I ruoli IAM associati a un cluster di database concedono l'autorizzazione per l'accesso del cluster di database ad altri servizi Amazon per tuo conto.

• AutomaticRestartTime: questo è un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Ora in cui il cluster database verrà riavviato automaticamente.

• AvailabilityZones: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce l'elenco delle zone di disponibilità EC2 in cui è possibile creare istanze nel cluster di database.

• BacktrackConsumedChangeRecords: questo è un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BacktrackWindow: questo è un valore LongOptional di tipo long (numero intero a 64 bit con segno).

  Non supportato da Neptune.

• BackupRetentionPeriod: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica il numero di giorni durante i quali vengono conservati gli snapshot DB automatici.

• Capacity: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Non supportato da Neptune.

• CloneGroupId: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Identifica il gruppo di cloni a cui è associato il cluster di database.

• ClusterCreateTime: questo è un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ora di creazione del cluster di database, nel fuso orario UTC (Universal Coordinated Time).

• CopyTagsToSnapshot: questo è un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, i tag vengono copiati in qualsiasi snapshot del cluster database che viene creato.

• CrossAccountClone: questo è un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Se impostato su true, il cluster database può essere clonato su più account.

• DatabaseName: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene il nome del database iniziale di questo cluster di database, fornito al momento della creazione, se è stato specificato un nome quando il cluster di database è stato creato. Questo stesso nome viene restituito per la durata del cluster di database.

• DBClusterArn: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il cluster di database.

• DBClusterIdentifier: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene un identificatore del cluster di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster di database.

• DBClusterMembers: questo è un array di oggetti DBClusterMember.

  Fornisce l'elenco delle istanze che compongono il cluster di database.

• DBClusterParameterGroup: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica il nome del gruppo di parametri del cluster di database per il cluster stesso.

• DbClusterResourceId: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Identificatore univoco e non modificabile della regione Amazon per il cluster database. Questo identificativo è disponibile nelle voci di log di Amazon CloudTrail ogni volta che si accede alla chiave Amazon KMS per il cluster database.

• DBSubnetGroup: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica le informazioni sul gruppo di sottoreti associato al cluster di database, tra cui nome, descrizione e sottoreti nel gruppo.

• DeletionProtection: questo è un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Indica se per il cluster di database è abilitata o meno la protezione da eliminazione. Il database non può essere eliminato quando è abilitata la protezione da eliminazione.

• EarliestBacktrackTime: questo è un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Non supportato da Neptune.

• EarliestRestorableTime: questo è un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica il primo orario possibile per il ripristino point-in-time di un database.

• EnabledCloudwatchLogsExports: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Elenco di tipi di log che questo cluster database può esportare in CloudWatch Logs. I tipi di log validi sono: audit (per pubblicare log di audit su CloudWatch) e slowquery (per pubblicare log di slow query su CloudWatch). Consulta Pubblicazione di log Neptune nei file di log Amazon CloudWatch.

• Endpoint: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'endpoint di connessione per l'istanza primaria del cluster di database.

• Engine: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Fornisce il nome del motore di database da utilizzare per questo cluster di database.

• EngineVersion: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Indica la versione del motore di database.

• GlobalClusterIdentifier: questo è un valore GlobalClusterIdentifier di tipo string (stringa codificata UTF-8), non inferiore a 1 o superiore a 255 ?st?s, corrispondente a questa espressione regolare: [A-Za-z][0-9A-Za-z-:._]*.

  Contiene un identificatore del cluster database globale fornito dall'utente. Questo identificatore è la chiave univoca che identifica un database globale.

• HostedZoneId: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.

• IAMDatabaseAuthenticationEnabled: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  True se la mappatura degli account Amazon Identity and Access Management (IAM) agli account di database è abilitata, in caso contrario false.

• IOOptimizedNextAllowedModificationTime: questo è un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La prossima volta puoi modificare il cluster di database per utilizzare il tipo di archiviazione iopt1.

• KmsKeyId: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per il cluster di database crittografato.

• LatestRestorableTime: questo è un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  Specifica l'ultimo orario possibile per il ripristino point-in-time di un database.

• MultiAZ: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database ha istanze in più zone di disponibilità.

• PendingModifiedValues: questo è un oggetto ClusterPendingModifiedValues.

  Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione ModifyDBCluster e contiene le modifiche che verranno applicate nella finestra di manutenzione successiva.

• PercentProgress: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'avanzamento dell'operazione sotto forma di percentuale.

• Port: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Specifica la porta su cui è in ascolto il motore di database.

• PreferredBackupWindow: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da BackupRetentionPeriod.

• PreferredMaintenanceWindow: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.

• ReaderEndpoint: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  L'endpoint di lettura per il cluster di database. L'endpoint di lettura per un cluster di database bilancia il carico delle connessioni tra le repliche di lettura disponibili in un cluster di database. Man mano che i client richiedono nuove connessioni all'endpoint di lettura, Neptune distribuisce tali richieste fra le repliche di lettura nel cluster di database. Questa funzionalità è utile per bilanciare il carico di lavoro di lettura tra più repliche di lettura nel cluster di database.

  Se si verifica un failover e la replica di lettura a cui sei connesso viene promossa a istanza primaria, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di lettura nel cluster, puoi quindi riconnetterti all'endpoint di lettura.

• ReadReplicaIdentifiers: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Contiene uno o più identificatori delle repliche di lettura associate a questo cluster di database.

• ReplicationSourceIdentifier: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ReplicationType: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Non supportato da Neptune.

• ServerlessV2ScalingConfiguration: questo è un oggetto ServerlessV2ScalingConfigurationInfo.

  Mostra la configurazione del dimensionamento per un cluster database Neptune Serverless.

  Per ulteriori informazioni, consulta Utilizzo di Amazon Neptune Serverless nella Guida per l'utente di Amazon Neptune.

• Status: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato corrente del cluster di database.

• StorageEncrypted: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Specifica se il cluster di database è crittografato.

• StorageType: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Il tipo di archiviazione utilizzato dal cluster di database.

  Valori validi:

  • standard: (impostazione predefinita) fornisce archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.

• VpcSecurityGroups: questo è un array di oggetti VpcSecurityGroupMembership.

  Fornisce un elenco dei gruppi di sicurezza VPC a cui appartiene il cluster di database.

• CreateDBCluster

• DeleteDBCluster

• FailoverDBCluster

• ModifyDBCluster

• PromoteReadReplicaDBCluster

• RestoreDBClusterFromSnapshot

• RestoreDBClusterToPointInTime

• StartDbCluster

• StopDBCluster

Campi

• DBClusterParameterGroupStatus: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica lo stato del gruppo di parametri del cluster di database per il membro del cluster di database.

• DBInstanceIdentifier: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Specifica l'identificatore di istanza per il membro del cluster di database.

• IsClusterWriter: questo è un valore booleano di tipo boolean [un valore booleano (vero o falso)].

  Valore corrispondente a true se il membro del cluster è l'istanza primaria per il cluster di database, in caso contrario false.

• PromotionTier: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Valore che specifica l'ordine di promozione di una replica di lettura a istanza primaria dopo un errore dell'istanza primaria esistente.

Campi

• FeatureName: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Il nome della caratteristica associata al ruolo Amazon Identity and Access Management (IAM). Per l'elenco dei nomi delle caratteristiche supportate, consulta DescribeDBEngineVersions (operazione).

• RoleArn: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) del ruolo IAM associato al cluster di database.

• Status: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Descrive lo stato dell'associazione tra il ruolo IAM e il cluster di database. La proprietà Status restituisce uno dei valori seguenti:

  • ACTIVE: l'ARN del ruolo IAM è associato al cluster database e può essere utilizzato per accedere ad altri servizi Amazon per tuo conto.

  • PENDING: è in corso l'associazione dell'ARN del ruolo IAM al cluster di database.

  • INVALID: l'ARN del ruolo IAM è associato al cluster database, ma il cluster database non è in grado di assumere il ruolo IAM per accedere ad altri servizi Amazon per tuo conto.

Campi

• DisableLogTypes: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  L'elenco dei tipi di log da disabilitare.

• EnableLogTypes: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  L'elenco dei tipi di log da abilitare.

Campi

• LogTypesToDisable: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Tipi di log in fase di abilitazione. Una volta abilitati, questi tipi di log vengono esportati in CloudWatch Logs.

• LogTypesToEnable: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Tipi di log in fase di disattivazione. Una volta disattivati, questi tipi di log non vengono esportati in CloudWatch Logs.

Campi

• AllocatedStorage: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  La dimensione dell'archiviazione allocato in gibibyte (GiB) per i motori di database. Per Neptune, AllocatedStorage restituisce sempre 1, perché le dimensioni di archiviazione dei cluster database Neptune non sono fisse, ma vengono regolate automaticamente in base alle esigenze.

• BackupRetentionPeriod: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Il numero di giorni durante i quali vengono conservati gli snapshot automatici del database.

• DBClusterIdentifier: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  Il valore DBClusterIdentifier per il cluster database.

• EngineVersion: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  La versione del motore del database.

• IAMDatabaseAuthenticationEnabled: questo è un valore BooleanOptional di tipo boolean [un valore booleano (vero o falso)].

  Un valore che indica la mappatura degli account AWS Identity and Access Management (IAM) agli account di database è abilitata.

• Iops: questo è un valore IntegerOptional di tipo integer(numero intero a 32 bit con segno).

  Il valore della capacità di IOPS (operazioni di I/O al secondo) allocata. Questa impostazione è solo per cluster di database Multi-AZ.

• PendingCloudwatchLogsExports: questo è un oggetto PendingCloudwatchLogsExports.

  Questa struttura PendingCloudwatchLogsExports specifica su quali log di CloudWatch sono abilitate e disabilitate le modifiche in sospeso.

• StorageType: questa è una stringa di tipo string (una stringa con codifica UTF-8).

  La modifica in sospeso nel tipo di archiviazione per il cluster di database.   Valori validi:

  • standard: (impostazione predefinita) consente di configurare archiviazione di database dai costi contenuti per applicazioni con un numero di operazioni di I/O da moderato a basso.

  • iopt1: abilita l'archiviazione ottimizzata per l'I/O che è progettata per soddisfare le esigenze di carichi di lavoro grafici con un numero elevato di operazioni di I/O che richiedono prezzi prevedibili con bassa latenza I/O e velocità di trasmissione effettiva I/O coerente.

    L'archiviazione ottimizzata per l'I/O di Neptune è disponibile solo a partire dal rilascio 1.3.0.0 del motore.