Element GetMultiple

Retrieve multiple elements by web id or path.

Request

GET elements/multiple

URL Parameters

• webId

  The ID of an element. See WebID for more information. Multiple elements may be specified with multiple instances of the parameter.

• path

  The path of an element. See Path Syntax for more information. Multiple elements may be specified with multiple instances of the parameter.

• includeMode

  The include mode for the return list. See Include Mode for more information. The default is 'All'.

• asParallel

  Specifies if the retrieval processes should be run in parallel on the server. This may improve the response time for large amounts of requested attributes. The default is 'false'.

• selectedFields

  List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned. See Selected Fields for more information.

• webIdType

  Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType". See WebID Type for more information.

• associations

  Associated values to return in the response, separated by semicolons (;). This call supports Paths to return all paths to the element. If this parameter is not specified, paths are not returned. See Associations for more information.

Status Codes

200: The requested elements

207: Some or all items contain exceptions.

Sample Response Body

{
  "Items": [
    {
      "Identifier": "\\\\server\\path",
      "IdentifierType": "Path",
      "Object": {
        "WebId": "I1EmDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBA",
        "Id": "cbb28260-853d-11e4-80c5-00155d844304",
        "Name": "MachineName",
        "Description": "Manufacturing Equipment MachineName",
        "Path": "\\\\MyAssetServer\\MyDatabase\\CityName\\EngineeringProcess\\Equipment\\MachineName",
        "Paths": null,
        "TemplateName": "MachineName",
        "HasChildren": false,
        "CategoryNames": [
          "Equipment Assets"
        ],
        "ExtendedProperties": {},
        "Errors": null,
        "Links": {
          "Self": "https://localhost.osisoft.int/piwebapi/elements/I1EmDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBA"
        }
      },
      "Exception": null
    },
    {
      "Identifier": "\\\\server\\path",
      "IdentifierType": "Path",
      "Object": {
        "WebId": "I1EmDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBA",
        "Id": "cbb28260-853d-11e4-80c5-00155d844304",
        "Name": "MachineName",
        "Description": "Manufacturing Equipment MachineName",
        "Path": "\\\\MyAssetServer\\MyDatabase\\CityName\\EngineeringProcess\\Equipment\\MachineName",
        "Paths": null,
        "TemplateName": "MachineName",
        "HasChildren": false,
        "CategoryNames": [
          "Equipment Assets"
        ],
        "ExtendedProperties": {},
        "Errors": null,
        "Links": {
          "Self": "https://localhost.osisoft.int/piwebapi/elements/I1EmDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBA"
        }
      },
      "Exception": null
    }
  ],
  "Links": {}
}