1、 ETSI TS 118 104 V1.1.0 (2016-03) oneM2M; Service Layer Core Protocol Specification (oneM2M TS-0004 version 1.6.0 Release 1) floppy3TECHNICAL SPECIFICATION ETSI ETSI TS 118 104 V1.1.0 (2016-03)2oneM2M TS-0004 version 1.6.0 Release 1Reference RTS/oneM2M-000004v110 Keywords IoT, M2M, protocol ETSI 650
2、 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice The present document can be downloaded from: http:/www.
3、etsi.org/standards-search The present document may be made available in electronic versions and/or in print. The content of any electronic and/or print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any existing or perceived differe
4、nce in contents between such versions and/or in print, the only prevailing document is the print of the Portable Document Format (PDF) version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or chang
5、e of status. Information on the current status of this and other ETSI documents is available at https:/portal.etsi.org/TB/ETSIDeliverableStatus.aspx If you find errors in the present document, please send your comment to one of the following services: https:/portal.etsi.org/People/CommiteeSupportSta
6、ff.aspx Copyright Notification No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm except as authorized by written permission of ETSI. The content of the PDF version shall not be modified without the written authorization
7、of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2016. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTMand the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM and LTE are Trad
8、e Marks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Marks registered and owned by the GSM Association. ETSI ETSI TS 118 104 V1.1.0 (2016-03)3oneM2M TS-0004 version 1.6.0 Release 1Contents Intellectual Property Rights 14g3F
9、oreword . 14g31 Scope 15g32 References 15g32.1 Normative references . 15g32.2 Informative references 16g33 Definitions and abbreviations . 17g33.1 Definitions 17g33.2 Abbreviations . 17g34 Conventions 18g35 Protocol design principles and requirements 19g35.1 General introduction . 19g35.2 Introducti
10、on 19g35.2.0 General 19g35.2.1 Interfaces to the underlying networks . 19g35.3 API design guidelines . 20g35.4 Primitives . 20g35.4.1 Introduction. 20g35.4.2 Primitives modelling . 21g35.4.3 Primitive principles . 22g35.4.4 Serialization of primitives . 22g35.5 Design principles 22g35.5.1 Introducti
11、on. 22g35.5.2 Extensibility 22g35.5.3 Scalability . 22g35.5.4 Fault tolerance and robustness 23g35.5.5 Efficiency 23g35.5.6 Inter-operability 23g35.5.7 Self-operation and self-management 23g36 oneM2M protocols/API overview 23g36.1 Introduction 23g36.2 Addressing 24g36.2.1 Introduction. 24g36.2.2 Sum
12、mary of oneM2M Identifiers . 24g36.2.3 oneM2M Entity Addressing 25g36.2.4 oneM2M Resource Addressing. 26g36.3 Common data types 27g36.3.1 Introduction. 27g36.3.2 Simple data types incorporated from XML schema . 27g36.3.3 oneM2M simple data types . 29g36.3.4 oneM2M enumerated data types . 32g36.3.4.1
13、 Introduction . 32g36.3.4.2 Enumeration type definitions 32g36.3.4.2.1 m2m:resourceType 32g36.3.4.2.2 m2m:cseTypeID 33g36.3.4.2.3 m2m:locationSource 33g36.3.4.2.4 m2m:stdEventCats . 33g36.3.4.2.5 m2m:operation . 33g36.3.4.2.6 m2m:responseType 33g36.3.4.2.7 m2m:resultContent 34g36.3.4.2.8 m2m:discRes
14、Type . 34g36.3.4.2.9 m2m:responseStatusCode 34g36.3.4.2.10 m2m:requestStatus 34g36.3.4.2.11 m2m:memberType 35g3ETSI ETSI TS 118 104 V1.1.0 (2016-03)4oneM2M TS-0004 version 1.6.0 Release 16.3.4.2.12 m2m:consistencyStrategy 35g36.3.4.2.13 m2m:cmdType . 35g36.3.4.2.14 m2m:execModeType . 36g36.3.4.2.15
15、m2m:execStatusType 36g36.3.4.2.16 m2m:execResultType 36g36.3.4.2.17 m2m:pendingNotification 37g36.3.4.2.18 m2m:notificationContentType . 37g36.3.4.2.19 m2m:notificationEventType 37g36.3.4.2.20 m2m:status . 38g36.3.4.2.21 m2m:batteryStatus . 38g36.3.4.2.22 m2m:mgmtDefinition 38g36.3.4.2.23 m2m:logTyp
16、eId . 39g36.3.4.2.24 m2m:logStatus . 39g36.3.4.2.25 m2m:eventType . 39g36.3.4.2.26 m2m:statsRuleStatusType . 40g36.3.4.2.27 m2m:statModelType 40g36.3.4.2.28 m2m:encodingType . 40g36.3.4.2.29 m2m:accessControlOperations 40g36.3.4.2.30 m2m:SRole-ID 41g36.3.4.2.31 m2m:filterUsage 41g36.3.5 Complex data
17、 types . 41g36.3.5.1 Introduction . 41g36.3.5.2 m2m:deliveryMetaData . 41g36.3.5.3 m2m:aggregatedRequest . 41g36.3.5.4 m2m:metaInformation . 42g36.3.5.5 m2m:primitiveContent 42g36.3.5.6 m2m:batchNotify 42g36.3.5.7 m2m:eventNotificationCriteria . 42g36.3.5.8 m2m:filterCriteria . 43g36.3.5.9 m2m:attri
18、bute 43g36.3.5.10 (void) . 43g36.3.5.11 m2m:scheduleEntries 43g36.3.5.12 m2m:aggregatedNotification . 44g36.3.5.13 m2m:notification . 44g36.3.5.14 m2m:actionStatus 45g36.3.5.15 m2m:anyArgType . 45g36.3.5.16 m2m:resetArgsType 45g36.3.5.17 m2m:rebootArgsType . 45g36.3.5.18 m2m:uploadArgsTypes . 45g36.
19、3.5.19 m2m:downloadArgsType 46g36.3.5.20 m2m:softwareInstallArgsType 46g36.3.5.21 m2m:softwareUpdateArgsType 46g36.3.5.22 m2m:softwareUninstallArgsType . 46g36.3.5.23 m2m:execReqArgsListType 47g36.3.5.24 m2m:mgmtLinkRef . 47g36.3.5.25 m2m:resourceWrapper 47g36.3.5.26 m2m:setOfAcrs . 48g36.3.5.27 m2m
20、:accessControlRule . 48g36.3.5.28 m2m:locationRegion . 49g36.3.5.29 m2m:childResourceRef . 49g36.3.5.30 m2m:responseTypeInfo . 49g36.3.5.31 m2m:rateLimit 49g36.3.5.32 m2m:operationResult 50g36.3.5.33 m2m:aggregatedResponse . 50g36.3.6 Universal and Common attributes 50g36.4 Message parameter data ty
21、pes 53g36.4.1 Request primitive parameter data types 53g36.4.2 Response primitive parameter data types 54g36.5 Resource data types 54g36.5.1 Description 54g36.5.2 resource . 55g36.5.2.1 Description 55g3ETSI ETSI TS 118 104 V1.1.0 (2016-03)5oneM2M TS-0004 version 1.6.0 Release 16.5.2.2 Reference 55g3
22、6.5.2.3 Usage . 55g36.5.3 regularResource 55g36.5.3.1 Description 55g36.5.3.2 Reference 55g36.5.3.3 Usage . 55g36.5.4 announceableResource 56g36.5.4.1 Description 56g36.5.4.2 Reference 56g36.5.4.3 Usage . 56g36.5.5 announcedResource 56g36.5.5.1 Description 56g36.5.5.2 Reference 56g36.5.5.3 Usage . 5
23、6g36.5.6 announceableSubordinateResource 56g36.5.6.1 Description 56g36.5.6.2 Reference 56g36.5.6.3 Usage . 56g36.5.7 announcedSubordinateResource . 57g36.5.7.1 Description 57g36.5.7.2 Reference 57g36.5.7.3 Usage . 57g36.6 Response status codes 57g36.6.1 Introduction. 57g36.6.2 RSC framework overview
24、 57g36.6.3 Definition of Response Status Codes 57g36.6.3.1 Overview . 57g36.6.3.2 Informational response class . 57g36.6.3.3 Successful response class 57g36.6.3.4 Redirection response class 58g36.6.3.5 Originator Error response class . 58g36.6.3.6 Receiver Error response class . 58g36.6.3.7 Network
25、System Error response class . 58g36.7 oneM2M specific MIME media types 59g36.8 Virtual Resources . 60g37 oneM2M procedures. 60g37.1 Introduction 60g37.2 Primitive format and generic procedure . 60g37.2.1 Primitive format 60g37.2.1.1 Request primitive format . 60g37.2.1.2 Response primitive format 61
26、g37.2.2 Description of generic procedures 62g37.2.2.1 Generic resource request procedure for originator 62g37.2.2.2 Generic request procedure for receiver . 64g37.3 Common operations . 68g37.3.1 Originator actions . 68g37.3.1.1 Compose request primitive . 68g37.3.1.2 Send a request to the receiver C
27、SE . 69g37.3.1.3 Wait for response primitive . 69g37.3.1.4 Retrieve the resource 69g37.3.2 Receiver CSE actions 69g37.3.2.1 Check the validity of received request primitive . 69g37.3.2.2 Create resource locally . 70g37.3.2.3 Create a success response (acknowledgement) . 71g37.3.2.4 Send response pri
28、mitive (acknowledgement) 72g37.3.2.5 Update resource 72g37.3.2.6 Forwarding 72g37.3.2.7 Check Service Subscription Profile . 72g37.3.3 Hosting CSE actions . 73g37.3.3.1 Check the supported resource types 73g37.3.3.2 Check existence of the addressed resource . 73g3ETSI ETSI TS 118 104 V1.1.0 (2016-03
29、)6oneM2M TS-0004 version 1.6.0 Release 17.3.3.3 Check validity of resource representation for CREATE . 73g37.3.3.4 Check validity of resource representation for UPDATE . 74g37.3.3.5 Create the resource 74g37.3.3.6 Retrieve the resource . 75g37.3.3.7 Update the resource . 75g37.3.3.8 Delete the resou
30、rce 76g37.3.3.9 Notify re-targeting . 76g37.3.3.10 Announce the resource or attribute . 77g37.3.3.11 De-announce the resource or attribute. 78g37.3.3.12 Create a success response 79g37.3.3.13 Create an error response 79g37.3.3.14 Resource discovery procedure 79g37.3.3.15 Check authorization of the o
31、riginator 80g37.3.3.16 Send response primitive 80g37.3.3.17 Using Filter Criteria for identification of target resources 80g37.3.3.17.0 Introduction . 80g37.3.3.17.1 Conditions on the creationTime attribute 81g37.3.3.17.2 Conditions on the lastModifiedTime attribute . 81g37.3.3.17.3 Conditions on st
32、ateTag attribute 82g37.3.3.17.4 Conditions on expirationTime attribute . 82g37.3.3.17.5 Conditions on labels attribute 82g37.3.3.17.6 Conditions on resourceType attribute 82g37.3.3.17.7 Conditions on contentSize attribute . 83g37.3.3.17.8 Conditions on typeOfContent of contentInfo attribute 83g37.3.
33、3.17.9 Conditions on attribute name and value pairs 83g37.3.3.17.10 Constraint on number of retrieved resources by limit element 83g37.3.3.17.11 Filter Usage request parameter 83g37.3.4 Management common operations . 84g37.3.4.1 Identify the managed entity and the technology specific protocol 84g37.
34、3.4.2 Locate the technology specific data model objects to be managed on the managed entity . 84g37.3.4.3 Establish a management session with the managed entity or management server 84g37.3.4.4 Send the management request(s) to the managed entity corresponding to the received Request primitive 84g37
35、.4 Resource type-specific procedures and definitions 85g37.4.1 Introduction. 85g37.4.2 Resource type specification conventions 85g37.4.2.0 Introduction . 85g37.4.2.1 Resource type definition conventions . 85g37.4.2.2 Resource type-specific procedure conventions . 86g37.4.3 Resource type 86g37.4.3.1
36、Introduction . 86g37.4.3.2 accessControlPolicy resource specific procedure on CRUD operations . 87g37.4.3.2.0 Introduction . 87g37.4.3.2.1 Create. 87g37.4.3.2.2 Retrieve . 87g37.4.3.2.3 Update . 87g37.4.3.2.4 Delete. 87g37.4.4 Resource Type 88g37.4.4.1 Introduction . 88g37.4.4.2 resource specific pr
37、ocedure on CRUD operations 88g37.4.4.2.1 Create. 88g37.4.4.2.2 Retrieve . 89g37.4.4.2.3 Update . 89g37.4.4.2.4 Delete. 89g37.4.5 Resource Type 89g37.4.5.1 Introduction . 89g37.4.5.2 resource specific procedure on CRUD operations . 90g37.4.5.2.0 Introduction . 90g37.4.5.2.1 Create. 91g37.4.5.2.2 Retr
38、ieve . 91g37.4.5.2.3 Update . 91g37.4.5.2.4 Delete. 91g3ETSI ETSI TS 118 104 V1.1.0 (2016-03)7oneM2M TS-0004 version 1.6.0 Release 17.4.6 Resource Type . 91g37.4.6.1 Introduction . 91g37.4.6.2 resource specific procedure on CRUD+N operations 92g37.4.6.2.1 Introduction . 92g37.4.6.2.2 Create. 92g37.4
39、.6.2.3 Retrieve . 93g37.4.6.2.4 Update . 93g37.4.6.2.5 Delete. 93g37.4.6.2.6 Notify 93g37.4.7 Resource Type 93g37.4.7.1 Introduction . 93g37.4.7.2 resource specific procedure on CRUD operations 94g37.4.7.2.0 Introduction . 94g37.4.7.2.1 Create. 95g37.4.7.2.2 Retrieve . 95g37.4.7.2.3 Update . 95g37.4
40、.7.2.4 Delete. 95g37.4.8 Resource Type 95g37.4.8.1 Introduction . 95g37.4.8.2 resource specific procedure on CRUD operations 96g37.4.8.2.1 Create. 96g37.4.8.2.2 Retrieve . 96g37.4.8.2.3 Update . 97g37.4.8.2.4 Delete. 97g37.4.9 Resource Type . 97g37.4.9.1 Introduction . 97g37.4.9.2 resource specific
41、procedure on CRUD operations . 98g37.4.9.2.1 Create. 98g37.4.9.2.2 Retrieve . 99g37.4.9.2.3 Update . 99g37.4.9.2.4 Delete. 99g37.4.10 Resource Type . 99g37.4.10.1 Introduction . 99g37.4.10.2 resource specific procedure on CRUD operations . 101g37.4.10.2.0 Introduction . 101g37.4.10.2.1 Create. 101g3
42、7.4.10.2.2 Retrieve . 101g37.4.10.2.3 Update . 101g37.4.10.2.4 Delete. 102g37.4.11 Resource Type 102g37.4.11.1 Introduction . 102g37.4.11.2 resource specific procedure on CRUD Operations . 103g37.4.11.2.0 Introduction . 103g37.4.11.2.1 Create. 103g37.4.11.2.2 Retrieve . 104g37.4.11.2.3 Update . 104g
43、37.4.11.2.4 Delete. 104g37.4.12 Resource Type 105g37.4.12.1 Introduction . 105g37.4.12.2 resource specific procedure on CRUD operations 106g37.4.12.2.0 Introduction . 106g37.4.12.2.1 Create. 106g37.4.12.2.2 Retrieve . 106g37.4.12.2.3 Update . 106g37.4.12.2.4 Delete. 107g37.4.13 Resource Type . 107g3
44、7.4.13.1 Introduction . 107g37.4.13.2 resource specific procedure on CRUD operations . 108g37.4.13.2.0 Introduction . 108g37.4.13.2.1 Create. 108g37.4.13.2.2 Retrieve . 108g37.4.13.2.3 Update . 109g3ETSI ETSI TS 118 104 V1.1.0 (2016-03)8oneM2M TS-0004 version 1.6.0 Release 17.4.13.2.4 Delete. 109g37
45、.4.14 Resource Type 109g37.4.14.1 Introduction . 109g37.4.14.2 resource specific procedure on CRUD operations 110g37.4.14.2.1 Introduction . 110g37.4.14.2.2 Create. 110g37.4.14.2.3 Retrieve . 111g37.4.14.2.4 Update . 111g37.4.14.2.5 Delete. 111g37.4.15 Resource Type . 111g37.4.15.1 Introduction . 11
46、1g37.4.15.2 operations . 112g37.4.15.2.1 Validate the type of resource to be created . 112g37.4.15.2.2 Sub-group creation for members residing on the same CSE . 112g37.4.15.2.3 Assign URI for aggregation of notification . 113g37.4.15.2.4 Fanout Request to each member 113g37.4.15.3 resource specific
47、procedure on CRUD operations . 113g37.4.15.3.1 Introduction . 113g37.4.15.3.2 Create. 113g37.4.15.3.3 Retrieve . 114g37.4.15.3.4 Update . 114g37.4.15.3.5 Delete. 115g37.4.16 Resource Type 115g37.4.16.1 Introduction . 115g37.4.16.2 resource specific procedure on CRUD operations 116g37.4.16.2.0 Introd
48、uction . 116g37.4.16.2.1 Create. 116g37.4.16.2.2 Retrieve . 117g37.4.16.2.3 Update . 117g37.4.16.2.4 Delete. 117g37.4.17 Resource Type 118g37.4.17.1 Introduction . 118g37.4.17.2 resource specific procedure on CRUD operations 120g37.4.17.2.0 Introduction . 120g37.4.17.2.1 Create. 120g37.4.17.2.2 Retr
49、ieve . 120g37.4.17.2.3 Update . 120g37.4.17.2.4 Delete. 121g37.4.18 Resource Type 122g37.4.18.1 Introduction . 122g37.4.18.2 resource specific procedure on CRUD oerations 123g37.4.18.2.0 Introduction . 123g37.4.18.2.1 Update (Cancel) . 123g37.4.18.2.2 Retrieve . 124g37.4.18.2.3 Delete. 124g37.4.19 Resource Type . 124g37.4.19.1 Introduction . 124g37.4.19.2 resource specific procedure on CRUD operations . 125g37.4.19.2.1 Create. 125g37.4.19.2.2 Retrieve . 125g37.4.19.2.3 Update . 126g37.4.19.2.4 Delete. 126g37.4.20 Resource Type 126g37.4.20.1 Introduction . 126g37.4.20
