Enabling/Disabling Mail Service on Domain

Use the enable (disable) operation to enable (disable) mail service on a particular site.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 

Request Packet Structure

A request XML packet that enables mail service on the specified site contains the enable operation node:

<packet>
  <mail>
    <enable>
     ...
    </enable>
  </mail>
</packet>

 

The enable node does not have a separate data type, it is nested within the MailTypeRequest type (mail_input.xsd). The enable node has the following graphics representation:

 

A request XML packet that disables mail service on the specified site contains the disable operation node:

<packet>
  <mail>
    <disable>
     ...
    </disable>
  </mail>
</packet>

 

The disable node does not have a separate data type, it is nested within the MailTypeRequest complex type (mail_input.xsd). The disable node has the following graphics representation:

 

Response Packet Structure

The enable node of the response packet is structured as follows:

 

The disable node of the response packet is structured as follows:

 

Samples

Enabling mail service on multiple sites

The following request packet demonstrates how mail service can be enabled on multiple sites:

<packet>
<mail>
 <enable>
   <site-id>1</site-id>
 </enable>
 <enable>
   <site-id>2</site-id>
 </enable>
 </mail>
</packet>

Response:

<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.7.0">
  <mail>
    <enable>
      <result>
        <status>ok</status>
      </result>
    </enable>
    <enable>
      <result>
        <status>ok</status>
      </result>
    </enable>
  </mail>
</packet>
Disabling mail service on multiple sites

To disable mail service on multiple sites, send the following request:

<packet>
<mail>
 <disable>
   <site-id>1</site-id>
 </disable>
 <disable>
   <site-id>2</site-id>
 </disable>
 </mail>
</packet>

Response:

<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.7.0">
  <mail>
    <disable>
      <result>
        <status>ok</status>
      </result>
    </disable>
    <disable>
      <result>
        <status>ok</status>
      </result>
    </disable>
  </mail>
</packet>
Enabling mail service on one site and disabling on another site

XML API allows the use of both these operations within a single packet and within the same mail operator:

<packet>
<mail>
 <enable>
   <site-id>1</site-id>
 </enable>
 <disable>
   <site-id>2</site-id>
 </disable>
</mail>
</packet>

Response:

<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.7.0">
  <mail>
    <enable>
      <result>
        <status>ok</status>
      </result>
    </enable>
    <disable>
      <result>
        <status>ok</status>
      </result>
    </disable>
  </mail>
</packet>