Export (0) Print
Expand All

2.2.3.5 Response

SharePoint

For each Request element that is part of a cell storage service request, there MUST be a corresponding Response element in a cell storage service response. Each Response element MUST contain one or more SubResponse elements.

<xs:element name="Response">
  <!--Allows for the numbers to be displayed between the SubResponse elements-->
  <xs:complexType mixed="true">
    <xs:sequence minOccurs="1" maxOccurs="unbounded">
      <xs:element name="SubResponse" type="tns:SubResponseElementGenericType" /> 
    </xs:sequence>
    <xs:attribute name="Url" type="xs:string" use="required"/>
    <xs:attribute name="RequestToken" type="xs:nonNegativeInteger" use="required" />
    <xs:attribute name="HealthScore" type="xs:integer" use="required"/>
    <xs:attribute name="ErrorCode" type="tns:GenericErrorCodeTypes" use="optional" />
    <xs:attribute name="ErrorMessage" type="xs:string" use="optional"/>
  </xs:complexType>
</xs:element>

SubResponse: A SubResponseElementGenericType that specifies the response given by the protocol server for the corresponding subrequest requested as part of the SubRequest element. The SubResponseElementGenericType is defined in section 2.2.4.5. The SubResponse element is defined in section 2.2.3.10. The SubRequest element is defined in section 2.2.3.8.

Url: A string that specifies the URL for the file that uniquely identifies the file whose response is being generated. The Url attribute MUST be specified for each Response element.

RequestToken: A nonnegative integer that specifies the request token that uniquely identifies the Request element whose response is being generated. The Request element is defined in section 2.2.3.2. The one-to-one mapping between the Response element and the Request element MUST be maintained by using the request token. The RequestToken MUST be specified for each Response element.

HealthScore: An integer that specifies the server performance health, expressed as an integer ranging from 0 through 10, where a score of 0 specifies excellent server health and a score of 10 specifies very poor server health. The health score provides hints that help the protocol client throttle the sending of cell storage service requests, depending on the server health.

ErrorCode: A GenericErrorCodeTypes that specifies an error code value indicating the type of error that occurred during the processing of the mapping Request element. GenericErrorCodeTypes is defined in section 2.2.5.6. This attribute MUST be present only if any of the following is true:

  • The Url attribute of the corresponding Request element does not exist or is an empty string.<3> (The Url attribute and the Request element are defined in section 2.2.3.2.)

  • The RequestToken attribute of the corresponding Request element is an empty string<4>. (The RequestToken attribute and the Request element are defined in section 2.2.3.2.)

  • An exception occurred during the processing of a subrequest that was not entirely handled by the subrequest processing logic.

ErrorMessage: A string that specifies a description of the error message and also specifies information about what was expected by the server. This attribute MUST be present when the ErrorCode attribute is present and does not equal "Success".

Show:
© 2014 Microsoft