Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The body is empty in case 204 No Content, and with specific HTTP code and error details in case failure


ENDC Setup Request (Deprecated)

Resource

 

Resource for this interface

/v#/nodeb

Description

E2 Manager exchange with this gNodeb RAN Setup Request and Response.

HTTP Method

POST

Supported Representation Formats

Request: Request Format ie application/json, none, etc

Response: Response Format ie application/json, none, etc

Successful HTTP Response Code

204 No Content

Code Block
languagejava
themeConfluence
POST http://<serverBaseURL>/v#/nodeb/endc-setup 

Request Data Details

Listed below are the key elements included in the request.

...

Location

...

accept

...

Header

...

String

...

Status
colourRed
titleYES

...

Refer to Standard API Request Headers

...

content-type

...

Header

...

String

...

Status
colourRed
titleYES

...

Refer to Standard API Request Headers

...

ranIp

...

Body

...

String

...

Status
colourRed
titleYES

...

IP of the RAN

...

ranPort

...

Body

...

Int

...

Status
colourRed
titleYES

...

Port of the RAN

...

ranName

...

Body

...

String

...

Status
colourRed
titleYES

...

Name of the RAN

Code Block
languagejava
themeConfluence
POST http://localhost:3800/v1/nodeb/endc-setup  
accept: application/json  
content-Type: application/json 
{
 "ranIp":"10.0.2.15",
 "ranPort":5577, 
 "ranName": "test1"
}

Response Data Details

The body is empty in case 204 No Content, and with specific HTTP code and error details in case failure

...

Reset nodeb Request  (Deprecated)

...

Resource

 

...

Resource for this interface

/v#/nodeb/<ran name>/reset

Note: Due to router problem we change the Endpoint of Reset nodeb to /v1/nodeb/<ran name>/reset

...

Description

...

E2 Manager is requested to Reset specific RAN  

...

HTTP Method

...

PUT

...

Supported Representation Formats

...

Request: Request Format ie application/json, none, etc

Response: Response Format ie application/json, none, etc

...

Successful HTTP Response Code

...

204 No Content


PUT http://<serverBaseURL>/v#/nodeb/<ran name>/reset
(See remark above about changing the Endpoint)

Request Data Details

Listed below are the key elements included in the request.

...

#

...

Parameter

...

Location

...

Data Type

...

Required?

...

Description and Value Rules

...

accept

...

Header

...

String

...

YES

...

Refer to - Standard API Request Headers

...

content-type

...

Header

...

String

...

See above - Standard API Request Headers

...

cause

...

Body

...

String

...

Note: Due to router problem we change the Endpoint of Reset nodeb to /v1/nodeb/<ranName>/reset.

...

PUT http://localhost:3800/v1/nodeb/NYC213123/reset
 accept: application/json
 {
 "cause":  “misc:om-intervention”
 }

Response Data Details

...

Reset nodeb Request  (Deprecated)


1. Health Check Request 


Resource

 

Resource for this interface

/v#/health

Description

For simple health check the client should send GET request to /health endpoint. If client receives 200OK it means the server is up and running

HTTP Method

GET

Supported Representation Formats

Request: Request Format ie application/json, none, etc

Response: Response Format ie application/json, none, etc

Successful HTTP Response Code

200 OK

...

Code Block
languagejava
themeConfluence
GET http://<serverBaseURL>/v#/health

Request Data Details

Listed below are the key elements included in the request.

...

Code Block
languagejava
themeConfluence
GET http://localhost:3800/v1/health 
accept: application/json  

Response Data Details

The body is empty in case 200 OK. No other response expected. If no answer - there is a problem....

...

Code Block
languagejava
themeConfluence
GET http://<serverBaseURL>/v#/nodeb/<ranName>

Request Data Details

Listed below are the key elements included in the request.

...

Code Block
languagejava
themeConfluence
GET http://localhost:3800/v1/nodeb/NYC213123  
accept: application/json  
Content-Type: application/json

Response Data Details

In case 200 OK, this is the payload

...

PUT http://<serverBaseURL>/v#/nodeb/<ranName>/update

Request Data Details

#

Parameter

Location

Data Type

Required?

Value Rules


acceptHeaderString

YES

Refer to Standard API Request Headers

content-type

Header

String

YES

Refer to Standard API Request Headers


servedNrCellsBodyArray of ObjectYESPlease refer to Served NR Cells array inside the gNB Object (In the Get NodeB Response)

...

Code Block
languagejava
themeConfluence
PUT http://localhost:3800/v1/nodeb/test1/update
accept: application/json
{
       "servedNrCells": [
      {
        "servedNrCellInformation": {
         "nrPci": 100,
          "cellId": "02f829:0007ab0178",
          "servedPlmns": [
            "02f829"
          ],
          "nrMode": "FDD",
          "choiceNrMode": {
            "fdd": {
              "ulFreqInfo": {
                "nrArFcn": "100",
                "frequencyBands": [
                  {
                    "nrFrequencyBand": 9,
                    "supportedSulBands": [
                      9
                    ]
                  }
                ]
              },
              "dlFreqInfo": {
                "nrArFcn": "100",
                "frequencyBands": [
                  {
                    "nrFrequencyBand": 9,
                    "supportedSulBands": [
                      9
                    ]
                  }
                ]
              },
              "ulTransmissionBandwidth": {
                "nrscs": "SCS15",
                "ncnrb": "NRB11"
              },
              "dlTransmissionBandwidth": {
                "nrscs": "SCS15",
                "ncnrb": "NRB11"
              }
            }
          }
        },
        "nrNeighbourInfos": [
          {
            "nrCgi": "string",
            "choiceNrMode": {
              "fdd": {
                "ulFreqInfo": {
                  "nrArFcn": "100",
                  "frequencyBands": [
                    {
                      "nrFrequencyBand": 9,
                      "supportedSulBands": [
                        9
                      ]
                    }
                  ]
                },
                "dlFreqInfo": {
                  "nrArFcn": "100",
                  "frequencyBands": [
                    {
                      "nrFrequencyBand": 9,
                      "supportedSulBands": [
                        9
                      ]
                    }
                  ]
                },
                "ulTransmissionBandwidth": {
                  "nrscs": "SCS15",
                  "ncnrb": "NRB11"
                },
                "dlTransmissionBandwidth": {
                  "nrscs": "SCS15",
                  "ncnrb": "NRB11"
                }
              }
            },
            "configuredStac": "string",
            "nrPci": 200,
            "nrMode": "FDD",
            "stac5g": "string"
          },
          {
            "nrCgi": "string",
            "choiceNrMode": {
              "fdd": {
                "ulFreqInfo": {
                  "nrArFcn": "100",
                  "frequencyBands": [
                    {
                      "nrFrequencyBand": 9,
                      "supportedSulBands": [
                        9
                      ]
                    }
                  ]
                },
                "dlFreqInfo": {
                  "nrArFcn": "100",
                  "frequencyBands": [
                    {
                      "nrFrequencyBand": 9,
                      "supportedSulBands": [
                        9
                      ]
                    }
                  ]
                },
                "ulTransmissionBandwidth": {
                  "nrscs": "SCS15",
                  "ncnrb": "NRB11"
                },
                "dlTransmissionBandwidth": {
                  "nrscs": "SCS15",
                  "ncnrb": "NRB11"
                }
              }
            },
            "configuredStac": "string",
            "nrPci": 201,
            "nrMode": "FDD",
            "stac5g": "string"
          }
        ]
      },
      {
        "servedNrCellInformation": {
          "nrPci": 101,
          "cellId": "02f829:0007ab0120",
          "servedPlmns": [
            "02f829"
          ],
          "nrMode": "FDD",
          "choiceNrMode": {
            "fdd": {
              "ulFreqInfo": {
                "nrArFcn": "100",
                "frequencyBands": [
                  {
                    "nrFrequencyBand": 9,
                    "supportedSulBands": [
                      9
                    ]
                  }
                ]
              },
              "dlFreqInfo": {
                "nrArFcn": "100",
                "frequencyBands": [
                  {
                    "nrFrequencyBand": 9,
                    "supportedSulBands": [
                      9
                    ]
                  }
                ]
              },
              "ulTransmissionBandwidth": {
                "nrscs": "SCS15",
                "ncnrb": "NRB11"
              },
              "dlTransmissionBandwidth": {
                "nrscs": "SCS15",
                "ncnrb": "NRB11"
              }
            }
          }
        },
        "nrNeighbourInfos": [
          {
            "nrCgi": "string",
            "choiceNrMode": {
              "fdd": {
                "ulFreqInfo": {
                  "nrArFcn": "100",
                  "frequencyBands": [
                    {
                      "nrFrequencyBand": 9,
                      "supportedSulBands": [
                        9
                      ]
                    }
                  ]
                },
                "dlFreqInfo": {
                  "nrArFcn": "100",
                  "frequencyBands": [
                    {
                      "nrFrequencyBand": 9,
                      "supportedSulBands": [
                        9
                      ]
                    }
                  ]
                },
                "ulTransmissionBandwidth": {
                  "nrscs": "SCS15",
                  "ncnrb": "NRB11"
                },
                "dlTransmissionBandwidth": {
                  "nrscs": "SCS15",
                  "ncnrb": "NRB11"
                }
              }
            },
            "configuredStac": "string",
            "nrPci": 300,
            "nrMode": "FDD",
            "stac5g": "string"
          }
        ]
      }
    ]
}

Response Data Details

In case 200 OK, the payload is identical to Get NodeB <RAN Name>.

...

POST http://<serverBaseURL>/v#/nodeb/<ranName>/enb

Request Data Details

#

Parameter

Location

Data Type

Required?

Value Rules

1acceptHeaderString

YES

Refer to Standard API Request Headers
2

content-type

Header

String

YES

Refer to Standard API Request Headers

3enbNodeBodyObjectYESPlease refer to ENB Node
4servedCellsBodyArray of ObjectYESPlease refer to Served Cells array inside the eNB Object (In the Get NodeB Response)

...

#

Parameter

Data Type

Required?

Value Rules

1

enbType

ENUM

YES


2

ranName

String

YES


3globalNbIdObjectNORefer to object globalNbId
4

ip

String

NO


5

port

Integer

NO


6

guGroupIds

Array of String

NO


Example (TBD)


Response Data Details

In case 201 CREATED, the payload is identical to Get NodeB <RAN Name>.

...

PUT http://<serverBaseURL>/v#/nodeb/<ranName>/enb

Request Data Details

#

Parameter

Location

Data Type

Required?

Value Rules

1acceptHeaderString

YES

Refer to Standard API Request Headers
2

content-type

Header

String

YES

Refer to Standard API Request Headers

3enbNodeBodyObjectYESPlease refer to ENB Node
4servedCellsBodyArray of ObjectYESPlease refer to Served Cells array inside the eNB Object (In the Get NodeB Response)

Response Data Details

In case 200 OK, the payload is identical to Get NodeB <RAN Name>.

...

DELETE http://<serverBaseURL>/v#/nodeb/<ranName>/enb

Request Data Details

#

Parameter

Location

Data Type

Required?

Value Rules

1acceptHeaderString

YES

Refer to Standard API Request Headers
2

content-type

Header

String

YES

Refer to Standard API Request Headers

3enbNodeBodyObjectYESPlease refer to ENB Node
4servedCellsBodyArray of ObjectYESPlease refer to Served Cells array inside the eNB Object (In the Get NodeB Response)

Response Data Details

In case success -  204 No Content

...

Code Block
languagejava
themeConfluence
PUT http://<serverBaseURL>/v#/nodeb/shutdown

Request Data Details

Listed below are the key elements included in the request.

...

Code Block
languagejava
themeConfluence
PUT http://localhost:3800/v1/nodeb/shutdown
accept: application/json  

Response Data Details

There is no Body in case 204 No Content, and with 202 Accepted with error details in case failure such as Routing Manager (511)

...

GET http://<serverBaseURL>/v#/nodeb/states

Request Data Details

Listed below are the key elements included in the request.

...

GET http://localhost:3800/v1/nodeb/states
accept: application/json

Response Data Details

In case 200 OK, this is the payload

...

GET http://<serverBaseURL>/v#/nodeb/states/<ran name>

Request Data Details

Listed below are the key elements included in the request.

...

GET http://localhost:3800/v1/nodeb/states/<ran name>
accept: application/json

Response Data Details

In case 200 OK, this is the payload

...

PUT http://<serverBaseURL>/v#/nodeb/health

Request Data Details

Listed below are the key elements included in the request.

...

PUT http://localhost:3800/v1/nodeb/health
 
accept: application/json

Response Data Details

202 Accepted or error.


11. Get All E2T Request 

...

GET http://<serverBaseURL>/v#/e2t/list

Request Data Details

Listed below are the key elements included in the request.

...

GET http://localhost:3800/v1/e2t/list 
accept: application/json


Response Data Details

In case 200 OK, this is the payload

...

PUT http://<serverBaseURL>/v#/nodeb/parameters

Request Data Details

Listed below are the key elements included in the request.

...

PUT http://localhost:3800/v1/nodeb/parameters
 accept: application/json

{

  "enableRic": true,

}


Response Data Details

200 OK with the list of All parameters or error