Modify Quota operation

The Modify Quota operation enables you to modify attributes of one or more existing quota specifications in the directory.

The following table describes the elements for the <items> XML element and adapter request for the Modify Quota operation.

Elements for the <items> XML for the Modify Quota operation

Input elements	Description	Required
<target>	Specifies the target for the request If this element is not present, the adapter uses the default target specified in its configuration.	No
<host>	Specifies the host name or IP address of the remote computer To specify a dynamic target, you must use this element.	No
<user-name>	Specifies the user name for remote host authentication To specify a dynamic target, you must use this element.	No
<password>	Specifies the password that corresponds to the user name To specify a dynamic target, you must use this element.	No
<commands>	Indicates the beginning of the <commands> element, which contains the individual <command> elements	Yes
<command>	Indicates the beginning of a <command> element, which contains the elements that specify the operation to execute and its parameters	Yes
<active-directory-command>	Specifies the operation to execute Default value: Modify Quota	Yes
<object-class>	Specifies the type of object on which to perform the operation Default value: Quota	Yes
<object-distinguished-name>	The distinguished name of the directory partition on which you want to create a quota. For example, CN=PUNBNADV21_TestUser,CN=NTDS Quotas,DC=punbnadv21,DC=local	Yes
<parameters>	Contains the element list for the operation	Yes
<quota-limit>	Specifies the number of objects in the directory partition that can be owned by the security principal to which the quota object is assigned To specify an unlimited quota, use -1.	No
<description>	Specifies a description for the quota specification that you want to modify	No
<server>	Specifies the remote server for the connection If the object belongs to an Active Directory service hosted on a remote server, you must use this element.	Conditional
<domain>	Specifies the remote domain for the connection If the object belongs to an Active Directory service hosted on a remote server, you must use this element.	Conditional
<user-name>	Specifies the logon user name for the remote server	Conditional
<password>	Specifies the password associated with the user name	Conditional

The following figure shows a sample adapter request for the Modify Quota operation.

Adapter request for the Modify Quota operation

<request-data>
<active-directory-request>
   <commands>
     <command>
       <active-directory-command>Modify Quota</active-directory-command>
       <object-class>Quota</object-class>
       <object-distinguished-name>CN=PUNBNADV21_pooja,CN=NTDS Quotas,DC=punbnadv21,DC=local</object-distinguished-name>
       <parameters>
         <quota-limit>15</quota-limit>
         <description>my update test</description>
       </parameters>
     </command>
   </commands>
</active-directory-request>
</request-data>

The following figure shows a sample adapter response for the Modify Quota operation.

Sample adapter response for the Modify Quota operation

<active-directory-response>
<metadata>
   <status>success</status>
</metadata>
<target-output host="vw-pun-bna-dv21.bmc.com">
   <metadata>
     <os-id>Windows Server 2008</os-id>
     <os-version>6.3.9600</os-version>
     <status>success</status>
   </metadata>
   <commands-output>
     <command-output>
       <metadata>
         <command>dsmod quota "\"CN=PUNBNADV21_pooja,CN=NTDS Quotas,DC=punbnadv21,DC=local"\" -qlimit "15" -desc "\"my update test"\"</command>
         <line-count>5</line-count>
         <execution-milliseconds>45313</execution-milliseconds>
         <exit-code>0</exit-code>
         <status>success</status>
       </metadata>
       <output>
         <line index="1">Copyright 2010 BMC Software Ltd, Version: 1.5 </line>
         <line index="2">Connecting to remote service...</line>
         <line index="3">Connected to remote host.</line>
         <line index="4">dsmod succeeded:CN=PUNBNADV21_pooja,CN=NTDS Quotas,DC=punbnadv21,DC=local</line>
         <line index="5">Remote application exited with code: 0 </line>
       </output>
     </command-output>
   </commands-output>
</target-output>
</active-directory-response>

Modify Quota operation

On this page