Attribute GetMultiple

Retrieve multiple attributes by web id or path.

Request

GET attributes/multiple

URL Parameters

• webId

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

• path

  The path of an attribute. See Path Syntax for more information. Multiple attributes 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 DataReference to return attributes with data references. If this parameter is not specified, DataReference values are not returned. See Associations for more information.

Status Codes

200: The requested attributes

207: Some or all items contain exceptions.

Sample Response Body

{
  "Items": [
    {
      "Identifier": "\\\\server\\path",
      "IdentifierType": "Path",
      "Object": {
        "WebId": "I1AbEDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBAGyPedZG1sUmxOOclp3Flwg",
        "Id": "75de231b-b591-49b1-b138-e725a77165c2",
        "Name": "Water",
        "Description": "2008 Water Use",
        "Path": "\\\\MyAssetServer\\MyDatabase\\CityName\\EngineeringProcess\\Equipment\\MachineName|Water(2008)",
        "Paths": [
          "\\\\MyAssetServer\\MyDatabase\\MyElement|MyAttribute",
          "\\\\MyAssetServer\\MyDatabase\\ReferencingElement\\MyElement|MyAttribute"
        ],
        "Type": "Int32",
        "TypeQualifier": "",
        "DefaultUnitsName": "liter",
        "DisplayDigits": -5,
        "DataReferencePlugIn": "Table Lookup",
        "ConfigString": "SELECT [Water Use] FROM [Energy Use 2008] WHERE [Asset ID] = '%Element%'",
        "IsConfigurationItem": false,
        "IsExcluded": false,
        "IsHidden": false,
        "IsManualDataEntry": false,
        "HasChildren": false,
        "CategoryNames": [
          "Energy Savings Targets"
        ],
        "Step": false,
        "TraitName": "LimitLoLo",
        "DefaultUnitsNameAbbreviation": "L",
        "Span": 100.0,
        "Zero": 0.0,
        "DataReference": null,
        "Links": {
          "Self": "https://localhost.osisoft.int/piwebapi/attributes/I1AbEDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBAGyPedZG1sUmxOOclp3Flwg"
        }
      },
      "Exception": null
    },
    {
      "Identifier": "\\\\server\\path",
      "IdentifierType": "Path",
      "Object": {
        "WebId": "I1AbEDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBAGyPedZG1sUmxOOclp3Flwg",
        "Id": "75de231b-b591-49b1-b138-e725a77165c2",
        "Name": "Water",
        "Description": "2008 Water Use",
        "Path": "\\\\MyAssetServer\\MyDatabase\\CityName\\EngineeringProcess\\Equipment\\MachineName|Water(2008)",
        "Paths": [
          "\\\\MyAssetServer\\MyDatabase\\MyElement|MyAttribute",
          "\\\\MyAssetServer\\MyDatabase\\ReferencingElement\\MyElement|MyAttribute"
        ],
        "Type": "Int32",
        "TypeQualifier": "",
        "DefaultUnitsName": "liter",
        "DisplayDigits": -5,
        "DataReferencePlugIn": "Table Lookup",
        "ConfigString": "SELECT [Water Use] FROM [Energy Use 2008] WHERE [Asset ID] = '%Element%'",
        "IsConfigurationItem": false,
        "IsExcluded": false,
        "IsHidden": false,
        "IsManualDataEntry": false,
        "HasChildren": false,
        "CategoryNames": [
          "Energy Savings Targets"
        ],
        "Step": false,
        "TraitName": "LimitLoLo",
        "DefaultUnitsNameAbbreviation": "L",
        "Span": 100.0,
        "Zero": 0.0,
        "DataReference": null,
        "Links": {
          "Self": "https://localhost.osisoft.int/piwebapi/attributes/I1AbEDqD5loBNH0erqeqJodtALAYIKyyz2F5BGAxQAVXYRDBAGyPedZG1sUmxOOclp3Flwg"
        }
      },
      "Exception": null
    }
  ],
  "Links": {}
}