browseUserSpaceRestrictions (user)

Returns the list of users with space restrictions on a specified volume and the quotas for those users.

Request

<browse>
   <volumeName/>
   <allUsers/>
</browse>

Reply

<browse>
   <userList>
      <user>
         <id/>
         <userName/>
         <quota/>
         <spaceUsed/>
      </user>
   </userList>
   <result value="">
      <description/>
   </result>
<browse>

Elements

volumeName: (Required) Specifies the volume's name for which to return the user space restriction.
allUsers: (Optional) Specifies to return all users that are using storage but have no restrictions. This functionality is useful in listing the storage in use for all users.
user: Repeats for each user.
id: Specifies the unique ID for the user.
userName: Specifies the user name for the restricted user.
quota: Specifies the quota for the restricted user.
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 list space restrictions for the MYVOL volume is as follows:

<userRequest>
      <browse>
         <volumeName>MYVOL</volumeName>
      </browse>
</userRequest>

A userReply packet to the list space restrictions command follows:

<userReply>
        <browse>
         <userList>
            <user>
               <userName>somebody.somedept.someorg</username>
               <quota>1048576</quota>
               <spaceUsed>401524</spaceUsed>
            </user>
            <user>
               <userName>someone.somedept.someorg</username>
               <quota>262144</quota>
               <spaceUsed>65534</spaceUsed>
            </user>
         </userList>
      </browse>
      <result value="0">            
      <description/>zOK</description>            
   </result>
</userReply>