

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

# Altro Neptune APIs
<a name="api-other-apis"></a>

**Operazioni:**
+ [AddTagsToResource (azione)](#AddTagsToResource)
+ [ListTagsForResource (azione)](#ListTagsForResource)
+ [RemoveTagsFromResource (azione)](#RemoveTagsFromResource)
+ [ApplyPendingMaintenanceAction (azione)](#ApplyPendingMaintenanceAction)
+ [DescribePendingMaintenanceActions (azione)](#DescribePendingMaintenanceActions)
+ [Descrivi le DBEngine versioni (azione)](#DescribeDBEngineVersions)

**Strutture:**
+ [DBEngineVersione (struttura)](#DBEngineVersion)
+ [EngineDefaults (struttura)](#EngineDefaults)
+ [PendingMaintenanceAction (struttura)](#PendingMaintenanceAction)
+ [ResourcePendingMaintenanceActions (struttura)](#ResourcePendingMaintenanceActions)
+ [UpgradeTarget (struttura)](#UpgradeTarget)
+ [Tag (struttura)](#Tag)

## AddTagsToResource (azione)
<a name="AddTagsToResource"></a>

         Il nome AWS CLI per questa API è:. `add-tags-to-resource`

Aggiunge tag di metadati a una risorsa Amazon Neptune. Questi tag possono anche essere utilizzati con la creazione di rapporti sull'allocazione dei costi per monitorare i costi associati alle risorse Amazon Neptune o utilizzati in un'istruzione di condizione in una policy IAM per Amazon Neptune.

**Richiesta**
+ **ResourceName** (nella CLI: `--resource-name`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La risorsa Amazon Neptune alla quale vengono aggiunti i tag. Questo valore è un Amazon Resource Name (ARN). Per informazioni su come creare un ARN, consultare [Costruzione di un ARN (Amazon Resource Name)](https://docs.aws.amazon.com/neptune/latest/UserGuide/tagging.ARN.html#tagging.ARN.Constructing).
+ **Tags** (nella CLI: `--tags`): *Obbligatorio:* un array di oggetti [Tag](#Tag).

  I tag da assegnare alla risorsa Amazon Neptune.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)
+ [DBSnapshotNotFoundFault](api-faults.md#DBSnapshotNotFoundFault)
+ [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault)

## ListTagsForResource (azione)
<a name="ListTagsForResource"></a>

         Il nome AWS CLI per questa API è:. `list-tags-for-resource`

Elenca tutti i tag su una risorsa Amazon Neptune.

**Richiesta**
+ **Filters** (nella CLI: `--filters`): un array di oggetti [Filtro](api-datatypes.md#Filter).

  Questo parametro non è attualmente supportato.
+ **ResourceName** (nella CLI: `--resource-name`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La risorsa Amazon Neptune con tag da elencare. Questo valore è un Amazon Resource Name (ARN). Per informazioni su come creare un ARN, consultare [Costruzione di un ARN (Amazon Resource Name)](https://docs.aws.amazon.com/neptune/latest/UserGuide/tagging.ARN.html#tagging.ARN.Constructing).

**Risposta**
+ **TagList**: una matrice di oggetti [Tag](#Tag).

  Elenco dei tag restituiti dall' ListTagsForResource operazione.

**Errori**
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)
+ [DBSnapshotNotFoundFault](api-faults.md#DBSnapshotNotFoundFault)
+ [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault)

## RemoveTagsFromResource (azione)
<a name="RemoveTagsFromResource"></a>

         Il nome AWS CLI per questa API è:. `remove-tags-from-resource`

Rimuove tag di metadati da una risorsa Amazon Neptune.

**Richiesta**
+ **ResourceName** (nella CLI: `--resource-name`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La risorsa Amazon Neptune dalla quale vengono rimossi i tag. Questo valore è un Amazon Resource Name (ARN). Per informazioni su come creare un ARN, consultare [Costruzione di un ARN (Amazon Resource Name)](https://docs.aws.amazon.com/neptune/latest/UserGuide/tagging.ARN.html#tagging.ARN.Constructing).
+ **TagKeys** (nella CLI: `--tag-keys`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La chiave del tag (nome) del tag da rimuovere.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)
+ [DBSnapshotNotFoundFault](api-faults.md#DBSnapshotNotFoundFault)
+ [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault)

## ApplyPendingMaintenanceAction (azione)
<a name="ApplyPendingMaintenanceAction"></a>

         Il nome AWS CLI per questa API è:. `apply-pending-maintenance-action`

Applica un'operazione di manutenzione in sospeso a una risorsa (ad esempio, a un'istanza database).

**Richiesta**
+ **ApplyAction** (nella CLI: `--apply-action`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'operazione di manutenzione in sospeso da applicare a questa risorsa.

  Valori validi: `system-update`, `db-upgrade`
+ **OptInType** (nella CLI: `--opt-in-type`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Un valore che specifica il tipo di richiesta di consenso esplicito o ne annulla una. Una richiesta di consenso esplicito di tipo `immediate` non può essere annullata.

  Valori validi:
  + `immediate`: applica immediatamente l'azione di manutenzione.
  + `next-maintenance` -Applica l'operazione di manutenzione durante la finestra di manutenzione successiva per la risorsa.
  + `undo-opt-in`: annulla qualsiasi richiesta di consenso esplicito `next-maintenance` esistente.
+ **ResourceIdentifier** (nella CLI: `--resource-identifier`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'Amazon Resource Name (ARN) della risorsa alla quale viene applicata l'operazione di manutenzione in sospeso. Per informazioni su come creare un ARN, consultare [Costruzione di un ARN (Amazon Resource Name)](https://docs.aws.amazon.com/neptune/latest/UserGuide/tagging.ARN.html#tagging.ARN.Constructing).

**Risposta**

Descrive le operazioni di manutenzione in sospeso per una risorsa.
+ **PendingMaintenanceActionDetails**: una matrice di oggetti [PendingMaintenanceAction](#PendingMaintenanceAction).

  Un elenco che fornisce i dettagli sulle operazioni di manutenzione in sospeso per la risorsa.
+ **ResourceIdentifier**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  La ARN della risorsa che dispone di operazioni di manutenzione in sospeso.

**Errori**
+ [ResourceNotFoundFault](api-faults.md#ResourceNotFoundFault)

## DescribePendingMaintenanceActions (azione)
<a name="DescribePendingMaintenanceActions"></a>

         Il nome AWS CLI per questa API è:. `describe-pending-maintenance-actions`

Restituisce un elenco di risorse (ad esempio istanze database) che hanno almeno un'operazione di manutenzione in sospeso.

**Richiesta**
+ **Filters** (nella CLI: `--filters`): un array di oggetti [Filtro](api-datatypes.md#Filter).

  Un filtro che specifica una o più risorse per restituire le operazioni di manutenzione in sospeso.

  Filtri supportati:
  +  `db-cluster-id`- Accetta identificatori di cluster DB e cluster DB Amazon Resource Names (ARNs). L'elenco dei risultati includerà solo le azioni di manutenzione in sospeso per i cluster DB identificati da questi. ARNs
  +  `db-instance-id`- Accetta identificatori di istanze DB e istanze DB. ARNs L'elenco dei risultati includerà solo le azioni di manutenzione in sospeso per le istanze DB identificate da queste istanze. ARNs
+ **Marker** (nella CLI: `--marker`): una stringa di tipo `string` (una stringa con codifica UTF-8).

   Token di paginazione opzionale fornito da una richiesta `DescribePendingMaintenanceActions` precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino a un numero di record specificato da `MaxRecords`.
+ **MaxRecords**(nella CLI:`--max-records`) — un IntegerOptional, di tipo: `integer` (un intero con segno a 32 bit).

   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.
+ **ResourceIdentifier** (nella CLI: `--resource-identifier`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ARN della risorsa per la quale restituire operazioni di manutenzione in sospeso.

**Risposta**
+ **Marker**: una stringa di tipo `string` (una stringa con codifica UTF-8).

   Token di paginazione opzionale fornito da una richiesta `DescribePendingMaintenanceActions` precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino a un numero di record specificato da `MaxRecords`.
+ **PendingMaintenanceActions**: una matrice di oggetti [ResourcePendingMaintenanceActions](#ResourcePendingMaintenanceActions).

  Un elenco di operazioni di manutenzione in sospeso per la risorsa.

**Errori**
+ [ResourceNotFoundFault](api-faults.md#ResourceNotFoundFault)

## Descrivi le DBEngine versioni (azione)
<a name="DescribeDBEngineVersions"></a>

         Il nome AWS CLI per questa API è:. `describe-db-engine-versions`

Restituisce un elenco dei motori di database disponibili.

**Richiesta**
+ **DBParameterGroupFamily** (nella CLI: `--db-parameter-group-family`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome di una determinato famiglia di gruppo di parametri database per la quale restituire i dettagli.

  Vincoli:
  + Se fornito, deve corrispondere a uno esistente DBParameterGroupFamily.
+ **DefaultOnly** (nella CLI: `--default-only`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Indica che solo la versione predefinita del motore specificato o una combinazione di motore e versione principale viene restituita.
+ **Engine** (nella CLI: `--engine`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il motore di database da restituire.
+ **EngineVersion** (nella CLI: `--engine-version`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  La versione del motore di database da restituire.

  Esempio: `5.1.49`
+ **Filters** (nella CLI: `--filters`): un array di oggetti [Filtro](api-datatypes.md#Filter).

  Attualmente non è supportato.
+ **ListSupportedCharacterSets**(nella CLI:`--list-supported-character-sets`) — a BooleanOptional, di tipo: `boolean` (un valore booleano (vero o falso)).

  Se questo parametro viene specificato e il modulo di richiesta supporta il parametro `CharacterSetName` per `CreateDBInstance`, la risposta include un elenco di set di caratteri supportati per ciascuna versione del motore.
+ **ListSupportedTimezones**(nella CLI:`--list-supported-timezones`) — a BooleanOptional, di tipo: `boolean` (un valore booleano (vero o falso)).

  Se questo parametro viene specificato e il modulo di richiesta supporta il parametro `TimeZone` per `CreateDBInstance`, la risposta include un elenco di fusi orari supportati per ciascuna versione del motore.
+ **Marker** (nella CLI: `--marker`): una stringa di tipo `string` (una stringa con codifica UTF-8).

   Token di paginazione opzionale fornito da una richiesta 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 IntegerOptional, di tipo: `integer` (un intero con segno a 32 bit).

   Numero massimo di record da includere nella risposta. Se sono presenti più valori oltre a `MaxRecords`, nella risposta viene incluso un token di paginazione detto contrassegno, per permettere di recuperare i risultati seguenti.

  Impostazione predefinita: 100

  Vincoli: minimo 20, massimo 100.

**Risposta**
+ **DBEngineVersions**: una matrice di oggetti [DBEngineVersione](#DBEngineVersion).

   Un elenco di elementi `DBEngineVersion`.
+ **Marker**: una stringa di tipo `string` (una stringa con codifica UTF-8).

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

## *Strutture:*
<a name="api-other-apis-structures-spacer"></a>

## DBEngineVersione (struttura)
<a name="DBEngineVersion"></a>

 Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione [Descrivi le DBEngine versioni (azione)](#DescribeDBEngineVersions).

**Campi**
+ **DBEngineDescription**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  La descrizione del motore di database.
+ **DBEngineVersionDescription**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  La descrizione della versione del motore di database.
+ **DBParameterGroupFamily**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome della famiglia del gruppo di parametri database per il motore di database.
+ **Engine**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del motore di database.
+ **EngineVersion**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il numero di versione del motore di database.
+ **ExportableLogTypes**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  I tipi di log che il motore di database ha a disposizione per l'esportazione in CloudWatch Logs.
+ **SupportedTimezones**: questo è un array di oggetti [Fuso orario](api-datatypes.md#Timezone).

  Un elenco di fusi orari supportati da questo motore per il parametro `Timezone` dell'operazione `CreateDBInstance`.
+ **SupportsGlobalDatabases**: questo è un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Un valore che indica se è possibile utilizzare i database globali Aurora con una versione specifica del motore di database.
+ **SupportsLogExportsToCloudwatchLogs**: questo è un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Un valore che indica se la versione del motore supporta l'esportazione dei tipi di log specificati da ExportableLogTypes to Logs. CloudWatch 
+ **SupportsReadReplica**: questo è un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Indica se la versione del motore di database supporta le repliche di lettura.
+ **ValidUpgradeTarget**: questo è un array di oggetti [UpgradeTarget](#UpgradeTarget).

  Un elenco di versioni dei motori alle quali questa versione del motore di database può essere aggiornata.

## EngineDefaults (struttura)
<a name="EngineDefaults"></a>

 Contiene il risultato di una chiamata di successo dell'operazione [DescribeEngineDefaultParameters (azione)](api-parameters.md#DescribeEngineDefaultParameters).

**Campi**
+ **DBParameterGroupFamily**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Specifica il nome della famiglia del gruppo di parametri database alla quale si applicano i parametri predefiniti del motore.
+ **Marker**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

   Un token di impaginazione opzionale fornito da una EngineDefaults richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.
+ **Parameters**: questo è un array di oggetti [Parametro](api-parameters.md#Parameter).

  Contiene un elenco di parametri predefiniti del motore.

`EngineDefaults` viene utilizzato come elemento di risposta per:
+ [DescribeEngineDefaultParameters](api-parameters.md#DescribeEngineDefaultParameters)
+ [DescribeEngineDefaultClusterParameters](api-parameters.md#DescribeEngineDefaultClusterParameters)

## PendingMaintenanceAction (struttura)
<a name="PendingMaintenanceAction"></a>

Fornisce informazioni su un'operazione di manutenzione in sospeso per una risorsa.

**Campi**
+ **Action**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il tipo di operazione di manutenzione in sospeso che è disponibile per la risorsa.
+ **AutoAppliedAfterDate**— Si tratta di un TStamp, di tipo: `timestamp` (un punto nel tempo, generalmente definito come un offset dalla mezzanotte del 01/01/1970).

  La data della finestra di manutenzione quando l'operazione viene applicata. L'operazione di manutenzione viene applicata alla risorsa durante la prima finestra di manutenzione dopo questa data. Se questa data è specificata, qualsiasi richiesta di consenso esplicito `next-maintenance` viene ignorata.
+ **CurrentApplyDate**— Si tratta di un TStamp, di tipo: `timestamp` (un punto nel tempo, generalmente definito come un offset rispetto alla mezzanotte del 01/01/1970).

  La data di validità quando l'operazione di manutenzione in sospeso viene applicata alla risorsa. Questa data tiene conto delle richieste di consenso esplicito ricevute dall'API [ApplyPendingMaintenanceAction (azione)](#ApplyPendingMaintenanceAction), `AutoAppliedAfterDate` e `ForcedApplyDate`. Questo valore è vuoto se una richiesta di consenso esplicito non è stato ricevuta e non è stato specificato nulla come `AutoAppliedAfterDate` o `ForcedApplyDate`.
+ **Description**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Una descrizione che fornisce dettagli sull'operazione di manutenzione.
+ **ForcedApplyDate**— Si tratta di un TStamp, di tipo: `timestamp` (un punto nel tempo, generalmente definito come un offset rispetto alla mezzanotte del 01/01/1970).

  La data quando l'operazione di manutenzione viene applicata automaticamente. L'operazione di manutenzione viene applicata alla risorsa in questa data indipendentemente dalla finestra di manutenzione per la risorsa. Se questa data è specificata, qualsiasi richiesta di consenso esplicito `immediate` viene ignorata.
+ **OptInStatus**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Indica il tipo di richiesta di consenso esplicito che è stata ricevuta per la risorsa.

## ResourcePendingMaintenanceActions (struttura)
<a name="ResourcePendingMaintenanceActions"></a>

Descrive le operazioni di manutenzione in sospeso per una risorsa.

**Campi**
+ **PendingMaintenanceActionDetails**: questo è un array di oggetti [PendingMaintenanceAction](#PendingMaintenanceAction).

  Un elenco che fornisce i dettagli sulle operazioni di manutenzione in sospeso per la risorsa.
+ **ResourceIdentifier**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  La ARN della risorsa che dispone di operazioni di manutenzione in sospeso.

`ResourcePendingMaintenanceActions` viene utilizzato come elemento di risposta per:
+ [ApplyPendingMaintenanceAction](#ApplyPendingMaintenanceAction)

## UpgradeTarget (struttura)
<a name="UpgradeTarget"></a>

La versione del motore di database alla quale può essere aggiornata un'istanza database.

**Campi**
+ **AutoUpgrade**: questo è un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Un valore che indica se la versione di destinazione viene applicata a qualsiasi istanza DB di origine AutoMinorVersionUpgrade impostata su true.
+ **Description**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  La versione del motore di database alla quale può essere aggiornata un'istanza database.
+ **Engine**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del motore di database di destinazione di aggiornamento.
+ **EngineVersion**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il numero di versione del motore di database di destinazione di aggiornamento.
+ **IsMajorVersionUpgrade**: questo è un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Un valore che indica se un motore di database viene aggiornato a una versione principale.
+ **SupportsGlobalDatabases**— Si tratta di un BooleanOptional valore booleano `boolean` (vero o falso) di tipo:.

  Un valore che indica se è possibile utilizzare i database globali Neptune con la versione del motore di destinazione.

## Tag (struttura)
<a name="Tag"></a>

I metadati assegnati a una risorsa Amazon Neptune costituita da una coppia chiave-valore.

**Campi**
+ **Key**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Una chiave corrisponde al nome obbligatorio del tag. Il valore della stringa può essere composto da 1 a 128 caratteri Unicode e non può avere il prefisso `aws:` o `rds:`. La stringa può contenere solo il set di lettere, cifre, spazi vuoti Unicode, '\_', '.', '/', '=', '\+', '-' (espressioni regolari Java: "^([\\\\p{L}\\\\p{Z}\\\\p{N}\_.:/=\+\\\\-]\*)$").
+ **Value**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Un valore è il valore opzione del tag. Il valore della stringa può essere composto da 1 a 256 caratteri Unicode e non può avere il prefisso `aws:` o `rds:`. La stringa può contenere solo il set di lettere, cifre, spazi vuoti Unicode, '\_', '.', '/', '=', '\+', '-' (espressioni regolari Java: "^([\\\\p{L}\\\\p{Z}\\\\p{N}\_.:/=\+\\\\-]\*)$").