Application Programming Interface Guide > Web Services Operations > Operations Reference > createDomain
 
createDomain
Create a domain. For some domains this creates a /users/domainName folder resource.
The set of valid domain types can be acquired using getDomainTypes. The set of required and optional attributes for creating the domain can be acquired using getDomainTypeAttributeDefs.
If isBlocking is FALSE and this operation is invoked on an explicit transaction, committing the transaction blocks until the creation is complete. If it is instead invoked on an implicit transaction, the operation returns immediately, but the implicit transaction is not committed or rolled back (as appropriate) until domain creation succeeds or fails.
Location
/services/webservices/system/admin/user/operations/
Request Elements
domainName: The name of the domain to create.
domainType: The domain type name.
isBlocking: If TRUE, the domain is created when this operation returns. A value of FALSE is not supported.
annotation (optional): A description of the domain.
attributes (optional): List of domain type specific attributes. The required attributes vary by domain type. See Attributes Element.
Response Elements
status:
SUCCESS if the domain has been created.
FAIL if the domain failed to be created.
INCOMPLETE if the domain is still being created. An INCOMPLETE domain can be canceled using cancelCreateDomain.
Faults
DuplicateName: If a domain with the same name already exists.
IllegalArgument: If any of the given types or attributes are not valid.
NotAllowed: If additional domains of the given domain type cannot be created.
NotAllowed: If an attempt is made to use this operation with an insufficient license.
NotFound: If the domain type does not exist.
Security: If the user does not have the ACCESS_TOOLS and MODIFY_ALL_USERS rights.