This documentation is archived and is not being maintained.

UNSUBSCRIBE Method

EWS Managed API

Topic Last Modified: 2006-06-13

This topic applies to Exchange 2000 Server SP2 or later.

The WebDAV UNSUBSCRIBE method is used to end a subscription to a resource.

The Subscription-ID Header is mandatory and must contain one or more subscription IDs to be cancelled.

Aa565361.note(en-us,EXCHG.80).gifNote:
See Authentication and Security Using WebDAV for more information.

The list of WebDAV Protocol Status Codes in the following table is not comprehensive. For information about 500-level status codes, see WebDAV Status Codes: 500s.

Status Code Meaning

200 (OK)

The subscription was cancelled.

207 (Multi-Status)

Multiple response codes to be found in XML body.

400 (Bad Request)

Probably an illegal combination of headers or invalid Subscription-ID Header.

The following is an example of a client terminating subscription 16 on the host www.contoso.com.

UNSUBSCRIBE /public/subtest HTTP/1.1
Host: www.contoso.com
Subscription-id: 16

HTTP/1.1 207 Multi-Status
Server: Microsoft-IIS/5.0
Date: Fri, 06 Jul 2001 22:03:15 GMT
Content-Type: text/xml
Content-Length: 273

<?xml version="1.0"?>
<a:multistatus xmlns:b="http://schemas.microsoft.com/Exchange/" xmlns:a="DAV:">
  <a:response>
    <a:href>http://www.contoso.com/public/subtest</a:href>
    <a:status>HTTP/1.1 200 OK</a:status>
    <b:subscriptionID>
      <li>16</li>
    </b:subscriptionID>
  </a:response>
</a:multistatus>

Show: