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à.
DescribeDBInstances
Restituisce informazioni sulle istanze Amazon DocumentDB assegnate. Quest'API supporta la paginazione.
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
- DBInstanceIdentifier
-
L'identificatore dell'istanza fornito dall'utente. Se viene specificato questo parametro, vengono restituite solo le informazioni relative all'istanza specifica. Questo parametro non fa distinzione tra maiuscole e minuscole.
Vincoli:
-
Se fornito, deve corrispondere all'identificatore di un'esistente
DBInstance.
▬Tipo: stringa
Campo obbligatorio: no
-
- Filtri.Filtro.N
-
Un filtro che specifica una o più istanze da descrivere.
Filtri supportati:
-
db-cluster-id- Accetta identificatori di cluster e Amazon Resource Names (ARN) del cluster. L'elenco dei risultati include solo le informazioni sulle istanze associate ai cluster identificati da questi ARN. -
db-instance-id- Accetta identificatori di istanza e ARN di istanze. L'elenco dei risultati include solo le informazioni sulle istanze identificate da questi ARN.
Tipo: matrice di oggetti Filter
Campo obbligatorio: no
-
- Marker
-
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.▬Tipo: stringa
Campo obbligatorio: no
- MaxRecords
-
Numero massimo di record da includere nella risposta. Se esistono più record rispetto al
MaxRecordsvalore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.Impostazione predefinita: 100
Vincoli: minimo 20, massimo 100.
Tipo: integer
Campo obbligatorio: no
Elementi di risposta
I seguenti elementi vengono restituiti dal servizio.
- dbInstances.dbInstance.
-
Informazioni dettagliate su una o più istanze.
Tipo: matrice di oggetti DBInstance
- Marker
-
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.▬Tipo: stringa
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- DBInstanceNotFound
-
DBInstanceIdentifiernon fa riferimento a un'istanza esistente.Codice di stato HTTP: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
