Utilisation de la limitation et suivant

Cet exemple utilise les alarmes GET pour récupérer toutes les alarmes et affiche le mode d'utilisation des liens limitation et suivant.
casp1032
Cet exemple utilise les alarmes GET pour récupérer toutes les alarmes et affiche le mode d'utilisation des liens limitation et suivant.
Procédez comme suit :
  1. Utilisez la requête suivante, qui demande que toutes les alarmes soient renvoyées, mais uniquement trois à la fois :
    http://comp001/spectrum/restful/alarms?throttlesize=3
    Notez les éléments suivants dans cette demande :
    • throttlesize
      Indique le nombre d'éléments à renvoyer à la fois. Cet exemple demande que trois alarmes soient renvoyées à la fois.
    La réponse suivante est renvoyée à partir du
    SpectroSERVER
    . Cette réponse indique qu'un total de cinq alarmes existe et que seuls trois sont renvoyés. Un lien relatif est fourni qui pointe vers les éléments suivants de la liste.
    <?xml version="1.0" encoding="UTF-8" standalone="yes" ?> - <alarm-response-list xmlns="http://www.ca.com/spectrum/restful/schema/response" throttle="3" total-alarms="5"> - <alarm-responses> <alarm id="4e77f4fd-1c9b-1000-0336-000874f00c29" /> <alarm id="4e77f4fe-1ca2-1000-0336-000874f00c29" /> <alarm id="4e80da2b-a48e-1001-0336-000874f00c29" /> </alarm-responses> <link rel="next" href="http://comp001/spectrum/restful/alarms?id=c6a367df-0b3e-4461-aa8d- aad451a45bf7&start=3&throttlesize=3" type="application/xml" /> </alarm-response-list>
    Notez les éléments suivants dans cette réponse :
    • throttle
      Indique le nombre d'éléments renvoyés dans cette réponse. Dans cet exemple, trois alarmes ont été renvoyées dans cette réponse.
    • total-alarms
      Indique le nombre total d'éléments dans l'ensemble de résultats. Dans cet exemple, il y a cinq alarmes au total dans l'ensemble de résultats.
    • link rel="next"
      Indique l'URL permettant de récupérer les éléments suivants dans l'ensemble de résultats. Ce lien peut être utilisé dans un navigateur ou un programme pour émettre la demande suivante.
      • id=<
        result_set_ID
        >
        Spécifie l'emplacement de l'ensemble de résultats sur le serveur OneClick. Les données expirent après dix minutes d'inactivité.
      • start=<
        element_num
        >
        Indique la position dans l'ensemble de résultats.
  2. Utilisez le lien relatif suivant de la réponse précédente pour demander les trois éléments suivants dans l'ensemble de résultats :
    http://comp001/spectrum/restful/alarms?id=c6a367df-0b3e-4461-aa8d- aad451a45bf7&start=3&throttlesize=3
    La réponse suivante est renvoyée à partir du
    SpectroSERVER
     :
    <?xml version="1.0" encoding="UTF-8" standalone="yes" ?> - <alarm-response-list xmlns="http://www.ca.com/spectrum/restful/schema/response" error="EndOfResults" throttle="2" total-alarms="5"> - <alarm-responses> <alarm id="4e83d694-18e1-1002-0336-000874f00c29" /> <alarm id="4e77f4fe-1c9e-1000-0336-000874f00c29" /> </alarm-responses> </alarm-response-list>
    Notez les éléments suivants dans cette réponse :
    error="EndOfResults"
    Indique que tous les éléments de la liste ont été récupérés.