getUserSpaceRestriction (user)

Returns the user space restriction for a supplied user on a specified volume.

Request

<get>
   <volumeName/>
   <id/>
   <userName/>
</get>

Reply

<get>
   <quota/>
   <noQuota/>
   <fullyRestricted/>
   <spaceUsed/>
   <result value="">
      <description/>
   </result>
</get>

Elements

volumeName: (Required) Specifies the volume's name for which to return the user space restrictions.
id: Specifies the unique ID for the user as returned from browseUserSpaceRestrictions (user). Either the user's ID or name must be specified.
userName: Specifies the DN of the user for which to return restrictions. Either the user's name or ID must be specified.
quota: Specifies the quota for the requested user.
noQuota: Specifies that the user has no limit quota on the specified volume.
fullyRestricted: Specifies that the user is limited to no space or new usage on the specified volume.
spaceUsed: Specifies the space in use by the restricted user.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

A userRequest packet to get space restrictions for a volume is as follows:

<userRequest>
         <get>
         <volumeName>MYVOL</volumeName>
         <userName>somebody.somedept.someorg</userName>
         </get>
</userRequest>

A userReply packet to the get space restrictions command follows:

<userReply>
       <get>
          <quota>1048576</quota>
          <spaceUsed>401524</spaceUsed>
       </get>
   <result value="0">         
      <description/>zOK</description>
   </result>
</userReply>