2.2.3.32 Commands
The Commands element is an optional child element of the Collection element in Sync command requests and responses that contains operations that apply to a collection. Available operations are add, delete, change, fetch, and soft delete. Client operations are sent in the POST request; server commands are sent in the POST response.
This element is optional. If it is present, it MUST include at least one operation. It is a child of the Collection element.
All elements referenced in this section are defined in the AirSync namespace.
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
Sync command request (section 2.2.1.21) |
Collection (section 2.2.3.29.2) |
Add (section 2.2.3.7.2) Delete (section 2.2.3.42.2) Change (section 2.2.3.24) Fetch (section 2.2.3.67.2)
|
container ([MS-ASDTYPE] section 2.2) |
0...1 (optional) |
|
Sync command response |
Collection |
Add Delete Change SoftDelete (section 2.2.3.172) |
container |
0...1 (optional) |
The result of including no child elements for the Commands element is undefined. The server MAY return a protocol status error in response to such a command request. See section 3.1.5.4 for information regarding the number of child elements contained in a Commands element.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support |
|---|---|
|
2.5 |
Yes |
|
12.0 |
Yes |
|
12.1 |
Yes |
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |