Operación unsubscribeUnsubscribe operation

La operación unsubscribe se usa para finalizar una suscripción de notificación de extracción.The Unsubscribe operation is used to end a pull notification subscription. Use esta operación en lugar de permitir un tiempo de espera de suscripción.Use this operation rather than letting a subscription timeout. Esta operación solo es válida para las notificaciones de extracción.This operation is only valid for pull notifications.

Ejemplo de solicitud de cancelación de suscripciónUnsubscribe request example

DescriptionDescription

En el ejemplo siguiente se muestra el mensaje XML de SOAP que se envía para cancelar la suscripción de un cliente desde el servicio de notificación.The following example shows the SOAP XML message that is sent to unsubscribe a client from the Notification service.

CódigoCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <Unsubscribe xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <SubscriptionId>e6fbf5c1-7e26-4bc6-a5f2-882063d5e34e</SubscriptionId>  
    </Unsubscribe>
  </soap:Body>
</soap:Envelope>

Elementos de solicitud de cancelación de suscripciónUnsubscribe request elements

Los siguientes elementos se usan en la solicitud:The following elements are used in the request:

Ejemplo de respuesta de cancelación de suscripción correctaSuccessful Unsubscribe response example

DescriptionDescription

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de cancelación de suscripción.The following example shows a successful response to an Unsubscribe request.

CódigoCode

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <UnsubscribeResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:UnsubscribeResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
        </m:UnsubscribeResponseMessage>
      </m:ResponseMessages>
    </UnsubscribeResponse>
  </soap:Body>
</soap:Envelope>

Elementos de respuesta unsubscribeUnsubscribe response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Ejemplo de respuesta de error de cancelación de suscripciónUnsubscribe Error response example

DescriptionDescription

El siguiente ejemplo de respuesta de error de cancelación de suscripción se produce en respuesta a un intento de cancelar la suscripción mediante un identificador de suscripción que no se encuentra en el almacén de Exchange.The following example of an Unsubscribe error response occurs in response to an attempt to unsubscribe by using a subscription identifier that cannot be located in the Exchange store.

CódigoCode

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <UnsubscribeResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:UnsubscribeResponseMessage ResponseClass="Error">
          <m:MessageText>The specified subscription was not found.</m:MessageText>
          <m:ResponseCode>ErrorSubscriptionNotFound</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:UnsubscribeResponseMessage>
      </m:ResponseMessages>
    </UnsubscribeResponse>
  </soap:Body>
</soap:Envelope>

Elementos de respuesta de error de cancelación de suscripciónUnsubscribe Error response elements

Los siguientes elementos se usan en la respuesta de error:The following elements are used in the error response:

Vea tambiénSee also