3.1.5.2.1 GET

This operation is transported by an HTTP GET request.

The operation can be invoked through the following URI suffix:

 Sync/{version}/Discover/Share

The following is an example of a complete URI for this operation:

https://contoso.com/Sync/1.0/Discover/Share

The request message for this operation contains the following HTTP headers.

Request header

Usage

Value

x-ecs-share-type

Optional

A string representing the type of the share to discover. If this header is present in the request, its value MUST be set to "User Data".

The response message for this operation contains the following HTTP headers.

Response header

Usage

Value

x-ecs-request-error

Optional

A string describing request failure information. This MUST be a string representation of the HRESULT in hexadecimal format.

Example:

x-ecs-request-error: "0x8007005"

The response message for this operation can result in the following status codes.

Status code

Description

200

Success

404

There is no sync share for the user (possible reasons include the type not existing or the user not having access).

500

Unexpected server error.