Thecom.vmware.vapi.std.errors_client module provides the standardexceptions that can be included in the list of exceptions in the specificationof methods to indicate that the method might report those exceptions.
The AlreadyExists exception indicates that an attempt was made tocreate an entity but the entity already exists. Typically the entity has aname or identifier that is required to be unique in some context, but thereis already an entity with that name or identifier in that context.
Methods may provide data that clients can use when responding toexceptions. Since the data that clients need may be specific to thecontext of the method reporting the exception, different methodsthat report the same exception may provide different data in theexception. The documentation for each each method will describewhat, if any, data it provides for each exception it reports.
The ArgumentLocations, FileLocations, andTransientIndication classes are intended as possiblevalues for this attribute.com.vmware.vapi.std_client.DynamicID may also be useful asa value for this attribute (although that is not its primarypurpose). Some classes may provide their own specific classes foruse as the value of this attribute when reporting exceptions fromtheir methods.Some methods will not set this attribute when reporting exceptions.
The ConcurrentChange exception indicates that a data structure, entity,or resource has been modified since some earlier point in time. Typicallythis happens when the client is doing the write portion of aread-modify-write sequence and indicates that it wants the server to notifyit if the data in the server has changed after it did the read, so thatit can avoid overwriting that change inadvertantly.
It is the exception that clients in many programming languages can catchto handle all standard exceptions. Typically those clients will display oneor more of the localizable messages from Error.messages to a human.
This class represents an enumerated type in the interface languagedefinition. The class contains class attributes which represent thevalues in the current version of the enumerated type. Newer versions ofthe enumerated type may contain new values. To use new values of theenumerated type in communication with a server that supports the newerversion of the API, you instantiate this class. See enumeratedtype description page.
Some types of exceptions are caused by a problem with one or more files.This class is intended to be used as the payload to identify those fileswhen the method reports exceptions like NotFound. SeeError.data.
One attribute of a class is the tag for a tagged union, and has aspecific value but another attribute of the class that is required to bespecified when the tag has that value is not specified, or anotherattribute of the class that is required to be unspecified when the tag hasthat value is specified.
A typical case is when the method is am attempt to change the groupmembership of the element fails, in which case a configuration change onthe element may allow the group membership change to succeed.
3a8082e126