API di snapshot Neptune - Amazon Neptune

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

API di snapshot Neptune

Operazioni:

Strutture:

CreateDBClusterSnapshot (operazione)

        Il nome AWS CLI per questa API è: create-db-cluster-snapshot.

Crea uno snapshot di un cluster di database.

Richiesta

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

    L'identificatore del cluster di database per il quale creare uno snapshot. Questo parametro non fa distinzione tra maiuscole e minuscole.

    Vincoli:

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

    Esempio: my-cluster1

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

    L'identificatore dello snapshot 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-snapshot1

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

    I tag da assegnare allo snapshot del cluster di database.

Risposta

Contiene i dettagli per uno snapshot del cluster di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione DescribeDBClusterSnapshots (operazione).

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

    Specifica le dimensioni dello storage allocato, in gibibyte (GiB).

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

    Fornisce l'elenco delle zone di disponibilità EC2 nelle quali è possibile ripristinare istanze nello snapshot del 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).

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

    Specifica l'identificatore del cluster di database, dal quale è stato creato questo snapshot del cluster di database.

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

    L'Amazon Resource Name (ARN) per lo snapshot del cluster di database.

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

    Specifica l'identificatore per uno snapshot del cluster DB. Deve corrispondere all'identificatore di una snapshot esistente.

    Dopo aver ripristinato un cluster di database utilizzando DBClusterSnapshotIdentifier, è necessario specificare lo stesso DBClusterSnapshotIdentifier per eventuali aggiornamenti futuri al cluster di database. Quando specifichi questa proprietà per un aggiornamento, il cluster di database non viene nuovamente ripristinato dallo snapshot e i dati nel database non vengono modificati.

    Tuttavia, se non specifichi DBClusterSnapshotIdentifier, viene creato un cluster DB vuoto e il cluster DB originale viene eliminato. Se specifichi una proprietà diversa dalla proprietà di ripristino dello snapshot precedente, il cluster DB viene ripristinato dallo snapshot specificato da DBClusterSnapshotIdentifier e il cluster DB originale viene eliminato.

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

    Specifica il nome del motore di database.

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

    Fornisce la versione del motore di database da utilizzare per questo snapshot del cluster di database.

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

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

    Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per lo snapshot del cluster database crittografato.

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

    Fornisce le informazioni del modello di licenza per questo snapshot del cluster di database.

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

    Specifica la percentuale dei dati stimati che sono stati trasferiti.

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

    Specifica la porta con la quale il cluster di database ascoltava al momento della creazione dello snapshot.

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

    Fornisce l'ora di creazione dello snapshot, nel formato UTC (Universal Coordinated Time).

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

    Fornisce il tipo di snapshot del cluster di database.

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

    Se lo snapshot del cluster di database è stato copiato da uno snapshot del cluster di database di origine, l'Amazon Resource Name (ARN) per lo snapshot del cluster di database di origine, in caso contrario, presenta un valore null.

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

    Specifica lo stato dello snapshot del cluster di database.

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

    Specifica se lo snapshot del cluster di database è crittografato.

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

    Il tipo di archiviazione associato allo snapshot del cluster di database.

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

    Fornisce l'ID VPC associato allo snapshot del cluster di database.

DeleteDBClusterSnapshot (operazione)

        Il nome AWS CLI per questa API è: delete-db-cluster-snapshot.

Elimina uno snapshot del cluster di database. Se si copia lo snapshot, l'operazione di copia viene terminata.

Nota

Lo snapshot del cluster di database snapshot deve essere nello stato available per essere eliminato.

Richiesta

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

    L'identificatore dello snapshot del cluster di database da eliminare.

    Vincoli: deve essere il nome di uno snapshot del cluster di database esistente nello stato available.

Risposta

Contiene i dettagli per uno snapshot del cluster di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione DescribeDBClusterSnapshots (operazione).

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

    Specifica le dimensioni dello storage allocato, in gibibyte (GiB).

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

    Fornisce l'elenco delle zone di disponibilità EC2 nelle quali è possibile ripristinare istanze nello snapshot del 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).

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

    Specifica l'identificatore del cluster di database, dal quale è stato creato questo snapshot del cluster di database.

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

    L'Amazon Resource Name (ARN) per lo snapshot del cluster di database.

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

    Specifica l'identificatore per uno snapshot del cluster DB. Deve corrispondere all'identificatore di una snapshot esistente.

    Dopo aver ripristinato un cluster di database utilizzando DBClusterSnapshotIdentifier, è necessario specificare lo stesso DBClusterSnapshotIdentifier per eventuali aggiornamenti futuri al cluster di database. Quando specifichi questa proprietà per un aggiornamento, il cluster di database non viene nuovamente ripristinato dallo snapshot e i dati nel database non vengono modificati.

    Tuttavia, se non specifichi DBClusterSnapshotIdentifier, viene creato un cluster DB vuoto e il cluster DB originale viene eliminato. Se specifichi una proprietà diversa dalla proprietà di ripristino dello snapshot precedente, il cluster DB viene ripristinato dallo snapshot specificato da DBClusterSnapshotIdentifier e il cluster DB originale viene eliminato.

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

    Specifica il nome del motore di database.

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

    Fornisce la versione del motore di database da utilizzare per questo snapshot del cluster di database.

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

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

    Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per lo snapshot del cluster database crittografato.

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

    Fornisce le informazioni del modello di licenza per questo snapshot del cluster di database.

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

    Specifica la percentuale dei dati stimati che sono stati trasferiti.

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

    Specifica la porta con la quale il cluster di database ascoltava al momento della creazione dello snapshot.

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

    Fornisce l'ora di creazione dello snapshot, nel formato UTC (Universal Coordinated Time).

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

    Fornisce il tipo di snapshot del cluster di database.

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

    Se lo snapshot del cluster di database è stato copiato da uno snapshot del cluster di database di origine, l'Amazon Resource Name (ARN) per lo snapshot del cluster di database di origine, in caso contrario, presenta un valore null.

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

    Specifica lo stato dello snapshot del cluster di database.

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

    Specifica se lo snapshot del cluster di database è crittografato.

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

    Il tipo di archiviazione associato allo snapshot del cluster di database.

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

    Fornisce l'ID VPC associato allo snapshot del cluster di database.

CopyDBClusterSnapshot (operazione)

        Il nome AWS CLI per questa API è: copy-db-cluster-snapshot.

Copia uno snapshot di un cluster di database.

Per copiare uno snapshot del cluster di database da uno snapshot del cluster di database manuale condiviso, SourceDBClusterSnapshotIdentifier deve essere l'Amazon Resource Name (ARN) dello snapshot del cluster di database condiviso.

Richiesta

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

    True per copiare tutti i tag dallo snapshot del cluster di database di origine allo snapshot del cluster di database di destinazione, in caso contrario false. Il valore di default è false.

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

    L'ID della chiave Amazon KMS per uno snapshot del cluster database crittografato. L'ID della chiave KMS è l'Amazon Resource Name (ARN), l'identificatore della chiave KMS o l'alias della chiave KMS per la chiave di crittografia KMS.

    Se copi uno snapshot del cluster database crittografato dall'account Amazon, puoi specificare un valore per KmsKeyId per crittografare la copia con una nuova chiave di crittografia KMS. Se non si specifica un valore per KmsKeyId, la copia dello snapshot del cluster di database viene crittografata con la stessa chiave KMS dello snapshot del cluster di database di origine.

    Se copi uno snapshot del cluster database crittografato che è condiviso da un altro account Amazon, devi specificare un valore per KmsKeyId.

    Le chiavi di crittografia KMS sono specifiche per la regione Amazon nella quale vengono create e non puoi utilizzare le chiavi di crittografia di una regione Amazon in un'altra.

    Non è possibile crittografare uno snapshot del cluster di database non crittografato durante la sua copia. Se si tenta di copiare uno snapshot del cluster di database non crittografato e si specifica un valore per il parametro KmsKeyId, viene restituito un errore.

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

    Attualmente non è supportato.

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

    L'identificatore dello snapshot del cluster di database da copiare. Questo parametro non fa distinzione tra maiuscole e minuscole.

    Vincoli:

    • Deve specificare uno snapshot di sistema valido nello stato "disponibile".

    • Specificare un identificatore dello snapshot di database valido.

    Esempio: my-cluster-snapshot1

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

    I tag da assegnare alla nuova copia dello snapshot del cluster di database.

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

    L'identificatore del nuovo snapshot del cluster di database da creare dallo snapshot del cluster di database di origine. Questo parametro non fa distinzione tra maiuscole e minuscole.

    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-cluster-snapshot2

Risposta

Contiene i dettagli per uno snapshot del cluster di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione DescribeDBClusterSnapshots (operazione).

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

    Specifica le dimensioni dello storage allocato, in gibibyte (GiB).

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

    Fornisce l'elenco delle zone di disponibilità EC2 nelle quali è possibile ripristinare istanze nello snapshot del 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).

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

    Specifica l'identificatore del cluster di database, dal quale è stato creato questo snapshot del cluster di database.

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

    L'Amazon Resource Name (ARN) per lo snapshot del cluster di database.

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

    Specifica l'identificatore per uno snapshot del cluster DB. Deve corrispondere all'identificatore di una snapshot esistente.

    Dopo aver ripristinato un cluster di database utilizzando DBClusterSnapshotIdentifier, è necessario specificare lo stesso DBClusterSnapshotIdentifier per eventuali aggiornamenti futuri al cluster di database. Quando specifichi questa proprietà per un aggiornamento, il cluster di database non viene nuovamente ripristinato dallo snapshot e i dati nel database non vengono modificati.

    Tuttavia, se non specifichi DBClusterSnapshotIdentifier, viene creato un cluster DB vuoto e il cluster DB originale viene eliminato. Se specifichi una proprietà diversa dalla proprietà di ripristino dello snapshot precedente, il cluster DB viene ripristinato dallo snapshot specificato da DBClusterSnapshotIdentifier e il cluster DB originale viene eliminato.

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

    Specifica il nome del motore di database.

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

    Fornisce la versione del motore di database da utilizzare per questo snapshot del cluster di database.

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

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

    Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per lo snapshot del cluster database crittografato.

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

    Fornisce le informazioni del modello di licenza per questo snapshot del cluster di database.

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

    Specifica la percentuale dei dati stimati che sono stati trasferiti.

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

    Specifica la porta con la quale il cluster di database ascoltava al momento della creazione dello snapshot.

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

    Fornisce l'ora di creazione dello snapshot, nel formato UTC (Universal Coordinated Time).

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

    Fornisce il tipo di snapshot del cluster di database.

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

    Se lo snapshot del cluster di database è stato copiato da uno snapshot del cluster di database di origine, l'Amazon Resource Name (ARN) per lo snapshot del cluster di database di origine, in caso contrario, presenta un valore null.

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

    Specifica lo stato dello snapshot del cluster di database.

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

    Specifica se lo snapshot del cluster di database è crittografato.

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

    Il tipo di archiviazione associato allo snapshot del cluster di database.

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

    Fornisce l'ID VPC associato allo snapshot del cluster di database.

ModifyDbClusterSnapshotAttribute (operazione)

        Il nome AWS CLI per questa API è: modify-db-cluster-snapshot-attribute.

Aggiunge un attributo e valori a, o rimuove un attributo e valori da, uno snapshot del cluster di database manuale.

Per condividere uno snapshot del cluster database manuale con altri account Amazon, specifica restore come AttributeName e utilizza il parametro ValuesToAdd per aggiungere un elenco di ID degli account Amazon che sono autorizzati a ripristinare lo snapshot del cluster database manuale. Utilizza il valore all per rendere pubblico lo snapshot del cluster database manuale, il che significa che può essere copiato o ripristinato da tutti gli account Amazon. Non aggiungere il valore all per nessuno snapshot del cluster database manuale contenente informazioni private che non vuoi rendere disponibili a tutti gli account Amazon. Se uno snapshot del cluster database manuale è crittografato, può essere condiviso, ma solo specificando un elenco di ID account Amazon autorizzati per il parametro ValuesToAdd. Non è possibile utilizzare all come valore per il parametro in questo caso.

Per visualizzare quali account Amazon hanno accesso per copiare o ripristinare uno snapshot del cluster database manuale oppure se uno snapshot del cluster database manuale è pubblico o privato, utilizza l'azione API DescribeDBClusterSnapshotAttributes (operazione).

Richiesta

  • AttributeName (nella CLI: --attribute-name): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

    Il nome dell'attributo dello snapshot del cluster di database da modificare.

    Per gestire le autorizzazioni per altri account Amazon per copiare o ripristinare uno snapshot del cluster database manuale, imposta questo valore su restore.

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

    L'identificatore per lo snapshot del cluster di database per il quale modificare gli attributi.

  • ValuesToAdd (nella CLI: --values-to-add): una stringa di tipo string (una stringa con codifica UTF-8).

    Un elenco di attributi dello snapshot del cluster di database da aggiungere all'attributo specificato da AttributeName.

    Per autorizzare altri account Amazon a copiare o ripristinare uno snapshot del cluster database manuale, imposta questo elenco affinché includa uno o più ID account Amazon o all per rendere ripristinabile lo snapshot del cluster database manuale da qualsiasi account Amazon. Non aggiungere il valore all per nessuno snapshot del cluster database manuale contenente informazioni private che non vuoi rendere disponibili a tutti gli account Amazon.

  • ValuesToRemove (nella CLI: --values-to-remove): una stringa di tipo string (una stringa con codifica UTF-8).

    Un elenco di attributi dello snapshot del cluster di database da rimuovere dall'attributo specificato da AttributeName.

    Per rimuovere l'autorizzazione per altri account Amazon a copiare o ripristinare uno snapshot del cluster database manuale, imposta questo elenco per includere uno o più identificatori di account Amazon o all per rimuovere l'autorizzazione di qualsiasi account Amazon a copiare o ripristinare lo snapshot del cluster database. Se specifichi all, un account Amazon il cui ID account viene esplicitamente aggiunto all'attributo restore può continuare a copiare o ripristinare uno snapshot del cluster database manuale.

Risposta

Contiene i risultati di una chiamata riuscita all'operazione API DescribeDBClusterSnapshotAttributes (operazione).

Gli attributi dello snapshot del cluster database manuale vengono utilizzati per autorizzare altri account Amazon a copiare o ripristinare uno snapshot del cluster database manuale. Per ulteriori informazioni, consultare ModifyDbClusterSnapshotAttribute (operazione) operazione API.

  • DBClusterSnapshotAttributes: una matrice di oggetti DBClusterSnapshotAttribute.

    L'elenco di attributi e valori per lo snapshot del cluster di database manuale.

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

    L'identificatore dello snapshot del cluster di database manuale al quale si applicano gli attributi.

RestoreDBClusterFromSnapshot (operazione)

        Il nome AWS CLI per questa API è: restore-db-cluster-from-snapshot.

Crea un nuovo cluster database da uno snapshot di database o da uno snapshot del cluster database.

Se uno snapshot DB viene specificato, il cluster di database di destinazione viene creato dallo snapshot di database di origine con una configurazione predefinita e il gruppo di sicurezza predefiniti.

Se viene specificato uno snapshot del cluster di database, il cluster di database di destinazione viene creato dal punto di ripristino del cluster di database di origine con la stessa configurazione del cluster originale di database di origine, però il nuovo cluster di database viene creato con il gruppo di sicurezza predefinito.

Richiesta

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

    Fornisce l'elenco delle zone di disponibilità EC2 nelle quali è possibile creare istanze nel cluster di database ripristinato.

  • 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 ripristinato che viene creato.

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

    Non supportato.

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

    Il nome del cluster di database da creare dallo snapshot di database o dallo snapshot del cluster di database. Questo parametro non fa distinzione tra maiuscole e minuscole.

    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-snapshot-id

  • 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 nuovo cluster di database.

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

    Nome del gruppo di sottoreti di database da utilizzare per il nuovo cluster di database.

    Vincoli: se specificato, deve corrispondere al nome di un oggetto DBSubnetGroup esistente.

    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 è disabilitata.

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

    L'elenco dei log che il cluster di database ripristinato deve esportare in Amazon CloudWatch Logs.

  • 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

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

    Il motore di database da utilizzare per il nuovo cluster di database.

    Impostazione predefinita: uguale all'origine

    Vincolo: deve essere compatibile con il motore dell'origine

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

    La versione del motore di database da utilizzare per il nuovo cluster di database.

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

    L'identificatore della chiave Amazon KMS da utilizzare per il ripristino di un cluster database crittografato da uno snapshot di database o da uno snapshot del cluster database.

    L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai ripristinando 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 si specifica un valore per il parametro KmsKeyId, avviene quanto segue:

    • Se lo snapshot di database o lo snapshot del cluster database in SnapshotIdentifier sono crittografati, il cluster database viene crittografato utilizzando la chiave KMS utilizzata per crittografare lo snapshot di database o lo snapshot del cluster database.

    • Se lo snapshot di database o lo snapshot del cluster database in SnapshotIdentifier non sono crittografati, il cluster database ripristinato non è crittografato.

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

    Il numero della porta sulla quale il nuovo 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.

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

  • SnapshotIdentifier (nella CLI: --snapshot-identifier): Obbligatorio: una stringa di tipo string (una stringa con codifica UTF-8).

    L'identificatore per lo snapshot di database o dello snapshot del cluster di database dal quale ripristinare.

    È possibile utilizzare il nome o l'Amazon Resource Name (ARN) per specificare uno snapshot del cluster di database. Tuttavia, è possibile utilizzare solo l'ARN per specificare uno snapshot di database.

    Vincoli:

    • Deve corrispondere all'identificatore di uno snapshot esistente.

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

    Specifica il tipo di archiviazione da associare al cluster di database.

    Valori validi: standard, iopt1

    Impostazione predefinita: standard

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

    I tag da assegnare al cluster di database ripristinato.

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

    Elenco dei gruppi di sicurezza VPC al quale appartiene il nuovo cluster di database.

Risposta

Contiene i dettagli di un cluster di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'DescribeDBClusters (operazione).

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

RestoreDBClusterToPointInTime (operazione)

        Il nome AWS CLI per questa API è: restore-db-cluster-to-point-in-time.

Ripristina un cluster di database a un point-in-time arbitrario. Gli utenti possono ripristinare a qualsiasi point-in-time prima di LatestRestorableTime per un massimo di BackupRetentionPeriod giorni. Il cluster di database di destinazione viene creato dal punto di ripristino del cluster di database di origine con la stessa configurazione del cluster originale di database di origine, però il nuovo cluster di database viene creato con il gruppo di sicurezza DB predefinito.

Nota

Questa operazione ripristina solo il cluster di database, non le istanze database per tale cluster di database. È necessario invocare l'operazione CreateDBInstance (operazione) per creare le istanze database del cluster di database ripristinato, specificando l'identificatore del cluster di database ripristinato in DBClusterIdentifier. È possibile creare le istanze database solo dopo che l'operazione RestoreDBClusterToPointInTime è completata e il cluster di database è disponibile.

Richiesta

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

    Il nome del nuovo cluster di database da creare.

    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

  • 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 nuovo cluster di database.

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

    Il nome del gruppo di sottoreti di database da utilizzare per il nuovo cluster di database.

    Vincoli: se specificato, deve corrispondere al nome di un oggetto DBSubnetGroup esistente.

    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 è disabilitata.

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

    L'elenco dei log che il cluster di database ripristinato deve esportare in CloudWatch Logs.

  • 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

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

    L'identificatore della chiave Amazon KMS da utilizzare per il ripristino di un cluster database crittografato da un cluster database crittografato.

    L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai ripristinando 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.

    È possibile ripristinare a un nuovo cluster di database e crittografare il nuovo cluster di database con una chiave KMS diversa dalla chiave KMS utilizzata per crittografare il cluster di database di origine. Il nuovo cluster di database è crittografato con la chiave KMS identificata dal parametro KmsKeyId.

    Se non si specifica un valore per il parametro KmsKeyId, avviene quanto segue:

    • Se il cluster di database è crittografato, il cluster di database ripristinato viene crittografato utilizzando la chiave KMS utilizzata per crittografare il cluster di database di origine.

    • Se il cluster di database non è crittografato, il cluster di database ripristinato non è crittografato.

    Se DBClusterIdentifier si riferisce a un cluster di database che non è crittografato, la richiesta di ripristino viene respinta.

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

    Il numero della porta sulla quale il nuovo 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.

  • RestoreToTime (nella CLI: --restore-to-time): un valore TStamp di tipo timestamp (un punto temporale, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

    La data e l'ora alle quali ripristinare il cluster di database.

    Valori validi: il valore deve essere espresso in formato Universal Coordinated Time (UTC)

    Vincoli:

    • Deve essere prima dell'ultima ora di ripristino per l'istanza database

    • Deve essere specificato se il parametro UseLatestRestorableTime non viene fornito

    • Non può essere specificato se il parametro UseLatestRestorableTime è true

    • Non può essere specificato se il parametro RestoreType è copy-on-write

    Esempio: 2015-03-07T23:45:00Z

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

    Il tipo di ripristino da eseguire. È possibile specificare uno dei seguenti valori:

    • full-copy: il nuovo cluster database viene ripristinato come una copia completa del cluster database di origine.

    • copy-on-write: il nuovo cluster database viene ripristinato come un clone del cluster database di origine.

    Se non si specifica un valore RestoreType, il nuovo cluster di database viene ripristinato come una copia completa del cluster di database di origine.

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

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

    L'identificatore del cluster di database di origine dal quale eseguire il ripristino.

    Vincoli:

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

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

    Specifica il tipo di archiviazione da associare al cluster di database.

    Valori validi: standard, iopt1

    Impostazione predefinita: standard

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

    I tag da applicare al cluster di database ripristinato.

  • UseLatestRestorableTime (nella CLI: --use-latest-restorable-time): un valore booleano di tipo boolean [un valore booleano (vero o falso)].

    Un valore impostato su true per ripristinare il cluster di database all'ora dell'ultimo backup ripristinabile e altrimenti impostato su false.

    Impostazione predefinita: false

    Vincoli: non è possibile specificare se il parametro RestoreToTime viene fornito.

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

    Un elenco dei gruppi di sicurezza VPC ai quali appartengono i nuovi cluster di database.

Risposta

Contiene i dettagli di un cluster di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'DescribeDBClusters (operazione).

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

DescribeDBClusterSnapshots (operazione)

        Il nome AWS CLI per questa API è: describe-db-cluster-snapshots.

Restituisce informazioni sugli snapshot del cluster di database. Questa operazione API supporta la paginazione.

Richiesta

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

    L'ID del cluster di database per il quale recuperare l'elenco degli snapshot del cluster di database. Questo parametro non può essere utilizzato in combinazione con il parametro DBClusterSnapshotIdentifier. Questo parametro non fa distinzione tra maiuscole e minuscole.

    Vincoli:

    • Se viene specificato, deve corrispondere all'identificatore di un DBCluster esistente.

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

    Un identificatore dello snapshot del cluster di database specifico da descrivere. Questo parametro non può essere utilizzato in combinazione con il parametro DBClusterIdentifier. Questo valore è archiviato come stringa in caratteri minuscoli.

    Vincoli:

    • Se viene specificato, deve corrispondere all'identificatore di un DBClusterSnapshot esistente.

    • Se questo identificatore è per uno snapshot automatizzato, anche il parametro SnapshotType deve essere specificato.

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

    Questo parametro non è attualmente supportato.

  • IncludePublic (nella CLI: --include-public): un valore booleano di tipo boolean [un valore booleano (vero o falso)].

    True per includere gli snapshot del cluster database manuale che sono pubblici e possono essere copiati o ripristinati da qualsiasi account Amazon, in caso contrario false. Il valore predefinito è false. Il valore di default è false.

    È possibile condividere uno snapshot del cluster di database manuale come pubblico utilizzando l'operazione API ModifyDbClusterSnapshotAttribute (operazione).

  • IncludeShared (nella CLI: --include-shared): un valore booleano di tipo boolean [un valore booleano (vero o falso)].

    True per includere gli snapshot del cluster database manuale condivisi da altri account Amazon che questo account Amazon è autorizzato a copiare o ripristinare, in caso contrario false. Il valore predefinito è false.

    Puoi fornire a un account Amazon l'autorizzazione per ripristinare uno snapshot del cluster database manuale da un altro account Amazon mediante l'azione API ModifyDbClusterSnapshotAttribute (operazione).

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

    Token di paginazione opzionale fornito da una richiesta DescribeDBClusterSnapshots 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.

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

    Il tipo di snapshot del cluster di database da restituire. È possibile specificare uno dei seguenti valori:

    • automated: restituisce tutti gli snapshot di cluster database che sono stati eseguiti automaticamente da Amazon Neptune per l'account Amazon personale.

    • manual: restituisce tutti gli snapshot di cluster database che sono stati eseguiti dall'account Amazon personale.

    • shared: restituisce tutti gli snapshot di cluster database manuale che sono stati condivisi con l'account Amazon personale.

    • public: restituisce tutti gli snapshot di cluster database che sono stati contrassegnati come pubblici.

    Se non si specifica un valore SnapshotType, entrambi gli snapshot di cluster di database automatici e manuali vengono restituiti. È possibile includere gli snapshot del cluster di database condivisi con questi risultati impostando il parametro IncludeShared su true. È possibile includere gli snapshot del cluster di database pubblici con questi risultati impostando il parametro IncludePublic su true.

    I parametri IncludePublic e IncludeShared non sono applicabili ai valori SnapshotType di manual o automated. Il parametro IncludePublic non è applicabile quando SnapshotType è impostato su shared. Il parametro IncludeShared non è applicabile quando SnapshotType è impostato su public.

Risposta

  • DBClusterSnapshots: una matrice di oggetti DBClusterSnapshot.

    Fornisce un elenco di snapshot del cluster di database per l'utente.

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

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

DescribeDBClusterSnapshotAttributes (operazione)

        Il nome AWS CLI per questa API è: describe-db-cluster-snapshot-attributes.

Restituisce un elenco di nomi e valori di attributo dello snapshot del cluster di database per uno snapshot del cluster di database manuale.

Quando si condividono snapshot con altri account Amazon, DescribeDBClusterSnapshotAttributes restituisce l'attributo restore e un elenco di ID per gli account Amazon che sono autorizzati a copiare o ripristinare lo snapshot del cluster database manuale. Se all è incluso nell'elenco di valori per l'attributo restore, lo snapshot del cluster database manuale è pubblico e può essere copiato o ripristinato da tutti gli account Amazon.

Per aggiungere o rimuovere l'accesso per consentire a un account Amazon di copiare o ripristinare uno snapshot del cluster database manuale o per rendere lo snapshot del cluster database manuale pubblico o privato, utilizza l'azione API ModifyDbClusterSnapshotAttribute (operazione).

Richiesta

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

    L'identificatore per lo snapshot del cluster di database per il quale descrivere gli attributi.

Risposta

Contiene i risultati di una chiamata riuscita all'operazione API DescribeDBClusterSnapshotAttributes (operazione).

Gli attributi dello snapshot del cluster database manuale vengono utilizzati per autorizzare altri account Amazon a copiare o ripristinare uno snapshot del cluster database manuale. Per ulteriori informazioni, consultare ModifyDbClusterSnapshotAttribute (operazione) operazione API.

  • DBClusterSnapshotAttributes: una matrice di oggetti DBClusterSnapshotAttribute.

    L'elenco di attributi e valori per lo snapshot del cluster di database manuale.

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

    L'identificatore dello snapshot del cluster di database manuale al quale si applicano gli attributi.

Strutture:

DBClusterSnapshot (struttura)

Contiene i dettagli per uno snapshot del cluster di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione DescribeDBClusterSnapshots (operazione).

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

    Specifica le dimensioni dello storage allocato, in gibibyte (GiB).

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

    Fornisce l'elenco delle zone di disponibilità EC2 nelle quali è possibile ripristinare istanze nello snapshot del 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).

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

    Specifica l'identificatore del cluster di database, dal quale è stato creato questo snapshot del cluster di database.

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

    L'Amazon Resource Name (ARN) per lo snapshot del cluster di database.

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

    Specifica l'identificatore per uno snapshot del cluster DB. Deve corrispondere all'identificatore di una snapshot esistente.

    Dopo aver ripristinato un cluster di database utilizzando DBClusterSnapshotIdentifier, è necessario specificare lo stesso DBClusterSnapshotIdentifier per eventuali aggiornamenti futuri al cluster di database. Quando specifichi questa proprietà per un aggiornamento, il cluster di database non viene nuovamente ripristinato dallo snapshot e i dati nel database non vengono modificati.

    Tuttavia, se non specifichi DBClusterSnapshotIdentifier, viene creato un cluster DB vuoto e il cluster DB originale viene eliminato. Se specifichi una proprietà diversa dalla proprietà di ripristino dello snapshot precedente, il cluster DB viene ripristinato dallo snapshot specificato da DBClusterSnapshotIdentifier e il cluster DB originale viene eliminato.

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

    Specifica il nome del motore di database.

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

    Fornisce la versione del motore di database da utilizzare per questo snapshot del cluster di database.

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

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

    Se StorageEncrypted è true, l'identificatore della chiave Amazon KMS per lo snapshot del cluster database crittografato.

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

    Fornisce le informazioni del modello di licenza per questo snapshot del cluster di database.

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

    Specifica la percentuale dei dati stimati che sono stati trasferiti.

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

    Specifica la porta con la quale il cluster di database ascoltava al momento della creazione dello snapshot.

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

    Fornisce l'ora di creazione dello snapshot, nel formato UTC (Universal Coordinated Time).

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

    Fornisce il tipo di snapshot del cluster di database.

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

    Se lo snapshot del cluster di database è stato copiato da uno snapshot del cluster di database di origine, l'Amazon Resource Name (ARN) per lo snapshot del cluster di database di origine, in caso contrario, presenta un valore null.

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

    Specifica lo stato dello snapshot del cluster di database.

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

    Specifica se lo snapshot del cluster di database è crittografato.

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

    Il tipo di archiviazione associato allo snapshot del cluster di database.

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

    Fornisce l'ID VPC associato allo snapshot del cluster di database.

DBClusterSnapshot viene utilizzato come elemento di risposta per:

DBClusterSnapshotAttribute (struttura)

Contiene il nome e i valori di un attributo dello snapshot del cluster di database manuale.

Gli attributi dello snapshot del cluster database manuale vengono utilizzati per autorizzare altri account Amazon a ripristinare uno snapshot del cluster database manuale. Per ulteriori informazioni, consultare ModifyDbClusterSnapshotAttribute (operazione) operazione API.

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

    Il nome dell'attributo dello snapshot del cluster di database manuale.

    L'attributo denominato restore fa riferimento all'elenco di account Amazon autorizzati a copiare o ripristinare lo snapshot del cluster database manuale. Per ulteriori informazioni, consultare ModifyDbClusterSnapshotAttribute (operazione) operazione API.

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

    I valori per l'attributo dello snapshot del cluster di database manuale.

    Se il campo AttributeName è impostato su restore, questo elemento restituisce un elenco di ID degli account Amazon autorizzati a copiare o ripristinare lo snapshot del cluster database manuale. Se il valore all è nell'elenco, lo snapshot del cluster database manuale è pubblico e disponibile per essere copiato o ripristinato da qualsiasi account Amazon.

DBClusterSnapshotAttributesResult (struttura)

Contiene i risultati di una chiamata riuscita all'operazione API DescribeDBClusterSnapshotAttributes (operazione).

Gli attributi dello snapshot del cluster database manuale vengono utilizzati per autorizzare altri account Amazon a copiare o ripristinare uno snapshot del cluster database manuale. Per ulteriori informazioni, consultare ModifyDbClusterSnapshotAttribute (operazione) operazione API.

Campi
  • DBClusterSnapshotAttributes: questo è un array di oggetti DBClusterSnapshotAttribute.

    L'elenco di attributi e valori per lo snapshot del cluster di database manuale.

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

    L'identificatore dello snapshot del cluster di database manuale al quale si applicano gli attributi.

DBClusterSnapshotAttributesResult viene utilizzato come elemento di risposta per: