diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/TR-0051-modification_for_MD_Conversion.md b/Conversed_MD/TR-0051-modification_for_MD_Conversion/TR-0051-modification_for_MD_Conversion.md new file mode 100644 index 0000000000000000000000000000000000000000..dc87e9237105a7bf0f53c795f1bbdb3c7cd397fe --- /dev/null +++ b/Conversed_MD/TR-0051-modification_for_MD_Conversion/TR-0051-modification_for_MD_Conversion.md @@ -0,0 +1,1652 @@ + +|<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668a5c0></mark> | + + + + + + + + + + + + + + +|**oneM2M**<br />**Technical Report** |**oneM2M**<br />**Technical Report** | +|-|-| +|Document Number |oneM2M-TR-0051-V-2.0.0 | +|Document Name: |oneM2M API guide<br /> | +|Date: |2020-11-24 | +|Abstract: |Provides a collection of oneM2M API for guiding developers to develop applications using functionalities provided by a oneM2M service platform | +|Template Version: January 2017 (Do not modify) |Template Version: January 2017 (Do not modify) | + + + + + + + + + + + +The present document is provided for future development work within oneM2M only. The Partners accept no liability for any use of the present document. + +The present document has not been subject to any approval process by the oneM2M Partners Type 1. Published oneM2M specifications and reports for implementation should be obtained via the oneM2M Partners' Publications Offices. + + + + + +<br />About oneM2M + +The purpose and goal of oneM2M is to develop technical specifications which address the need for a common M2M Service Layer that can be readily embedded within various hardware and software, and relied upon to connect the myriad of devices in the field with M2M application servers worldwide. + +More information about oneM2M may be found at: http//www.oneM2M.org + +Copyright Notification + +(c) 2020, oneM2M Partners Type 1 (ARIB, ATIS, CCSA, ETSI, TIA, TSDSI, TTA, TTC). + +All rights reserved. + +The copyright and the foregoing restriction extend to reproduction in all media. + + + +Notice of Disclaimer & Limitation of Liability + +The information provided in this document is directed solely to professionals who have the appropriate degree of experience to understand and interpret its contents in accordance with generally accepted engineering or other professional standards and applicable regulations. No recommendation as to products or vendors is made or should be implied. + +NO REPRESENTATION OR WARRANTY IS MADE THAT THE INFORMATION IS TECHNICALLY ACCURATE OR SUFFICIENT OR CONFORMS TO ANY STATUTE, GOVERNMENTAL RULE OR REGULATION, AND FURTHER, NO REPRESENTATION OR WARRANTY IS MADE OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR AGAINST INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS. NO oneM2M PARTNER TYPE 1 SHALL BE LIABLE, BEYOND THE AMOUNT OF ANY SUM RECEIVED IN PAYMENT BY THAT PARTNER FOR THIS DOCUMENT, WITH RESPECT TO ANY CLAIM, AND IN NO EVENT SHALL oneM2M BE LIABLE FOR LOST PROFITS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES. oneM2M EXPRESSLY ADVISES ANY AND ALL USE OF OR RELIANCE UPON THIS INFORMATION PROVIDED IN THIS DOCUMENT IS AT THE RISK OF THE USER. + +<br />Contents + + + +# 1 Scope +The present document is a collection of the CRUDN messages used for managing some of the main resources defined in oneM2M TS-0001 <a href="#_ref_i.2">[i.2]</a>. It also provides the description and associated flow in basic examples. It aims to use this list as a common sets of APIs to help developers to write applications that can run across different platforms and specific implementations. + +When an application developer would need to build software code for managing a specific resource, he could have an immediate access to the list of CRUDN message with description and its associated examples of requests to send and its expected responses. The REST API examples are sorted by resource type and CRUDN operations, which allows a quick and easy access to the information. + + +# 2 References + +## 2.1 Normative references +Normative references are not applicable in the present document. + + +## 2.2 Informative references +References are either specific (identified by date of publication and/or edition number or version number) or nonspecific. For specific references, only the cited version applies. For non-specific references, the latest version of the referenced document (including any amendments) applies. + +The following referenced documents are not necessary for the application of the present document but they assist the user with regard to a particular subject area. + + +- <a name="_ref_i.1">[i.1]</a> oneM2M Drafting Rules. +> NOTE: Available at [http://www.onem2m.org/images/files/oneM2M-Drafting-Rules.pdf](http://www.onem2m.org/images/files/oneM2M-Drafting-Rules.pdf). + +- <a name="_ref_i.2">[i.2]</a> oneM2M TS-0001: "Functional Architecture". +- <a name="_ref_i.3">[i.3]</a> oneM2M TS-0004: "Service Layer Core protocol Specification". + +# 3 Definition of terms, symbols and abbreviations + +## 3.1 Terms + +Void. + + +## 3.2 Symbols +Void. + + +## 3.3 Abbreviations +For the purposes of the present document, the following abbreviations apply: + + +`ACP Access Control Policy` +`AE Application Entity` +`AE-ID Application Entity Identifier` +`API Application Programming Interface` +`CBOR Concise Binary Object Representation` +`CRUDN Create, Retrieve, Update, Delete and Notify operations for REST API` +`CSE Common Services Entity` +`HAIM Home Appliances Information Model` +`HTTP HyperText Transfer Protocol` +`JSON JavaScript Object Notation` +`RCN Result Content` +`REST Representational State Transfer` +`XML eXtensible Markup Language` + +# 4 Conventions + +The key words "Shall", "Shall not", "May", "Need not", "Should", "Should not" in the present document are to be interpreted as described in the oneM2M Drafting Rules <a href="#_ref_i.1">[i.1]</a>. + + +# 5 oneM2M REST APIs + +## 5.1 Introduction +The major objective of the present document is providing example sets of request and response. The REST APIs that are defined in the present document cover for resources Create, Retrieve, Update and Delete management, subscription/notification, data discovery, etc. Sending the CRUD request to the CSE and getting the response may help user to learn oneM2M specification. + +In the current guide, examples of API are written based on HTTP protocol binding and JSON format. The APIs are written based on release 2a version. + +For more references, please refer to clause 2.2. + + +## 5.2 Short name representation + +### 5.2.1 Introduction +oneM2M defines short names for resources and attributes. To encode the message using XML, JSON and CBOR, short names are used. Request or response body which have been formed in short names can reduce the size of the message. + + +### 5.2.2 Resource type short names +Table 5.2.2-1 shows shot names for the resource type. It includes resource types which are used in the present document. For more information please refer to oneM2M TS-0004 <a href="#_ref_i.2">[i.2]</a>. + + +**Table 5.2.2-1: Resource type short names**<a name="table_5.2.2-1"></a> + +|Resource Type Name |Short Name | +|-|-| +|accessControlPolicy |**_acp_** | +|AE |**_ae_** | +|container |**_cnt_** | +|contentInstance |**_cin_** | +|CSEBase |**_cb_** | +|group |**_grp_** | +|remoteCSE |**_csr_** | +|subscription |**_sub_** | +|semanticDescriptor |**_smd_** | +|timeSeries |**_ts_** | +|timeSeriesInstance |**_tsi_** | + + + + +### 5.2.3 Resource attribute short names +Table 5.2.3-1 shows shot names for the resource attribute. It includes attributes which are used in the present document. For more information please refer to oneM2M TS-0004 <a href="#_ref_i.2">[i.2]</a>. + + +**Table 5.2.3-1: Resource attribute short names**<a name="table_5.2.3-1"></a> + +|Attribute Name |Occurs in |Short Name | +|-|-|-| +|_accessControlPolicyIDs_ |All except accessControlPolicy, contentInstance |**_acpi_** | +|_announcedAttribute_ |accessControlPolicy, AE, container, contentInstance, group, locationPolicy, mgmtObj, node, remoteCSE, schedule, semanticDescriptor, trafficPattern |**_aa_** | +|_announceTo_ |accessControlPolicy, AE, container, contentInstance, group, locationPolicy, mgmtObj, node, remoteCSE, schedule, semanticDescriptor, trafficPattern |**_at_** | +|_creationTime_ |All |**_ct_** | +|_expirationTime_ |All except contentInstance, CSEBase |**_et_** | +|labels |All (optional) |**_lb_** **_l_** | +|_lastModifiedTime_ |All |**_lt_** | +|_L_ _ink_ |All |**_lnk_** | +|_parentID_ |All |**_pi_** | +|_resourceID_ |All |**_ri_** | +|resourceType |All |**_ty_** | +|_stateTag_ |container, contentInstance, delivery, request |**_st_** | +|_resourceName_ |All |**_rn_** | +|_privileges_ |accessControlPolicy |**_pv_** | +|_selfPrivileges_ |accessControlPolicy |**_pvs_** | +|_App-ID_ |AE |**_api_** | +|_AE-ID_ |AE |**_aei_** | +|_appName_ |AE |**_apn_** | +|_pointOfAccess_ |AE, CSEBase, remoteCSE |**_poa_** | +|_ontologyRef_ |AE, container, contentInstance, semanticDescriptor. flexContainer, timeSeries |**_or_** | +|_nodeLink_ |AE, CSEBase, remoteCSE |**_nl_** | +|contentSerialization |AE |**_csz_** | +|_creator_ |container, contentInstance, eventConfig, group, pollingChannel, statsCollect, statsConfig, subscription, semanticDescriptor, notificationTargetPolicy, flexContainer, timeSeries |**_cr_** | +|_maxNrOfInstances_ |container, timeSeries |**_mni_** | +|_maxByteSize_ |container, timeSeries |**_mbs_** | +|_maxInstanceAge_ |container, timeSeries |**_mia_** | +|_currentNrOfInstances_ |container, timeSeries |**_cni_** | +|_currentByteSize_ |container |**_cbs_** | +|_locationID_ |container |**_li_** | +|_disableRetrieval_ |container |**_disr_** | +|_contentInfo_ |contentInstance |**_cnf_** | +|_contentSize_ |contentInstance, timeSeriesInstance |**_cs_** | +|_contentRef_ |contentInstance |**_conr_** | +|_containerDefinition_ |flexContainer |**_cnd_** | +|primitiveContent |request |**_pc_** | +|_content_ |contentInstance, timeSeriesInstance |**_con_** | +|_cseType_ |CSEBase, remoteCSE |**_cst_** | +|_CSE-ID_ |CSEBase, remoteCSE, serviceSubscribedNode |**_csi_** | +|_supportedResourceType_ |CSEBase |**_srt_** | +|_notificationCongestionPolicy_ |CSEBase |**_ncp_** | +|_memberType_ |group |**_mt_** | +|_currentNrOfMembers_ |group |**_cnm_** | +|_maxNrOfMembers_ |group |**_mnm_** | +|_memberIDs_ |group |**_mid_** | +|_membersAccessControlPolicyIDs_ |group |**_macp_** | +|_memberTypeValidated_ |group |**_mtv_** | +|_consistencyStrategy_ |group |**_csy_** | +|_semanticSupportIndicator_ |group |**_ssi_** | +|_notifyAggregation_ |group |**_nar_** | +|_groupName_ |group, subscription |**_gn_** | +|_CSEBase_ |remoteCSE |**_cb_** | +|_M2M-Ext-ID_ |remoteCSE |**_mei_** | +|_Trigger-Recipient-ID_ |remoteCSE |**_tri_** | +|_requestReachability_ |remoteCSE |**_rr_** | +|_trigger_ _R_ _eference_ _N_ _umber_ |remoteCSE |**_trn_** | +|_eventNotificationCriteria_ |subscription |**_enc_** | +|_expirationCounter_ |subscription |**_exc_** | +|_notificationURI_ |subscription |**_nu_** | +|groupID |subscription |**_gpi_** | +|_notificationForwardingURI_ |subscription |**_nfu_** | +|_batchNotify_ |subscription |**_bn_** | +|_rateLimit_ |subscription |**_rl_** | +|_preSubscriptionNotify_ |subscription |**_psn_** | +|_pendingNotification_ |subscription |**_pn_** | +|_notificationStoragePriority_ |subscription |**_nsp_** | +|_latestNotify_ |subscription |**_ln_** | +|_notificationContentType_ |subscription |**_nct_** | +|_notificationEventCat_ |subscription |**_nec_** | +|_subscriberURI_ |subscription |**_su_** | +|_descriptorRepresentation_ |semanticDescriptor |**_dcrp_** | +|_semanticOpExec_ |semanticDescriptor |**_soe_** | +|_descriptor_ |semanticDescriptor |**_dsp_** | +|_relatedSemantics_ |semanticDescriptor |**_rels_** | +|_periodicInterval_ |timeSeries |**_pei_** | +|_missingDataDetect_ |timeSeries |**_mdd_** | +|_missingDataMaxNr_ |timeSeries |**_mdn_** | +|_missingDataList_ |timeSeries |**_mdlt_** | +|_missingDataCurrentNr_ |timeSeries |**_mdc_** | +|_missingDataDetectTimer_ |timeSeries |**_mdt_** | +|_dataGenerationTime_ |timeSeriesInstance |**_dgt_** | +|_sequenceNr_ |timeSeriesInstance |**_snr_** | +|_e2eSecInfo_ |CSEBase, remoteCSE, AE |**_esi_** | +|_supportedReleaseVersions_ |CSEBase, remoteCSE, AE |**_srv_** | +|_descriptorRepresentation_ |semanticDescriptor |**_dcrp_** | +|_semanticOpExec_ |semanticDescriptor |**_soe_** | +|_descriptor_ |semanticDescriptor |**_dsp_** | +|_relatedSemantics_ |semanticDescriptor |**_rels_** | +|_periodicInterval_ |timeSeries |**_pei_** | +|_missingDataDetect_ |timeSeries |**_mdd_** | +|_missingDataMaxNr_ |timeSeries |**_mdn_** | +|_missingDataList_ |timeSeries |**_mdlt_** | +|_missingDataCurrentNr_ |timeSeries |**_mdc_** | +|_missingDataDetectTimer_ |timeSeries |**_mdt_** | +|_dataGenerationTime_ |timeSeriesInstance |**_dgt_** | +|_sequenceNr_ |timeSeriesInstance |**_snr_** | +|_e2eSecInfo_ |CSEBase, remoteCSE, AE |**_esi_** | +|_supportedReleaseVersions_ |CSEBase, remoteCSE, AE |**_srv_** | + + + + +## 5.3 Enumeration data types + +### 5.3.0 Introduction +The oneM2M Enumeration Types are based on xs:integer, and the numeric values are interpreted as specified in table 5.3.1-1. + + +### 5.3.1 m2m:resource Type +The enumeration type of resource Type is used in the Content-Type in the HTTP header of request. Table 5.3.1-1 only has enumeration type for resource Type which are used in the present document. More information can be found in oneM2M TS-0004 <a href="#_ref_i.2">[i.2]</a>. + + +**Table 5.3.1-: Interpretation of resourceType**<a name="table_5.3.1-"></a> + +|**Value** |**Interpretation** |**Note** | +|-|-|-| +|1 |accessControlPolicy | | +|2 |AE | | +|3 |container | | +|4 |contentInstance | | +|5 |CSEBase | | +|9 |group | | +|15 |pollingChannel | | +|16 |remoteCSE | | +|23 |subscription | | +|24 |semanticDescriptor | | +|28 |flexContainer | | +|29 |timeSeries | | +|30 |timeSeriesInstance | | + + + + +### 5.3.2 m2m:result content +The response format can be changed using resultContent (RCN) parameter. The oneM2M standard defines 8 different result content, but this API guide only deals with result content 0 to 3. Table 5.3.2-1 shows resultContent value and response format matches. + + +**Table 5.3.2-: Interpretation of resultContent**<a name="table_5.3.2-"></a> + +|**Value** |**Interpretation** |**Note** | +|-|-|-| +|0 |nothing | | +|1 |attributes | | +|2 |hierarchical address | | +|3 |hierarchical address and attributes | | + + + + +# 6 Open API collection + +## 6.1 APIs list + +### 6.1.1 Introduction +The identifier of the API is constructed with the following format: + +API/<RESOURCE\_TYPE>/<OPERATION\_TYPE>/<NUMBER>\_<PERMUTATION> + +Specific values are used in the format defined in table 6.1.1-1. + + +**Table 6.1.1-1: API Id Notation**<a name="table_6.1.1-1"></a> + +|Name |Value |interpretation | +|-|-|-| +|<RESOURCE\_TYPE> |CB |CSEBase | +| |CSR |remoteCSE | +| |AE |AE | +| |CONT |container | +| |CI |contentInstance | +| |SMD |semanticDescriptor | +| |DIS |discovery | +| |SUB |subscription | +| |GRP |group | +| |TS |timeSeries | +| |TSI |timeSeriesInstance | +| |ACP |accessControlPolicy | +| |FLX |flexContainer | +|<OPERATION\_TYPE> |CRE |CREATE | +| |RET |RETRIEVE | +| |UPD |UPDATE | +| |DEL |DELETE | +| |DIS |DISCOVERY | +|<NUMBER> |001 - 999 |- | +|<PERMUTATION> |short name of attribute or resource type that is used in a request primitive. |A resultContent with its value is presented as a <PERMUTATION><br />RCN1, RCN2, RCN3, RCN4<br />Filter Criteria parameter used in discovery clause is presented as a <PERMUTATION><br />TY, LBL, LVL, CRB, etc. | + + + + +### 6.1.2 APIs list + +**Table 6.1.2-1: list of the APIs**<a name="table_6.1.2-1"></a> + +|Interface ID |Interface Category |Interface Description | +|-|-|-| +|API/CB/RET/001<br />API/CB/RET/001\_RCN1 |<CSEBase> RETRIEVE |Retrieve CSEBase with resultContent set to 1 or no RCN | +|API/CB/RET/001\_RCN4 |<CSEBase> RETRIEVE |Retrieve CSEBase with ResultContent set to 4 | +|API/CSR/CRE/001\_RCN0 |<remoteCSE> CREATE |Create remoteCSE with resultContent set to 0 | +|API/CSR/CRE/001<br />API/CSR/CRE/001\_RCN1 |<remoteCSE> CREATE |Create remoteCSE with resultContent set to 1 or no RCN | +|API/CSR/CRE/001\_RCN2 |<remoteCSE> CREATE |Create remoteCSE with resultContent set to 2 | +|API/CSR/CRE/001\_RCN3 |<remoteCSE> CREATE |Create remoteCSE with resultContent set to 3 | +|API/CSR/RET/001<br />API/CSR/RET/001\_RCN1 |<remdoteCSE> RETRIEVE |Retrieve remoteCSE with resultContent set to 1 or no RCN | +|API/CSR/UPD/001<br />API/CSR/UPD/001\_RCN1 |<remoteCSE> UPDATE |Update remoteCSE with resultContent set to 1 or no RCN | +|API/CSR/UPD/001\_RCN0 |<remoteCSE> UPDATE |Update remoteCSE with resultContent set to 0 | +|API/CSR/DEL/001\_RCN0 |<remoteCSE> DELETE |Delete remoteCSE with resultContent set to 0 | +|API/CSR/DEL/001<br />API/CSR/DEL/001\_RCN1 |<remoteCSE> DELETE |Delete remoteCSE with resultContent set to 1 or no RCN | +|API/AE/CRE/001\_RCN0 |<AE> CREATE |Create AE with resultContent set to 0 | +|API/AE/CRE/001<br />API/AE/CRE/001\_RCN1 |<AE> CREATE |Create AE with resultContent set to 1 or no RCN | +|API/AE/CRE/001\_RCN2 |<AE> CREATE |Create AE with resultContent set to 2 | +|API/AE/CRE/001\_RCN3 |<AE> CREATE |Create AE with resultContent set to 3 | +|API/AE/RET/001<br />API/AE/RET/001\_RCN1 |<AE> RETRIEVE |Retrieve AE with resultContent set to 1 or no RCN | +|API/AE/RET/001\_RCN4 |<AE> RETRIEVE |Retrieve AE with resultContent set to 4 | +|API/AE/UPD/001\_RCN0 |<AE> UPDATE |Update AE with resultContent set to 0 | +|API/AE/UPD/001<br />API/AE/UPD/001\_RCN1 |<AE> UPDATE |Update AE with resultContent set to 1 or no RCN | +|API/AE/DEL/001\_RCN0 |<AE> DELETE |Delete AE with ResultContent set to 0 | +|API/AE/DEL/001<br />API/AE/DEL/001\_RCN1 |<AE> DELETE |Delete AE with ResultContent set to 1 or no RCN | +|API/CONT/CRE/001\_RCN0 |<container> CREATE |Create container with resultContent set to 0 | +|API/CONT/CRE/001<br />API/CONT/CRE/001\_RCN1 |<container> CREATE |Create container with resultContent set to 1 or no RCN | +|API/CONT/CRE/001\_RCN2 |<container> CREATE |Create container with resultContent set to 2 | +|API/CONT/CRE/001\_RCN3 |<container> CREATE |Create container with resultContent set to 3 | +|API/CONT/RET/001<br />API/CONT/RET/001\_RCN1 |<container> RETRIEVE |Retrieve container with resultContent set to 1 or no RCN | +|API/CONT/RET/002\_RCN4 |<container> RETRIEVE |Retrieve container with resultContent set to 4 | +|API/CONT/UPD/001\_RCN0 |<container> UPDATE |Update container with resultContent set to 0 | +|API/CONT/UPD/001<br />API/CONT/UPD/001\_RCN1 |<container> UPDATE |Update container with resultContent set to 1 or no RCN | +|API/CONT/DEL/001\_RCN0 |<container> DELETE |Delete container with resultContent set to 0 | +|API/CONT/DEL/001<br />API/CONT/DEL/001\_RCN1 |<container> DELETE |Delete container with resultContent set to 1 or no RCN | +|API/CI/CRE/001\_RCN0 |<contentInstance> CREATE |Create contentInstance with resultContent set to 0 | +|API/CI/CRE/001<br />API/CI/CRE/001\_RCN1 |<contentInstance> CREATE |Create contentInstance with resultContent set to 1 or no RCN | +|API/CI/CRE/001\_RCN2 |<contentInstance> CREATE |Create contentInstance with resultContent set to 2 | +|API/CI/CRE/001\_RCN3 |<contentInstance> CREATE |Create contentInstance with resultContent set to 3 | +|API/CI/RET/001\_LA |<contentInstance> RETRIEVE |Retrieve a latest contentInstance resource | +|API/CI/RET/001\_OL |<contentInstance> RETRIEVE |Retrieve an oldest contentInstance resource | +|API/CI/RET/001\_CI |<contentInstance> RETRIEVE |Retrieve a specific contentInstance resource | +|API/CI/DEL/001\_LA |<contentInstance> DELETE |Delete a latest contentInstance resource without setting resultContent | +|API/CI/DEL/001\_LA\_RCN0 |<contentInstance> DELETE |Delete a latest contentInstance resource with resultContent set to 0 | +|API/CI/DEL/001\_OL |<contentInstance> DELETE |Delete an oldest contentInstance resource without setting resultContent | +|API/CI/DEL/001\_OL\_RCN0 |<contentInstance> DELETE |Delete an oldest contentInstance resource with resultContent set to 0 | +|API/CI/DEL/001\_CI |<contentInstance> DELETE |Delete a specific contentInstance resource without setting resultContent | +|API/CI/DEL/001\_CI\_RCN0 |<contentInstance> DELETE |Delete a specific contentInstance resource with resultContent set to 0 | +|API/SMD/CRE/001\_RCN0 |<semanticDescriptor> CREATE |Create semanticDescriptor with resultContent set to 0 | +|API/SMD/CRE/001<br />API/SMD/CRE/001\_RCN1 |<semanticDescriptor> CREATE |Create semanticDescriptor with resultContent set to 1 or no RCN | +|API/SMD/CRE/001\_RCN3 |<semanticDescriptor> CREATE |Create semanticDescriptor with resultContent set to 3 | +|API/SMD/RET/001<br />API/SMD/RET/001\_RCN1 |<semanticDescriptor> RETRIEVE |Retrieve semanticDescriptor with resultContent set to 1 or no RCN | +|API/SMD/UPD/001\_RCN0 |<semanticDescriptor> UPDATE |Update semanticDescriptor with resultContent set to 0 | +|API/SMD/UPD/001<br />API/SMD/UPD/001\_RCN1 |<semanticDescriptor> UPDATE |Update semanticDescriptor with resultContent set to 1 or no RCN | +|API/SMD/DEL/001\_RCN0 |<semanticDescriptor> DELETE |Delete semanticDescriptor with resultContent set to 0 | +|API/SMD/DEL/001<br />API/SMD/DEL/001\_RCN1 |<semanticDescriptor> DELETE |Delete semanticDescriptor with resultContent set to 1 or no RCN | +|API/DIS\_TY2 |Discovery |Discovery with resourceType filter criteria set to 2 | +|API/DIS\_TY3 |Discovery |Discovery with resourceType filter criteria set to 3 | +|API/DIS\_LBL\_ACTUATOR |Discovery |Discovery with labels filter criteria set to actuator | +|API/DIS\_LBL\_SENSOR |Discovery |Discovery with labels filter criteria set to sensor | +|API/DIS\_LVL1 |Discovery |Discovery with level filter criteria set to 1 | +|API/DIS\_LVL2 |Discovery |Discovery with level filter criteria set to 2 | +|API/DIS\_CRB |Discovery |Discovery with createdBefore filter criteria | +|API/DIS\_CRA |Discovery |Discovery with createdAfter filter criteria | +|API/DIS\_STB |Discovery |Discovery with stateTagBigger filter criteria | +|API/DIS\_STS |Discovery |Discovery with stateTagSmaller filter criteria | +|API/DIS\_SZB |Discovery |Discovery with sizeBelow filter criteria | +|API/DIS\_SZA |Discovery |Discovery with sizeAbove filter criteria | +|API/DIS\_CRB |Discovery |Discovery with unmodifiedSince filter criteria | +|API/DIS\_CRA |Discovery |Discovery with modifiedSince filter criteria | +|API/DIS\_EXB |Discovery |Discovery with expiredBefore filter criteria | +|API/DIS\_EXA |Discovery |Discovery with expiredAfter filter criteria | +|API/SUB/CRE/001\_RCN0 |<subscription> CREATE |Create subscription with resultContent set to 0 | +|API/SUB/CRE/001<br />API/SUB/CRE/001\_RCN1 |<subscription> CREATE |Create subscription with resultContent set to 1 or no RCN | +|API/SUB/CRE/001\_RCN2 |<subscription> CREATE |Create subscription with resultContent set to 2 | +|API/SUB/CRE/001\_RCN3 |<subscription> CREATE |Create subscription with resultContent set to 3 | +|API/SUB/RET/001<br />API/SUB/RET/001\_RCN1 |<subscription> RETRIEVE |Retrieve subscription with resultContent set to 1 or no RCN | +|API/SUB/UPD/001\_RCN0 |<subscription> UPDATE |Update subscription with resultContent set to 0 | +|API/SUB/UPD/001<br />API/SUB/UPD/001\_RCN1 |<subscription> UPDATE |Update subscription with resultContent set to 1 or no RCN | +|API/SUB/DEL/001\_RCN0 |<subscription> DELETE |Delete subscription with resultContent set to 0 | +|API/SUB/DEL/001<br />API/SUB/DEL/001\_RCN1 |<subscription> DELETE |Delete subscription with resultContent set to 1 or no RCN | +|API/GRP/CRE/001\_RCN0 |<group> CREATE |Create group with resultContent set to 0 | +|API/GRP/CRE/001<br />API/GRP/CRE/001\_RCN1 |<group> CREATE |Create group with resultContent set to 1 or no RCN | +|API/GRP/CRE/001\_RCN2 |<group> CREATE |Create group with resultContent set to 2 | +|API/GRP/CRE/001\_RCN3 |<group> CREATE |Create group with resultContent set to 3 | +|API/GRP/RET/001<br />API/GRP/RET/001\_RCN1 |<group> RETRIEVE |Retrieve group with resultContent set to 1 or no RCN | +|API/GRP/UPD/001\_RCN0 |<group> UPDATE |Update group with resultContent set to 0 | +|API/GRP/UPD/001<br />API/GRP/UPD/001\_RCN1 |<group> UPDATE |Update group with resultContent set to 1 or no RCN | +|API/GRP/DEL/001\_RCN0 |<group> DELETE |Delete group with resultContent set to 0 | +|API/GRP/DEL/001<br />API/GRP/DEL/001\_RCN1 |<group> DELETE |Delete group with resultContent set to 1 or no RCN | +|API/TS/CRE/001\_RCN0 |<timeSeries> CREATE |Create timeSeries with resultContent set to 0 | +|API/TS/CRE/001<br />API/TS/CRE/001\_RCN1 |<timeSeries> CREATE |Create timeSeries with resultContent set to 1 or no RCN | +|API/TS/CRE/001\_RCN2 |<timeSeries> CREATE |Create timeSeries with resultContent set to 2 | +|API/TS/CRE/001\_RCN3 |<timeSeries> CREATE |Create timeSeries with resultContent set to 3 | +|API/TS/RET/001<br />API/TS/RET/001\_RCN1 |<timeSeries> RETRIEVE |Retrieve timeSeries with resultContent set to 1 or no RCN | +|API/TS/UPD/001\_RCN0 |<timeSeries> UPDATE |Update timeSeries with resultContent set to 0 | +|API/TS/UPD/001\_RCN1 |<timeSeries> UPDATE |Update timeSeries with resultContent set to 1 or no RCN | +|API/TS/DEL/001\_RCN0 |<timeSeries> DELETE |Delete timeSeries with resultContent set to 0 | +|API/TS/DEL/001<br />API/TS/DEL/001\_RCN1 |<timeSeries> DELETE |Delete timeSeries with resultContent set to 1 or no RCN | +|API/TSI/CRE/001\_RCN0 |<timeSeriesInstance> CREATE |Create timeSeriesInstance with resultContent set to 0 | +|API/TSI/CRE/001<br />API/TSI/CRE/001\_RCN1 |<timeSeriesInstance> CREATE |Create timeSeriesInstance with resultContent set to 1 or no RCN | +|API/TSI/CRE/001\_RCN2 |<timeSeriesInstance> CREATE |Create timeSeriesInstance with resultContent set to 2 | +|API/TSI/CRE/001\_RCN3 |<timeSeriesInstance> CREATE |Create timeSeriesInstance with resultContent set to 3 | +|API/TSI/RET/001<br />API/TSI/RET/001\_RCN1 |<timeSeriesInstance> RETRIEVE |Retrieve timeSeriesInstance with resultContent set to 1 or no RCN | +|API/TSI/DEL/001\_RCN0 |<timeSeriesInstance> DELETE |Delete timeSeriesInstance with resultContent set to 0 | +|API/TSI/DEL/001<br />API/TSI/DEL/001\_RCN1 |<timeSeriesInstance> DELETE |Delete timeSeriesInstance with resultContent set to 1 or no RCN | +|API/ACP/CRE/001\_RCN0 |<accessControlPolicy> CREATE |Create accessControlPolicy with resultContent set to 0 | +|API/ACP/CRE/001<br />API/ACP/CRE/001\_RCN1 |<accessControlPolicy> CREATE |Create accessControlPolicy with resultContent set to 1 or no RCN | +|API/ACP/CRE/001\_RCN2 |<accessControlPolicy> CREATE |Create accessControlPolicy with resultContent set to 2 | +|API/ACP/CRE/001\_RCN3 |<accessControlPolicy> CREATE |Create accessControlPolicy with resultContent set to 3 | +|API/ACP/RET/001<br />API/ACP/RET/001\_RCN1 |<accessControlPolicy> RETRIEVE |Retrieve accessControlPolicy with resultContent set to 1 or no RCN | +|API/ACP/UPD/001\_RCN0 |<accessControlPolicy> UPDATE |Update accessControlPolicy with resultContent set to 0 | +|API/ACP/UPD/001<br />API/ACP/UPD/001\_RCN1 |<accessControlPolicy> UPDATE |Update accessControlPolicy with resultContent set to 1 or no RCN | +|API/ACP/DEL/001\_RCN0 |<accessControlPolicy> DELETE |Delete accessControlPolicy with resultContent set to 0 | +|API/ACP/DEL/001<br />API/ACP/DEL/001\_RCN1 |<accessControlPolicy> DELETE |Delete accessControlPolicy with resultContent set to 1 or no RCN | +|API/FLX/CRE/001\_RCN0 |<flexContainer> CREATE |Create flexContainer with resultContent set to 0 | +|API/FLX/CRE/001<br />API/FLX/CRE/001\_RCN1 |<flexContainer> CREATE |Create flexContainer with resultContent set to 1 or no RCN | +|API/FLX/CRE/001\_RCN2 |<flexContainer> CREATE |Create flexContainer with resultContent set to 2 | +|API/FLX/CRE/001\_RCN3 |<flexContainer> CREATE |Create flexContainer with resultContent set to 3 | +|API/FLX/RET/001<br />API/FLX/RET/001\_RCN1 |<flexContainer> RETRIEVE |Retrieve flexContainer with resultContent set to 1 or no RCN | +|API/FLX/UPD/001\_RCN0 |<flexContainer> UPDATE |Update flexContainer with resultContent set to 0 | +|API/FLX/UPD/001<br />API/FLX/UPD/001\_RCN1 |<flexContainer> UPDATE |Update flexContainer with resultContent set to 1 or no RCN | +|API/FLX/DEL/001\_RCN0 |<flexContainer> DELETE |Delete flexContainer with resultContent set to 0 | +|API/FLX/DEL/001<br />API/FLX/DEL/001\_RCN1 |<flexContainer> DELETE |Delete flexContainer with resultContent set to 1 or no RCN | + + + + +## 6.2 API details + +### 6.2.1 Introduction +This clause introduces standard APIs to perform CRUD operations on the target resource. Each API has request and response using HTTP binding and JSON serialization, but some resources do not have all CRUD APIs which means that the resource does not support all operations. A result content is only used from 0 to 3 in this clause. + + +### 6.2.2 Resource Type _CSEBase_ + +#### 6.2.2.0 Introduction +A <_CSEBase_ > resource represents a CSE and it is the root for all resources that are residing in the CSE. The <_CSEBase_ >resource does not support the creation, update, and delete operations via API but only supports retrieve operation. + + +#### 6.2.2.1 API-CB-RET + +|<br /><br />API Id |API/CB/RET/001<br />API/CB/RET/001\_RCN1<br />API/CB/RET/001\_RCN4 | +|-|-| +|API Name |CSEBase RETRIEVE with or without resultContent parameter | +|Target Resource |<CSEBase> resource of the requested <AE> resource | +|<br />Description |The interface is used to send a <CSEBase> resource RETRIEVE request to CSE, and receive response from the CSE_._ | +|<br />Resource Structure<br />before Sending Request | | +|<br /><br /><br /><br /><br />Call Flow | | +|<br /><br /><br />HTTP Header Information<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : Entity ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />Example with<br />RCN=1<br />or No RCN |<br /> **API/CB/RET/001**<br /> **API/CB/RET/001\_RCN1**<br /><br /><br />**HTTP** **Request:**<br /><br />GET /mn-name?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />Accept: application/json<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2000<br />Content-Length:344<br />Content-Type:application/json<br />X-M2M-Origin:/mnID<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cb": {<br /> "acpi": [<br /> "mnIDAcp"<br /> ],<br /> "csi": "/mnID",<br /> "cst": 2,<br /> "csz": [<br /> "application/xml",<br /> "application/json"<br /> ],<br /> "ct": "20180727T135221",<br /> "lbl": [<br /> "17.0.0+",<br /> "ID-CSE-01"<br /> ],<br /> "lt": "20180727T135221",<br /> "pi": null,<br /> "poa": [<br /> "http://192.168.0.10:8282"<br /> ],<br /> "ri": "mnID",<br /> "rn": "mn-name",<br /> "srt": [<br /> 1,<br /> 2,<br /> 3,<br /> 4,<br /> 5,<br /> 9,<br /> 12,<br /> 13,<br /> 14,<br /> 15,<br /> 16,<br /> 18,<br /> 23,<br /> 17,<br /> 11,<br /> 20,<br /> 19,<br /> 28,<br /> 22,<br /> 7,<br /> 21,<br /> 24,<br /> 100,<br /> 8,<br /> 10<br /> ],<br /> "srv": [<br /> "2a"<br /> ],<br /> "ty": 5,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br />Example with<br />RCN=4<br /> |<br /> **API/CB/RET/001\_RCN4**<br /><br /><br />**HTTP** **Request:**<br /><br />GET /mn-name?rcn=4 HTTP/1.1<br />Host: 192.168.0.10:8282<br />Accept: application/json<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2000<br />Content-Length: 1009<br />Content-Type:application/json<br />X-M2M-Origin:/mnID<br />X-M2M-RVI: 2a<br /><br /><br />{<br /> "m2m:cb": {<br /> "acpi": [<br /> "mnIDAcp"<br /> ],<br /> "csi": "/mnID",<br /> "cst": 2,<br /> "csz": [<br /> "application/xml",<br /> "application/json"<br /> ],<br /> "ct": "20180727T135221",<br /> "lbl": [<br /> "17.0.0+",<br /> "ID-CSE-01"<br /> ],<br /> "lt": "20180727T135221",<br /> "m2m:acp": [<br /> {<br /> "ct": "20180723T141039",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "cseAcp"<br /> ],<br /> "lt": "20180723T141039",<br /> "pi": "mnID",<br /> "pv": {<br /> "acr": [<br /> {<br /> "acco": {<br /> "acip": {<br /> "ipv4": [<br /> "127.0.0.1/0"<br /> ]<br /> },<br /> "actw": [<br /> "\* \* \* \* \* \*"<br /> ]<br /> },<br /> "acop": 63,<br /> "acor": [<br /> "\*"<br /> ]<br /> }<br /> ]<br /> },<br /> "pvs": {<br /> "acr": [<br /> {<br /> "acco": {<br /> "acip": {<br /> "ipv4": [<br /> "127.0.0.1/0",<br /> "127.0.0.1/1"<br /> ]<br /> },<br /> "actw": [<br /> "\* \* \* \* \* \*"<br /> ]<br /> },<br /> "acop": 63,<br /> "acor": [<br /> "\*"<br /> ]<br /> }<br /> ]<br /> },<br /> "ri": "mnIDAcp",<br /> "rn": "mn-nameAcp",<br /> "ty": 1<br /> }<br /> ],<br /> "m2m:ae": [<br /> {<br /> "aei": "CAE0120180723T1415351396520173012480\_cse01",<br /> "api": "A01.com.company.Temp",<br /> "ct": "20180723T141535",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp",<br /> "room\_1"<br /> ],<br /> "lt": "20180723T142022",<br /> "pi": "mnID",<br /> "ri": "CAE0120180723T1415351396520173012480\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": false,<br /> "ty": 2<br /> }<br /> ],<br /> "pi": null,<br /> "poa": [<br /> "http://192.168.0.10:8282"<br /> ],<br /> "ri": "mnID",<br /> "rn": "mn-name",<br /> "srt": [<br /> 1,<br /> 2,<br /> 3,<br /> 4,<br /> 5,<br /> 9,<br /> 12,<br /> 13,<br /> 14,<br /> 15,<br /> 16,<br /> 18,<br /> 23,<br /> 17,<br /> 11,<br /> 20,<br /> 19,<br /> 28,<br /> 22,<br /> 7,<br /> 21,<br /> 24,<br /> 100,<br /> 8,<br /> 10<br /> ],<br /> "ty": 5,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /><br /> | + + +### 6.2.3 Resource Type _remoteCSE_ + +#### 6.2.3.0 Introduction +The <remoteCSE> resource represents a Registree CSE that is registered into a Registrar CSE, and <remoteCSE> locates directly under the <CSEBase> of the Registrar CSE. Similarly, one <remoteCSE> resource will also be created under the <CSEBase> of the Registree CSE to represent the Registrar CSE when the Registree CSE is successfully registered into the Registrar CSE. + + +#### 6.2.3.1 API-CSR-CRE + +|<br /><br />API Id |API/CSR/CRE/001<br />API/CSR/CRE/001\_RCN1<br />API/CSR/CRE/001\_RCN2<br />API/CSR/CRE/001\_RCN3<br />API/CSR/CRE/001\_RCN4 | +|-|-| +|API Name |remoteCSE CREATE with or without resultContent parameter | +|Target Resource |<remoteCSE> resource | +|<br />Description |The interface is used to send a <remoteCSE> resource CREATE request to CSE, and receive response from the CSE_._ | +|<br /><br />Resource Structure | | +|<br /><br /><br /><br /><br />Call Flow | | +|<br /><br /><br />HTTP Header Information<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : Entity ID of request originator<br />Content-Type : application/json;ty=16<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />Example with<br />RCN=0<br /> |<br /> **API/CSR/CRE/001\_RCN0**<br /><br /><br />**HTTP** **Request:**<br /><br />POST /cse-name?rcn=0 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Content-Type:application/json;ty=16<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /><br /> "m2m:csr": {<br /> "cb": "//192.168.0.50:8080/cse-name2",<br /> "csi": "/cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true<br /><br /> }<br /><br />}<br /><br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 201 Created<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />Content-Length:0<br />Content-Type:application/json<br />Content-Location: /cseID/cse2ID<br /> | +|<br /><br /><br /><br /><br /><br />Example with<br />RCN=1<br />or No RCN |<br /> API/CSR/CRE/001<br /> API/CSR/CRE/001\_RCN1<br /><br /><br />HTTP Request:<br /><br />POST /cse-name?rcn=1 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Content-Type:application/json;ty=16<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /><br /> "m2m:csr": {<br /> "cb": "//192.168.56.50:8080/cse-name2",<br /> "csi": "/cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true<br /><br /> }<br /><br />}<br /><br /><br />HTTP Response:<br /><br />HTTP/1.1 201 Created<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2001<br />X-M2M-RVI: 2a<br />Content-Length:216<br />Content-Type:application/json<br />Content-Location: /cseID/cse2ID<br /><br /><br /><br />{<br /> "m2m:csr": {<br /> "cb": "//192.168.0.50:8080/cse-name2",<br /> "csi": "/cse2ID",<br /> "ct": "20200604T123044,616218",<br /> "et": "99991231T235959",<br /> "lt": "20200604T123044,616218",<br /> "pi": "ID-CSE-01",<br /> "ri": "cse2ID",<br /> "rn": "cse-name2",<br /> "rr": false,<br /> "ty": 16<br /> }<br />}<br /><br /> | +|<br /><br /><br /><br /><br /><br />Example with<br />RCN=2<br /> |<br /> **API/CSR/CRE/001\_RCN2**<br /><br /><br />**HTTP** **Request:**<br /><br />POST /cse-name?rcn=2 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Content-Type:application/json;ty=16<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /><br /> "m2m:csr": {<br /> "cb": "//192.168.0.50:8080/cse-name2",<br /> "csi": "/cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true<br /><br /> }<br /><br />}<br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 201 Created<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2001<br />X-M2M-RVI: 2a<br />Content-Length:30<br />Content-Type:application/json<br />Content-Location: /cseID/cse2ID<br /><br />{"m2m:uri":"cse-name/cse-name2"}<br /><br /> | +|<br /><br /><br /><br /><br /><br />Example with<br />RCN=3<br /> |<br /> **API/CSR/CRE/001\_RCN3**<br /><br /><br />**HTTP** **Request:**<br /><br />POST /cse-name?rcn=3 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Content-Type:application/json;ty=16<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /><br /> "m2m:csr": {<br /> "cb": "//192.168.0.50:8080/cse-name2",<br /> "csi": "/cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true<br /><br /> }<br /><br />}<br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 201 Created<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2001<br />X-M2M-RVI: 2a<br />Content-Length:264<br />Content-Type:application/json<br />Content-Location: /cseID/cse2ID<br /><br />{<br /> "m2m:rce": {<br /> "m2m:csr": {<br /> "cb": "//192.168.56.2:8282/cse-name2",<br /> "csi": "/cse2ID",<br /> "ct": "20180801T093501",<br /> "et": "99991231T235959",<br /> "lt": "20180801T093501",<br /> "pi": "cseID",<br /> "poa": [<br /> "http://192.168.56.2:8282"<br /> ],<br /> "ri": "cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true,<br /> "ty": 16,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> },<br /> "uri": "cse-name/cse-name2"<br /> }<br />}<br /> | + + + + +#### 6.2.3.2 API-CSR-RET + +|<br />**API Id** |API/CSR/RET/001<br />API/CSR/RET/001\_RCN1 | +|-|-| +|**API Name** |remoteCSE RETRIEVE with or without resultContent parameter | +|**Target Resource** |<remoteCSE> resource located under <CSEBase> of the hosting CSE | +|<br /><br />**Description** |The interface is used to send a <remoteCSE> RETRIEVE request attached with resultContent to a hosting CSE, and the hosting CSE will send back a response containing attributes of the requested <remoteCSE> resource. | +|<br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : Entity ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1**<br />**or No RCN** |<br /> **API/CSR/RET/001**<br />**API/CSR/RET/001\_RCN1**<br /><br /><br />**HTTP Request:**<br /><br />GET /cse-name/cse-name2?rcn=1 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Accept: application/json<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br /><br />**HTTP Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2000<br />X-M2M-RVI: 2a<br />Content-Length:227<br />Content-Type:application/json<br /><br /><br /><br />{<br /> "m2m:csr": {<br /> "cb": "//192.168.56.2:8282/cse-name2",<br /> "csi": "/cse2ID",<br /> "ct": "20180801T093501",<br /> "et": "99991231T235959",<br /> "lt": "20180801T093501",<br /> "pi": "cseID",<br /> "poa": [<br /> "http://192.168.56.2:8282"<br /> ],<br /> "ri": "cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true,<br /> "ty": 16,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />} | + + + + +#### 6.2.3.3 API-CSR-UPD + +|<br />**API** **Id** |API/CSR/UPD/001<br />API/CSR/UPD/001\_RCN0<br />API/CSR/UPD/001\_RCN1 | +|-|-| +|**API** **Name** |remoteCSE UPDATE with or without resultContent parameter | +|**Target** **Resource** |<remoteCSE> resource located under <CSEBase> of the hosting CSE | +|<br />**Description** |The interface is used to send a _<_ remoteCSE_>_ UPDATE request attached with resultContent to a hosting CSE, and the hosting CSE will send back a response resultContent. | +|<br />**Resource** **Structure** **before** **Sending** **Request** | | +|<br /><br /><br /><br /><br />**Call** **Flow** | | +|<br /><br /><br />**HTTP** **Header** **Information**<br /> |Header and Value pair information:<br />Content-Type : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : CSE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example** **with** <br />**RCN=0**<br /> |<br /> **API/CSR/UPD/001\_RCN0**<br /><br />EXAMPLE: Demonstrate the update of the <pointOfAccess> attribute of <remoteCSE> resource.<br /><br /><br />**HTTP** **Request:**<br /><br />PUT /cse-name/cse-name2?rcn=0 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Content-Type: application/json<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />{<br /> "m2m:csr": {<br /> "poa": ["http://192.168.0.101:8282"]<br /> }<br />}<br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2004<br />X-M2M-RVI: 2a<br />Content-Length:0<br /><br /><br /> | +|<br /><br /><br /><br /><br /><br />**Example** **with** <br />**RCN=1**<br />**or** **No** **RCN** |<br /> **API/CSR/UPD/001**<br /> **API/CSR/UPD/001\_RCN1**<br /><br />EXAMPLE: Demonstrate the update of the <pointOfAccess> attribute of <remoteCSE> resource.<br /><br /><br />**HTTP** **Request:**<br /><br />PUT /cse-name/cse-name2?rcn=1 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Accept: application/json<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:csr": {<br /> "poa": ["http://192.168.0.100:8282"]<br /> }<br />}<br /><br /><br />**HTTP** **Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2004<br />X-M2M-RVI: 2a<br />Content-Length:251<br />Content-Type:application/json<br /><br />{<br /> "m2m:csr": {<br /> "cb": "//192.168.56.2:8282/cse-name2",<br /> "csi": "/cse2ID",<br /> "ct": "20180801T093501",<br /> "et": "99991231T235959",<br /> "lt": "20180801T095839",<br /> "pi": "cseID",<br /> "poa": [<br /> "http://192.168.0.100:8282"<br /> ],<br /> "ri": "cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true,<br /> "ty": 16<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /> | + + + + +#### 6.2.3.4 API-CSR-DEL + +|<br /><br />**API Id** |API/CSR/DEL/001<br />API/CSR/DEL/001\_RCN0<br />API/CSR/DEL/001\_RCN1 | +|-|-| +|**API Name** |remoteCSE DELETE with or without resultContent parameter | +|**Target Resource** |<remoteCSE> resource located under <CSEBase> of the hosting CSE | +|<br /><br />**Description** |The interface is used to send a <remoteCSE> DELETE request attached with resultContent set to 0 to the hosting CSE, and the hosting CSE will delete the <remoteCSE> resource and send back a response containing the response status code of the DELETE operation. | +|<br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : CSE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=0**<br /> |<br /> **API/CSR/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /cse-name/cse-name2?rcn=0 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Accept: application/json<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br /><br />**HTTP Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2002<br />X-M2M-RVI: 2a<br />Content-Length:0<br /><br /><br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1**<br />**or No RCN** |<br /> **API/CSR/DEL/001**<br />**API/CSR/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /cse-name/cse-name2 HTTP/1.1<br />Host: 192.168.56.102:9011<br />Accept: application/json<br />X-M2M-Origin: C0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />HTTP/1.1 200 OK<br />X-M2M-RI: 1234<br />X-M2M-RSC: 2004<br />X-M2M-RVI: 2a<br />Content-Length:228<br />Content-Type:application/json<br /><br />{<br /> "m2m:csr": {<br /> "cb": "//192.168.56.2:8282/cse-name2",<br /> "csi": "/cse2ID",<br /> "ct": "20180801T093501",<br /> "et": "99991231T235959",<br /> "lt": "20180801T100431",<br /> "pi": "cseID",<br /> "poa": [<br /> "http://192.168.0.101:8282"<br /> ],<br /> "ri": "cse2ID",<br /> "rn": "cse-name2",<br /> "rr": true,<br /> "ty": 16,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /> | + + + + +### 6.2.4 Resource Type _AE_ + +#### 6.2.4.0 Introduction +The <AE> resource represents information about an Application Entity that is registered to a CSE. The originator of an <AE> create request is and only can be an AE. A CSE is not allowed to initiate an <AE> create request. + +The <AE> resource which resides in different kind of nodes such as Application Dedicated Node, Middle Node, Infrastructure Node, etc. An Application Dedicated Node could reside in a constrained M2M device, while a Middle Node could reside in an M2M gateway and an Infrastructure Node could reside in an M2M Service Infrastructure. For example, in smart home scenario, light bulbs are modelled as Application Dedicated Node which communicate with home gateway which is modelled as a Middle Node and in resource registration phase, light bulbs can be registered as an <AE> resource. + + +#### 6.2.4.1 API-AE-CRE + +|<br /><br />**API Id** |API/AE/CRE/001<br />API/AE/CRE/001\_RCN0<br />API/AE/CRE/001\_RCN1<br />API/AE/CRE/001\_RCN2<br />API/AE/CRE/001\_RCN3 | +|-|-| +|**API Name** |AE CREATE with or without resultContent parameter | +|**Target Resource** |<CSEBase> resource of the requested <AE> resource | +|<br /><br /><br />**Description** |The interface is used by a AE Registree to send an _<_ AE_>_ CREATE request to a Registrar CSE and the Registrar CSE creates an <AE> resource and sends back a response to the AE Registree according to the configured resultContent parameter.<br /><br />A sensor is registered to the platform by sending an <AE> registration request to the CSEBase. | +|<br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=2<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br /> **API/AE/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: C<br />Content-Type: application/json;ty=2<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ae": {<br /> "api": "A01.com.company.Temperature1",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "rr": false,<br /> "rn": "ae\_sensor"<br /> }<br />}<br /><br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:0<br />Content-Location:/mnID/CAE0120180404T0830181405122857960960\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1**<br />**or No RCN** |<br /> **API/AE/CRE/001**<br /> **API/AE/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: C<br />Content-Type: application/json;ty=2<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ae": {<br /> "api": "A01.com.company.Temperature",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "rr": false,<br /> "rn": "ae\_sensor"<br /> }<br />}<br /><br /><br />HTTP Response:<br /><br />201 Created<br />Content-Length:310<br />Content-Location:/mnID/CAE0120180404T0833201405122522252800\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:ae": {<br /> "aei": "CAE0120180404T0833201405122522252800\_cse01",<br /> "api": "A01.com.company.Temperature",<br /> "ct": "20180404T083320",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "lt": "20180404T083320",<br /> "pi": "mnID",<br /> "ri": "CAE0120180404T0833201405122522252800\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": false,<br /> "ty": 2,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /> }<br />} | +|<br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br /> **API/AE/CRE/001\_RCN2**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: C<br />Content-Type: application/json;ty=2<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ae": {<br /> "api": "A01.com.company.Temperature",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "rr": false,<br /> "rn": "ae\_sensor"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:40<br />Content-Location:/mnID/CAE0120180404T0836301405122354398720\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_sensor"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br /> **API/AE/CRE/001\_RCN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: C<br />Content-Type: application/json;ty=2<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ae": {<br /> "api": "A01.com.company.Temperature",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "rr": false,<br /> "rn": "ae\_sensor"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:355<br />Content-Location:/mnID/CAE0120180404T0838301405122186544640\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:ae": {<br /> "aei": "CAE0120180404T0838301405122186544640\_cse01",<br /> "api": "A01.com.company.Temperature",<br /> "ct": "20180404T083830",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "lt": "20180404T083830",<br /> "pi": "mnID",<br /> "ri": "CAE0120180404T0838301405122186544640\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": false,<br /> "ty": 2,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /> },<br /> "uri": "mn-name/ae\_sensor"<br /> }<br />}<br /> | + + + + +#### 6.2.4.2 API-AE-RET + +|<br />**API Id** |API/AE/RET/001\_RCN1<br />API/AE/RET/001\_RCN4 | +|-|-| +|**API Name** |AE RETRIEVE with or without resultContent parameter | +|**Target Resource** |The <AE> resource located under <CSEBase> | +|<br />**Description** |The interface is used to send an <AE> RETRIEVE request attached with resultContent to the <AE> resource located under the <CSEBase> of the CSE, and the hosting CSE will send back a response according to the configured resultContent. | +|<br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=1**<br />**or No RCN** |<br />**API/AE/RET/001**<br />**API/AE/RET/001\_RCN1**<br /><br />HTTP Request:<br /><br />GET /mn-name/ae\_sensor HTTP/1.1<br />Accept: application/json<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0838301405122186544640\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br />HTTP Response:<br /><br />200 OK<br />Content-Length:308<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RSC:2000<br />{<br /> "m2m:ae": {<br /> "aei": "CAE0120180404T0838301405122186544640\_cse01",<br /> "api": "A01.com.company.Temperature",<br /> "ct": "20180404T083830",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "lt": "20180404T083830",<br /> "pi": "mnID",<br /> "ri": "CAE0120180404T0838301405122186544640\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": false,<br /> "ty": 2,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=4** |<br /> **API/AE/RET/001\_RCN4**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_sensor?rcn=4 HTTP/1.1<br />Accept: application/json<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0838301405122186544640\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br />// In the example, the <AE> has 2 child <container> resources cont\_temp1 and cont\_temp2<br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:874<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br /><br />{<br /> "m2m:ae": {<br /> "aei": "CAE0120180404T0838301405122186544640\_cse01",<br /> "api": "A01.com.company.Temperature",<br /> "ct": "20180404T083830",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "lt": "20180404T084508",<br /> "m2m:cnt": [<br /> {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180404T084508",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180404T084508",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 10000,<br /> "pi": "CAE0120180404T0838301405122186544640\_cse01",<br /> "ri": "cnt20180404T0845081405122522252801\_cse01",<br /> "rn": "cont\_temp2",<br /> "st": 0,<br /> "ty": 3<br /> },<br /> {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180404T084503",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180404T084503",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 10000,<br /> "pi": "CAE0120180404T0838301405122186544640\_cse01",<br /> "ri": "cnt20180404T0845031405122606179840\_cse01",<br /> "rn": "cont\_temp1",<br /> "st": 0,<br /> "ty": 3<br /> }<br /> ],<br /> "pi": "mnID",<br /> "ri": "CAE0120180404T0838301405122186544640\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": false,<br /> "ty": 2,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /> }<br />}<br /> | + + + + +#### 6.2.4.3 API-AE-UPD + +|<br /><br />**API Id** |API/AE/UPD/001<br />API/AE/UPD/001\_RCN0<br />API/AE/UPD/001\_RCN1 | +|-|-| +|**API Name** |AE UPDATE with or without resultContent set | +|**Target Resource** |The <AE> resource located under <CSEBase> resource of CSE | +|<br /><br />**Description** |The interface is used to send an <AE> UPDATE request to the target <AE> resource under the CSE, and the hosting CSE will send back a response only containing the response status code indicating the request processing status. | +|<br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0**<br /><br /><br /> |<br /> **API/AE/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_sensor?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0838301405122186544640\_cse01<br />Content-Type:application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ae": {<br /> "poa": ["http://ae.temp.com:9090"],<br /> "rr":true<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2004<br /> | +|<br /><br /><br />**Example with**<br />**RCN=1**<br />**or No RCN**<br /><br /><br /> |<br /> **API/AE/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_sensor HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0838301405122186544640\_cse01<br />Content-Type:application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ae": {<br /> "poa": ["http://ae.temp.com:9090"],<br /> "rr:":true<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:341<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2004<br /><br />{<br /> "m2m:ae": {<br /> "aei": "CAE0120180404T0838301405122186544640\_cse01",<br /> "api": "A01.com.company.Temperature",<br /> "ct": "20180404T083830",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "lt": "20180404T085903",<br /> "pi": "mnID",<br /> "poa": [<br /> "http://ae.temp.com:9090"<br /> ],<br /> "ri": "CAE0120180404T0838301405122186544640\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": true,<br /> "ty": 2,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /> | + + + + +#### 6.2.4.4 API-AE-DEL + +|<br /><br />**API Id** |API/AE/DEL/001<br />API/AE/DEL/001\_RCN0<br />API/AE/DEL/001\_RCN1 | +|-|-| +|**API Name** |AE DELETE | +|**Target Resource** |The <AE> resource located under <CSEBase> resource of CSE | +|<br /><br />**Description** |The interface is used to send an <AE> DELETE request to the hosting CSE, and the hosting CSE will delete the <AE> and send back a response containing a response status code indicating the DELETE request status. | +|<br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0**<br /> |**API/AE/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0838301405122186544640\_cse01<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /> | +|<br /><br /><br />**Example with**<br />**RCN=1 or**<br />**no RCN**<br /> |<br />**API/AE/DEL/001**<br />**API/AE/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0904581405122774033921\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:308<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /><br />{<br /> "m2m:ae": {<br /> "aei": "CAE0120180404T0904581405122774033921\_cse01",<br /> "api": "A01.com.company.Temperature",<br /> "ct": "20180404T090458",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temperature",<br /> "room\_1"<br /> ],<br /> "lt": "20180404T090556",<br /> "pi": "mnID",<br /> "ri": "CAE0120180404T0904581405122774033921\_cse01",<br /> "rn": "ae\_sensor",<br /> "rr": false,<br /> "ty": 2,<br /> "srv": [<br /> "1",<br /> "2",<br /> "2a"<br /> ]<br /><br /> }<br />}<br /> | + + + + +### 6.2.5 Resource Type _container_ + +#### 6.2.5.0 Introduction +The <container> resource represents a container for data instances. It is used to share information with other entities and potentially to track the data. A <container> resource has no associated content. It has only attributes and child resources. + +The <container> resource can be seen as a container of a group of data instances with same characteristics, for example, sensor measurement of temperature, humidity, illumination, CO2, etc. For example, when a temperature sensor is modelled as application dedicated node and registered with an <AE> resource, a <container> resource can be created under the created <AE> as its child resource to contain temperature measurements. Note that <container> resource has no associated content and the real data is contained in a child resource of container called <contentInstance> which will be introduced in clause 6.2.6. + + +#### 6.2.5.1 API-CONT-CRE + +|<br /><br />**API** **Id** |API/CONT/CRE/001<br />API/CONT/CRE/001\_RCN0<br />API/CONT/CRE/001\_RCN1<br />API/CONT/CRE/001\_RCN2<br />API/CONT/CRE/001\_RCN3 | +|-|-| +|**API** **Name** |container CREATE with and without resultContent parameter | +|**Target** **Resource** |<AE> resource as a parent resource of the requested <container> resource | +|<br /><br />**Description** |The interface is used to send a _<_ container_>_ CREATE request attached with resultContent under the <AE> resource located in the <CSEBase>. The hosting CSE will create the <container> resource under the <AE>, and send back a response according to the configured resultContent_._ | +|<br />**Resource** **Structure** **before** **Sending** **Request** | | +|<br /><br /><br /><br /><br />**Call** **Flow** | | +|<br /><br /><br />**HTTP** **Header** **Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=3<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example** **with** <br />**No** **RCN** **or** **RCN=1** |<br /> **API/CONT/CRE/001**<br /> **API/CONT/CRE/001\_RCN1**<br /><br />**HTTP** **Request:**<br /><br />POST /mn-name/ae\_sensor HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=3<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "rn": "cont\_temp"<br /> }<br />}<br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:265<br />Content-Location:/mnID/cnt20180406T0857121405855183193600\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br />{<br /> "m2m:cnt": {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180406T085712",<br /> "et": "99991231T235959",<br /> "lt": "20180406T085712",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 10000,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T0857121405855183193600\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 0,<br /> "ty": 3<br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example** **with** <br />**RCN=0** |<br /> **API/CONT/CRE/001\_RCN/0**<br /><br />**HTTP** **Request:**<br /><br />POST /mn-name/ae\_sensor HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=3<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "rn": "cont\_temp"<br /> }<br />}<br /><br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:0<br />Content-Location:/ mnID/cnt20180406T0922111405855351047681\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /> | +|<br /><br /><br />**Example** **with** <br />**RCN=2** |<br /> **API/CONT/CRE/001\_RCN2**<br /><br />**HTTP** **Request:**<br /><br />POST /mn-name/ae\_sensor?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=3<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "rn": "cont\_temp"<br /> }<br />}<br /><br /><br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:50<br />Content-Location:/mnID/cnt20180406T0924461405855854609922\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_sensor/cont\_temp"<br />}<br /> | +|<br /><br /><br />**Example** **with** <br />**RCN=3** |<br />**API/CONT/CRE/001\_RCN3**<br /><br />**HTTP** **Request:**<br /><br />POST /mn-name/ae\_sensor?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=3<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "rn": "cont\_temp"<br /> }<br />}<br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:322<br />Content-Location:/mnID/cnt20180406T0927581405855602828800\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:cnt": {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180406T092758",<br /> "et": "99991231T235959",<br /> "lt": "20180406T092758",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 10000,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T0927581405855602828800\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 0,<br /> "ty": 3<br /> },<br /> "uri": "mn-name/ae\_sensor/cont\_temp"<br /> }<br />}<br /> | + + + + +#### 6.2.5.2 API-CONT-RET + +|<br /><br />**API Id** |API/CONT/RET/001<br />API/CONT/RET/001\_RCN1<br />API/CONT/RET/001\_RCN4 | +|-|-| +|**API Name** |container RETRIEVE with or without resultContent parameter set | +|**Target Resource** |Requested <container> resource | +|<br /><br />**Description** |The interface is used to send a <container> RETRIEVE request attached with resultContent to the <container> resource located in the <CSEBase>. The hosting CSE will send back a response according to the configured resultContent_._ | +|<br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**No RCN or RCN=1** |<br />**API/CONT/RET/001**<br />**API/CONT/RET/001\_RCN/1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_sensor/cont\_temp HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:265<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br /><br />{<br /> "m2m:cnt": {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180406T092758",<br /> "et": "99991231T235959",<br /> "lt": "20180406T092758",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 10000,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T0927581405855602828800\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 0,<br /> "ty": 3<br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=4**<br /><br /> |<br />**API/CONT/RET/001\_RCN4**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_sensor/cont\_temp?rcn=4 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE3878123815422295646<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />// Container <cont\_temp> has 2 child <contentInstance> resources<br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:1347<br />Content-Type:application/json<br />X-M2M-Origin:/mnID<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br /><br />{<br /> "m2m:cnt": {<br /> "cbs": 6,<br /> "cni": 2,<br /> "ct": "20180406T092758",<br /> "et": "99991231T235959",<br /> "lt": "20180406T094838",<br /> "m2m:cin": [<br /> {<br /> "con": "27",<br /> "cs": 3,<br /> "ct": "20180406T094838",<br /> "et": "99991231T235959",<br /> "lt": "20180406T094838",<br /> "pi": "cnt20180406T0927581405855602828800\_cse01",<br /> "ri": "cin20180406T0948381405855183193602\_cse01",<br /> "rn": "cin20180406T0948381405855183193601\_cse01",<br /> "st": 2,<br /> "ty": 4<br /> },<br /> {<br /> "con": "28",<br /> "cs": 3,<br /> "ct": "20180406T094719",<br /> "et": "99991231T235959",<br /> "lt": "20180406T094719",<br /> "pi": "cnt20180406T0927581405855602828800\_cse01",<br /> "ri": "cin20180406T0947191405855686755841\_cse01",<br /> "rn": "cin20180406T0947191405855686755840\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br /> ],<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 10000,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T0927581405855602828800\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 2,<br /> "ty": 3<br /> }<br />}<br /> | + + + + +#### 6.2.5.3 API-CONT-UPD + +|<br />**API Id** |API/CONT/UPD/001<br />API/CONT/UPD/001\_RCN0<br />API/CONT/UPD/001\_RCN1 | +|-|-| +|**API Name** |container UPDATE with or without resultContent set | +|**Target Resource** |Requested <container> resource | +|<br /><br />**Description** |The interface is used to send a <container> UPDATE request to the target <container> resource located under the CSE, and the hosting CSE will respond with only the response status code to indicate the UPDATE operation status. | +|<br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0**<br /><br /><br /> |<br />**API/CONT/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br />PUT /mn-name/ae\_sensor/cont\_temp?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "mni": 400,<br /> "lbl": ["indoor\_temperature"]<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2004<br /><br /> | +|<br /><br /><br />**Example with**<br />**No RCN or RCN=1**<br /><br /><br /> |<br />**API/CONT/UPD/001**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_sensor/cont\_temp HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Accept: application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "mni": 300,<br /> "lbl": ["indoor\_temp"]<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:285<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2004<br /><br />{<br /> "m2m:cnt": {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180406T125807",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180406T130109",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 300,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T1258071405855183193603\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 1,<br /> "ty": 3<br /> }<br />}<br /> | + + + + +#### 6.2.5.4 API-CONT-DEL + +|<br />**API Id** |API/CONT/DEL/001<br />API/CONT/DEL/001\_RCN0 | +|-|-| +|**API Name** |container DELETE with no resultContent (or resultContent set to 0) | +|**Target Resource** |Requested <container> resource | +|<br /><br />**Description** |The interface is used to send a <container> DELETE request to a target <container> resource located under the CSE, and the hosting CSE will respond with only response status code to indicate the DELETE operation status. | +|<br /><br /><br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0**<br /><br /><br /> |<br />**API/CONT/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /> | +|<br /><br /><br />**Example with**<br />**No RCN or RCN=1**<br /><br /><br /> |<br />**API/CONT/DEL/001**<br />**API/CONT/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />X-M2M-Origin:/mnID<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br />{<br /> "m2m:cnt": {<br /> "cbs": 0,<br /> "cni": 0,<br /> "ct": "20180406T125807",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180406T130330",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 400,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T1258071405855183193603\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 2,<br /> "ty": 3<br /> }<br />}<br /> | + + + + +### 6.2.6 Resource Type _contentInstance_ + +#### 6.2.6.0 Introduction +The_<_ contentInstance_>_ resource represents a data instance stored in the _<_ container_>_ resource. Taking a temperature sensor device as an example, the temperature sensor is designed to collect temperature data of environment and in this case, the real temperature data is modelled as a <contentInstance> resource. In details, we assume both the temperature sensor is registered with <AE> resource and a <container> resource is created under the <AE> to store temperature instances, under this consumption, whenever the temperature data is uploaded into a central server, the temperature data has to be denoted as a value of _content_ attribute of <contentInstance> resource. + +The _<_ contentInstance_>_ resource cannot be modified once created, and is able to be deleted explicitly by an AE or may be deleted by the platform based on specific policies. If the platform has policies to manage the _<_ contentInstance_>_ resource, these policies are represented by attributes _axByteSize_ , _maxNrOfInstances_ and/or _maxInstanceAge_ attributes in their parent <container> resource. + +The _<_ contentInstance_>_ resource inheritances the same access control policies of its parent _<container>_ resource, and does not have its own _accessControlPolicyIDs_ attribute. + + +#### 6.2.6.1 API-CI-CRE + +|<br /><br />**API Id** |API/CI/CRE/001<br />API/CI/CRE/001\_RCN0<br />API/CI/CRE/001\_RCN1<br />API/CI/CRE/001\_RCN2<br />API/CI/CRE/001\_RCN3 | +|-|-| +|**API Name** |contentInstance CREATE with or without resultContent parameter | +|**Target Resource** |The <container> resource as a parent resource of being created <contentInstance> resource | +|<br /><br /><br />**Description** |The interface is used to send a _<_ contentInstance_>_ CREATE request to the target <container> resource located under the CSE, and the hosting CSE will create a new <contentInstance> under the requested <container>, and send back a response containing only the response status code to indicate the CREATE operation status. | +|<br /><br /><br /><br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=4<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**rcn** **=0** |<br />**API/CI/CRE/001\_RCN/0**<br /><br />**HTTP** **Request** **:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=4<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />{<br /> "m2m:cin": {<br /> "con": "20"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:0<br />Content-Location:/mnID/cin20180406T1358251405855267120642\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /> | +|<br /><br /><br />**Example with**<br />**No RCN**<br />**or RCN=1** |<br />**API/CI/CRE/001**<br />**API/CI/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=4<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cin": {<br /> "con": "20"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:258<br />Content-Location:/mnID/cin20180406T1355091405855351047683\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br />**Example with**<br />**RCN=2** |<br />**API/CI/CRE/001\_RCN2**<br /><br />**HTTP** **Request** **:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=4<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cin": {<br /> "con": "20"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:91<br />Content-Location:/mnID/cin20180406T1400131405855099266562\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_sensor/cont\_temp/cin20180406T1400131405855099266561\_cse01"<br />}<br /> | +|<br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/CI/CRE/001\_RCN3**<br /><br />**HTTP** **Request** **:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />Content-Type: application/json;ty=4<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cin": {<br /> "con": "20"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Length:356<br />Content-Location:/mnID/cin20180406T1402131405855770682883\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T140213",<br /> "et": "99991231T235959",<br /> "lt": "20180406T140213",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1402131405855770682883\_cse01",<br /> "rn": "cin20180406T1402131405855770682882\_cse01",<br /> "st": 4,<br /> "ty": 4<br /> },<br /> "uri": "mn-name/ae\_sensor/cont\_temp/cin20180406T1402131405855770682882\_cse01"<br /> }<br />}<br /> | + + + + +#### 6.2.6.2 API-CI-RET + +|<br />**API Id** |API/CI/RET/001\_LA<br />API/CI/RET/001\_OL<br />API/CI/RET/001\_CI | +|-|-| +|**API Name** |Latest, Oldest or specific contentInstance RETRIEVE | +|**Target Resource** |<latest>, <oldest> virtual resources or individual <contentInstance> resource of the requested <container> resource | +|**Description** |The interface is used to send a <contentInstance> RETRIEVE request to the CSE, and the hosting CSE will send back a response containing the result. | +|<br /><br /><br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**latest** |<br />**API/CI/RET/001\_LA** <br /><br />**HTTP** **Request** **:**<br /><br />GET /mn-name/ae\_sensor/cont\_temp/la HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:258<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T140213",<br /> "et": "99991231T235959",<br /> "lt": "20180406T140213",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1402131405855770682883\_cse01",<br /> "rn": "cin20180406T1402131405855770682882\_cse01",<br /> "st": 4,<br /> "ty": 4<br /> }<br />} | +|<br /><br /><br />**Example with**<br />**oldest** |<br /> **API/CI/RET/001\_OL**<br /><br />**HTTP** **Request** **:**<br /><br />GET /mn-name/ae\_sensor/cont\_temp/ol HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:258<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br />**Example with**<br />**CI name** |<br />**API/CI/RET/001\_CI**<br /><br />**HTTP** **Request** **:**<br /><br />GET /mn-name/ae\_sensor/cont\_temp/cin20180406T1400131405855099266561\_cse01 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:258<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T140013",<br /> "et": "99991231T235959",<br /> "lt": "20180406T140013",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1400131405855099266562\_cse01",<br /> "rn": "cin20180406T1400131405855099266561\_cse01",<br /> "st": 3,<br /> "ty": 4<br /> }<br />}<br /> | + + + + +#### 6.2.6.3 API-CI-DEL + +|<br /><br /><br /><br /><br />**API Id** |API/CI/DEL/001\_LA<br />API/CI/DEL/001\_LA\_RCN0<br /><br />API/CI/DEL/001\_OL<br />API/CI/DEL/001\_OL\_RCN0<br /><br />API/CI/DEL/001\_CI<br />API/CI/DEL/001\_CI\_RCN0 | +|-|-| +|**API Name** |Latest, Oldest or specific contentInstance DELETE | +|**Target Resource** |<latest>, <oldest> virtual resources or individual <contentInstance> resource of the requested <container> resource | +|<br /><br />**Description** |The interface is used to send a <container> DELETE request to the CSE, and the hosting CSE will delete the <contentInstance>, and send back a response containing the response status code to indicate the status of the DELETE operation. | +|<br /><br /><br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Accept : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**latest**<br /><br />**(No RCN or RCN=1)** |<br />**API/CI/DEL/001\_LA**<br /><br />**HTTP** **Request** **:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/la HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:258<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T140213",<br /> "et": "99991231T235959",<br /> "lt": "20180406T140213",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1402131405855770682883\_cse01",<br /> "rn": "cin20180406T1402131405855770682882\_cse01",<br /> "st": 4,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br />**Example with**<br />**latest and RCN=0** |<br />**API/CI/DEL/001\_LA\_RCN0**<br /><br />**HTTP** **Request** **:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/la?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /> | +|<br /><br /><br />**Example with**<br />**oldest**<br /><br />**(No RCN or RCN=1)** |<br />**API/CI/DEL/001\_OL**<br /><br />**HTTP** **Request** **:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/ol HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:258<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br />**Example with**<br />**oldest and RCN=0** |<br />**API/CI/DEL/001\_OL\_RCN0**<br /><br />**HTTP** **Request** **:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/ol?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /><br /> | +|<br /><br /><br />**Example with**<br />**CI name**<br /><br />**(No RCN or RCN=1)** |<br />**API/CI/DEL/001\_CI**<br /><br />**HTTP** **Request** **:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/cin20180406T1400131405855099266561\_cse01 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />X-M2M-Origin:/mnID<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T143434",<br /> "et": "99991231T235959",<br /> "lt": "20180406T143434",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1434341405855518901762\_cse01",<br /> "rn": "cin20180406T1434341405855518901761\_cse01",<br /> "st": 9,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br />**Example with**<br />**CI name and RCN=0** |<br />**API/CI/DEL/001\_CI\_RCN0** <br /><br />**HTTP** **Request** **:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/cin20180406T1400131405855099266561\_cse01?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T0846311405855351047680\_cse01<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /> | + + + + +### 6.2.7 Resource Type _semanticDescriptor_ + +#### 6.2.7.0 Introduction +The <semanticDescriptor> resource is used to store a semantic description pertaining to a resource and potentially sub-resources. Such a description may be provided according to ontologies. The semantic information is used by the semantic functionalities of the oneM2M system and is also available to applications or CSEs. + + +#### 6.2.7.1 API-SMD-CRE + +|<br /><br />**API** **Id** |API/SMD/CRE/001<br />API/SMD/CRE/001\_RCN0<br />API/SMD/CRE/001\_RCN1<br />API/SMD/CRE/001\_RCN3 | +|-|-| +|**API** **Name** |semanticDescriptor CREATE with or without resultContent parameter | +|**Target** **Resource** |The <container> resource as a parent resource of being created <semanticDescriptor> resource | +|<br /><br />**Description** |The interface is used to send a _<_ semanticDescriptor_>_ CREATE request to the target <container> resource located under the CSE, and the hosting CSE will create a new <semanticDescriptor> under the requested <container>, and send back a response according to the configured resultContent_._ | +|<br />**Resource** **Structure** **before** **Sending** **Request** | | +|<br /><br /><br /><br /><br />**Call** **Flow** | | +|<br /><br /><br /><br />**HTTP** **Header** **Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=24<br />X-M2M-RVI : Release Version Indicator | +|**RDF** **content** |The RDF content will be encode Base64 in the HTTP payload<br /><br /><?xml version="1.0"?><br /><rdf:RDF xmlns="http://www.onem2m.org/ontology/houses\_temperature\_example#"<br /> xml:base="http://www.onem2m.org/ontology/houses\_temperature\_example"<br /> xmlns:temperature\_example="http://www.onem2m.org/ontology/temperature\_example#"<br /> xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br /> xmlns:owl="http://www.w3.org/2002/07/owl#"<br /> xmlns:xml="http://www.w3.org/XML/1998/namespace"<br /> xmlns:xsd="http://www.w3.org/2001/XMLSchema#"<br /> xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"><br /><br /> <owl:NamedIndividual rdf:about="http://www.onem2m.org/ontology/houses\_temperature\_example#House1"><br /> <rdf:type rdf:resource="http://www.onem2m.org/ontology/temperature\_example#House"/><br /> <temperature\_example:hasIndoorTemperature rdf:resource="http://www.onem2m.org/ontology/houses\_temperature\_example#IndoorTempProperty1"/><br /> </owl:NamedIndividual><br /><br /> <owl:NamedIndividual rdf:about="http://www.onem2m.org/ontology/houses\_temperature\_example#IndoorTempProperty1"><br /> <rdf:type rdf:resource="http://www.onem2m.org/ontology/temperature\_example#TemperatureProperty"/><br /> <temperature\_example:hasDatatype>xsd:int</temperature\_example:hasDatatype><br /> <temperature\_example:hasUnit>Fahrenheit</temperature\_example:hasUnit><br /> <temperature\_example:valueIsStoredIn>http://mnprovider.com:9011/mn-name/ae\_sensor/cont\_temp/la</temperature\_example:valueIsStoredIn><br /> </owl:NamedIndividual><br /></rdf:RDF> | +|<br /><br /><br />**Example** **with** <br />**RCN=0** |<br />**API/SMD/CRE/001\_RCN0**<br /><br />**HTTP** **Request:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />Content-Type: application/json;ty=24<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:smd" : {<br /> "dcrp" : "application/rdf+xml:1",<br /> "rn" : "semantic\_describer",<br /> "dsr": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0hvdXNlMSI+DQogICAgICAgIDxyZGY6dHlwZSByZGY6cmVzb3VyY2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS90ZW1wZXJhdHVyZV9leGFtcGxlI0hvdXNlIi8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0luZG9vclRlbXBlcmF0dXJlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+DQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSI+DQogICAgICAgIDxyZGY6dHlwZSByZGY6cmVzb3VyY2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS90ZW1wZXJhdHVyZV9leGFtcGxlI1RlbXBlcmF0dXJlUHJvcGVydHkiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+eHNkOmludDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNEYXRhdHlwZT4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzVW5pdD5GYWhyZW5oZWl0PC90ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOnZhbHVlSXNTdG9yZWRJbj5odHRwOi8vbW5wcm92aWRlci5jb206OTAxMS9tbi1uYW1lL2FlX3NlbnNvci9jb250X3RlbXAvbGE8L3RlbXBlcmF0dXJlX2V4YW1wbGU6dmFsdWVJc1N0b3JlZEluPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCjwvcmRmOlJERj4="<br /> }<br />}<br /><br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:0<br />Content-Location:/mnID/CAE0120180404T0830181405122857960960\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /> | +|**Example** **with** **no** **RCN** **or**<br />**RCN=1** <br /> |<br />**API/SMD/CRE/001**<br />**API/SMD/CRE/001\_RCN1**<br /><br />**HTTP** **Request:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />Content-Type: application/json;ty=24<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:smd" : {<br /> "dcrp" : "application/rdf+xml:1",<br /> "rn" : "semantic\_describer",<br /> "dsr": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0hvdXNlMSI+DQogICAgICAgIDxyZGY6dHlwZSByZGY6cmVzb3VyY2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS90ZW1wZXJhdHVyZV9leGFtcGxlI0hvdXNlIi8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0luZG9vclRlbXBlcmF0dXJlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+DQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSI+DQogICAgICAgIDxyZGY6dHlwZSByZGY6cmVzb3VyY2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS90ZW1wZXJhdHVyZV9leGFtcGxlI1RlbXBlcmF0dXJlUHJvcGVydHkiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+eHNkOmludDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNEYXRhdHlwZT4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzVW5pdD5GYWhyZW5oZWl0PC90ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOnZhbHVlSXNTdG9yZWRJbj5odHRwOi8vbW5wcm92aWRlci5jb206OTAxMS9tbi1uYW1lL2FlX3NlbnNvci9jb250X3RlbXAvbGE8L3RlbXBlcmF0dXJlX2V4YW1wbGU6dmFsdWVJc1N0b3JlZEluPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCjwvcmRmOlJERj4="<br /> }<br />}<br /><br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:3480<br />Content-Location:/mnID/smd20180413T1256011400030218380800\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:smd": {<br /> "ct": "20180413T125601",<br /> "dcrp": "application/rdf+xml:1",<br /> "dsp": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo3NTc5L3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFNlbnNvcjEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVNlbnNvciIvPg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNUZW1wZXJhdHVyZU1lYXN1cmluZ0Z1bmN0aW9uIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI1RlbXBGdW5jdGlvbjEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+DQoNCiAgICA8b3dsOk5hbWVkSW5kaXZpZHVhbCByZGY6YWJvdXQ9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wRnVuY3Rpb24xIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjVGVtcGVyYXR1cmVNZWFzdXJpbmdGdW5jdGlvbiIvPg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTptZWFzdXJlc1RlbXBlcmF0dXJlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+ICAgDQo8L3JkZjpSREY+DQo=",<br /> "et": "99991231T235959",<br /> "lt": "20180413T125601",<br /> "or": "http://www.onem2m.org/ontology/temperature\_example",<br /> "pi": "cnt20180413T0847561400030050526720\_cse01",<br /> "ri": "smd20180413T1256011400030218380800\_cse01",<br /> "rn": "semantic\_describer",<br /> "ty": 24<br /> }<br />}<br /> | +|**Example** **with** **RCN=3** <br /> |<br />**API/SMD/CRE/001**<br />**API/SMD/CRE/001\_RCN3**<br /><br />**HTTP** **Request** **:**<br /><br />POST /mn-name/ae\_sensor/cont\_temp?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />Content-Type: application/json;ty=24<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:smd" : {<br /> "dcrp" : "application/rdf+xml:1",<br /> "rn" : "semantic\_describer",<br /> "dsr": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0hvdXNlMSI+DQogICAgICAgIDxyZGY6dHlwZSByZGY6cmVzb3VyY2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS90ZW1wZXJhdHVyZV9leGFtcGxlI0hvdXNlIi8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0luZG9vclRlbXBlcmF0dXJlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+DQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSI+DQogICAgICAgIDxyZGY6dHlwZSByZGY6cmVzb3VyY2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS90ZW1wZXJhdHVyZV9leGFtcGxlI1RlbXBlcmF0dXJlUHJvcGVydHkiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+eHNkOmludDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNEYXRhdHlwZT4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzVW5pdD5GYWhyZW5oZWl0PC90ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOnZhbHVlSXNTdG9yZWRJbj5odHRwOi8vbW5wcm92aWRlci5jb206OTAxMS9tbi1uYW1lL2FlX3NlbnNvci9jb250X3RlbXAvbGE8L3RlbXBlcmF0dXJlX2V4YW1wbGU6dmFsdWVJc1N0b3JlZEluPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCjwvcmRmOlJERj4="<br /> }<br />}<br /><br /><br />**HTTP** **Response:**<br /><br />201 Created<br />Content-Length:3480<br />Content-Location:/mnID/smd20180413T1256011400030218380800\_cse01<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:smd": {<br /> "ct": "20180413T125601",<br /> "dcrp": "application/rdf+xml:1",<br /> "dsp": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo3NTc5L3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFNlbnNvcjEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVNlbnNvciIvPg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNUZW1wZXJhdHVyZU1lYXN1cmluZ0Z1bmN0aW9uIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI1RlbXBGdW5jdGlvbjEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+DQoNCiAgICA8b3dsOk5hbWVkSW5kaXZpZHVhbCByZGY6YWJvdXQ9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wRnVuY3Rpb24xIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjVGVtcGVyYXR1cmVNZWFzdXJpbmdGdW5jdGlvbiIvPg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTptZWFzdXJlc1RlbXBlcmF0dXJlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+ICAgDQo8L3JkZjpSREY+DQo=",<br /> "et": "99991231T235959",<br /> "lt": "20180413T125601",<br /> "or": "http://www.onem2m.org/ontology/temperature\_example",<br /> "pi": "cnt20180413T0847561400030050526720\_cse01",<br /> "ri": "smd20180413T1256011400030218380800\_cse01",<br /> "rn": "semantic\_describer",<br /> "ty": 24<br /> },<br /> "uri": "mn-name/ae\_sensor/cont\_temp/semantic\_describer"<br /> }<br />}<br /> | + + + + +#### 6.2.7.2 API-SMD-RET + +|**API Id** |API/SMD/RET/001\_RCN1 | +|-|-| +|**API Name** |SemanticDescriptor RETRIEVE with or without resultContent parameter | +|**Target Resource** |Requested <semanticDescriptor> resource | +|<br /><br />**Description** |The interface is used to send a <semanticDescriptor> RETRIEVE request attached with resultContent to the <container> resource located in the <CSEBase>. The hosting CSE will send back a response according to the configured resultContent_._ | +|<br /><br /><br /><br />**Resource Structure** **before** **Sending** **Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example** **with** <br />**RCN=1**<br />**or** **No RCN** |<br />**API/SMD/RET/001**<br />**API/SMD/RET/001\_RCN1**<br /><br />**HTTP** **Request** **:**<br /><br />GET /mn-name/ae\_sensor/cont\_temp/semantic\_describer HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0838301405122186544640\_cse01<br />Accept: application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP** **Response** **:**<br /><br />200 OK<br />Content-Length:3374<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2000<br /><br />{<br /> "m2m:smd": {<br /> "ct": "20180413T125601",<br /> "dcrp": "application/rdf+xml:1",<br /> "dsp": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo3NTc5L3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFNlbnNvcjEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVNlbnNvciIvPg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNUZW1wZXJhdHVyZU1lYXN1cmluZ0Z1bmN0aW9uIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI1RlbXBGdW5jdGlvbjEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+DQoNCiAgICA8b3dsOk5hbWVkSW5kaXZpZHVhbCByZGY6YWJvdXQ9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wRnVuY3Rpb24xIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjVGVtcGVyYXR1cmVNZWFzdXJpbmdGdW5jdGlvbiIvPg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTptZWFzdXJlc1RlbXBlcmF0dXJlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiLz4NCiAgICA8L293bDpOYW1lZEluZGl2aWR1YWw+ICAgDQo8L3JkZjpSREY+DQo=",<br /> "et": "99991231T235959",<br /> "lt": "20180413T125601",<br /> "or": "http://www.onem2m.org/ontology/temperature\_example",<br /> "pi": "cnt20180413T0847561400030050526720\_cse01",<br /> "ri": "smd20180413T1256011400030218380800\_cse01",<br /> "rn": "semantic\_describer",<br /> "ty": 24<br /> }<br />}<br /> | + + + + +#### 6.2.7.3 API-SMD-UPD + +|<br /><br />**API Id** |API/SMD/UPD/001<br />API/SMD/UPD/001\_RCN0<br />API/SMD/UPD/001\_RCN1 | +|-|-| +|**API Name** |semanticDescriptor UPDATE with or without resultContent set | +|**Target Resource** |The < semanticDescriptor > resource located under <container> resource | +|<br /><br />**Description** |The interface is used to send a _<_ semanticDescriptor_>_ UPDATE request to the target <container> resource located under the CSE, and the hosting CSE will create a new <semanticDescriptor> under the requested <container>, and send back a response according to the configured resultContent_._ | +|<br /><br /><br /><br />**Resource Structure** **before** **Sending** **Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example** **with** <br />**RCN=0**<br /><br /><br /> |<br /> **API/AE/UPD/001\_RCN0**<br /><br />**HTTP** **Request** **:**<br /><br />PUT /mn-name/ae\_sensor/cont\_temp/semantic\_describer?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:smd" : {<br /><br /> "dsp":<br />" PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo4MjgyL3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KPC9yZGY6UkRGPg==",<br /><br /> "or": "http://www.onem2m.org/ontology/temperature\_example2",<br /><br />}<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2004<br /> | +|<br /><br /><br />**Example with**<br />**RCN=1**<br />**or No RCN**<br /><br /><br /> |<br /> **API/AE/UPD/001**<br /> **API/AE/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_sensor/cont\_temp/semantic\_describer HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:smd" : {<br /><br /> "dsp":<br />" PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo4MjgyL3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KPC9yZGY6UkRGPg==",<br /><br /> "or": "http://www.onem2m.org/ontology/temperature\_example2",<br /><br />}<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:2405<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2004<br /><br />{<br /> "m2m:smd": {<br /> "ct": "20180413T125601",<br /> "dcrp": "application/rdf+xml:1",<br /> "dsp": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo4MjgyL3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KPC9yZGY6UkRGPg==",<br /> "et": "99991231T235959",<br /> "lt": "20180413T150302",<br /> "or": "http://www.onem2m.org/ontology/temperature\_example2",<br /> "pi": "cnt20180413T0847561400030050526720\_cse01",<br /> "ri": "smd20180413T1256011400030218380800\_cse01",<br /> "rn": "semantic\_describer",<br /> "ty": 24<br /> }<br />}<br /> | + + + + +#### 6.2.7.4 API-SMD-DEL + +|<br />**API Id** |API/SMD/DEL/001<br />API/SMD/DEL/001\_RCN0<br />API/SMD/DEL/001\_RCN1 | +|-|-| +|**API Name** |SMD DELETE | +|**Target Resource** |The <semanticDescriptor> resource located under the <container> resource | +|<br /><br />**Description** |The interface is used to send a <semanticDescriptor> DELETE request to the hosting CSE, and the hosting CSE will delete the <semanticDescriptor> and send back a response containing a response status code indicating the DELETE request status. | +|<br /><br /><br /><br />**Resource Structure** **before Sending Request** | | +|<br /><br /><br /><br /><br />**Call Flow** | | +|<br /><br /><br />**HTTP Header Information**<br /> |Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0**<br /> |<br />**API/AE/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/semantic\_describer?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:0<br />X-M2M-RI:1234<br />X-M2M-RSC:2002<br /> | +|<br /><br /><br />**Example** **with**<br />**RCN=1 or**<br />**no RCN**<br /> |<br />**API/SMD/DEL/001**<br />**API/SMD/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/cont\_temp/semantic\_describer HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830181405122857960960\_cse01<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Length:2299<br />Content-Type:application/json<br />X-M2M-RI:1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC:2002<br /><br />{<br /> "m2m:smd": {<br /> "ct": "20180413T125601",<br /> "dcrp": "application/rdf+xml:1",<br /> "dsp": "PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8cmRmOlJERiB4bWxucz0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlIyINCiAgICAgeG1sOmJhc2U9Imh0dHA6Ly93d3cub25lbTJtLm9yZy9vbnRvbG9neS9ob3VzZXNfdGVtcGVyYXR1cmVfZXhhbXBsZSINCiAgICAgeG1sbnM6dGVtcGVyYXR1cmVfZXhhbXBsZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjIg0KICAgICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiDQogICAgIHhtbG5zOm93bD0iaHR0cDovL3d3dy53My5vcmcvMjAwMi8wNy9vd2wjIg0KICAgICB4bWxuczp4bWw9Imh0dHA6Ly93d3cudzMub3JnL1hNTC8xOTk4L25hbWVzcGFjZSINCiAgICAgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSMiDQogICAgIHhtbG5zOnJkZnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDEvcmRmLXNjaGVtYSMiPg0KDQogICAgPG93bDpOYW1lZEluZGl2aWR1YWwgcmRmOmFib3V0PSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UxIj4NCiAgICAgICAgPHJkZjp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L3RlbXBlcmF0dXJlX2V4YW1wbGUjSG91c2UiLz4NCiAgICAgICAgPHRlbXBlcmF0dXJlX2V4YW1wbGU6aGFzSW5kb29yVGVtcGVyYXR1cmUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvaG91c2VzX3RlbXBlcmF0dXJlX2V4YW1wbGUjSW5kb29yVGVtcFByb3BlcnR5MSIvPg0KICAgIDwvb3dsOk5hbWVkSW5kaXZpZHVhbD4NCg0KICAgIDxvd2w6TmFtZWRJbmRpdmlkdWFsIHJkZjphYm91dD0iaHR0cDovL3d3dy5vbmVtMm0ub3JnL29udG9sb2d5L2hvdXNlc190ZW1wZXJhdHVyZV9leGFtcGxlI0luZG9vclRlbXBQcm9wZXJ0eTEiPg0KICAgICAgICA8cmRmOnR5cGUgcmRmOnJlc291cmNlPSJodHRwOi8vd3d3Lm9uZW0ybS5vcmcvb250b2xvZ3kvdGVtcGVyYXR1cmVfZXhhbXBsZSNUZW1wZXJhdHVyZVByb3BlcnR5Ii8+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc0RhdGF0eXBlPnhzZDppbnQ8L3RlbXBlcmF0dXJlX2V4YW1wbGU6aGFzRGF0YXR5cGU+DQogICAgICAgIDx0ZW1wZXJhdHVyZV9leGFtcGxlOmhhc1VuaXQ+RmFocmVuaGVpdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTpoYXNVbml0Pg0KICAgICAgICA8dGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+aHR0cDovL2luLnByb3ZpZGVyLmNvbTo4MjgyL3NlcnZlci90ZW1wc2Vuc29yYWUxL3RlbXBlcmF0dXJlL2xhdGVzdDwvdGVtcGVyYXR1cmVfZXhhbXBsZTp2YWx1ZUlzU3RvcmVkSW4+DQogICAgPC9vd2w6TmFtZWRJbmRpdmlkdWFsPg0KPC9yZGY6UkRGPg==",<br /> "et": "99991231T235959",<br /> "lt": "20180413T151556",<br /> "or": "http://www.onem2m.org/ontology/temperature\_example2",<br /> "pi": "cnt20180413T0847561400030050526720\_cse01",<br /> "ri": "smd20180413T1256011400030218380800\_cse01",<br /> "rn": "semantic\_describer",<br /> "ty": 24<br /> }<br />}<br /> | + + +### 6.2.8 Resource discovery + +#### 6.2.8.0 Introduction +The discovery is one of the common service functions which searches information about application and services. An originator can receive the matching information according to the filter criteria, by sending the discovery request. The format of a query string has both target resource address and filter criteria information; e.g. /mn-name?fu=2&ty=2. + +The filterUsage can be set to retrieve any preferred format of the discovery response. The filterUsage value is specified in table 6.2.8.0-1. When filterUsage sets to 1, the response of the discovery is represented with a format of the URI list and all URIs of discovered resources is listed in the response. And when filterUsage sets to 2, the response contains attributes of the resources that matched with presented filter criteria conditions. + + +**Table 6.2.8.0-1: Interpretation of filterUsage**<a name="table_6.2.8.0-1"></a> + +|Interpretation |Value |Note | +|-|-|-| +|Discovery Criteria |1 | | +|Conditional Retrieval |2 |Default | + + + +Filter criteria are set to search the resources with specific conditions. For example, AE resources can be found by setting the resourceType to 2. Some Filter criteria conditions are listed in table 6.2.8.0-2, which is extracted from the table 8.1.2-2 of oneM2M TS-0001 <a href="#_ref_i.2">[i.2]</a>. + + +**Table 6.2.8.0-2: Filter criteria conditions**<a name="table_6.2.8.0-2"></a> + +|Condition tag |Short Name |Multiplicity |Description | +|-|-|-|-| +|**Matching Conditions** |**Matching Conditions** |**Matching Conditions** |**Matching Conditions** | +|createdBefore |crb |0..1 |The creationTime attribute of the matched resource is chronologically before the specified value. | +|createdAfter |cra |0..1 |The creationTime attribute of the matched resource is chronologically after the specified value. | +|modifiedSince |ms |0..1 |The lastModifiedTime attribute of the matched resource is chronologically after the specified value. | +|unmodifiedSince |us |0..1 |The lastModifiedTime attribute of the matched resource is chronologically before the specified value. | +|stateTagSmaller |sts |0..1 |The stateTag attribute of the matched resource is smaller than the specified value. | +|stateTagBigger |stb |0..1 |The stateTag attribute of the matched resource is bigger than the specified value. | +|expireBefore |exb |0..1 |The expirationTime attribute of the matched resource is chronologically before the specified value. | +|expireAfter |exa |0..1 |The expirationTime attribute of the matched resource is chronologically after the specified value. | +|labels |lbl |0..1 |The labels attribute of the matched resource matches the specified value. | +|resourceType |ty |0..n |The resourceType attribute of the matched resource is the same as the specified value. It also allows differentiating between normal and announced resources. | +|sizeAbove |sza |0..1 |The contentSize attribute of the <contentInstance> matched resource is equal to or greater than the specified value. | +|sizeBelow |szb |0..1 |The contentSize attribute of the <contentInstance> matched resource is smaller than the specified value. | +|Filter Handling Conditions |Filter Handling Conditions |Filter Handling Conditions |Filter Handling Conditions | +|limit |lim |0..1 |The maximum number of resources to be included in the filtering result. This may be modified by the Hosting CSE. When it is modified, then the new value shall be smaller than the suggested value by the Originator. | +|level |lvl |0..1 |The maximum level of resource tree that the Hosting CSE shall perform the operation starting from the target resource (i.e. **To** parameter). This shall only be applied for Retrieve operation. The level of the target resource itself is zero and the level of the direct children of the target is one. | + + + +As an initial condition to use discovery function, CSEBase need to have resources. Table 6.2.8.0-3 has detailed information of resources which will be used in this clause. + + +**Table 6.2.8.0-3: Resource Specifications**<a name="table_6.2.8.0-3"></a> + +|Resource Name |Resource attributes in JSON format | +|-|-| +|CSEBase |{<br /> "m2m:cb": {<br /> "pi": null,<br /> "ty": 5,<br /> "ct": "20180302T070445",<br /> "ri": "CSE9486743758493047362",<br /> "rn": "mn-name",<br /> "lt": "20180302T070445",<br /> "lbl": [<br /> "mn-name"<br /> ],<br /> "cst": 1,<br /> "csi": "/mn-name",<br /> "srt": [<br /> 1,<br /> 2,<br /> 3,<br /> 4,<br /> 5,<br /> 9,<br /> 10,<br /> 13,<br /> 14,<br /> 16,<br /> 17,<br /> 23<br /> ],<br /> "poa": [<br /> "http://192.168.0.10:8282"<br /> ]<br /> }<br />} | +|ae\_actuator |{<br /> "m2m:ae": {<br /> "pi": "mnID",<br /> "ty": 2,<br /> "ct": "20180404T083025",<br /> "ri": "CAE0120180404T0830251405122594272800\_cse01",<br /> "rn": "ae\_actuator",<br /> "lbl": [<br /> "actuator",<br /> "light"<br /> ],<br /> "lt": "20180406T083320",<br /> "et": "20221231T235959",<br /> "api": "A01.com.company.Light",<br /> "aei": "CAE0120180404T0830251405122594272800\_cse01",<br /> "rr": false<br /> }<br />} | +|cnt\_light1 |{<br /> "m2m:cnt": {<br /> "pi": "CAE0120180404T0830251405122594272800\_cse01",<br /> "ty": 3,<br /> "ct": "20180406T085318",<br /> "ri": "cnt20180406T0853181405855183193600\_cse01",<br /> "rn": "cont\_light1",<br /> "lt": "20180406T085318",<br /> "et": "20201231T235959",<br /> "lbl": [<br /> "indoor\_light"<br /> "actuator"<br /> "room1"<br /> ],<br /> "st": 5,<br /> "cr": "S20170717074825768bp2l",<br /> "mni": 10000,<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "cni": 5,<br /> "cbs": 10<br /> }<br />} | +|cnt\_light2 |{<br /> "m2m:cnt": {<br /> "pi": "CAE0120180404T0830251405122594272800\_cse01",<br /> "ty": 3,<br /> "ct": "20180405T085318",<br /> "ri": "cnt20180406T0853181405855183193600\_cse01",<br /> "rn": "cont\_light2",<br /> "lt": "20180406T085318",<br /> "et": "20201231T235959",<br /> "lbl": [<br /> "outdoor\_light"<br /> "actuator"<br /> ],<br /> "st": 4,<br /> "cr": "S20170717074825768bp2l",<br /> "mni": 10000,<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "cni": 10,<br /> "cbs": 20<br /> }<br />} | +|ae\_sensor |{<br /> "m2m:ae": {<br /> "pi": "mnID",<br /> "ty": 2,<br /> "ct": "20180404T083320",<br /> "ri": "CAE0120180404T0833201405122522252800\_cse01",<br /> "rn": "ae\_sensor",<br /> "lbl": [<br /> "sensor",<br /> "temperature"<br /> ],<br /> "lt": "20180404T083320",<br /> "et": "20221231T235959",<br /> "api": "A01.com.company.Temperature",<br /> "aei": "CAE0120180404T0833201405122522252800\_cse01",<br /> "rr": false<br /> }<br />} | +|cnt\_temp1 |{<br /> "m2m:cnt": {<br /> "pi": "CAE0120180404T0833201405122522252800\_cse01",<br /> "ty": 3,<br /> "ct": "20180406T085712",<br /> "ri": "cnt20180406T0857121405855183193600\_cse01",<br /> "rn": "cont\_temp1",<br /> "lt": "20180406T085712",<br /> "et": "20201231T235959",<br /> "lbl": [<br /> "indoor\_temperature"<br /> "sensor"<br /> "room2"<br /> ],<br /> "st": 8,<br /> "cr": "S20170717074825768bp2l",<br /> "mni": 10000,<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "cni": 10,<br /> "cbs": 20<br /> }<br />} | +|cnt\_temp2 |{<br /> "m2m:cnt": {<br /> "pi": "CAE0120180404T0833201405122522252800\_cse01",<br /> "ty": 3,<br /> "ct": "20180406T085820",<br /> "ri": "cnt20180406T0858201405855563993600\_cse01",<br /> "rn": "cont\_temp2",<br /> "lt": "20180406T085820",<br /> "et": "20211231T235959",<br /> "lbl": [<br /> "outdoor\_temperature"<br /> "sensor"<br /> ],<br /> "st": 9,<br /> "cr": "S20170717074825768bp2l",<br /> "mni": 10000,<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "cni": 15,<br /> "cbs": 30<br /> }<br />} | + + + + +#### 6.2.8.1 API-DIS-TY + +|<br />**API Id** |API/DIS\_TY2<br />API/DIS\_TY3 | +|-|-| +|**API Name** |Discovery with resourceType **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **specific resource type** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668ea00></mark><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668ea00></mark><br /> | +|<br /><br />**HTTP Header Information**<br /><br /> |Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**ty=2** |<br />**API/DIS** **\_** **TY2**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&ty=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830251405122594272800\_cse01<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_sensor"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**ty=3** |<br />**API/DIS** **\_** **TY3**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&ty=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180404T0830251405122594272800\_cse01<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril": [<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_actuator/cnt\_light2",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br /> ]<br />}<br /> | + + + + +#### 6.2.8.2 API-DIS-LBL + +|<br />**API Id** |API/DIS\_LBL\_ACTUATOR<br />API/DIS\_LBL\_SENSOR | +|-|-| +|**API Name** |Discovery with label **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **specific** **_label_** **value** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668e380></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066368c0></mark><br /> | +|<br /><br /><br />**HTTP Header Information**<br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**lbl** **=actuator** |<br />**API/DIS** **\_** **LBL\_ACTUATOR**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&lbl=actuator HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_actuator/cnt\_light2"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**lbl** **=sensor** |<br />**API/DIS** **\_** **LBL\_SENSOR**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&lbl=sensor HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_sensor",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | + + + + +#### 6.2.8.3 API-DIS-LVL + +|<br />**API Id** |API/DIS\_LVL1<br />API/DIS\_LVL2 | +|-|-| +|**API Name** |Discovery with level **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **child** **_level_** **value** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106699b40></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668ca80></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**lvl** **=1** |<br />**API/DIS** **\_** **LVL1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&lvl=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_sensor"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**lvl** **=2** |<br />**API/DIS** **\_** **LVL2**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&lvl=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_actuator/cnt\_light2",<br /> "/mn-name/ae\_sensor",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | + + + + +#### 6.2.8.4 API-DIS-CRB, API-DIS-CRA + +|<br />**API Id** |API/DIS\_CRB<br />API/DIS\_CRA | +|-|-| +|**API Name** |Discovery with createdBefore and createdAfter **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **period of created time** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106698bc0></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066981c0></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**crb** |<br />**API/DIS** **\_** **CRB**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&crb=20180405T235959 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_actuator/cnt\_light2",<br /> "/mn-name/ae\_sensor"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**cra** |<br />**API/DIS** **\_** **CRA**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&cra=20180405T235959 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | + + + + +#### 6.2.8.5 API-DIS-STB, API-DIS-STS + +|<br />**API Id** |API/DIS\_STB<br />API/DIS\_STS | +|-|-| +|**API Name** |Discovery with stateTagBigger and stateTagSmaller **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **_stateTag_** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10669bd40></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10669b740></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**stb** |<br />**API/DIS** **\_** **STB**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&stb=6 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**sts** |<br />**API/DIS** **\_** **STS**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&sts=6 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_actuator/cnt\_light2"<br />}<br /> | + + + + +#### 6.2.8.6 API-DIS-SZB, API-DIS-SZA + +|<br />**API Id** |API/DIS\_SZB<br />API/DIS\_SZA | +|-|-| +|**API Name** |Discovery with sizeBelow and sizeAbove **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **size of container** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bef40></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668e640></mark> | +|<br /><br /><br />**HTTP Header Information**<br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**szb** |<br />**API/DIS** **\_** **SZB**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&szb=15 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator/cnt\_light1"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**sza** |<br />**API/DIS** **\_** **SZA**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&sza=15 HTTP/1.1<br />Accept: application/json<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator/cnt\_light2",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | + + + + +#### 6.2.8.7 API-DIS-US, API-DIS-MS + +|<br />**API Id** |API/DIS\_US<br />API/DIS\_MS | +|-|-| +|**API Name** |Discovery with unmodifiedSince and modifiedSince **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **time of modification** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10668cd00></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10669e8c0></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**us** |<br />**API/DIS** **\_** **US**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&us=20180405T235959 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_sensor"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**ms** |<br />**API/DIS** **\_** **MS** <br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&ms=20180405T235959 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_actuator/cnt\_light2",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | + + + + +#### 6.2.8.8 API-DIS-EXB, API-DIS-EXA + +|<br />**API Id** |API/DIS\_EXB<br />API/DIS\_EXA | +|-|-| +|**API Name** |Discovery with expiredBefore and expiredAfter **_Filter Criteria_** condition | +|**Target Resource** |CSEBase (can be any oneM2M resource primitives) | +|<br />**Description** |The interface is used to discovery resources that match with the **period of** **_expirationTime_** . If found, the Hosting CSE sends back a response with matched resources. | +|<br /><br /><br /><br />**Resource Structure** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066be180></mark><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x10669bf00></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**exb** |<br />**API/DIS** **\_** **EXB**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&exb=20211231T235959 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator/cnt\_light1",<br /> "/mn-name/ae\_actuator/cnt\_light2",<br /> "/mn-name/ae\_sensor/cnt\_temp1",<br /> "/mn-name/ae\_sensor/cnt\_temp2"<br />}<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**exa** |<br />**API/DIS** **\_** **EXA**<br /><br />**HTTP Request:**<br /><br />GET /mn-name?fu=1&exa=20211231T235959 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:uril":<br /> "/mn-name/ae\_actuator",<br /> "/mn-name/ae\_sensor",<br />}<br /> | + + + + +### 6.2.9 Resource Type _subscription_ + +#### 6.2.9.0 Introduction +The <subscription> resource contains subscription information for its subscribed-to resource. The <subscription> resource created under the subscribed-to resource. Each <subscription> may include notification policies that specify when, and how notification are sent. + + +#### 6.2.9.1 API-SUB-CRE + +|<br /><br />**API Id** |API/SUB/CRE/001<br />API/SUB/CRE/001\_RCN0<br />API/SUB/CRE/001\_RCN1<br />API/SUB/CRE/001\_RCN2<br />API/SUB/CRE/001\_RCN3 | +|-|-| +|**API Name** |<subscription> resource CREATE | +|**Target Resource** |<AE> resource of the requested <subscription> resource | +|<br />**Description** |The interface is used to send a <subscription> CREATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <subscription> resource and sends back a response. | +|<br /><br />**Resource Structure**<br />**before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bc2c0></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bcb00></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=23<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/SUB/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2,<br /> "nu": ["https://192.168.0.10:8282/notification/handler"],<br /> "rn": "ae\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/SUB/CRE/001**<br />**API/SUB/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuatorHTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2,<br /> "nu": [<br /> https://192.168.0.10:8282/notification/handler<br /> ],<br /> "rn": "ae\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:sub": {<br /> "rn": "ae\_sub",<br /> "ty": 23,<br /> "ri": "SUB583675048372974938",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20180302T070445",<br /> "lt": "20180302T070445",<br /> "nu": [<br /> "https://192.168.0.10:8282/notification/handler"<br /> ],<br /> "cnm": 2,<br /> "mnm": 50,<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2<br /> }<br />} | +|<br /><br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br />**API/SUB/CRE/001\_RCN2**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2,<br /> "nu": [<br /> https://192.168.0.10:8282/notification/handler<br /> ],<br /> "rn": "ae\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_actuator/ae\_sub"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/SUB/CRE/001\_RCN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2,<br /> "nu": [<br /> https://192.168.0.10:8282/notification/handler<br /> ],<br /> "rn": "ae\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:sub": {<br /> "rn": "ae\_sub",<br /> "ty": 23,<br /> "ri": "SUB583675048372974938",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20180302T070445",<br /> "lt": "20180302T070445",<br /> "nu": [<br /> "https://192.168.0.10:8282/notification/handler"<br /> ],<br /> "cnm": 2,<br /> "mnm": 50,<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2<br /> }<br />}<br /> | + + + + +#### 6.2.9.2 API-SUB-RET + +|**API Id** |API/SUB/RET/001<br />API/SUB/RET/001\_RCN1 | +|-|-| +|**API Name** |<subscription> resource RETRIEVE with resultContent set to 1 | +|**Target Resource** |Requested <subscription> resource | +|**Description** |The interface is used to send a <subscription> RETRIEVE request attached with resultContent set to 1 to the <subscription> resource hosting CSE and sends back a response. | +|<br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bcb40></mark><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bd840></mark><br /> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/SUB/RET/001**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_actuator/ae\_sub HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:sub": {<br /> "rn": "ae\_sub",<br /> "ty": 23,<br /> "ri": "SUB583675048372974938",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20180302T070445",<br /> "lt": "20180302T070445",<br /> "nu": [<br /> "https://192.168.0.10:8282/notification/handler"<br /> ],<br /> "cnm": 2,<br /> "mnm": 50,<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 2<br /> }<br />}<br /> | + + + + +#### 6.2.9.3 API-SUB-UPD + +|<br />**API Id** |API/SUB/UPD/001<br />API/SUB/UPD/001\_RCN0<br />API/SUB/UPD/001\_RCN1 | +|-|-| +|**API Name** |<subscription> resource UPDATE with resultContent parameter | +|**Target Resource** |Requested <subscription> resource | +|<br />**Description** |The interface is used to send a <subscription> UPDATE request attached with resultContent to the Registrar CSE, and the Registrar CSE updates a <subscription> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure** **before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bf6c0></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066be1c0></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/SUB/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_actuator/ae\_sub?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "nct": 3<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/SUB/UPD/001**<br />**API/SUB/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_actuator/ae\_sub HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "nct": 3<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:sub": {<br /> "rn": "ae\_sub",<br /> "ty": 23,<br /> "ri": "SUB583675048372974938",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20180302T070445",<br /> "lt": "20180302T070445",<br /> "nu": [<br /> "https://192.168.0.10:8282/notification/handler"<br /> ],<br /> "cnm": 2,<br /> "mnm": 50,<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 3<br /> }<br />}<br /> | + + + + +#### 6.2.9.4 API-SUB-DEL + +|<br />**API Id** |API/SUB/DEL/001<br />API/SUB/DEL/001\_RCN0<br />API/SUB/DEL/001\_RCN1 | +|-|-| +|**API Name** |<subscription> resource DELETE with resultContent parameter | +|**Target Resource** |Requested <subscription> resource | +|<br />**Description** |The interface is used to send a <subscription> DELETE request attached with resultContent to the Registrar CSE, and the Registrar CSE deletes a <subscription> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106688e80></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066a0300></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=0** |<br /> **API/SUB/DEL/001**<br /> **API/SUB/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_actuator/ae\_sub?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1** |<br />**API/SUB/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_actuator/ae\_sub?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/ae\_sub<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /><br />{<br /> "m2m:sub": {<br /> "rn": "ae\_sub",<br /> "ty": 23,<br /> "ri": "SUB583675048372974938",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20180302T070445",<br /> "lt": "20180302T070445",<br /> "nu": [<br /> "https://192.168.0.10:8282/notification/handler"<br /> ],<br /> "cnm": 2,<br /> "mnm": 50,<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nct": 3<br /> }<br />}<br /> | + + + + +### 6.2.10 Resource Type _group_ + +#### 6.2.10.0 Introduction +The <group> resource represents a group of resources of the same or mixed types. It basically designed to handle several of resources at the same time. When a request sent through the <group> resource, it distributes the request to each member of the <group> resources, which are indicated by the memberIDs attribute. + + +#### 6.2.10.1 API-GRP-CRE + +|<br /><br />**API Id** |API/GRP/CRE/001<br />API/GRP/CRE/001\_RCN0<br />API/GRP/CRE/001\_RCN1<br />API/GRP/CRE/001\_RCN2<br />API/GRP/CRE/001\_RCN3 | +|-|-| +|**API Name** |<group> resource CREATE | +|**Target Resource** |<AE> resource of the requested <group> resource | +|<br />**Description** |The interface is used to send a <group> CREATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <group> resource and sends back a response. | +|<br /><br />**Resource Structure**<br />**before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106688040></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066a20c0></mark><br /> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json;ty=9<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/GRP/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=9<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:grp": {<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ],<br /> "mt": 3,<br /> "mnm": 50,<br /> "rn": "group\_lamp"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br />**_Example_** **with**<br />**no RCN or**<br />**RCN=1** |<br />**API/GRP/CRE/001**<br />**API/GRP/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=9<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:grp": {<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ],<br /> "mt": 3,<br /> "mnm": 50,<br /> "rn": "group\_lamp"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:grp": {<br /> "rn": "group\_lamp",<br /> "ty": 9,<br /> "ri": "GRP792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "mt": 3,<br /> "cnm": 2,<br /> "mnm": 50,<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ]<br /> "mtv": true,<br /> "csy": 1<br /> }<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br />**API/GRP/CRE/001\_RCN2** <br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=9<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:grp": {<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ],<br /> "mt": 3,<br /> "mnm": 50,<br /> "rn": "group\_lamp"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_actuator/group\_lamp"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/GRP/CRE/001\_RCN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=9<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:grp": {<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ],<br /> "mt": 3,<br /> "mnm": 50,<br /> "rn": "group\_lamp"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:grp": {<br /> "rn": "group\_lamp",<br /> "ty": 9,<br /> "ri": "GRP792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "mt": 3,<br /> "cnm": 2,<br /> "mnm": 50,<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ]<br /> "mtv": true,<br /> "csy": 1<br /> }<br /> "uri": "mn-name/ae\_actuator/group\_lamp"<br /> }<br />}<br /> | + + + + +#### 6.2.10.2 API-GRP-RET + +|**API Id** |API/GRP/RET/001<br />API/GRP/RET/001\_RCN1 | +|-|-| +|**API Name** |<group> resource RETRIEVE with resultContent set to 1 | +|**Target Resource** |Requested <group> resource | +|**Description** |The interface is used to send a <group> RETRIEVE request attached with resultContent set to 1 to the <group> resource hosting CSE and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106688e80></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106689dc0></mark><br /> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/GRP/RET/001**<br />**API/GRP/RET/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_actuator/group\_lamp?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br />{<br /> "m2m:grp": {<br /> "rn": "group\_lamp",<br /> "ty": 9,<br /> "ri": "GRP792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "mt": 3,<br /> "cnm": 2,<br /> "mnm": 50,<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ]<br /> "mtv": true,<br /> "csy": 1<br /> }<br />}<br /> | + + + + +#### 6.2.10.3 API-GRP-UPD + +|<br />**API Id** |API/GRP/UPD/001<br />API/GRP/UPD/001\_RCN0<br />API/GRP/UPD/001\_RCN1 | +|-|-| +|**API Name** |<group> resource UPDATE with resultContent parameter | +|**Target Resource** |Requested <group> resource | +|<br />**Description** |The interface is used to send a <group> UPDATE request attached with resultContent to the Registrar CSE, and the Registrar CSE updates a <group> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105048b40></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bd980></mark><br /> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/GRP/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_actuator/group\_lamp?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:grp": {<br /> "mnm": 100<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/GRP/UPD/001**<br />**API/GRP/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_actuator/group\_lamp?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:grp": {<br /> "mnm": 100<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:grp": {<br /> "rn": "group\_lamp",<br /> "ty": 9,<br /> "ri": "GRP792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "mt": 3,<br /> "cnm": 2,<br /> "mnm": 100,<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ]<br /> "mtv": true,<br /> "csy": 1<br /> }<br />}<br /> | + + + + +#### 6.2.10.4 API-GRP-DEL + +|<br />**API Id** |API/GRP/DEL/001<br />API/GRP/DEL/001\_RCN0<br />API/GRP/DEL/001\_RCN1 | +|-|-| +|**API Name** |<group> resource DELETE with resultContent parameter | +|**Target Resource** |Requested <group> resource | +|<br />**Description** |The interface is used to send a <group> DELETE request attached with resultContent to the Registrar CSE, and the Registrar CSE deletes a <group> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bfc00></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066bfc00></mark><br /> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/GRP/D** **EL** **/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_actuator/group\_lamp?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/GRP/D** **EL** **/001**<br />**API/GRP/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_actuator/group\_lamp?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /><br />{<br /> "m2m:grp": {<br /> "rn": "group\_lamp",<br /> "ty": 9,<br /> "ri": "GRP792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "mt": 3,<br /> "cnm": 2,<br /> "mnm": 100,<br /> "mid": [<br /> "mn-name/ae\_actuator/lamp\_container1",<br /> "mn-name/ae\_actuator/lamp\_container2"<br /> ]<br /> "mtv": true,<br /> "csy": 1<br /> }<br />}<br /> | + + + + +#### 6.2.10.5 API-GRP-FOPT + +|**API Id** |API/GRP/FOPT/001 | +|-|-| +|**API Name** |<group> resource | +|**Target Resource** |Fopt virtual resource of the <group> resource | +|<br />**Description** |The interface is used to send a contentInstance CREATE request to the FanoutOutPoint Virtual resource of a group.<br />As a result, the contentInstances will be created on each container that belonging to this group. | +|<br /><br />**Resource Structure**<br />**before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066beb40></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105048400></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json;ty=4<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/GRP/**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_actuator/ group\_lamp/fopt HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=4<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cin": {<br /> "con": "20"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 Created<br />Content-Location: mn-name/ae\_actuator/group\_lamp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br /><br />{<br /> "m2m:agr": {<br /> "rsp": [<br /> {<br /> "fr": "/ID-CSE-01/mn-name/ae\_actuator/lamp\_container1",<br /> "pc": {<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20200609T163651,675786",<br /> "et": "99991231T235959",<br /> "lt": "20200609T163651,675786",<br /> "pi": "cnt20200609T1632571403417286346243\_cse01",<br /> "ri": "cin20200609T1636511403417286346245\_cse01",<br /> "rn": "fopt20200609T1636511403417286346244\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br /> },<br /> "rqi": "1234",<br /> "rsc": 2001<br /> },<br /> {<br /> "fr": "/ID-CSE-01/mn-name/ae\_actuator/lamp\_container2",<br /> "pc": {<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20200609T163651,680775",<br /> "et": "99991231T235959",<br /> "lt": "20200609T163651,680775",<br /> "pi": "cnt20200609T1609261403417286346240\_cse01",<br /> "ri": "cin20200609T1636511403417286346246\_cse01",<br /> "rn": "fopt20200609T1636511403417286346244\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br /> },<br /> "rqi": "1234",<br /> "rsc": 2001<br /> }<br /> ]<br /> }<br />}<br /><br /><br /> | + + + + +### 6.2.11 Resource Type _timeSeries_ + +#### 6.2.11.0 Introduction +The <timeSeries> resource represents a container for Time Series Data Instance. It is used to share information with other entities and potentially to track, detect and report the missing data in Time Series. + + +#### 6.2.11.1 API-TS-CRE + +|<br /><br />**API Id** |API/TS/CRE/001<br />API/TS/CRE/001\_/RCN0<br />API/TS/CRE/001\_/RCN1<br />API/TS/CRE/001\_/RCN2<br />API/TS/CRE/001\_/RCN3 | +|-|-| +|**API Name** |<timeSeries> resource CREATE with resultContent parameter | +|**Target Resource** |<AE> resource of the requested <timeSeries> resource | +|<br />**Description** |The interface is used to send a <timeSeries> CREATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <timeSeries> resource and sends back a response. | +|<br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105064480></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106689840></mark> | +|<br /><br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=29<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/TS/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=29<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ts": {<br /> "rn": timeSeries\_cont,<br /> "pei": 1,<br /> "mdd": true,<br /> "mdt": 5<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/TS/CRE/001**<br />**API/TS/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=29<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ts": {<br /> "rn": timeSeries\_cont,<br /> "pei": 1,<br /> "mdd": true,<br /> "mdt": 1<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:ts": {<br /> "rn": "timeSeries\_cont",<br /> "ty": 29,<br /> "ri": "TS792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "et": "2021212T170445",<br /> "st": 0,<br /> "mni": 3153600000,<br /> "mbs": 3153600000,<br /> "mia": 31536000,<br /> "cni": 0,<br /> "cbs": 0,<br /> "pei": 1,<br /> "mdd": "true",<br /> "mdn": 1000,<br /> "mdc": 0,<br /> "mdt": 1<br /> }<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br />**API/TS/CRE/001\_RCN2**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=29<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ts": {<br /> "rn": timeSeries\_cont,<br /> "pei": 1,<br /> "mdd": true,<br /> "mdt": 1<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_sensor/timeSeries\_cont"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/TS/CRE/001** **\_R** **CN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=29<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ts": {<br /> "rn": timeSeries\_cont,<br /> "pei": 1,<br /> "mdd": true,<br /> "mdt": 1<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:ts": {<br /> "rn": "timeSeries\_cont",<br /> "ty": 29,<br /> "ri": "TS792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "et": "2021212T170445",<br /> "st": 0,<br /> "mni": 3153600000,<br /> "mbs": 3153600000,<br /> "mia": 31536000,<br /> "cni": 0,<br /> "cbs": 0,<br /> "pei": 1,<br /> "mdd": "ture",<br /> "mdn": 1000,<br /> "mdc": 0,<br /> "mdt": 1<br /> }<br /> "m2m:uri": "mn-name/ae\_sensor/timeSeries\_cont"<br /> }<br />}<br /> | + + + + +#### 6.2.11.2 API-TS-RET + +|**API Id** |API/TS/CRE/001<br />API/TS/CRE/001\_RCN1 | +|-|-| +|**API Name** |<timeSeries> resource RETRIEVE with resultContent parameter | +|**Target Resource** |Requested <timeSeries> resource | +|**Description** |The interface is used to send a <timeSeries> RETRIEVE request attached with resultContent set to 1 to the Registrar CSE and sends back a response. | +|<br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105035d40></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105048380></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/TS/RET/001**<br />**API/TS/RET/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_sensor?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:ts": {<br /> "rn": "timeSeries\_cont",<br /> "ty": 29,<br /> "ri": "TS792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "et": "2021212T170445",<br /> "st": 0,<br /> "mni": 3153600000,<br /> "mbs": 3153600000,<br /> "mia": 31536000,<br /> "cni": 0,<br /> "cbs": 0,<br /> "pei": 1,<br /> "mdd": "ture",<br /> "mdn": 1000,<br /> "mdc": 0,<br /> "mdt": 1<br /> }<br />}<br /> | + + + + +#### 6.2.11.3 API-TS-UPD + +|<br />**API Id** |API/TS/UPD/001<br />API/TS/UPD/001\_RCN0<br />API/TS/UPD/001\_RCN1 | +|-|-| +|**API Name** |<timeSeries> resource UPDATE with resultContent parameter | +|**Target Resource** |Requested <timeSeries> resource | +|<br />**Description** |The interface is used to send a <timeSeries> UPDATE request attached with resultContent to the Registrar CSE, and the Registrar CSE updates a <timeSeries> resource and sends back a response. | +|<br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105036ec0></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106689980></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/TS/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_sensor/timeSeries\_cont?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ts": {<br /> "mdt": 2<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/TS/UPD/001**<br />**API/TS/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/ae\_sensor/timeSeries\_cont?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:ts": {<br /> "mdt": 2<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:ts": {<br /> "rn": "timeSeries\_cont",<br /> "ty": 29,<br /> "ri": "TS792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "et": "2021212T170445",<br /> "st": 0,<br /> "mni": 3153600000,<br /> "mbs": 3153600000,<br /> "mia": 31536000,<br /> "cni": 0,<br /> "cbs": 0,<br /> "pei": 1,<br /> "mdd": "ture",<br /> "mdn": 1000,<br /> "mdc": 0,<br /> "mdt": 2<br /> }<br />}<br /> | + + + + +#### 6.2.11.4 API-TS-DEL + +|<br />**API Id** |API/TS/DEL/001<br />API/TS/DEL/001\_RCN0<br />API/TS/DEL/001\_RCN1 | +|-|-| +|**API Name** |<timeSeries> resource DELETE with resultContent parameter | +|**Target Resource** |Requested <timeSeries> resource | +|<br />**Description** |The interface is used to send a <timeSeries> DELETE request attached with resultContent to the Registrar CSE, and the Registrar CSE updates a <timeSeries> resource and sends back a response. | +|<br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1050374c0></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105035e40></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=0** |<br />**API/TS/DEL/001**<br />**API/TS/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/timeSeries\_cont?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1** |<br />**API/TS/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/timeSeries\_cont?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /><br />{<br /> "m2m:ts": {<br /> "rn": "timeSeries\_cont",<br /> "ty": 29,<br /> "ri": "TS792482146823489621",<br /> "pi": "CAE5630283216026458665",<br /> "ct": "20171212T170445",<br /> "lt": "20171212T170445",<br /> "et": "2021212T170445",<br /> "st": 0,<br /> "mni": 3153600000,<br /> "mbs": 3153600000,<br /> "mia": 31536000,<br /> "cni": 0,<br /> "cbs": 0,<br /> "pei": 1,<br /> "mdd": "ture",h<br /> "mdn": 1000,<br /> "mdc": 0,<br /> "mdt": 2<br /> }<br />}<br /> | + + + + +### 6.2.12 Resource Type _timeSeriesInstance_ + +#### 6.2.12.0 Introduction +The <timeSeriesInstance> resource represents a data instance in the <timeSeries> resource. + + +#### 6.2.12.1 API-TSI-CRE + +|<br /><br />**API Id** |API/TSI/CRE/001<br />API/TSI/CRE/001\_RCN0<br />API/TSI/CRE/001\_RCN1<br />API/TSI/CRE/001\_RCN2<br />API/TSI/CRE/001\_RCN3 | +|-|-| +|**API Name** |<timeSeriesInstance> resource CREATE with resultContent parameter | +|**Target Resource** |<timeSeries> resource of the requested <timeSeriesInstance> resource | +|<br />**Description** |The interface is used to send a <timeSeriesInstance> CREATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <timeSeriesInstance> resource and sends back a response. | +|<br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105035c80></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105035c80></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=30<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/TSI/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor/timeSeries\_cont?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=30<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:tsi": {<br /> "dgt": "20180307T123456",<br /> "con": "DATA\_TACK"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/TSI/CRE/001**<br />**API/TSI/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor/timeSeries\_cont HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=30<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "dgt": "20180307T123456",<br /> "con": "DATA\_TACK"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont<br />Content-Type: application/json<br />X-M2M-Origin: CAE5630283216026458665<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "ty": 30,<br /> "pi": "CAE5630283216026458665",<br /> "ri": "TSI840674869203617594",<br /> "ct": "20180307T012211",<br /> "lt": "20180307T012211",<br /> "et": "20210307T012211",<br /> "dgt": "20180307T123456"<br /> "con": "DATA\_TACK",<br /> "cs": 9,<br /> "st": 7<br /> }<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br />**API/TSI/CRE/001\_RCN2**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor/timeSeries\_cont?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=30<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "dgt": "20180307T123456",<br /> "con": "DATA\_TACK"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:uri": "mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/TSI/CRE/001\_RCN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/ae\_sensor/timeSeries\_cont?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=30<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "dgt": "20180307T123456",<br /> "con": "DATA\_TACK"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "ty": 30,<br /> "pi": "CAE5630283216026458665",<br /> "ri": "TSI840674869203617594",<br /> "ct": "20180307T012211",<br /> "lt": "20180307T012211",<br /> "et": "2n0210307T012211",<br /> "dgt": "20180307T123456"<br /> "con": "DATA\_TACK",<br /> "cs": 9,<br /> "st": 7<br /> }<br /> "m2m:uri": "mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1"<br /> }<br />}<br /> | + + + + +#### 6.2.12.2 API-TSI-RET + +|**API Id** |API/TSI/RET/001<br />API/TSI/RET/001\_RCN1 | +|-|-| +|**API Name** |<timeSeriesInstance> resource RETRIEVE with resultContent parameter | +|**Target Resource** |Requested <timeSeriesInstance> resource | +|<br />**Description** |The interface is used to send a <timeSeriesInstance> RETRIEVE request attached with resultContent set to 1 to the Registrar CSE and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b1180></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105048a00></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/TSI/RET/001**<br />**API/TSI/RET/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "ty": 30,<br /> "pi": "CAE5630283216026458665",<br /> "ri": "TSI840674869203617594",<br /> "ct": "20180307T012211",<br /> "lt": "20180307T012211",<br /> "et": "2n0210307T012211",<br /> "dgt": "20180307T123456"<br /> "con": "DATA\_TACK",<br /> "cs": 9,<br /> "st": 7<br /> }<br />}<br /> | + + + + +#### 6.2.12.3 API-TSI-UPD + +|**API Id** |API/TSI/UPD | +|-|-| +|**API Name** |<timeSeriesInstance> resource UPDATE | +|**Target Resource** |Requested <timeSeriesInstance> resource | +|**Description** |Update operation is not allowed in <timeSeriesInstance> resource | + + + + +#### 6.2.12.4 API-TSI-DEL + +|<br />**API Id** |API/TSI/DEL/001<br />API/TSI/DEL/001\_RCN0<br />API/TSI/DEL/001\_RCN1 | +|-|-| +|**API Name** |<timeSeriesInstance> resource DELETE with resultContent parameter | +|**Target Resource** |Requested <timeSeriesInstance> resource | +|<br />**Description** |The interface is used to send a <timeSeriesInstance> DELETE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <timeSeriesInstance> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b1a80></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x105036300></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=0** |<br />**API/TSI/DEL/001**<br />**API/TSI/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1** |<br />**API/TSI/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/ae\_sensor/timeSeries\_cont/tsi\_value1<br />Content-Type: application/json<br />X-M2M-Origin: CAE5630283216026458665<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /><br />{<br /> "m2m:tsi": {<br /> "rn": "tsi\_value1",<br /> "ty": 30,<br /> "pi": "CAE5630283216026458665",<br /> "ri": "TSI840674869203617594",<br /> "ct": "20180307T012211",<br /> "lt": "20180307T012211",<br /> "et": "2n0210307T012211",<br /> "dgt": "20180307T123456"<br /> "con": "DATA\_TACK",<br /> "cs": 9,<br /> "st": 7<br /> }<br />}<br /> | + + + + +### 6.2.13 Resource Type _accessControlPolicy_ + +#### 6.2.13.0 Introduction +The <accessControlPolicy> resource is defined to contain a set of access control rules defining for which entities have which privilege to perform operations such as CREATE, RETRIEVE, UPDATE and DELETE. The allowed operations are defined by an attribute accessControlOperations that associated with each <accessControlPolicy> resource. + + +#### 6.2.13.1 API-ACP-CRE + +|<br /><br />**API Id** |API/ACP/CRE/001<br />API/ACP/CRE/001\_RCN0<br />API/ACP/CRE/001\_RCN1<br />API/ACP/CRE/001\_RCN2<br />API/ACP/CRE/001\_RCN3 | +|-|-| +|**API Name** |<accessControlPolicy> resource CREATE with resultContent parameter | +|**Target Resource** |<CSEBase> of the requested <accessControlPolicy> resource | +|<br />**Description** |The interface is used to send a <accessControlPolicy> CREATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <accessControlPolicy> resource, and sends back a response. | +|<br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b1900></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b0d00></mark> | +|<br /><br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=1<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/ACP/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=1<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:acp" : {<br /> "rn": "accessControlPolicy",<br /> "et" : "20201221T064952",<br /> "pv" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "CAE1", "CAE2" ]<br /> }<br /> ]<br /> },<br /> "pvs" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "all" ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/ACP/CRE/001**<br />**API/ACP/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=1<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:acp" : {<br /> "rn": "accessControlPolicy",<br /> "et" : "20201221T064952",<br /> "pv" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "CAE1", "CAE2" ]<br /> }<br /> ]<br /> },<br /> "pvs" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "all" ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:acp": {<br /> "rn": "accessControlPolicy",<br /> "ty": 1,<br /> "ri": "ACP503720698362418574",<br /> "pi": "mnID",<br /> "ct": "20180308T115922",<br /> "lt": "20180308T115922",<br /> "et": "20201221T064952",<br /> "pv": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE1",<br /> "CAE2"<br /> ]<br /> }<br /> ]<br /> },<br /> "pvs": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "all"<br /> ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br />**API/ACP/CRE/001\_RCN2**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=1<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:acp" : {<br /> "rn": "accessControlPolicy",<br /> "et" : "20201221T064952",<br /> "pv" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "CAE1", "CAE2" ]<br /> }<br /> ]<br /> },<br /> "pvs" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "all" ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:uri": "mn-name/accessControlPolicy"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/ACP/CRE/001\_RCN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=1<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:acp" : {<br /> "rn": "accessControlPolicy",<br /> "et" : "20201221T064952",<br /> "pv" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "CAE1", "CAE2" ]<br /> }<br /> ]<br /> },<br /> "pvs" : {<br /> "acr" : [<br /> {<br /> "acco" : [],<br /> "acop" : 63,<br /> "acor" : [ "all" ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:rce": {<br /> "m2m:acp": {<br /> "rn": "accessControlPolicy",<br /> "ty": 1,<br /> "ri": "ACP503720698362418574",<br /> "pi": "mnID",<br /> "ct": "20180308T115922",<br /> "lt": "20180308T115922",<br /> "et": "20201221T064952",<br /> "pv": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE1",<br /> "CAE2"<br /> ]<br /> }<br /> ]<br /> },<br /> "pvs": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "all"<br /> ]<br /> }<br /> ]<br /> }<br /> "m2m:uri": "mn-name/accessControlPolicy"<br /> }<br /> }<br />}<br /> | + + + + +#### 6.2.12.2 API-ACP-RET + +|**API Id** |API/ACP/RET/001<br />API/ACP/RET/001\_RCN1 | +|-|-| +|**API Name** |<accessControlPolicy> resource RETRIEVE with resultContent parameter | +|**Target Resource** |<CSEBase> of the requested <accessControlPolicy> resource | +|<br />**Description** |The interface is used to send a <accessControlPolicy> RETRIEVE request attached with resultContent set to 1 to the Registrar CSE and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b1400></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b31c0></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/ACP/RET/001**<br />**API/ACP/RET/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/accessControlPolicy?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:acp": {<br /> "rn": "accessControlPolicy",<br /> "ty": 1,<br /> "ri": "ACP503720698362418574",<br /> "pi": "mnID",<br /> "ct": "20180308T115922",<br /> "lt": "20180308T115922",<br /> "et": "20201221T064952",<br /> "pv": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE1",<br /> "CAE2"<br /> ]<br /> }<br /> ]<br /> },<br /> "pvs": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "all"<br /> ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /> | + + + + +#### 6.2.12.3 API-ACP-UPD + +|<br />**API Id** |API/ACP/UPD/001<br />API/ACP/UPD/001\_RCN0<br />API/ACP/UPD/001\_RCN1 | +|-|-| +|**API Name** |<accessControlPolicy> resource UPDATE with resultContent parameter | +|**Target Resource** |<accessControlPolicy> resource | +|<br />**Description** |The interface is used to send a <accessControlPolicy> UPDATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <accessControlPolicy> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b1400></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b2540></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/ACP/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/accessControlPolicy?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:acp" : {<br /> "pv" : {<br /> "acr" : [<br /> {<br /> "acor" : [ "CAE\_A", "CAE\_B" ]<br /> }<br /> ]<br /> },<br /> "pvs" : {<br /> "acr" : [<br /> {<br /> "acor" : [ "CAE\_C", "CAE\_D" ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/ACP/UPD/001**<br />**API/ACP/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/accessControlPolicy?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:acp" : {<br /> "pv" : {<br /> "acr" : [<br /> {<br /> "acor" : [ "CAE\_A", "CAE\_B" ]<br /> }<br /> ]<br /> },<br /> "pvs" : {<br /> "acr" : [<br /> {<br /> "acor" : [ "CAE\_C", "CAE\_D" ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:acp": {<br /> "rn": "accessControlPolicy",<br /> "ty": 1,<br /> "ri": "ACP503720698362418574",<br /> "pi": "mnID",<br /> "ct": "20180308T115922",<br /> "lt": "20180308T115922",<br /> "et": "20201221T064952",<br /> "pv": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE\_A",<br /> "CAE\_B"<br /> ]<br /> }<br /> ]<br /> },<br /> "pvs": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE\_C",<br /> "CAE\_D"<br /> ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /> | + + + + +#### 6.2.12.4 API-ACP-DEL + +|<br />**API Id** |API/ACP/DEL/001<br />API/ACP/DEL/001\_RCN0<br />API/ACP/DEL/001\_RCN1 | +|-|-| +|**API Name** |<accessControlPolicy> resource DELETE with resultContent parameter | +|**Target Resource** |<accessControlPolicy> resource | +|<br />**Description** |The interface is used to send a <accessControlPolicy> DELETE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <accessControlPolicy> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cd440></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf9c0></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=0** |<br />**API/ACP/DEL/001**<br />**API/ACP/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/accessControlPolicy?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1** |<br />**API/ACP/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/accessControlPolicy?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/accessControlPolicy<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /><br />{<br /> "m2m:acp": {<br /> "rn": "accessControlPolicy",<br /> "ty": 1,<br /> "ri": "ACP503720698362418574",<br /> "pi": "mnID",<br /> "ct": "20180308T115922",<br /> "lt": "20180308T115922",<br /> "et": "20201221T064952",<br /> "pv": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE\_A",<br /> "CAE\_B"<br /> ]<br /> }<br /> ]<br /> },<br /> "pvs": {<br /> "acr": [<br /> {<br /> "acco": [],<br /> "acop": 63,<br /> "acor": [<br /> "CAE\_C",<br /> "CAE\_D"<br /> ]<br /> }<br /> ]<br /> }<br /> }<br />}<br /> | + + + + +### 6.2.14 Resource Type _flexContainer_ + +#### 6.2.14.0 Introduction +The <flexContainer> resource type is a customizable container for data instances. While <contentInstance> save the data in content attribute, <flexContainer> resource type directly contains the data in the attribute. Since it can have any attribute name, it may be a solution for saving custom data which is defined by the developer or manufacturer. + +The CRUD examples in this clause are written based on the parking lot implementation. As custom attributes, availableSpotNumber, totalSpotNumber are made to save data for the parking lot. + + +#### 6.2.14.1 API-FLX-CRE + +|<br /><br />**API Id** |API/FLX/CRE/001<br />API/FLX/CRE/001\_RCN0<br />API/FLX/CRE/001\_RCN1<br />API/FLX/CRE/001\_RCN2<br />API/FLX/CRE/001\_RCN3 | +|-|-| +|**API Name** |<flexContainer> resource CREATE with resultContent parameter | +|**Target Resource** |<CSEBase> of the requested <flexContainer> resource | +|<br />**Description** |The interface is used to send a <flexContainer> CREATE request attached with resultContent to the Registrar CSE, and the Registrar CSE creates a <flexContainer> resource, and sends back a response. | +|<br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf500></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf2c0></mark><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=28<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/FLX/CRE/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=28<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "rn": "yt\_lot\_1",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "3",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/FLX/CRE/001**<br />**API/FLX/CRE/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=28<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "rn": "yt\_lot\_1",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "3",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /><br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "pi": "CAE5630283216026458665",<br /> "ri": "FLX37696264720673421",<br /> "ty": 28,<br /> "ct": "20181019T045127",<br /> "st": 15878,<br /> "rn": "yt\_lot\_1",<br /> "lt": "20181207T002422",<br /> "et": "20211019T045127",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "3",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=2**<br /> |<br />**API/FLX/CRE/001\_RCN2**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=2 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=28<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "rn": "yt\_lot\_1",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "3",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /><br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:uri": "mn-name/yt\_lot\_1"<br />}<br /> | +|<br /><br /><br /><br />**Example with**<br />**RCN=3** |<br />**API/FLX/CRE/001\_RCN3**<br /><br />**HTTP Request:**<br /><br />POST /mn-name?rcn=3 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=28<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "rn": "yt\_lot\_1",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "3",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /><br /><br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /><br />{<br /> "m2m:rce":{<br /> "m2m:sc\_offLot":{<br /> "pi":"CAE5630283216026458665",<br /> "ri":"FLX37696264720673421",<br /> "ty":28,<br /> "ct":"20181019T045127",<br /> "st":15878,<br /> "rn":"yt\_lot\_1",<br /> "lt":"20181207T002422",<br /> "et":"20211019T045127",<br /> "lbl":[<br /> "sc"<br /> ],<br /> "cnd":"http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type":"OffStreetParking",<br /> "category":"lot\_1",<br /> "geolocation":[<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name":"parkingLot\_1",<br /> "availableSpotNumber":"3",<br /> "totalSpotNumber":"110"<br /> }<br /> },<br /> "m2m:uri":"mn-name/yt\_lot\_1"<br />}<br /> | + + + + +#### 6.2.14.2 API-FLX-RET + +|**API Id** |API/FLX/RET/001<br />API/FLX/RET/001\_RCN1 | +|-|-| +|**API Name** |<flexContainer> resource RETRIEVE with resultContent parameter | +|**Target Resource** |<CSEBase> of the requested <flexContainer> resource | +|<br />**Description** |The interface is used to send a <flexContainer> RETRIEVE request attached with resultContent set to 1 to the Registrar CSE and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066ce980></mark><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b2780></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/FLX/RET/001**<br />**API/FLX/RET/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />GET /mn-name/yt\_lot\_1?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "pi": "CAE5630283216026458665",<br /> "ri": "FLX37696264720673421",<br /> "ty": 28,<br /> "ct": "20181019T045127",<br /> "st": 15878,<br /> "rn": "yt\_lot\_1",<br /> "lt": "20181207T002422",<br /> "et": "20211019T045127",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "3",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /> | + + + + +#### 6.2.14.3 API-FLX-UPD + +|<br />**API Id** |API/FLX/UPD/001<br />API/FLX/UPD/001\_RCN0<br />API/FLX/UPD/001\_RCN1 | +|-|-| +|**API Name** |<flexContainer> resource UPDATE with resultContent parameter | +|**Target Resource** |<flexContainer> resource | +|<br />**Description** |The interface is used to send a <flexContainer> UPDATE request attached with resultContent to the Registrar CSE, and the Registrar CSE updates a <flexContainer> resource and sends back a response. | +|<br />**Resource Structure before Sending Request**<br /><br /> |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b0e40></mark> | +|<br /><br /><br /><br /><br />**Call Flow** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b0e40></mark> | +|<br /><br />**HTTP Header Information**<br /><br /><br /> |<br />Header and Value pair information:<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**RCN=0** |<br />**API/FLX/UPD/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/yt\_lot\_1?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sc\_offLot" : {<br /> "availableSpotNumber": "40",<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=1** |<br />**API/FLX/UPD/001**<br />**API/FLX/UPD/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/yt\_lot\_1?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sc\_offLot" : {<br /> "availableSpotNumber": "40",<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "pi": "CAE5630283216026458665",<br /> "ri": "FLX37696264720673421",<br /> "ty": 28,<br /> "ct": "20181019T045127",<br /> "st": 15878,<br /> "rn": "yt\_lot\_1",<br /> "lt": "20181207T052435",<br /> "et": "20211019T045127",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "40",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /> | + + + + +#### 6.2.14.4 API-FLX-DEL + +|<br />**API Id** |API/FLX/DEL/001<br />API/FLX/DEL/001\_RCN0<br />API/FLX/DEL/001\_RCN1 | +|-|-| +|**API Name** |<flexContainer> resource DELETE with resultContent parameter | +|**Target Resource** |<flexContainer> resource | +|<br />**Description** |The interface is used to send a <flexContainer> DELETE request attached with resultContent to the Registrar CSE, and the Registrar CSE deletes a <flexContainer> resource and sends back a response. | +|<br /><br /><br /><br />**Resource Structure before Sending Request** |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf500></mark><br /><br /> | +|<br /><br /><br /><br /><br />**Call Flow** |<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066b0300></mark> | +|<br /><br />**HTTP Header Information**<br /><br /> |<br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br />**Example with**<br />**no RCN or**<br />**RCN=0** |<br />**API/FLX/DEL/001**<br />**API/FLX/DEL/001\_RCN0**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/yt\_lot\_1?rcn=0 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /> | +|<br /><br /><br /><br /><br /><br />**Example with**<br />**RCN=1** |<br />**API/FLX/DEL/001\_RCN1**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/yt\_lot\_1?rcn=1 HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Location: mn-name/yt\_lot\_1<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2002<br /><br />{<br /> "m2m:sc\_offLot": {<br /> "pi": "CAE5630283216026458665",<br /> "ri": "FLX37696264720673421",<br /> "ty": 28,<br /> "ct": "20181019T045127",<br /> "st": 15878,<br /> "rn": "yt\_lot\_1",<br /> "lt": "20181207T052435",<br /> "et": "20211019T045127",<br /> "lbl": [<br /> "sc"<br /> ],<br /> "cnd": "http://developers.iotocean.org/schema/offStreetParking.xsd",<br /> "type": "OffStreetParking",<br /> "category": "lot\_1",<br /> "geolocation": [<br /> 37.4114423,<br /> 127.1293735<br /> ],<br /> "name": "parkingLot\_1",<br /> "availableSpotNumber": "40",<br /> "totalSpotNumber": "110"<br /> }<br />}<br /> | + + + + +######### Annex A: Example of notification + +# A.1 Notification API + +## A.1.0 Introduction +The notify operation is used for notify any event. AE or CSE which has privilege to make a <subscription> resource as a child resource of the subscribed-to resource. The <subscription> resource includes notification policies that specify which, when, and how notifications are sent. + +In this clause, notification examples are provided for the understanding of notification procedure. Especially, examples have different notificationEnentType in the eventNotificationCriteria. The notificationEventType value is specified in table A.1.0-1 and set when notification is sent. + + +**Table A.1.0-1: Interpretation of notificationEventType**<a name="table_A.1.0-1"></a> + +|Value |Interpretation |Note | +|-|-|-| +|1 |Update\_of\_Resource |Default | +|2 |Delete\_of\_Resource | | +|3 |Create\_of\_Direct\_Child\_Resource | | +|4 |Delete\_of\_Direct\_Child\_Resource | | + + + + +## A.1.1 API-NOTI-NET1 + +|API Id |API/NOTI/NET1/STEP01<br />API/NOTI/NET1/STEP02<br />API/NOTI/NET1/STEP03 | +|-|-| +|API Name |Notification procedure when the <subscription> resource has notificationEventType set to 1(Hosting CSE sends notification when the subscribed-to resource has been updated) | +|Target Resource |Update Target: Requested <container> resource<br />Notification Target: originator | +|<br />Description |Figure below depicts the procedure for notification.<br /><br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d5200></mark><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />Initial condition: MN(Hosting CSE) has a <container> resource. The originator is AE1 in this clause, but can be CSE.<br /><br />Step 01: The originator sends a <subscription> resource CREATE request to the <container> resource on the Registrar CSE. In the request, notificationEventType set to 1 and notificationURI attribute set to originator. The Registrar CSE creates a <subscription> resource and sends back a response.<br />Step 02: An AE2 sends an UPDATE request to the <container> resource. The Registrar CSE updates a <container> resource and sends back a response.<br />Step 03: The Hosting CSE sends notification as soon as update succeed. The originator sends back an ACK message. | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Resource Structure** **before Sending Request**<br /><br /> <mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cc2c0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cdf40></mark>**Call Flow** | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json;ty=23<br />X-M2M-RVI : Release Version Indicator<br /><br /><br /><br /><br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Example**<br /><br />**API/NOTI/NET1/STEP01**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_1">[1]</a><br /> },<br /> "nu": ["AE1"],<br /> "rn": "cont\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/cont\_temp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Resource** **Structurebefore** **Sending Request**<br /><br /><br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |<mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf4c0></mark>**Call Flow**<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Example**<br /><br />**API/NOTI/NET1/STEP02**<br /><br />**HTTP Request:**<br /><br />PUT /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T08463114<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cnt": {<br /> "mni": "300"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:cnt": {<br /> "cbs": 10,<br /> "cni": 0,<br /> "ct": "20180406T125807",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180406T130109",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 300,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T1258071405855183193603\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 1,<br /> "ty": 3<br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Resource Structure** **before Sending Request**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cefc0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066ce800></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Example**<br /><br />**API/NOTI/NET1/STEP03**<br /><br />**HTTP Request:**<br /><br />POST HTTP/1.1<br />Accept: application/json<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: mn-name<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sgn": {<br /> "sur": " mn-name/cont\_temp/cont\_sub",<br /> "nev": {<br /> "net":1,<br /> "rep": {<br /> "m2m:cnt": {<br /> "cbs": 10,<br /> "cni": 0,<br /> "ct": "20180406T125807",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180406T130109",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 300,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T1258071405855183193603\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 1,<br /> "ty": 3<br /> }<br /> }<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /> | + + + + +## A.1.2 API-NOTI-NET2 + +|**API Id** |API/NOTI/NET2/STEP01<br />API/NOTI/NET2/STEP02<br />API/NOTI/NET2/STEP03 | +|-|-| +|**API Name** |Notification procedure when the <subscription> resource has notificationEventType set to 2(Hosting CSE sends notification when the subscribed to resource has been deleted) | +|**Target Resource** |Delete Target: Requested <container> resource<br />Notification Target: originator | +|<br />**Description** |Figure below depicts the procedure for notification.<br /><br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d7ac0></mark><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />Initial condition: MN(Hosting CSE) has a <container> resource. The originator is AE1 in this clause, but can be CSE.<br /><br />Step 01: The originator sends a <subscription> resource CREATE request to the <container> resource on the Registrar CSE. In the request, notificationEventType set to 2 and notificationURI attribute set to originator. The Registrar CSE creates a <subscription> resource and sends back a response.<br />Step 02: An AE2 sends a DELETE request to the <container> resource. The Registrar CSE deletes a <container> resource and sends back a response.<br />Step 03: The Hosting CSE sends notification as soon as delete succeed. The originator sends back an ACK message. | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Resource Structure** **before Sending Request**<br /><br /> <mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d4080></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d6540></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json;ty=23<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Example**<br /><br />**API/NOTI/NET2/STEP01**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_2">[2]</a><br /> },<br /> "nu": ["AE1"],<br /> "rn": "cont\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/cont\_temp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Resource Structure** **before Sending Request**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d5340></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d6100></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Example**<br /><br />**API/NOTI/NET2/STEP02**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T08463114<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:cnt": {<br /> "cbs": 10,<br /> "cni": 0,<br /> "ct": "20180406T125807",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180406T130109",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 300,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T1258071405855183193603\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 1,<br /> "ty": 3<br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Resource Structure** **before Sending Request** <mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d5340></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d52c0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of request originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Example**<br /><br />**API/NOTI/NET2/STEP03**<br /><br />**HTTP Request:**<br /><br />POST HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: mn-name<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sgn": {<br /> "sur": " mn-name/cont\_temp/cont\_sub",<br /> "nev": {<br /> "net":2,<br /> "rep": {<br /> "m2m:cnt": {<br /> "cbs": 10,<br /> "cni": 0,<br /> "ct": "20180406T125807",<br /> "et": "99991231T235959",<br /> "lbl": [<br /> "indoor\_temp"<br /> ],<br /> "lt": "20180406T130109",<br /> "mbs": 60000000,<br /> "mia": 1600,<br /> "mni": 300,<br /> "pi": "CAE0120180406T0846311405855351047680\_cse01",<br /> "ri": "cnt20180406T1258071405855183193603\_cse01",<br /> "rn": "cont\_temp",<br /> "st": 1,<br /> "ty": 3<br /> }<br /> }<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /> | + + + + +## A.1.3 API-NOTI-NET3 + +|**API Id** |API/NOTI/NET3/STEP01<br />API/NOTI/NET3/STEP02<br />API/NOTI/NET3/STEP03 | +|-|-| +|**API Name** |Notification procedure when the <subscription> resource has notificationEventType set to 3 (Hosting CSE sends notification when the direct child resource has been created) | +|**Target Resource** |Create <contentIntance> target: Requested <container> resource<br />Notification Target: originator | +|<br />**Description** |Figure below depicts the procedure for notification.<br /><br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066dac00></mark><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />Initial condition: MN(Hosting CSE) has a <container> resource. The originator is AE1 in this clause, but can be CSE.<br /><br />Step 01: The originator sends a <subscription> resource CREATE request to the <container> resource on the Registrar CSE. In the request, notificationEventType set to 3 and notificationURI attribute set to originator. The Registrar CSE creates a <subscription> resource and sends back a response.<br />Step 02: An AE2 sends a CREATE request of the <contentInstance> resource to the <container> resource. The Registrar CSE creates a <contentInstance> resource and sends back a response.<br />Step 03: The Hosting CSE sends notification as soon as create succeed. The originator sends back an ACK message. | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Resource Structure** **before Sending Request**<br /><br /> <mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d4300></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d5ac0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json;ty=23<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Example**<br /><br />**API/NOTI/NET3/STEP01**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_3">[3]</a><br /> },<br /> "nu": ["AE1"],<br /> "rn": "cont\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/cont\_temp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Resource Structure** **before Sending Request**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d74c0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf6c0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Example**<br /><br />**API/NOTI/NET3/STEP02**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T08463114<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:cin": {<br /> "con": "20"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Resource Structure** **before Sending Request**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cd800></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cf6c0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Example**<br /><br />**API/NOTI/NET3/STEP03**<br /><br />**HTTP Request:**<br /><br />POST HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: mn-name<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sgn": {<br /> "sur": " mn-name/cont\_temp/cont\_sub",<br /> "nev": {<br /> "net":3,<br /> "rep": {<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br /> }<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /> | + + + + +## A.1.4 API-NOTI-NET4 + +|**API** **Id** |API/NOTI/NET4/STEP01<br />API/NOTI/NET4/STEP02<br />API/NOTI/NET4/STEP03 | +|-|-| +|**API** **Name** |Notification procedure when the <subscription> resource has notificationEventType set to 4(Hosting CSE sends notification when the direct child resource has been deleted) | +|**Target** **Resource** |Delete <contentIntance> target: Requested <container> resource<br />Notification Target: originator | +|<br />**Description** |Figure below depicts the procedure for notification.<br /><br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066d9140></mark><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />Initial condition: MN(Hosting CSE) has a <container> resource. At the same time, <container> resource has <contentInstance> resource as a direct child resource. The originator is AE1 in this clause, but can be CSE.<br /><br />Step 01: The originator sends a <subscription> resource CREATE request to the <container> resource on the Registrar CSE. In the request, notificationEventType set to 4 and notificationURI attribute set to originator. The Registrar CSE creates a <subscription> resource and sends back a response.<br />Step 02: An AE2 sends a DELETE request of the <contentInstance> resource to the <container> resource. The Registrar CSE deletes a <contentInstance> resource and sends back a response.<br />Step 03: The Hosting CSE sends notification as soon as delete succeed. The originator sends back an ACK message. | + + + +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Resource Structure** **before Sending Request** <mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066dad40></mark><br /> | +|-|-| +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066dba40></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json;ty=23<br />X-M2M-RVI : Release Version Indicator<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 01**<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> |**Example**<br /><br />**API/NOTI/NET4/STEP01**<br /><br />**HTTP Request:**<br /><br />POST /mn-name/cont\_temp? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE5630283216026458665<br />Content-Type: application/json;ty=23<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sub": {<br /> "enc": {<br /> "net": <a href="#_ref_4">[4]</a><br /> },<br /> "nu": ["AE1"],<br /> "rn": "cont\_sub"<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />201 Created<br />Content-Location: mn-name/cont\_temp<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2001<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Resource Structure** **before Sending Request**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066dbdc0></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066dbd80></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />X-M2M-RVI : Release Version Indicator<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 02**<br /><br /> |**Example**<br /><br />**API/NOTI/NET4/STEP02**<br /><br />**HTTP Request:**<br /><br />DELETE /mn-name/cont\_temp/ci\_temp\_value1? HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: CAE0120180406T08463114<br />Content-Type: application/json<br />Accept: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2004<br /><br />{<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br />}<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Resource Structure** **before Sending Request**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x1066cd800></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Call Flow**<br /><mark>unsupported pict element: <Element {http://schemas.openxmlformats.org/wordprocessingml/2006/main}pict at 0x106473180></mark> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**HTTP Header Information**<br /><br />Header and Value pair information:<br />Accept : application/ json<br />X-M2M-RI : Request ID<br />X-M2M-Origin : AE-ID of originator<br />Content-Type : application/json<br />X-M2M-RVI : Release Version Indicator<br /> | +|<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />**S** **tep 03**<br /><br /> |**Example**<br /><br />**API/NOTI/NET4/STEP03**<br /><br />**HTTP Request:**<br /><br />POST HTTP/1.1<br />Host: 192.168.0.10:8282<br />X-M2M-Origin: mn-name<br />Content-Type: application/json<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br /><br />{<br /> "m2m:sgn": {<br /> "sur": " mn-name/cont\_temp/cont\_sub",<br /> "nev": {<br /> "net":4,<br /> "rep": {<br /> "m2m:cin": {<br /> "con": "20",<br /> "cs": 2,<br /> "ct": "20180406T135509",<br /> "et": "99991231T235959",<br /> "lt": "20180406T135509",<br /> "pi": "cnt20180406T1353041405855518901760\_cse01",<br /> "ri": "cin20180406T1355091405855351047683\_cse01",<br /> "rn": "cin20180406T1355091405855351047682\_cse01",<br /> "st": 1,<br /> "ty": 4<br /> }<br /> }<br /> }<br /> }<br />}<br /><br /><br />**HTTP Response:**<br /><br />200 OK<br />X-M2M-RI: 1234<br />X-M2M-RVI: 2a<br />X-M2M-RSC: 2000<br /> | + + + + +######### Annex B: Bibliography + +- oneM2M TS-0009: "HTTP Protocol Binding". +- oneM2M TS-0011: "Common Terminology". + +# History + +|**Draft history** (to be removed on publication) |**Draft history** (to be removed on publication) |**Draft history** (to be removed on publication) | +|-|-|-| +|V0.0.1 |2017-12-19 |Initial Draft<br />TST-2017-0291-TS-0051-oneM2M\_API\_Guide\_Skeleton | +|V0.0.2 |2017-12-20 |Implemented contribution agreed at TST32.2<br />TST-2017-0293-oneM2M\_API\_template | +|V0.0.3 |2018-05-29 |Implemented contribution agreed at TST35<br />TST-2018-0040R04-TR-0051-AE\_resource\_API<br />TST-2018-0041R03-TR-0051-container\_resource\_API<br />TST-2018-0042R03-TR-0051-contentInstance\_resource\_API<br />TST-2018-0047R03-TR-0051\_supplementation\_of\_resources<br />TST-2018-0069-TR-0051\_semanticDescriptor\_resource\_API | +|V0.1.0 |2018-07-02 |Implemented contribution agreed at TST35.2<br />TST-2018-0104-TR-0051\_subscription\_and\_discovery\_supplement | +|V0.2.0 |2018-07-19 |Implemented contribution agreed at TST36<br />TST-2018-0123R01-TR-0051\_add\_description\_for\_discovery<br />TST-2018-0124R01-TR-0051\_example\_of\_notification | +|V0.3.0 |2018-09-10 |Implemented contribution agreed at TST36.1<br />TST-2018-0129R01-TR-0051-CSEBase\_resource\_API<br />TST-2018-0130-TR-0051-remoteCSE\_resource\_API<br />TST-2018-0135-TR-0051\_RVI\_and\_srv\_supplement | +|V0.3.1 |2018-09-19 |Implemented contribution agreed at TST37<br />TST-2018-0144R01-CR\_for\_TR-0051<br />TST-2018-0149R01-TR-0051\_adding\_introduction\_for\_open\_API\_collection<br />TST-2018-0150-TR-0051\_editorial\_changes | +|V0.4.0 |2018-12-11 |Implemented contribution agreed at TST38<br />TST-2018-0174-TR-0051\_update\_of\_the\_resultContent<br />TST-2018-0176-TR-0051\_flexContainer\_supplement | +|V0.5.0 |2019-02-13 |Implemented contribution agreed at TDE38.2<br />TDE-2019-0010R01-TR-0051\_Addition\_of\_clause\_5 | +|V0.6.0 |2019-06-04 |Clean-up | + + + + + +|**Publication history** |**Publication history** |**Publication history** | +|-|-|-| +|V0.0.6 |August 2020 |Partners pre-processing done by **_editHelp_** **_!_** <br />e-mail: [mailto:edithelp@etsi.org](mailto:edithelp@etsi.org) | +|V2.0.0 |November 2020 |Final version | +| | | | +| | | | +| | | | + + + + + + diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image1.png b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image1.png new file mode 100644 index 0000000000000000000000000000000000000000..97c1800c30f775e41f7ceeccb99e5678e51651cd Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image1.png differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image10.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image10.emf new file mode 100644 index 0000000000000000000000000000000000000000..02ab2a45b577e9c122ecafc49f69b1fb018166d5 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image10.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image11.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image11.emf new file mode 100644 index 0000000000000000000000000000000000000000..f6a1a8c814f2a5f51ebe3d2591d2f3affd18782b Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image11.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image12.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image12.emf new file mode 100644 index 0000000000000000000000000000000000000000..b748a52cb63be7c1d930987ebef2a996f45b1b0c Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image12.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image13.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image13.emf new file mode 100644 index 0000000000000000000000000000000000000000..f6d54beb3e7de04686d90ad2af9f20571d85206e Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image13.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image14.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image14.emf new file mode 100644 index 0000000000000000000000000000000000000000..477b3d168991f0626ba02a7cc77efff1a05d13ef Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image14.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image15.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image15.emf new file mode 100644 index 0000000000000000000000000000000000000000..1c4080665fd76c52a00ad6890abb0e89bf5e2b06 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image15.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image16.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image16.emf new file mode 100644 index 0000000000000000000000000000000000000000..ac50165f5abc8d87cf0a2165ceee3bf01d356591 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image16.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image17.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image17.emf new file mode 100644 index 0000000000000000000000000000000000000000..4771098741736968a7b03151dabf9da4f73835c1 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image17.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image18.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image18.emf new file mode 100644 index 0000000000000000000000000000000000000000..b6f5b50e1f57187431712c6b8bb1bf6a2d5062fe Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image18.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image19.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image19.emf new file mode 100644 index 0000000000000000000000000000000000000000..8f294ac84b29d1109bd0b7d0d58bc2f65ab581b0 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image19.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image20.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image20.emf new file mode 100644 index 0000000000000000000000000000000000000000..5219801e597219a454772701c77daca9c1942111 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image20.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image21.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image21.emf new file mode 100644 index 0000000000000000000000000000000000000000..5d19bb4578313816cc384c9a69dc6a74b48965c3 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image21.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image22.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image22.emf new file mode 100644 index 0000000000000000000000000000000000000000..f26ce3257003f504a50287603ff1f2901a15cde2 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image22.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image23.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image23.emf new file mode 100644 index 0000000000000000000000000000000000000000..900bc5fc8f4d01f5a542e3f992ac6ec4f93e8099 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image23.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image24.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image24.emf new file mode 100644 index 0000000000000000000000000000000000000000..ee7a7668c06e3a5d1b22f13470b4d26d576665fe Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image24.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image25.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image25.emf new file mode 100644 index 0000000000000000000000000000000000000000..fbd8f513fbb80cb3a018915b72bb94cbc060f5da Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image25.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image26.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image26.emf new file mode 100644 index 0000000000000000000000000000000000000000..7420af091fd4c70d0c600fa13fb7bc7d88569cc1 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image26.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image27.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image27.emf new file mode 100644 index 0000000000000000000000000000000000000000..e1aca25aaa37bff7d6ad57855a5b738a864acb28 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image27.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image28.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image28.emf new file mode 100644 index 0000000000000000000000000000000000000000..19cc731b8df0f6d9e7cdc6a7dc9822b23aef5730 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image28.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image29.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image29.emf new file mode 100644 index 0000000000000000000000000000000000000000..afc6279a71d7496377781c9e1312fc5ae0f6a8ea Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image29.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image3.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image3.emf new file mode 100644 index 0000000000000000000000000000000000000000..aed142ab3401263bd2ff3f5d3617be73b429191f Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image3.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image30.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image30.emf new file mode 100644 index 0000000000000000000000000000000000000000..17497c2a98139ac48278bb82491b534137c8e5d2 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image30.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image31.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image31.emf new file mode 100644 index 0000000000000000000000000000000000000000..8aa605e547770186ffb1df99e0d5e14592777074 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image31.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image32.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image32.emf new file mode 100644 index 0000000000000000000000000000000000000000..cff3988912b2a4016aec069282ea8ce81b87f629 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image32.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image33.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image33.emf new file mode 100644 index 0000000000000000000000000000000000000000..37f362ce8392d00df7713f06e7f9c009464959bf Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image33.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image34.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image34.emf new file mode 100644 index 0000000000000000000000000000000000000000..d08cf1838e17bb101ad7be579ce195e1a4595eb1 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image34.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image35.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image35.emf new file mode 100644 index 0000000000000000000000000000000000000000..5c56bccd88a05bf716ac583d431c8f3a70942536 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image35.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image36.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image36.emf new file mode 100644 index 0000000000000000000000000000000000000000..dc95c83b95cdf894998d2b25dd138c4652c7e7a4 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image36.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image4.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image4.emf new file mode 100644 index 0000000000000000000000000000000000000000..a68d2e86e6496845bd6c1c6451c00856dfcf3f1b Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image4.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image5.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image5.emf new file mode 100644 index 0000000000000000000000000000000000000000..23334bee025f96c175f913ab1b44a280f06b82ab Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image5.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image6.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image6.emf new file mode 100644 index 0000000000000000000000000000000000000000..7cd121763e65121741048ee377acc53c892f9897 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image6.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image7.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image7.emf new file mode 100644 index 0000000000000000000000000000000000000000..8573f9c56151c8b7b62226f9d59de7e0feb33615 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image7.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image8.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image8.emf new file mode 100644 index 0000000000000000000000000000000000000000..715bf265fec39b868b891cc3bcadb7bc83fd291a Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image8.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image9.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image9.emf new file mode 100644 index 0000000000000000000000000000000000000000..8f192b87dc8e454c4d731a0435285aba9eb99f07 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/media/image9.emf differ diff --git a/Conversed_MD/TR-0051-modification_for_MD_Conversion/unreferenced/image2.emf b/Conversed_MD/TR-0051-modification_for_MD_Conversion/unreferenced/image2.emf new file mode 100644 index 0000000000000000000000000000000000000000..d579fb7c8b59c1e93df282ca8d7b66cd693c2f03 Binary files /dev/null and b/Conversed_MD/TR-0051-modification_for_MD_Conversion/unreferenced/image2.emf differ diff --git a/Original_Document/TR-0051-modification_for_MD_Conversion.docx b/Original_Document/TR-0051-modification_for_MD_Conversion.docx new file mode 100644 index 0000000000000000000000000000000000000000..616946c445693ca4aab609e6539ce390b0dc9765 Binary files /dev/null and b/Original_Document/TR-0051-modification_for_MD_Conversion.docx differ