So what you are seeing is that this call might be deprecated in a future release. You can still use it for now ... but it may just disappear in the future.
As for the rest of your questions, you'll probably want to ask in the API specific forum for answers here: https://communities.vmware.com/community/vmtn/developer/forums/vcloudapi