Tech-invite3GPPspaceIETFspace
21222324252627282931323334353637384‑5x

Content for  TS 29.502  Word version:  18.7.0

Top   Top   Up   Prev   Next

 

6.1.3  Resourcesp. 101

6.1.3.1  Overviewp. 101

This clause describes the structure for the Resource URIs and the resources and methods used for the service.
Figure 6.1.3.1-1 describes the resource URI structure of the Nsmf_PDUSession API.
Reproduction of 3GPP TS 29.502, Fig. 6.1.3.1-1: Resource URI structure of the Nsmf_PDUSession API
Up
Table 6.1.3.1-1 provides an overview of the resources and applicable HTTP methods.
Resource name Resource URI HTTP method or custom operation Description
(service operation)
SM contexts collection/sm-contextsPOSTCreate SM Context
Individual SM context/sm-contexts/{smContextRef}/retrieveretrieve (POST)Retrieve SM Context
/sm-contexts/{smContextRef}/modify modify (POST)Update SM Context
/sm-contexts/{smContextRef}/releaserelease (POST) Release SM Context
/sm-contexts/{smContextRef}/send-mo-datasend-mo-data (POST)Send MO Data
PDU sessions collection (H-SMF or SMF)/pdu-sessionsPOSTCreate
Individual PDU session (H-SMF or SMF)/pdu-sessions/{pduSessionRef}/modify modify (POST)Update (initiated by V-SMF or I-SMF)
/pdu-sessions/{pduSessionRef}/releaserelease (POST)Release
/pdu-sessions/{pduSessionRef}/retrieveretrieve (POST)Retrieve
/pdu-sessions/{pduSessionRef}/transfer-mo-datatransfer-mo-data (POST)Transfer MO Data
Individual PDU session (V-SMF or I-SMF){vsmfPduSessionUri}/modify or {ismfPduSessionUri}/modify modify (POST)Update (initiated by H-SMF or SMF)
{vsmfPduSessionUri} or {ismfPduSessionUri}POSTNotify Status
{vsmfPduSessionUri}/transfer-mt-data or {ismfPduSessionUri}/ transfer-mt-datatransfer-mt-data (POST)Transfer MT Data
Up

6.1.3.2  Resource: SM contexts collectionp. 103

6.1.3.2.1  Descriptionp. 103
This resource represents the collection of the individual SM contexts created in the SMF.
This resource is modelled with the Collection resource archetype (see clause C.2 of TS 29.501).
6.1.3.2.2  Resource Definitionp. 103
Resource URI:
{apiRoot}/nsmf-pdusession/<apiVersion>/sm-contexts
This resource shall support the resource URI variables defined in Table 6.1.3.2.2-1.
Name Data type Definition
apiRootstringSee clause 6.1.1.
Up
6.1.3.2.3  Resource Standard Methodsp. 104
6.1.3.2.3.1  POSTp. 104
This method creates an individual SM context resource in the SMF, or in V-SMF in HR roaming scenarios.
This method shall support the URI query parameters specified in Table 6.1.3.2.3.1-1.
Name Data type P Cardinality Description
n/a
This method shall support the request data structures specified in Table 6.1.3.2.3.1-2 and the response data structures and response codes specified in Table 6.1.3.2.3.1-3.
Data type P Cardinality Description
SmContextCreateDataM1Representation of the SM context to be created in the SMF.
Data type P Cardinality Response codes Description
SmContextCreatedDataM1201 CreatedSuccessful creation of an SM context.
RedirectResponseO0..1307 Temporary RedirectTemporary redirection. (NOTE 2)
RedirectResponseO0..1308 Permanent RedirectPermanent redirection. (NOTE 2)
SmContextCreateErrorM1400 Bad Request The "cause" attribute shall be set to one of the errors defined in Table 5.2.7.2-1 of TS 29.500.
ProblemDetailsO0..1400 Bad RequestThis error shall only be returned by an SCP for errors it originates. As an exception, this error may also be returned by an SMF, with an empty content, for a protocol error other than those specified for the SMF PDUSession service logic (e.g. protocol error found by the HTTP stack).
SmContextCreateErrorM1403 Forbidden The "cause" attribute shall be set to one of the following application errors:
  • N1_SM_ERROR
  • N2_SM_ERROR
  • SNSSAI_DENIED
  • DNN_DENIED
  • PDUTYPE_DENIED
  • SSC_DENIED
  • SUBSCRIPTION_DENIED
  • DNN_NOT_SUPPORTED
  • PDUTYPE_NOT_SUPPORTED
  • SSC_NOT_SUPPORTED
  • HOME_ROUTED_ROAMING_REQUIRED
  • OUT_OF_LADN_SERVICE_AREA
  • NO_EPS_5GS_CONTINUITY
  • INTEGRITY_PROTECTED_MDR_NOT_ACCEPTABLE
  • DEFAULT_EPS_BEARER_INACTIVE
  • NOT_SUPPORTED_WITH_ISMF
  • SERVICE_NOT_AUTHORIZED_BY_NEXT_HOP
  • EXCEEDED_UE_SLICE_DATA_RATE
  • EXCEEDED_SLICE_DATA_RATE
See Table 6.1.7.3-1 for the description of these errors.
ProblemDetailsO0..1403 ForbiddenThis error shall only be returned by an SCP for errors it originates. As an exception, this error may also be returned by an SMF, with an empty content, for a protocol error other than those specified for the SMF PDUSession service logic (e.g. protocol error found by the HTTP stack).
SmContextCreateErrorM1404 Not Found The "cause" attribute shall be set to one of the following application error:
  • CONTEXT_NOT_FOUND
See Table 6.1.7.3-1 for the description of these errors.
ExtProblemDetailsO0..1413 Content Too Large
ExtProblemDetailsO0..1415 Unsupported Media Type
ExtProblemDetailsO0..1429 Too Many Requests
SmContextCreateErrorM1500 Internal Server Error The "cause" attribute shall be set to one of the errors defined in Table 5.2.7.2-1 of TS 29.500 or to one of the following application errors:
  • INSUFFICIENT_RESOURCES_SLICE
  • INSUFFICIENT_RESOURCES_SLICE_DNN
See Table 6.1.7.3-1 for the description of these errors.
ProblemDetailsO0..1500 Internal Server ErrorThis error shall only be returned by an SCP for errors it originates. As an exception, this error may also be returned by an SMF, with an empty content, for a general server error other than those specified for the SMF PDUSession service logic.
SmContextCreateErrorM1503 Service Unavailable The "cause" attribute shall be set to one of the errors defined in Table 5.2.7.2-1 of TS 29.500 or to one of the following application errors:
  • DNN_CONGESTION
  • S_NSSAI_CONGESTION
See Table 6.1.7.3-1 for the description of these errors.
ProblemDetailsO0..1503 Service UnavailableThis error shall only be returned by an SCP for errors it originates. As an exception, this error may also be returned by an SMF, with an empty content, for a general server error other than those specified for the SMF PDUSession service logic.
SmContextCreateErrorM1504 Gateway Timeout The "cause" attribute shall be set to one of the following application errors:
  • PEER_NOT_RESPONDING
  • NETWORK_FAILURE
See Table 6.1.7.3-1 for the description of these errors.
ProblemDetailsO0..1504 Gateway TimeoutThis error shall only be returned by an SCP for errors it originates.
NOTE 1:
The mandatory HTTP error status codes for the POST method listed in Table 5.2.7.1-1 of TS 29.500 other than those specified in the Table above also apply, with a ProblemDetails data type (see clause 5.2.7 of TS 29.500).
NOTE 2:
RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of TS 29.500.
Name Data type P Cardinality Description
LocationstringM1 Contains the URI of the newly created resource, according to the structure:
{apiRoot}/nsmf-pdusession/<apiVersion>/sm-contexts/{smContextRef}
Name Data type P Cardinality Description
LocationstringM1An alternative URI of the resource located on an alternative service instance within the same SMF or SMF (service) set.
For the case when a request is redirected to the same target resource via a different SCP, see clause 6.10.9.1 in TS 29.500.
3gpp-Sbi-Target-Nf-IdstringO0..1Identifier of the target SMF (service) instance ID towards which the request is redirected
Name Data type P Cardinality Description
LocationstringM1An alternative URI of the resource located on an alternative service instance within the same SMF or SMF (service) set.
For the case when a request is redirected to the same target resource via a different SCP, see clause 6.10.9.1 in TS 29.500.
3gpp-Sbi-Target-Nf-IdstringO0..1Identifier of the target SMF (service) instance ID towards which the request is redirected
Up
6.1.3.2.4  Resource Custom Operationsp. 107
None.

Up   Top   ToC