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
Campo 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 marker in modo da poter recuperare i risultati rimanenti.
Tipo: integer
Campo obbligatorio: no
- NextToken
-
Un marker opzionale restituito da una richiesta precedente. Utilizzate questo marker 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
Campo 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, consulta Tipi di nodi supportati.
▬Tipo: stringa
Campo 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: «All Upfront"|"Partial Upfront"| «No Upfront»
▬Tipo: stringa
Campo obbligatorio: no
- ReservationId
-
Il valore del filtro dell'identificatore del nodo riservato. Utilizza questo parametro per mostrare solo la prenotazione che corrisponde all'ID di prenotazione specificato.
▬Tipo: stringa
Campo obbligatorio: no
- ReservedNodesOfferingId
-
Il valore del filtro dell'identificatore dell'offerta. Utilizza questo parametro per mostrare solo le prenotazioni acquistate che corrispondono all'identificativo dell'offerta specificato.
▬Tipo: stringa
Campo 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 marker opzionale restituito da una richiesta precedente. Utilizzate questo marker 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 Errori 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 una delle lingue specifiche AWS SDKs, consulta quanto segue: