Content for TS 32.158 Word version: 18.1.0

1 Scope p. 6

The present document defines design rules for REpresentational State Transfer (REST) Solution Sets (SS). These rules are applied when specifying REST Solution Sets.

2 References p. 6

The following documents contain provisions which, through reference in this text, constitute provisions of the present document.

References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific.
For a specific reference, subsequent revisions do not apply.
For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document.

[1]

TR 21.905: "Vocabulary for 3GPP Specifications".

[2]

RFC 7231: "Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content".

[3]

TS 32.300: "Telecommunication management; Configuration Management (CM); Name convention for Managed Objects".

[4]

RFC 3986: "Uniform Resource Identifier (URI): Generic Syntax".

[5]

RFC 7230: "Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing".

[6]

RFC 7159: " The JavaScript Object Notation (JSON) Data Interchange Format".

[7]

draft-wright-json-schema-01: (October 2017) "JSON Schema: A Media Type for Describing JSON Documents".

[8]

draft-wright-json-schema-validation-01: (October 2017: "JSON Schema Validation: A Vocabulary for Structural Validation of JSON".

[9]

draft-wright-json-schema-hyperschema-01: (October 2017): "JSON Hyper-Schema: A Vocabulary for Hypermedia Annotation of JSON.

[10]

OpenAPI Specification (https://github.com/OAI/OpenAPI-Specification)

[11]

RFC 5789: "PATCH Method for HTTP".

[12]

RFC 7396: "JSON Merge Patch".

[13]

RFC 6902: "JavaScript Object Notation (JSON) Patch".

[14]

RFC 6901: "JavaScript Object Notation (JSON) Pointer".

[15]

XML Path Language (XPath) Version 1.0: W3C Recommendation 16 November 1999 (https://www.w3.org/TR/xpath-10/)

[16]

TS 32.160: "Management and orchestration; Management service template".

[17]

RFC 4918: "HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)"

[18]

RFC 6585: "Additional HTTP Status Codes"

[19]

RFC 7807: "Problem Details for HTTP APIs"

[20]

RFC 7725: "An HTTP Status Code to Report Legal Obstacles"

[21]

TS 32.161: "JSON expressions (Jex)"

3 Definitions and abbreviations p. 7

3.1 Definitions p. 7

For the purposes of the present document, the terms and definitions given in TR 21.905 and the following apply. A term defined in the present document takes precedence over the definition of the same term, if any, in TR 21.905.

3.2 Abbreviations p. 7

For the purposes of the present document, the abbreviations given in TR 21.905 and the following apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if any, in TR 21.905.

CRUD

Create, Retrieve, Update, Delete

Domain Component

Distinguished Name

DNS

Domain Name Service

FQDN

Fully Qualified Doman Name

HTTP

Hypertext Transfer Protocol

JSON

JavaScript Object Notation

LDN

Local Distinguished Name

MnS

Management Service

REST

REpresentational State Transfer

RPC

Remote Procedure Call

TCP

Transmission Control Protocol

URI

Uniform Resource Identifier