[OperationContractAttribute]
[WebInvokeAttribute(Method = "POST", ResponseFormat = WebMessageFormat.Json, 
	RequestFormat = WebMessageFormat.Json, BodyStyle = WebMessageBodyStyle.Wrapped, 
	UriTemplate = "/dra/domains/{domainFqdn}/contacts/post")]
Stream ContactCreate(
	string domainFqdn,
	Contact contact,
	ConnectionParameters connectionParameters
)

<OperationContractAttribute>
<WebInvokeAttribute(Method := "POST", ResponseFormat := WebMessageFormat.Json, 
	RequestFormat := WebMessageFormat.Json, BodyStyle := WebMessageBodyStyle.Wrapped, 
	UriTemplate := "/dra/domains/{domainFqdn}/contacts/post")>
Function ContactCreate ( 
	domainFqdn As String,
	contact As Contact,
	connectionParameters As ConnectionParameters
) As Stream

Parameters

domainFqdn: Type: SystemString
The FQDN of the domain to create the contact in
contact: Type: NetIQ.DRA.Common.Rest.DataModelsContact
The contact object to create
connectionParameters: Type: NetIQ.DRA.Common.Rest.DataModelsConnectionParameters
Optional ConnectionParameters to specify a DRA server and Assistant Admin credentials

Return Value

Type: Stream
A GetContactPropertiesResponse object containing the operation results

Examples

Creating a Basic Contact

This will create a contact in the External OU of MyDomain.corp and add that contact to the Domain Users group.

Request Payload

Copy

{
    "contact": {
        "containerOnePointPath": "OnePoint://OU=External,DC=MyDomain,DC=corp",
        "name": "Juanita Gomez",
        "firstName": "Juanita",
        "lastName": "Gomez",
        "memberOf": [{
            "distinguishedName": "CN=Domain Users,CN=Users,DC=MyDomain,DC=corp"
        }]
    }
}

Response

Copy

{
    "contact": {
        "class": "Contact",
        "distinguishedName": "CN=Juanita Gomez,OU=External,DC=MyDomain,DC=corp",
        "objectClass": "Contact"
    },
    "draServerAndPort": "draServer01.MyDomain.corp:11192",
    "errors": []
}

Creating an Email Enabled Contact

This will create a contact with an SMTP email address using Exchange 2010 management tools.

Request Payload

Copy

{
    "contact": {
        "containerOnePointPath": "OnePoint://OU=External,DC=MyDomain,DC=corp",
        "mailNickname": "Patrick_Collins",
        "firstName": "Patrick",
        "lastName": "Collins",
        "createEmail": true,
        "exchangeTool": 4,
        "legacyExchangeDn": "CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,CN=Cris2010 First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=MyDomain,DC=corp",
        "emailAddress": "SMTP:patrick.collins@mycorp.com"
    }
}

Response

Copy

{
    "contact": {
        "class": "Contact",
        "distinguishedName": "CN=Patrick Collins,OU=External,DC=MyDomain,DC=corp",
        "objectClass": "Contact"
    },
    "draServerAndPort": "draServer01.MyDomain.corp:11192",
    "errors": []
}

Reference

IDRARestServer Interface

NetIQ.DRA.RestServiceLibrary Namespace

IDRARestServerAddLanguageSpecificTextSet("LSTB4C04E44_0?cpp=::|nu=.");ContactCreate Method

Parameters

Return Value

Creating a Basic Contact

Creating an Email Enabled Contact

Reference

IDRARestServerContactCreate Method