Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
DescribeReservedNodes
Renvoie des informations sur les nœuds réservés pour ce compte ou sur un nœud réservé spécifié.
Syntaxe de la requête
{
"Duration": "string",
"MaxResults": number,
"NextToken": "string",
"NodeType": "string",
"OfferingType": "string",
"ReservationId": "string",
"ReservedNodesOfferingId": "string"
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- Duration
-
La valeur du filtre de durée, spécifiée en années ou en secondes. Utilisez ce paramètre pour afficher uniquement les réservations pour cette durée.
Type : chaîne
Obligatoire : non
- MaxResults
-
Nombre maximal d'enregistrements à inclure dans la réponse. S'il existe plus d'enregistrements que la MaxRecords valeur spécifiée, un marqueur est inclus dans la réponse afin que les résultats restants puissent être récupérés.
Type : entier
Obligatoire : non
- NextToken
-
Marqueur facultatif renvoyé suite à une demande précédente. Utilisez ce marqueur pour la pagination des résultats de cette opération. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par MaxRecords.
Type : chaîne
Obligatoire : non
- NodeType
-
La valeur du filtre du type de nœud. Utilisez ce paramètre pour afficher uniquement les réservations correspondant au type de nœud spécifié. Pour plus d'informations, consultez la section Types de nœuds pris en charge.
Type : chaîne
Obligatoire : non
- OfferingType
-
La valeur du filtre du type d'offre. Utilisez ce paramètre pour afficher uniquement les offres disponibles correspondant au type d'offre spécifié. Valeurs valides : « Tout en amont » | « En haut partiel » | « Pas en amont »
Type : chaîne
Obligatoire : non
- ReservationId
-
La valeur du filtre d'identifiant du nœud réservé. Utilisez ce paramètre pour afficher uniquement la réservation correspondant à l'ID de réservation spécifié.
Type : chaîne
Obligatoire : non
- ReservedNodesOfferingId
-
La valeur du filtre de l'identifiant de l'offre. Utilisez ce paramètre pour afficher uniquement les réservations achetées correspondant à l'identifiant d'offre spécifié.
Type : chaîne
Obligatoire : non
Syntaxe de la réponse
{
"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"
}
]
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- NextToken
-
Marqueur facultatif renvoyé suite à une demande précédente. Utilisez ce marqueur pour la pagination des résultats de cette opération. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par MaxRecords.
Type : chaîne
- ReservedNodes
-
Renvoie des informations sur les nœuds réservés pour ce compte ou sur un nœud réservé spécifié.
Type : tableau d’objets ReservedNode
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InvalidParameterCombinationException
-
Code d’état HTTP : 400
- InvalidParameterValueException
-
Code d’état HTTP : 400
- ReservedNodeNotFoundFault
-
Le nœud demandé n'existe pas.
Code d’état HTTP : 400
- ServiceLinkedRoleNotFoundFault
-
Code d’état HTTP : 400
consultez aussi
Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
