[core-parameters] NEW INTERFACE DESCRIPTION - oic.*

Dave Thaler <dthaler@microsoft.com> Sat, 10 September 2016 00:33 UTC

Return-Path: <dthaler@microsoft.com>
X-Original-To: core-parameters@ietfa.amsl.com
Delivered-To: core-parameters@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A62C212B284 for <core-parameters@ietfa.amsl.com>; Fri, 9 Sep 2016 17:33:13 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.021
X-Spam-Level:
X-Spam-Status: No, score=-102.021 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, USER_IN_WHITELIST=-100] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=microsoft.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id CZeN7Efwb5ai for <core-parameters@ietfa.amsl.com>; Fri, 9 Sep 2016 17:33:11 -0700 (PDT)
Received: from NAM02-SN1-obe.outbound.protection.outlook.com (mail-sn1nam02on0110.outbound.protection.outlook.com [104.47.36.110]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E1BBA12B010 for <core-parameters@ietf.org>; Fri, 9 Sep 2016 17:33:10 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=Fy81Q/vpdD00t/KxUwapE5KzAiIzaGjiI0eMfl2di34=; b=hNMVZlD0JJe8GuYST4pniWFHBdKI0RhqdenKhho7H5ord0LK0q6dI7ASVCakELsAwu4Qd2NJ5BOxDC36w0MdiNO39P+WGq851Yp0wET2RxzccdVaw1FbZMBDS29i7QFm2PaeFXyfBIOZCfralV3n5FMxdVQKa+Il6rhsicAXsD4=
Received: from CY1PR03MB2265.namprd03.prod.outlook.com (10.166.207.17) by CY1PR03MB2268.namprd03.prod.outlook.com (10.166.207.20) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.619.10; Sat, 10 Sep 2016 00:33:09 +0000
Received: from CY1PR03MB2265.namprd03.prod.outlook.com ([10.166.207.17]) by CY1PR03MB2265.namprd03.prod.outlook.com ([10.166.207.17]) with mapi id 15.01.0599.016; Sat, 10 Sep 2016 00:33:09 +0000
From: Dave Thaler <dthaler@microsoft.com>
To: "core-parameters@ietf.org" <core-parameters@ietf.org>
Thread-Topic: NEW INTERFACE DESCRIPTION - oic.*
Thread-Index: AdIK+srLZ+ON+ScLQLucFC2GSUVeIQ==
Date: Sat, 10 Sep 2016 00:33:09 +0000
Message-ID: <CY1PR03MB2265C9B5523E4C80F0B4453EA3FD0@CY1PR03MB2265.namprd03.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=dthaler@microsoft.com;
x-originating-ip: [2001:4898:80e8:1::6fe]
x-ms-office365-filtering-correlation-id: 93b661c2-d882-49ae-59b1-08d3d9120a45
x-microsoft-exchange-diagnostics: 1; CY1PR03MB2268; 6:zHQJPjhEFCvxS70qVOeaJFiB7dwjgSVgUbUUpy/9UYvNudXWpH5s91tyZ7bm37Y1Dt+p1g+4TRcWOCbuuPo6vEGTpovplqxdYzF9uN2IFKwqsza2IsxzVIuaYOmPscfkRvQ7dfAb5t6ZsgLeJeRlclf/mS1oC+giX18t8kEkNMF4ziUuEERXeeJxZI/VtUBKSbKEiRgrfDFzCQL2s57eFhOjuiyz1lzuzRuP0gWBzyv0+ErQ5BEUF9rMBItdcPoIhhaGAa2yBCEW3zQ3qO4fMwZT4MuU5+rsSS1xKhmQ30+CptQ8+79LHDpC+3gNZn6AocdEFl9ZKPevRbCkiJu8JQ==; 5:KhRmEi40S52giAG/Rg0FTJuW4FlazPTa88BNXW1YNIAIqdEO7zamMUOG7RCkdhOXWrbG+ouZqu8+DTZok5T81RoS/qi6zCXJTdBPosgxp19bLD+v8AKqLxlWJJ04aE4mycFqkt1LZIn3dLbTEjIUuw==; 24:T58uoVG9ScQ30+JOC/EAzMgmR2lnoeLRwJI0752s0dBA0ci6UJ9SvkAtOoXTIEDc65exXuDNPHD2f3J71zMgJU6JxSfquRI3Fl5ixmT8KhY=; 7:z280TUi6uHSzuE+uGPEg+TrVPPeTc3bSHwR2hxbtC++kvxCrywOa0q04Lk4bD1j3nlBJH5ZhsVfM0rjcWJZs53nElPKGWC05B5coKcFt5OO/PLRPfwlhxJLNcgnixn6fs0Rs5XwGb4JPC+Cb7CIHsJi/jwFqobgib03mJGnfOvUyAAJ5FsZki5jNbH1NZbSrKS5MWIS8OnyRFQPZlyAj8GyWBjQfpGcgKw1TkjMbj+sJ7MqdeQvZjfl3Eix+wLTj
x-microsoft-antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:CY1PR03MB2268;
x-microsoft-antispam-prvs: <CY1PR03MB2268778887C285DED0891900A3FD0@CY1PR03MB2268.namprd03.prod.outlook.com>
x-exchange-antispam-report-test: UriScan:(158342451672863)(35073007944872)(21748063052155)(1591387915157);
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(61425038)(6040176)(601004)(2401047)(8121501046)(5005006)(10201501046)(3002001)(6055026)(61426038)(61427038); SRVR:CY1PR03MB2268; BCL:0; PCL:0; RULEID:; SRVR:CY1PR03MB2268;
x-forefront-prvs: 0061C35778
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(7916002)(199003)(189002)(99286002)(92566002)(450100001)(10090500001)(2351001)(2906002)(5660300001)(3660700001)(15975445007)(2900100001)(86362001)(86612001)(19580395003)(105586002)(122556002)(229853001)(19300405004)(3280700002)(77096005)(110136002)(106356001)(8558605004)(5002640100001)(11100500001)(16236675004)(33656002)(189998001)(101416001)(107886002)(19617315012)(7736002)(76576001)(7846002)(50986999)(7906003)(54356999)(74316002)(81166006)(8936002)(81156014)(87936001)(2501003)(9686002)(586003)(7696004)(6116002)(5630700001)(5640700001)(790700001)(102836003)(8676002)(97736004)(19625215002)(8990500004)(68736007)(5005710100001)(10290500002)(10400500002)(12290500005)(3826002)(15398625002)(217873001); DIR:OUT; SFP:1102; SCL:1; SRVR:CY1PR03MB2268; H:CY1PR03MB2265.namprd03.prod.outlook.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en;
received-spf: None (protection.outlook.com: microsoft.com does not designate permitted sender hosts)
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: multipart/alternative; boundary="_000_CY1PR03MB2265C9B5523E4C80F0B4453EA3FD0CY1PR03MB2265namp_"
MIME-Version: 1.0
X-OriginatorOrg: microsoft.com
X-MS-Exchange-CrossTenant-originalarrivaltime: 10 Sep 2016 00:33:09.2716 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 72f988bf-86f1-41af-91ab-2d7cd011db47
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR03MB2268
Archived-At: <https://mailarchive.ietf.org/arch/msg/core-parameters/ria9LTAOfNnXKijWncb0rafryA4>
Subject: [core-parameters] NEW INTERFACE DESCRIPTION - oic.*
X-BeenThere: core-parameters@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: "Expert review of CoAP parameters." <core-parameters.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/core-parameters>, <mailto:core-parameters-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/core-parameters/>
List-Post: <mailto:core-parameters@ietf.org>
List-Help: <mailto:core-parameters-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/core-parameters>, <mailto:core-parameters-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 10 Sep 2016 00:33:14 -0000

The Open Connectivity Foundation has defined a number of interface descriptions to be registered in the http://www.iana.org/assignments/core-parameters/core-parameters.xhtml#if-link-target-att-value registry according to the "Specification Required" policy.
The references for all of them are in the ZIP file at https://openconnectivity.org/wp-content/uploads/2016/06/OIC_1.1_Candidate_Specification.zip

Since registering a prefix is not currently allowed, per the CoRE WG mailing list discussion, here is a list of 7 separate 'if' values requested to register.

Attribute Value

Description

Reference

Notes [optional]


oic.if.baseline



The baseline Interface defines a view into all Properties of a Resource including the Meta Properties. This Interface is used to operate on the full Representation of a Resource.

OIC_Core_Specification_v1.1.0 section 7.5.3




oic.if.ll




The 'links list' Interface provides a view into Links in a Collection (Resource).
Since Links represent relationships to other Resources, the links list interfaces may be used to discover Resources with respect to a context. The discovery is done by retrieving Links to these Resources.

OIC_Core_Specification_v1.1.0 section 7.5.3




oic.if.b




The batch Interface is used to interact with a collection of Resources at the same time. This also removes the need for the Client to first discover the Resources it is manipulating - the Server forwards the requests and aggregates the responses.

OIC_Core_Specification_v1.1.0 section 7.5.3




oic.if.r




The read-only Interface exposes the Properties of a Resource that may be 'read'. This Interface does not provide methods to update Properties or a Resource and so can only be used to 'read' Property Values.

OIC_Core_Specification_v1.1.0 section 7.5.3




oic.if.rw




The read-write Interface exposes only those Properties that may be both 'read' and 'written' and provides methods to read and write the Properties of a Resource.

OIC_Core_Specification_v1.1.0 section 7.5.3




oic.if.a




The actuator Interface is used to read or write the Properties of an actuator Resource.

OIC_Core_Specification_v1.1.0 section 7.5.3




oic.if.s




The sensor Interface is used to read the Properties of a sensor Resource.

OIC_Core_Specification_v1.1.0 section 7.5.3