VMware, Inc. 149
Chapter 8 XML Representations in the vCloud API
Thisextensibilitymechanism,whichisnotusedinthisreleaseofthevCloud API,allowsnewserverstoextend
theXMLrepresentationsnativetothisreleaseofthevCloud APIwithoutrequiringexistingclientsto
understandthoseextensions.
VCloudExtension
AclientshouldbepreparedtoencounteraVCloudExtensionelementinanyresponse.Iftheelementdeclares
required=”true”andclientdoesnotknowhowtointerpretthecontentsoftheelement,theclientcanignore
it,butitmustincludetheVCloudExtensioninanyrequesttomodifytheelementthat contains
it.Aserver
mustreturnafailurewhenarequestincludesaVCloudExtensionelementthatdeclaresrequired=”true”
buttheserverdoesnotunderstandtheextension.
Schema
Name Min Max Type Description
required 0 1 xs:boolean Trueifthisextensionmustbeunderstoodbytheserver
anyattributename 0 n xs:any Anarbitrarynumberofattributesofanytype
anyelementname 0 n xs:any Anarbitrarynumberofelementsofanytype