2.2.2.1.2 Response Headers

  • Article

This protocol and [RFC2616] define several headers that can be sent from the server to the client in an HTTP POST response. The headers follow the status line in the HTTP part of a response. The following table lists some common headers that can be set by the server in response to client requests.

Header

Example value

Notes

Cache-Control

private

Optional. Controls how the response is cached.

Content-Encoding

gzip

Required when the content is compressed; otherwise, this header is not included. Specifies the HTTP compression format that is used in the response.

Content-Length

56

Optional. Specifies the size of the response body in bytes.

Content-Type

application/vnd.ms-sync.wbxml

Required. Specifies that the media-type of the response body is WBXML. Other types of content, such as [RFC2822], can also be specified.

MS-Server-ActiveSync

15.1

Optional. Indicates the version of the ActiveSync server that was used to handle the request.

X-MS-Location

https://mail.contoso.com/Microsoft-Server-ActiveSync

Optional. Used in conjunction with a 451 Redirect status code. Specifies the URL to use for future requests.

MS-ASProtocolCommands

Sync,SendMail,SmartForward,SmartReply,​GetAttachment,GetHierarchy,CreateCollection,​DeleteCollection,MoveCollection,FolderSync,​FolderCreate,FolderDelete,FolderUpdate,​MoveItems,GetItemEstimate,MeetingResponse,​Search,Settings,Ping,ItemOperations,​Provision,ResolveRecipients,ValidateCert, Find

Optional. Indicates the commands supported by the server.

MS-ASProtocolVersions

2.5,12.0,12.1,14.0,14.1,16.0,16.1

Optional. Indicates the protocol versions supported by the server.

X-MS-RP

2.5,12.0,12.1,14.0,14.1,16.0,16.1

Optional. Indicates to the client that the client has to perform a full resynchronization.

X-MS-Credential-Service-Url

https://portal.microsoftonline.com/ChangePassword.aspx

Optional. Contains a URL for reset of user's password.

X-MS-Credentials-Expire

13

Optional. Indicates the number of days remaining until expiration of a user's password.

X-MS-ASThrottle

Global

Optional. Contains information about request being throttled.

Set-Cookie

X-Cookie=value; expires=Wed, 08-Jul-2015 23:40:27 GMT; path=/Microsoft-Server-ActiveSync; secure; HttpOnly

Optional. Contains one or more cookies returned by the server.

X-BEServer

EXCH-SERV-1

Optional. Contains the name of the server that processed the request.

X-FEServer

EXCH-SERV-1

Optional. Contains the name of the server(s) that routed the request.

request-id

7faa449e-4912-4a79-aade-afee642c2c36

Optional. Contains a server-generated identifier for the request.

When protocol version 12.1, 14.0, 14.1, 16.0, or 16.1 is used: Some of the headers in the response can be eliminated when the response is to an HTTP POST request and the response has HTTP status 200. When these two conditions are met, only the following headers are necessary in the response:

  • Content-Length

  • Content-Type, required only if Content-Length is greater than zero.