Create Quota operation
The Create Quota operation assigns quotas
The following table describes the elements for the <items> XML element and adapter request for the Create Quota operation.
Elements for the <items> XML for the Create Quota operation
Input element | Description | Required |
|---|---|---|
<target> | Specifies the target for the request | No |
<host> | Specifies the host name or IP address of the remote computer | No |
<user-name> | Specifies the user name for remote host authentication | No |
<password> | Specifies the password that corresponds to the user name | 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 | Yes |
<object-class> | Specifies the type of object on which to perform the operation | Yes |
<object-distinguished-name> | The distinguished name of the directory partition on which you want to create a quota. For example, DC=punbnadv21,DC=local | Yes |
<parameters> | Contains the element list for the operation | Yes |
<account> | Specifies the security principal (such as a user, group, or computer object, or an InetOrgPerson object) to whom the quota specification applies | Yes |
<quota-limit> | Specifies the number of objects within the directory partition that the security principal can own To specify an unlimited quota, use -1 | Yes |
<relative-distinguished-name> | Specifies the relative distinguished name of the quota specification that you want to create. If you do not specify -rdn, dsadd sets the name to DOMAIN_ACCOUNTNAME | No |
<description> | Specifies a description for the quota specification that you want to add | No |
<server> | Specifies the remote server for the connection | Conditional |
<domain> | Specifies the remote domain for the connection | 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 Create Quota operation.
Adapter request for the Create Quota operation
<active-directory-request>
<commands>
<command>
<active-directory-command>Create Quota</active-directory-command>
<object-class>Quota</object-class>
<object-distinguished-name>DC=punbnadv21,Dc=local</object-distinguished-name>
<parameters>
<account>CN=Testuser1,CN=Users,DC=punbnadv21,Dc=local</account>
<quota-limit>16</quota-limit>
<relative-distinguished-name>jeena</relative-distinguished-name>
<description>NewQuotya</description>
</parameters>
</command>
</commands>
</active-directory-request>
</request-data>
The following figure shows a sample adapter response for the Create Quota operation:
Sample adapter response for the Create Quota operation
<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>dsadd quota "\"DC=punbnadv21,Dc=local\"" -acct "\"CN=Testuser1,CN=Users,DC=punbnadv21,Dc=local\"" -qlimit "\"16\"" -rdn "\"jeena\"" -desc "\"NewQuotya\""</command>
<line-count>5</line-count>
<execution-milliseconds>43719</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">dsadd succeeded: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>