B.2 Resource representation and APIs for event triggered network slice configuration
24.5493GPPNetwork slice capability enablement- Service Enabler Architecture Layer for Verticals (SEAL)Protocol specificationRelease 17Stage 3TS
B.2.1 ETN_Configuration API
B.2.1.1 API URI
The CoAP URIs used in CoAP requests from SNSCE-C towards the SNSCE-S shall have the Resource URI structure as defined in clause C.1.1 of 3GPP TS 24.546 [3A] with the following clarifications:
– the <apiName> shall be "su_nsc";
– the <apiVersion> shall be "v1"; and
– the <apiSpecificSuffixes> shall be set as described in clause B.2.1.2.
B.2.1.2 Resources
B.2.1.2.1 Overview
The Resource URI structure of the ETN_Configuration API is as shown in Figure B.2.1.2.1-1:
Figure B.2.1.2.1-1: Resource URI structure of the ETN_Configuration API
Table B.2.1.2.1-1 provides an overview of the resources and applicable CoAP method.
Table B.2.1.2.1-1: Resources and method overview
|
Resource name |
Resource URI |
CoAP method |
Description |
|
Configuration |
/val-services/{valServiceId}/configurations/{configurationId} |
PUT (NOTE) |
Performs configuration. |
|
NOTE: In this release, the only configuration is the slice adaptation as described in 3GPP TS 23.434 [2]. |
|||
B.2.1.2.2 Resource: Configuration
B.2.1.2.2.1 Description
The Configuration resource allows an SNSCE-C a specific configuration identified by a configuration ID, to send a CoAP request containing:
a) a list of one or more VAL UEs;
b) a requested S-NSSAI;
c) optionally a requested DNN; and
d) optionally a requested configuration cause,
for a specific VAL service identified by a VAL service ID, toward a SNSCE-S to perform a network triggered slice configuration for the list of one or more VAL UEs for that specific VAL service.
NOTE: In this release, S-NSSAI and DNN are the only used route selection descriptors of the URSP rules described in 3GPP TS 24.526 [3].
B.2.1.2.2.2 Resource Definition
Resource URI: {apiRoot}/su_nsc/<apiVersion>/val-services/{valServiceId}/configurations/{configurationId}
This resource shall support the resource URI variables defined in the table B.2.1.2.2.2-1.
Table B.2.1.2.2.2-1: Resource URI variables for this resource
|
Name |
Data Type |
Definition |
|
apiRoot |
string |
See clause B.1.1 |
|
apiVersion |
string |
See clause B.2.1.1 |
|
valServiceId |
string |
Identifier of a VAL service. |
|
configurationId |
string |
Identifier of a configuration |
B.2.1.2.2.3 Resource Standard Method
B.2.1.2.2.3.1 PUT
This operation is to update a given configuration for one or more VAL UEs for a given VAL service which is provided by the SNSCE-S.
This method shall support the request data structures specified in table B.2.1.2.2.3.1-1, the response data structures and response codes specified in table B.2.1.2.2.3.1-2.
Table B.2.1.2.2.3.1-1: Data structures supported by the PUT Request payload on this resource
|
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
|
VAL UE List |
string |
M |
1..N |
Represents a space-separated of VAL UE IDs within a given VAL service, for which a given network slice configuration trigger applies. The VAL service is identified by the value "valServiceId" and the network slice configuration is identified by the value "configurationId". |
|
|
Requested |
string |
M |
1 |
The new S-NSSAI which is requested. |
|
|
Requested DNN |
string |
O |
1 |
The new DNN which is requested. |
|
|
configuration cause |
string |
O |
1 |
Indicates the cause for the configuration. |
Table B.2.1.2.2.3.1-2: Data structures supported by the PUT Response payload on this resource
|
Data type |
P |
Cardinality |
Response Codes (NOTE) |
Description |
|
n/a |
M |
1 |
2.04 Changed |
The configuration of the VAL UEs with VAL UE List within the VAL service identified by the value "valServiceId" and for the network slice configuration identified by the value "configurationId, was successfull. |
|
NOTE: The mandatory CoAP error status codes for the PUT method listed in table B.1.3-1 shall also apply. |
||||
B.2.1.3 Error Handling
General error responses are defined in clause B.1.3.
Annex C (informative):
Change history
|
Change history |
|||||||
|
Date |
Meeting |
TDoc |
CR |
Rev |
Cat |
Subject/Comment |
New version |
|
2021-08 |
CT1#131-e |
TS skeleton for Network slice capability management – Service Enabler Architecture Layer for Verticals (SEAL); Protocol specification |
0.0.0 |
||||
|
2021-08 |
CT1#131-e |
Network slice capability management procedures |
0.1.0 |
||||
|
2021-08 |
CT1#131-e |
Requirements for functional entities |
0.1.0 |
||||
|
2021-10 |
CT1#132-e |
Correction of event triggered network slice adaptation procedure |
0.2.0 |
||||
|
2021-12 |
CT#94e |
Creation of version 1.0.0 for CT#94 for information |
1.0.0 |
||||
|
2022-01 |
CT1#133-bis-e |
Definitions of terms and symbols for network slice capability enablement Spec. |
1.1.0 |
||||
|
2022-01 |
CT1#133 |
Network slice adaptation |
1.1.0 |
||||
|
2022-01 |
CT1#133 |
Resolving EN |
1.1.0 |
||||
|
2022-01 |
CT1#133 |
General description for network slice capability enablement Spec |
1.1.0 |
||||
|
2022-01 |
CT1#133 |
Scope for network slice capability enablement Spec |
1.1.0 |
||||
|
2022-01 |
CT1#133 |
Replace management with enablement |
1.1.0 |
||||
|
2022-02 |
CT1#134 |
Clarification on route selection descriptors |
1.2.0 |
||||
|
2022-03 |
CT1#95e |
CP-220315 |
Specification presented for approval, v2.0.0 |
2.0.0 |
|||
|
2022-03 |
CT#95e |
TS 24.549 v17.0.0 created after CT#95e by MCC |
17.0.0 |
||||
|
2022-06 |
CT#96 |
CP-221217 |
0001 |
2 |
B |
Authenticate of SNSCE-C identity |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0002 |
3 |
B |
CoAP encoding |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0003 |
2 |
B |
CoAP requirements for SNSCE-C |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0004 |
1 |
B |
CoAP requirements for SNSCE-S |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0005 |
1 |
F |
Re-order the reference |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0006 |
2 |
B |
SNSCE client CoAP procedure |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0007 |
3 |
B |
SNSCE server CoAP procedure |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0008 |
1 |
F |
HTTP parameters |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0009 |
1 |
F |
Modification of general descriptions |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0010 |
1 |
F |
SNSCE client HTTP procedure |
17.1.0 |
|
2022-06 |
CT#96 |
CP-221217 |
0011 |
1 |
F |
SNSCE server HTTP procedure |
17.1.0 |
|
2022-09 |
CT#97e |
CP-222150 |
0012 |
1 |
F |
Added description and overview |
17.2.0 |