Cisco Unity Express -- DNS Configuration REST PI Service Operation

From DocWiki

(Difference between revisions)
Jump to: navigation, search
m (1 revision)
 
Line 5: Line 5:
'''Next page:''' [[Cisco Unity Express -- System Information REST PI Service Operation]]
'''Next page:''' [[Cisco Unity Express -- System Information REST PI Service Operation]]
 +
 +
 +
'''Search the Cisco Unity Express documentation on the DocWiki:'''
 +
<html><div id="cse" style="width:25%;">Loading</div>
 +
<script src="http://www.google.com/jsapi" type="text/javascript"></script>
 +
<script type="text/javascript">
 +
  google.load('search', '1', {language : 'en'});
 +
  google.setOnLoadCallback(function(){
 +
    var customSearchControl = new google.search.CustomSearchControl('007771824002417948961:zfpvm8yv4fc');
 +
    customSearchControl.setResultSetSize(google.search.Search.FILTERED_CSE_RESULTSET);
 +
    customSearchControl.draw('cse');
 +
  }, true);
 +
</script>
 +
<link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
 +
</html>

Latest revision as of 01:37, 3 May 2010

Main page: Cisco Unity Express -- REST PI Service Operations

Previous page: Cisco Unity Express -- Login Banner REST PI Service Operation

Next page: Cisco Unity Express -- System Information REST PI Service Operation


Search the Cisco Unity Express documentation on the DocWiki:

Loading




Contents

DNS Configuration

Classes

Figure 17: DNS Settings

CUE80 DNS Settings.jpg


DNS
Class Name

DNS

Extends From

ManagedBaseElement

Description

System DNS configuration settings

XML Namespace

http://dns.model.rest.aesop.cisco.com

Field Name Type Constraints Comments

hostName

String

Hostname where CUE is located

domainName

String

Domain name in which CUE is located

dnsServers

DNSServerList

List of DNS servers to be used


DNSServerList
Class Name

DNSServerList

Extends From

ManagedBaseElement

Description

List of DNS Servers

XML Namespace

http://dns.model.rest.aesop.cisco.com

Field Name Type Constraints Comments

dnsServer

DNSServer (collection)

List of DNS servers to be used

DNSServer
Class Name

DNSServer

Extends From

ManagedBaseElement

Description

A DNS Server

XML Namespace

http://dns.model.rest.aesop.cisco.com

Field Name Type Constraints Comments

address

String

Address of the DNS server


Resources

Resource URI Operation Input Return Value

/system/dns

GET (read DNS settings)

DNS

PUT (update DNS settings)

DNS (including DNSServerList)

/system/dns/servers

GET (read list of DNS servers configured)

DNSServerList

PUT (update the list of DNS servers)

DNSServerList

POST (Add a DNS server to the list of configured DNS servers)

DNSServer

/system/dns/servers/{dnsServerAddress}

GET (Read DNSServer)

DNSServer

DELETE (Remove a DNS server from the lust of DNS servers configured)


DNS configuration examples

Update DNS settings
  • Data for the DNS settings is read from local file ./data/dns_data.xml.
  • Changed atributes are dnsServers (DNS Server list) and hostName.
  • Notice that DNSServer to be configured can be referenced either by resource URI or address.
$ cat data/dns_data.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dns>
    <dnsServers>
         <dnsServer>
              <address>5.6.7.8</address>
         </dnsServer>
    <dnsServer>
        <resourceURI>/system/dns/servers/1.2.3.4</resourceURI>
    </dnsServer>
    <dnsServer>
        <resourceURI>/system/dns/servers/1.2.3.5</resourceURI>
    </dnsServer>
    </dnsServers>
    <hostName>newhostname</hostName>
</dns>

$ curl -i -X PUT -H 'Authorization: Basic Y2lzY286Y2lzY28=' -H 'Content-type: application/xml' -d  
@./data/dns_data.xml http://172.27.104.144/rest/system/dns 
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Set-Cookie: JSESSIONID=B86ADA2D33F944576E8814824B42AAC6; Path=/rest
PI-Version: 8.0.0.150
Content-Type: application/xml
Transfer-Encoding: chunked
Date: Mon, 07 Dec 2009 09:44:34 GMT
Updated - /system/dns
Read DNS settings
$ curl -i -X GET -H 'Authorization: Basic Y2lzY286Y2lzY28=' http://172.27.104.144/rest/system/dns 
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Set-Cookie: JSESSIONID=A0333BDEA9895E0EC8B77D8D60EBFA53; Path=/rest
PI-Version: 8.0.0.150
Content-Type: application/xml
Transfer-Encoding: chunked
Date: Mon, 07 Dec 2009 09:44:42 GMT

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dns>
    <resourceURI>/system/dns</resourceURI>
    <dnsServers>
         <resourceURI>/system/dns/servers</resourceURI>
         <dnsServer>
              <resourceURI>/system/dns/servers/5.6.7.8</resourceURI>
              <address>5.6.7.8</address>
         </dnsServer>
         <dnsServer>
              <resourceURI>/system/dns/servers/1.2.3.4</resourceURI>
              <address>1.2.3.4</address>
         </dnsServer>
         <dnsServer>
              <resourceURI>/system/dns/servers/1.2.3.5</resourceURI>
              <address>1.2.3.5</address>
         </dnsServer>
    </dnsServers>
    <domainName>localdomain</domainName>
    <hostName>newhostname</hostName>
</dns>
Remove a DNS Server

Remove a DNS server (address 1.2.3.4) from DNS server list configured

$ curl -i -X DELETE -H 'Authorization: Basic Y2lzY286Y2lzY28=' http://172.27.104.144/rest/system  
/dns/servers/1.2.3.4
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Set-Cookie: JSESSIONID=A50578616C1B282056169F1521CAEBCC; Path=/rest
PI-Version: 8.0.0.150
Content-Type: application/xml
Transfer-Encoding: chunked
Date: Mon, 07 Dec 2009 10:04:06 GMT
Removed  - /system/dns/servers/1.2.3.4

Rating: 0.0/5 (0 votes cast)

Personal tools