• Article for your preferred language does not exist. Below is international version of the article.

Article ID: 115603, created on Feb 26, 2013, last review on May 6, 2014

  • Applies to:
  • Operations Automation

Symptoms


As Provider or customer I would like to modify deleted items retention period for Hosted Exchange mailboxes.

Resolution


A customer may manage deleted items retention period for their Exchange mailboxes in POA Customer Control Panel on the 'Limits' tab for every particular mailbox, they may modify the 'Keep deleted items for' parameter as shown on the screenshot:



A customer may change the retention period only if the 'Deleted items retention is read-only' parameter is set to 'No' in subscription's Service Template activation parameters: Service Director > Provisioning Manager > Service Templates > select Service Template a customer Hosted Exchange subscription is based on > the 'Parameters' tab, otherwise customer will only see the value configured by the Provider without possibility to change it.

The default deleted items retention period can be set in POA Service Template settings, under 'Default value of deleted items retention (days)'.

Note: if you change this setting the change will only be applied to newly provisioned Exchange mailboxes.

Provider may set custom retention period for existing mailboxes using the 'pem.exchange.modifyMailbox' POA API method. Here is the example of the API call that will change retention period to 365 days for mailbox with ID #101:
<?xml version='1.0'?>
<methodCall>
  <methodName>pem.exchange.modifyMailbox</methodName>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>message_retention</name>
            <value><i4>365</i4></value>
          </member>
          <member>
            <name>mailbox_id</name>
            <value><i4>101</i4></value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodCall>

If Provider wants to modify retention period to mailboxes in a certain customer subscription, they can get list of mailboxes for a subscription using the 'pem.exchange.getMailboxes' API call. For example, this is an example of API call which gets mailboxes for subscription #1000101:
<?xml version='1.0'?>
<methodCall>
  <methodName>pem.exchange.getMailboxes</methodName>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>subscription_id</name>
            <value><i4>1000101</i4></value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodCall>

Note: there is no way to specify custom retention setting at customer/subscription level. This setting can only be applied at Service Template level and will affect all newly provisioned mailboxes based on the Service Template, or it can be overridden at a mailbox level, this will have to be done by customer (or Provider) every time a new mailbox is provisioned.

You may find all available API methods for managing Exchange mailboxes (including the ones listed above) in POA documentation: Exchange Mailbox Management

caea8340e2d186a540518d08602aa065 5356b422f65bdad1c3e9edca5d74a1ae e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF