View a markdown version of this page

DescribeReservedNodes - Amazon MemoryDB

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

DescribeReservedNodes

Restituisce informazioni sui nodi riservati per questo account o su un nodo riservato specificato.

Sintassi della richiesta

{ "Duration": "string", "MaxResults": number, "NextToken": "string", "NodeType": "string", "OfferingType": "string", "ReservationId": "string", "ReservedNodesOfferingId": "string" }

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

Duration

Il valore del filtro di durata, specificato in anni o secondi. Usa questo parametro per mostrare solo le prenotazioni per questa durata.

▬Tipo: stringa

Obbligatorio: no

MaxResults

Numero massimo di record da includere nella risposta. Se esistono più record rispetto al MaxRecords valore specificato, nella risposta viene incluso un indicatore che consente di recuperare i risultati rimanenti.

Tipo: Integer

Obbligatorio: no

NextToken

Un marker opzionale restituito da una richiesta precedente. Utilizzate questo indicatore per l'impaginazione dei risultati di questa operazione. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da MaxRecords.

▬Tipo: stringa

Obbligatorio: no

NodeType

Il valore del filtro del tipo di nodo. Utilizzate questo parametro per mostrare solo le prenotazioni che corrispondono al tipo di nodo specificato. Per ulteriori informazioni, vedere Tipi di nodi supportati.

▬Tipo: stringa

Obbligatorio: no

OfferingType

Il valore del filtro del tipo di offerta. Utilizza questo parametro per mostrare solo le offerte disponibili che corrispondono al tipo di offerta specificato. Valori validi: «Tutto anticipato"|"Parziale anticipato"| «Nessun anticipo»

▬Tipo: stringa

Obbligatorio: no

ReservationId

Il valore del filtro identificativo del nodo riservato. Utilizza questo parametro per mostrare solo la prenotazione che corrisponde all'ID di prenotazione specificato.

▬Tipo: stringa

Obbligatorio: no

ReservedNodesOfferingId

Il valore del filtro identificativo dell'offerta. Utilizza questo parametro per mostrare solo le prenotazioni acquistate che corrispondono all'identificativo di offerta specificato.

▬Tipo: stringa

Obbligatorio: no

Sintassi della risposta

{ "NextToken": "string", "ReservedNodes": [ { "ARN": "string", "Duration": number, "FixedPrice": number, "NodeCount": number, "NodeType": "string", "OfferingType": "string", "RecurringCharges": [ { "RecurringChargeAmount": number, "RecurringChargeFrequency": "string" } ], "ReservationId": "string", "ReservedNodesOfferingId": "string", "StartTime": number, "State": "string" } ] }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

NextToken

Un indicatore opzionale restituito da una richiesta precedente. Utilizzate questo indicatore per l'impaginazione dei risultati di questa operazione. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da MaxRecords.

Tipo: stringa

ReservedNodes

Restituisce informazioni sui nodi riservati per questo account o su un nodo riservato specificato.

Tipo: matrice di oggetti ReservedNode

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Tipi di errore comuni.

InvalidParameterCombinationException

Codice di stato HTTP: 400

InvalidParameterValueException

Codice di stato HTTP: 400

ReservedNodeNotFoundFault

Il nodo richiesto non esiste.

Codice di stato HTTP: 400

ServiceLinkedRoleNotFoundFault

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: