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 set to TRUE, then this operation will not return until the processing associated with the execution has completed and the "outputs" element is set. A value of FALSE is not supported.

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.