VMware, Inc. 61
Appendix B ADM API Tutorial
Bulk API
TheBulkAPIprovidesyouwiththepossibilityofqueryingtheADMwithmoresophisticatedfilters,and
browsingtheresultsetbymeansofpagination.Theresultsaredeliveredinsubsets(pages)ofapredefined
sizeandformattedinXMLCIM.ThisAPIisintendedforthosecaseswhereanapplication
intendstobrowse
onfinely‐filteredsegmentoftheADMʹsdata.
The Bulk API works as follows
1 Createthefilterobjectandselectthelevelofgranularityoftheresults.
2 Callquery( )withthefilterobjectandobtainthetaskUUIDinstringform.
3AfterthetaskisFINISHED,youcanretrievethemaximumamountof
pagesavailableinthisresultsetby
callinggetPageAmount( ).
4Atthismoment,thereisaniteratorinADMthatyoucancontrolbythefollowingcalls,andtheresults
retrievedfromthem:
a hasNextPage( )
b getNextPage()
5Afterfinishingretrievalofallthedatawiththespecificquery,youmustcallcloseQuery() toreleaseall
resourcesassociatedwiththisquery.
Web Services API
ThepreferredmethodtoaccessADMʹsAPIisthroughthewebservicesAPI,whichprovidesfora
standardizedwayofcommunicationandhighinteroperability.ThisAPIisnotlockedinagivenprogramming
language.
ADMoffersadescriptionoftheAPIinamachine‐readabledocumentformattedinWebServices
Description
Language(WSDL).Withthisdocument,automatedtoolsavailableforthepopularprogramminglanguages
cancreatethelow‐levelcodenecessarytoaccesstransparentlythefunctionalityprovidedbytheADM.
Commentaires sur ces manuels