Click or drag to resize

IDRARestServerContactCreate Method

Creates a new contact object

UriTemplate: /dra/domains/{domainFqdn}/contacts/post

Namespace:  NetIQ.DRA.RestServiceLibrary
Assembly:  NetIQ.DRA.RestServiceLibrary (in NetIQ.DRA.RestServiceLibrary.dll) Version: 10.2.2.1
Syntax
[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
)

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
{
    "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
{
    "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
{
    "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
{
    "contact": {
        "class": "Contact",
        "distinguishedName": "CN=Patrick Collins,OU=External,DC=MyDomain,DC=corp",
        "objectClass": "Contact"
    },
    "draServerAndPort": "draServer01.MyDomain.corp:11192",
    "errors": []
}
See Also