Operación GetHoldOnMailboxes
Importante
A partir del 1 de abril de 2020, la operación GetHoldOnMailboxes ya no estará disponible en Exchange Online. Esta operación no se verá afectada en las versiones locales de Exchange Server. Para obtener más información, vea Retirada de herramientas de exhibición de documentos electrónicos heredadas en Exchange Online.
Busque información sobre la operación EWS GetHoldOnMailboxes .
La operación GetHoldOnMailboxes obtiene los buzones que están en una suspensión específica y la consulta de suspensión asociada.
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación GetHoldOnMailboxes
La operación GetHoldOnMailboxes proporciona al cliente información sobre qué buzones se colocan en una suspensión específica, información sobre la consulta de suspensión asociada a cada retención, si procede, e información sobre el estado de suspensión de cada buzón. Para obtener más información sobre las retenciones de buzones, incluidas las retenciones basadas en consultas, consulte Suspensión local en TechNet.
Encabezados SOAP de la operación GetHoldOnMailboxes
La operación GetHoldOnMailboxes puede usar los encabezados SOAP que aparecen en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| ManagementRole |
ManagementRole |
Identifica los roles de servidor necesarios para que el autor de la llamada realice la solicitud. Este encabezado es aplicable a una solicitud. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta. |
Ejemplo de solicitud de operación GetHoldOnMailboxes: Obtener información de retención del buzón
En el ejemplo siguiente de una solicitud de operación GetHoldOnMailboxes se muestra cómo obtener la información de retención del buzón de correo HoldId2.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body >
<m:GetHoldOnMailboxes>
<m:HoldId>HoldId2</m:HoldId>
</m:GetHoldOnMailboxes>
</soap:Body>
</soap:Envelope>
El cuerpo SOAP de la solicitud contiene los siguientes elementos:
Respuesta correcta de la operación GetHoldOnMailboxes
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación GetHoldOnMailboxes para obtener la información de retención del buzón de correo HoldId2.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetHoldOnMailboxesResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<MailboxHoldResult>
<HoldId xmlns="http://schemas.microsoft.com/exchange/services/2006/types">HoldId2</HoldId>
<Query xmlns="http://schemas.microsoft.com/exchange/services/2006/types">test</Query>
<MailboxHoldStatuses xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
<MailboxHoldStatus>
<Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDIBPDLT)/cn=Recipients/cn=ecc0fd98c2cadf-Willi</Mailbox>
<Status>OnHold</Status>
<AdditionalInfo/>
</MailboxHoldStatus>
<MailboxHoldStatus>
<Mailbox>/o=First Organization/ou=Exchange Administrative Group (FYDIBPDLT)/cn=Recipients/cn=dasdat341q8de95-Micha</Mailbox>
<Status>OnHold</Status>
<AdditionalInfo/>
</MailboxHoldStatus>
</MailboxHoldStatuses>
</MailboxHoldResult>
</GetHoldOnMailboxesResponse>
</s:Body>
</s:Envelope>
El cuerpo soap de respuesta contiene los siguientes elementos:
Respuesta de error de la operación GetHoldOnMailboxes
En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación GetHoldOnMailboxes . Se trata de una respuesta a una solicitud para obtener una suspensión que se ha eliminado.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetHoldOnMailboxesResponse ResponseClass="Error"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>The specific query-based hold is not found.</MessageText>
<ResponseCode>ErrorMailboxHoldNotFound</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</GetHoldOnMailboxesResponse>
</s:Body>
</s:Envelope>
El cuerpo SOAP de la respuesta de error contiene los siguientes elementos:
Para obtener códigos de error adicionales que son genéricos para EWS y específicos de esta operación, vea ResponseCode.