Query Meta Measurement Point¶

Get meta measurement points by object type IDs.

Request Format¶

GET/POST https://{api-gateway}/cds-meta-service/v1.0/measurement-point?action=query

Request Parameters (URI)¶

Name	Location	Mandatory/Optional	Data Type	Description
orgId	Query	Mandatory	String	The organization ID which the measurement point belongs to. How to get orgId >>
mdmTypes	Query/Form	Optional	String	The object type ID which the measurement point belongs to. Separate multiple IDs by commas. Up to 100 object type IDs are allowed in a single query. How to get mdmTypes>>
mdmIds	Query/Form	Optional	String	The object instance ID which the measurement point belongs to. Separate multiple IDs by commas. Up to 20000 object instances are allowed in a single query. To ensure query performance, it is recommended that you pass in no more than 100 object instances in a single query.
locale	Query/Form	Optional	String	Use zh-CN, en-US, ja-JP, or es-ES. If not specified, the value is set to en_US by default.
withI18n	Query/Form	Optional	Boolean	Whether to return the internationalization content. The value is `true` or `false`. Default is false.
withElementGroupInfo	Query/Form	Optional	Boolean	Whether to return the visualization group information. The default value is true.
applyDataFilter	Query/Form	Optional	Boolean	Whether to filter the measurement points without data upload in the returned results. Default is false.

Note

mdmTypes and mdmIds are both optional and you need to use at least one of them in a query. If both are used, mdmIds has a higher priority than mdmTypes.

Response Content Type¶

application/json; charset = UTF-8

Response Parameters¶

Name	To Return Definitely/Conditionally	Data Type	Description
mdmType	Definitely	String	The object type which the measurement point belongs to.
modelId	Conditionally	String	The model ID which the measurement point is associated with.
measurementPoint	Definitely	String	The identifier of the measurement point.
name	Definitely	String	The name of the measurement point in the corresponding request language.
nameI18n	Conditionally	I18n Struct	Describe the internalization content of the measurement point name. See I18n Struct.
type	Definitely	String	The data type of the measurement point.
units	Conditionally	String	The unit of the measurement point.
expression	Conditionally	String	The expression of the virtual measurement point.
mdmAggMethods	Definitely	String	The aggregation method of the measurement point by object type.
timeAggMethods	Definitely	String	The aggregation method of the measurement point by time.
interval	Definitely	String	The supported query intervals of the measurement point such as RAW, 5m, and 10m.
signalType	Definitely	String	The type of the measurement point such as AI and DI.
amcFlag	Conditionally	String	The Configuration Center tags of the measurement point.
groups	Conditionally	Group Struct	Describe the visualization group information of the measurement point. See Group Struct.
enumerate	Conditionally	Enumerate Struct	Describe the enumeration values of the enumerated measurement point. See Enumerate Struct.
tags	Conditionally	Tag Struct	Describe the tags of the measurement point.
source	Definitely	String	The source of the point. CDS means the point is a virtual point in Common Data Service, MODEL means the point is a model point, and AMC means the point comes from Configuration Center.
subSource	Conditionally	String	Describe the point is a public or private point.

I18n Struct ¶

Name	To Return Definitely/Conditionally	Data Type	Description
defaultValue	Definitely	String	The default content.
en_US	Conditionally	String	The English content.
zh_CN	Conditionally	String	The Chinese content.
es_ES	Conditionally	String	The Spanish content.
ja_JP	Conditionally	String	The Japanese content.

Group Struct ¶

Name	To Return Definitely/Conditionally	Data Type	Description
groupName	Definitely	String	The name of the visualization group in the corresponding request language.
groupNameI18n	Conditionally	I18n Struct	Describe the internalization content of the visualization group name. See I18n Struct.
groupOrder	Definitely	Integer	The order of the visualization group.
elementName	Definitely	String	The name of the element in the visualization group in the corresponding request language.
elementNameI18n	Conditionally	I18n Struct	Describe the internalization content of the element. See I18n Struct.
elementOrder	Definitely	Integer	The order of the element in the visualization group.
area	Definitely	Map (The Key is of the String type and the Value is an Area Struct)	Describe the area in the visualization group. See Area Struct.

Area Struct ¶

Name	To Return Definitely/Conditionally	Data Type	Description
areaName	Definitely	String	The name of the area in the corresponding request language.
areaNameI18n	Conditionally	I18n Struct	Describe the internalization content of the area name. See I18n Struct.
areaOrder	Definitely	Integer	The order of the area.

Enumerate Struct ¶

Name	To Return Definitely/Conditionally	Data Type	Description
name	Definitely	String	The name of the enumeration values in the corresponding request language.
nameI18n	Conditionally	I18n Struct	Describe the internalization content of the enumeration values. See I18n Struct.

Response Codes¶

See Common Data Service API Response Codes.

Samples¶

Request Sample¶

GET https://{api-gateway}/cds-meta-service/v1.0/measurement-point?action=query&orgId=yourOrgId&mdmTypes=yourMdmType

Response Sample¶

{
   "data":[
         {
            "mdmType":"yourMdmType",
            "modelId": "yourModelId",
            "name": "Site Active Power",
            "units": "kW",
            "type": "Double",
            "measurementPoint": "SITE.GenActivePW",
            "timeAggMethods": "avg,sum,max,min,first,last",
            "mdmAggMethods": "sum",
            "interval":"5,15,60",
            "accumulable": false,
            "signalType": "AI"
        },
        {
            "mdmType":"yourMdmType",
            "modelId": "yourModelId",
            "name": "Site POA",
            "units": "W/m²",
            "type": "Double",
            "measurementPoint": "SITE.Radiation",
            "timeAggMethods": "avg,sum,max,min,first,last",
            "mdmAggMethods": "sum",
            "interval":"5,15,60",
            "accumulable": true,
            "signalType": "AI"
        }
   ],
   "code":0,
   "msg":"OK",
   "traceId": "1234567890abcdefghijkl0987654321"
}