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 delle sottoreti Neptune
<a name="api-subnets"></a>

**Operazioni:**
+ [Crea DBSubnet gruppo (azione)](#CreateDBSubnetGroup)
+ [Elimina DBSubnet gruppo (azione)](#DeleteDBSubnetGroup)
+ [Modifica DBSubnet gruppo (azione)](#ModifyDBSubnetGroup)
+ [DBSubnetDescrivi i gruppi (azione)](#DescribeDBSubnetGroups)

**Strutture:**
+ [Sottorete (struttura)](#Subnet)
+ [DBSubnetGruppo (struttura)](#DBSubnetGroup)

## Crea DBSubnet gruppo (azione)
<a name="CreateDBSubnetGroup"></a>

         Il nome AWS CLI per questa API è:. `create-db-subnet-group`

Crea un nuovo gruppo di sottoreti di database. I gruppi di sottoreti DB devono contenere almeno una sottorete su almeno due AZs nella regione Amazon.

**Richiesta**
+ **DBSubnetGroupDescription** (nella CLI: `--db-subnet-group-description`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La descrizione per il gruppo di sottoreti DB.
+ **DBSubnetGroupName** (nella CLI: `--db-subnet-group-name`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del gruppo di sottoreti DB. Questo valore è archiviato come stringa in caratteri minuscoli.

  Vincoli: devono contenere un massimo di 255 lettere, numeri, punti, trattini bassi, spazi o trattini. Non deve essere predefinito.

  Esempio: `mySubnetgroup`
+ **SubnetIds** (nella CLI: `--subnet-ids`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La EC2 sottorete IDs per il gruppo di sottoreti DB.
+ **Tags** (nella CLI: `--tags`): un array di oggetti [Tag](api-other-apis.md#Tag).

  I tag da assegnare al nuovo gruppo di sottoreti di database.

**Risposta**

Contiene i dettagli di un gruppo di sottoreti di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione [DBSubnetDescrivi i gruppi (azione)](#DescribeDBSubnetGroups).
+ **DBSubnetGroupArn**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il gruppo di sottoreti di database.
+ **DBSubnetGroupDescription**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce la descrizione del gruppo di sottoreti di database.
+ **DBSubnetGroupName**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del gruppo di sottoreti DB.
+ **SubnetGroupStatus**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce lo stato del gruppo di sottoreti di database.
+ **Subnets**: una matrice di oggetti [Sottorete](#Subnet).

   Include un elenco di elementi [Sottorete (struttura)](#Subnet).
+ **VpcId**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce il gruppo VpcId di sottoreti DB.

**Errori**
+ [DBSubnetGroupAlreadyExistsFault](api-faults.md#DBSubnetGroupAlreadyExistsFault)
+ [DBSubnetGroupQuotaExceededFault](api-faults.md#DBSubnetGroupQuotaExceededFault)
+ [DBSubnetQuotaExceededFault](api-faults.md#DBSubnetQuotaExceededFault)
+ [DBSubnetGroupDoesNotCoverEnoughAZs](api-faults.md#DBSubnetGroupDoesNotCoverEnoughAZs)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)

## Elimina DBSubnet gruppo (azione)
<a name="DeleteDBSubnetGroup"></a>

         Il nome AWS CLI per questa API è:. `delete-db-subnet-group`

Eliminare un gruppo di sottoreti di database.

**Nota**  
Il gruppo di sottoreti di database specificato non deve essere associato ad alcuna istanza database.

**Richiesta**
+ **DBSubnetGroupName** (nella CLI: `--db-subnet-group-name`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del gruppo di sottoreti di database da eliminare.
**Nota**  
Non è possibile eliminare il gruppo di sottoreti di default.

  Vincoli:

  Vincoli: deve corrispondere al nome di un gruppo esistente. DBSubnet Non deve essere predefinito.

  Esempio: `mySubnetgroup`

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

**Errori**
+ [Non valido DBSubnet GroupStateFault](api-faults.md#InvalidDBSubnetGroupStateFault)
+ [Non valido DBSubnet StateFault](api-faults.md#InvalidDBSubnetStateFault)
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)

## Modifica DBSubnet gruppo (azione)
<a name="ModifyDBSubnetGroup"></a>

         Il nome AWS CLI per questa API è:. `modify-db-subnet-group`

Modifica un gruppo di sottoreti di database esistente. I gruppi di sottoreti DB devono contenere almeno una sottorete su almeno due AZs nella regione Amazon.

**Richiesta**
+ **DBSubnetGroupDescription** (nella CLI: `--db-subnet-group-description`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  La descrizione per il gruppo di sottoreti DB.
+ **DBSubnetGroupName** (nella CLI: `--db-subnet-group-name`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del gruppo di sottoreti DB. Questo valore è archiviato come stringa in caratteri minuscoli. Non è possibile modificare il gruppo di sottoreti di default.

  Vincoli: deve corrispondere al nome di un gruppo esistente. DBSubnet Non deve essere predefinito.

  Esempio: `mySubnetgroup`
+ **SubnetIds** (nella CLI: `--subnet-ids`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La EC2 sottorete IDs per il gruppo di sottoreti DB.

**Risposta**

Contiene i dettagli di un gruppo di sottoreti di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione [DBSubnetDescrivi i gruppi (azione)](#DescribeDBSubnetGroups).
+ **DBSubnetGroupArn**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Amazon Resource Name (ARN) per il gruppo di sottoreti di database.
+ **DBSubnetGroupDescription**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce la descrizione del gruppo di sottoreti di database.
+ **DBSubnetGroupName**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del gruppo di sottoreti DB.
+ **SubnetGroupStatus**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce lo stato del gruppo di sottoreti di database.
+ **Subnets**: una matrice di oggetti [Sottorete](#Subnet).

   Include un elenco di elementi [Sottorete (struttura)](#Subnet).
+ **VpcId**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce il gruppo VpcId di sottoreti DB.

**Errori**
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)
+ [DBSubnetQuotaExceededFault](api-faults.md#DBSubnetQuotaExceededFault)
+ [SubnetAlreadyInUse](api-faults.md#SubnetAlreadyInUse)
+ [DBSubnetGroupDoesNotCoverEnoughAZs](api-faults.md#DBSubnetGroupDoesNotCoverEnoughAZs)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)

## DBSubnetDescrivi i gruppi (azione)
<a name="DescribeDBSubnetGroups"></a>

         Il nome AWS CLI per questa API è:. `describe-db-subnet-groups`

Restituisce un elenco di descrizioni dei DBSubnet gruppi. Se DBSubnet GroupName viene specificato a, l'elenco conterrà solo le descrizioni del DBSubnet Gruppo specificato.

Per una panoramica degli intervalli CIDR, consulta [Tutorial di Wikipedia](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing).

**Richiesta**
+ **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 per il quale restituire i dettagli.
+ **Filters** (nella CLI: `--filters`): un array di oggetti [Filtro](api-datatypes.md#Filter).

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

   Un token di impaginazione opzionale fornito da una precedente richiesta Descrivi DBSubnet Groups. 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ù 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.

**Risposta**
+ **DBSubnetGroups**: una matrice di oggetti [DBSubnetGruppo](#DBSubnetGroup).

   Elenco di istanze di [DBSubnetGruppo (struttura)](#DBSubnetGroup).
+ **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`.

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

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

## Sottorete (struttura)
<a name="Subnet"></a>

Specifica una sottorete.

 Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione [DBSubnetDescrivi i gruppi (azione)](#DescribeDBSubnetGroups).

**Campi**
+ **SubnetAvailabilityZone**: questo è un oggetto [AvailabilityZone](api-datatypes.md#AvailabilityZone).

  Speciifica la zona di EC2 disponibilità in cui si trova la sottorete.
+ **SubnetIdentifier**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Specifica l'identificatore della sottorete.
+ **SubnetStatus**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Specifica lo stato della sottorete.

## DBSubnetGruppo (struttura)
<a name="DBSubnetGroup"></a>

Contiene i dettagli di un gruppo di sottoreti di database Amazon Neptune.

Questo tipo di dati viene utilizzato come elemento di risposta nell'operazione [DBSubnetDescrivi i gruppi (azione)](#DescribeDBSubnetGroups).

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

  Amazon Resource Name (ARN) per il gruppo di sottoreti di database.
+ **DBSubnetGroupDescription**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce la descrizione del gruppo di sottoreti di database.
+ **DBSubnetGroupName**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome del gruppo di sottoreti DB.
+ **SubnetGroupStatus**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce lo stato del gruppo di sottoreti di database.
+ **Subnets**: questo è un array di oggetti [Sottorete](#Subnet).

   Include un elenco di elementi [Sottorete (struttura)](#Subnet).
+ **VpcId**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Fornisce il gruppo VpcId di sottoreti DB.

`DBSubnetGroup` viene utilizzato come elemento di risposta per:
+ [Crea DBSubnet gruppo](#CreateDBSubnetGroup)
+ [Modifica DBSubnet gruppo](#ModifyDBSubnetGroup)