Table of Contents

maxLevel	2

1. Select NST API

...

Interface Definition

...

Description

...

Content-Type

...

application/json

...

Operation Type

...

POST

...

URI

...

https://{host}:{port}/api/oof/v1/selection/nst

NOTE

This page is only for understanding. Please refer swagger for a comprehensive documentation.

swagger link : https://gerrit.onap.org/r/gitweb?p=optf/osdf.git;a=blob;f=docs/sections/swaggerdoc/oof-osdf-has-api.json;h=7289ef4a24de6f6ad728d91554dc7b0394681b27;hb=HEAD

SAMPLE API

SAMPLE NSI API ( preferReuse : true )

Code Block

language	powershell
theme	RDark
title	Sample NSI API Request
collapse	true

{
   "serviceProfile":{
      "blob":"content"
   },
   "requestInfo":{
      "transactionId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
      "requestId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
      "callbackUrl":"myDomain.com/myCallback",
      "callbackHeader":{
         "blob":"content"
      },
      "sourceId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
      "timeout":5,
      "numSolutions":1
   },
   "NSTInfo":{
      "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa1",
      "invariantUUID":"7ua85f64-5717-4562-b3fc-2c963f66afa6",
      "name":"embb-nst"
   },
   "NSSTInfo":[
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa2",
         "invariantUUID":"2fa85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-an-nf"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa3",
         "invariantUUID":"4fa85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-cn"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa4",
         "invariantUUID":"5ta85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-tn-fh"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa5",
         "invariantUUID":"6ya85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-tn-mh"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa7",
         "invariantUUID":"7ua85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-tn-bh"
      }
   ],
   "preferReuse":true,
   "subnetCapabilities":[
      {
         "domainType":"AN-NF",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"CN",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"TN-FH",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"TN-MH",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"TN-BH",
         "capabilityDetails":{
            "blob":"content"
         }
      }
   ]
}

Code Block

language	yml
theme	RDark
title	Sample NSI API Response
collapse	true

{
  "transactionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "requestId": "f450f1ee-6c54-4b01-90e6-d701748f0851",
  "requestStatus": "completed",
  "solutions": [
    {
      "existingNSI": true,
      "sharedNSISolution": {
        "invariantUUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "UUID": "e4t85f64-5717-4562-b3fc-2c963f66afa6",
        "NSIName": "embb-ser",
        "NSIId": "t5y85f64-5717-4562-b3fc-2c963f66afa6",
        "matchLevel": {
		    "key":"value"
		}
      }
    }
  ]
}

SAMPLE NSI API ( preferReuse : false )

Code Block

language	yml
theme	RDark
title	Sample NSI API Request
collapse	true

{
   "serviceProfile":{
      "blob":"content"
   },
   "requestInfo":{
      "transactionId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
      "requestId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
      "callbackUrl":"myDomain.com/myCallback",
      "callbackHeader":{
         "blob":"content"
      },
      "sourceId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
      "timeout":5,
      "numSolutions":1
   },
   "NSTInfo":{
      "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa1",
      "invariantUUID":"7ua85f64-5717-4562-b3fc-2c963f66afa6",
      "name":"embb-nst"
   },
   "NSSTInfo":[
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa2",
         "invariantUUID":"2fa85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-an-nf"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa3",
         "invariantUUID":"4fa85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-cn"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa4",
         "invariantUUID":"5ta85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-tn-fh"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa5",
         "invariantUUID":"6ya85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-tn-mh"
      },
      {
         "UUID":"3fa85f64-5717-4562-b3fc-2c963f66afa7",
         "invariantUUID":"7ua85f64-5717-4562-b3fc-2c963f66afa6",
         "name":"embb-tn-bh"
      }
   ],
   "preferReuse":false,
   "subnetCapabilities":[
      {
         "domainType":"AN-NF",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"CN",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"TN-FH",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"TN-MH",
         "capabilityDetails":{
            "blob":"content"
         }
      },
      {
         "domainType":"TN-BH",
         "capabilityDetails":{
            "blob":"content"
         }
      }
   ]
}

Code Block

language	yml
theme	RDark
title	Sample NSI API Response
collapse	true

{
  "transactionId": "s4r0f1ee-6c54-4b01-90e6-d701748f0851",
  "requestId": "r500f1ee-6c54-4b01-90e6-d701748f0851",
  "requestStatus": "completed",
  "solutions": [
    {
      "existingNSI": false,
      "newNSISolution": {
        "sliceProfiles": [
	      	{
         		"domainType":"AN-NF"     		
      		},
      		{
         		"domainType":"CN"
     	 	},
      		{
         		"domainType":"TN-FH"       
      		},
      		{
         		"domainType":"TN-MH"    
      		},
      		{
         		"domainType":"TN-BH" 
      		}
        ],
        "matchLevel": {
            "blob": "content"
          }
      }
    }
  ]
}

SAMPLE NSSI API

Code Block

language	yml
theme	RDark
title	Sample NSSI API Request
collapse	true

{
  "sliceProfile": {
    "blob": "content"
  },
  "requestInfo": {
    "transactionId": "t670f1ee-6c54-4b01-90e6-d701748f0851",
    "requestId": "r450f1ee-6c54-4b01-90e6-d701748f0851",
    "callbackUrl": "myDomain.com/myCallback",
    "callbackHeader": {
      "blob": "content"
    },
    "sourceId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "timeout": 5,
    "numSolutions": 1,
    "addtnlArgs": {
      "blob": "content"
    }
  },
  "NSSTInfo": {
    "UUID": "y7785f64-5717-4562-b3fc-2c963f66afa6",
    "invariantUUID": "9fh85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "embb-cn"
  }
}

Code Block

language	yml
theme	RDark
title	Sample NSSI API Response
collapse	true

{
  "transactionId": "c440f1ee-6c54-4b01-90e6-d701748f0851",
  "requestId": "88u0f1ee-6c54-4b01-90e6-d701748f0851",
  "requestStatus": "completed",
  "solutions": [
    {
      "invariantUUID": "y7685f64-5717-4562-b3fc-2c963f66afa6",
      "UUID": "8u785f64-5717-4562-b3fc-2c963f66afa6",
      "NSSIName": "embb-core-ser",
      "NSSIId": "f4485f64-5717-4562-b3fc-2c963f66afa6",
      "matchLevel": {
			"blob":"content"
	   }
    }
  ]
}

Sample NxI API(NSI Termination)

Code Block

language	yml
theme	RDark
title	Sample NxI API Request
collapse	true

{
  "requestInfo": {
    "transactionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "requestId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "callbackUrl": "http://0.0.0.0:9000/osdfCallback/",
    "sourceId": "SO",
    "timeout": 5,
    "addtnlArgs": {
      "serviceProfileId":"cdad9f49-4201-4e3a-aac1-b0f27902c299"
    }
  },
  "type":"NSI",
  "NxIId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
  "UUID":"d290f1ee-6c54-4b01-90e6-d701748f0851",
  "invariantUUID":"d290f1ee-6c54-4b01-90e6-d701748f0851"

}

Code Block

language	yml
theme	RDark
title	Sample NxI API Response
collapse	true

{
  "requestId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "transactionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "requestStatus": "success",
  "terminateResponse": true,
  "reason": ""
}

Sample NxI API(NSSI Termination)

Code Block

language	yml
theme	RDark
title	Sample NxI API Request
collapse	true

{
  "requestInfo": {
    "transactionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "requestId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "callbackUrl": "http://0.0.0.0:9000/osdfCallback/",
    "sourceId": "SO",
    "timeout": 5,
    "addtnlArgs": {
      "serviceInstanceId":"4115d3c8-dd59-45d6-b09d-e756dee9b518"
    }
  },
  "type":"NSSI",
  "NxIId":"d290f1ee-6c54-4b01-90e6-d701748f0851",
  "UUID":"d290f1ee-6c54-4b01-90e6-d701748f0851",
  "invariantUUID":"d290f1ee-6c54-4b01-90e6-d701748f0851"

}

Code Block

language	yml
theme	RDark
title	Sample NxI API Response
collapse	true

{
  "requestId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "transactionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "requestStatus": "success",
  "terminateResponse": true,
  "reason": ""
}

1. Select NST API

Interface Definition	Description
Content-Type	application/json
Operation Type	POST
URI	https://{host}:{port}/api/oof/selection/nst/v1

1.1. Request Header

Header	Required	Description
Accept	N	Determines the format of the body of the response. Valid value is “application/json”
Authorization	Y	Supplies Basic Authentication credentials for the request

1.1. Request Header

Header	Required	Description
Accept	N	Determines the format of the body of the response. Valid value is “application/json”
Authorization	Y	Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.
Content-Length	N	Number of bytes in the body of the request. Note that content length is limited to 1 MB.
Content-Type	Y	Determines the format of the request content. Only application/json is supported.

...

The content of the requestInfo Object

Attribute	Required?	Cardinality	Content	Values	Description
serviceProfile	Y	1	serviceProfile Object	The content of the serviceProfile Object	requestInfo	Y	1	requestInfo Object

serviceProfile

...

Attribute

Required?

Cardinality

Content

Values

serviceProfileParameters

Description

Y

1

JSON BLOB

A JSON object containing service profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and

will be in the form of attribute value pairs.

will be in the form of attribute value pairs.
requestInfo	Y	1	requestInfo Object		The content of the requestInfo Object

RequestInfo Object

Attribute	Required?	Cardinality	Content	Description
transactionId	Y	1	UUID/String	A unique ID to track an ONAP transaction.
requestId	Y	1	UUID/String	A unique ID to track multiple requests associated with a transaction.
callbackUrl	Y	1	URL	The end point of a callback service where recommendations are posted.
callbackHeader	Y	1	JSON blob	The header information a client expecting in a async callback.
sourceId	Y	1	String	The unique ID of a client making an optimization call.
numSolutions	Y	1	Integer	Expected number of solutions. numSolution can also be specified using an optimization query policies, where the default configured value is 1. The value from a request gets higher precedence over the value defined in a policy.
timeout	N	1	Integer

...

1.5. Asynchronous Response Body

Attribute

Required?

Cardinality

Content

Values

Description

NSTsolutions

Attribute	Required?	Cardinality	Content	Values	Description
requestId	Y	1	UUID/String		A unique Id for an ONAP transaction.
transactionId	Y	1	UUID/String		A unique ID to track multiple requests associated with a transaction.
statusMessage	N	1	String		Reasoning if requestStatus is failed.
requestStatus	Y	1	String	completed, failed, pending	The status of a request.
solutions	Y	1	Solution Object	Solutions related to a request.

Solution Object

Y

1

..N

List of NSTSolution Object

A list of matching NSTs

NSTSolution Object

Attribute	Required?	Cardinality	Content	Description
invariantUUID	Y	1	UUID/String	Invariant UUID
UUID	Y	1	UUID/String	UUID of NST
NSTName	Y	1	String	Name of NST
matchLevel	Y	1	JSON BLOB	Details of match of requirements in service profile

...

Interface Definition	Description
Content-Type	application/json
Operation Type	POST
URI	https://{host}:{port}/api/oof/v1/selection/nsi/v1

2.1. Request Header

Header	Required	Description
Accept	N	Determines the format of the body of the response. Valid value is “application/json”
Authorization	Y	Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.
Content-Length	N	Number of bytes in the body of the request. Note that content length is limited to 1 MB.
Content-Type	Y	Determines the format of the request content. Only application/json is supported.

...

Attribute	Required?	Cardinality	Content	Values	Description
serviceProfile	Y	1	serviceProfile Object		JSON Blob		A JSON object containing service profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.The content of the serviceProfile Object
NSTInfo	Y	1	nstInfo Object		The content of nstInfo Object
NSSTInfoListNSSTInfo	Y	1..N	list of nsstInfo Object		All the constituent NSSTs of the NST
subnetCapabilityListsubnetCapabilities	Y	1..N	subnetCapabilityObject	Subnet capabilities	list of subnetCapability Object		Subnet capabilities
preferReuse	N	1	Boolean	solutionPref	Y	1	Integer	0-100	Preference for new or existing NSI solutions. 0 indicates preference only for existing NSI solutions, and 100 indicates preference only for new solutions, If both should be provided (subject to the rank), a value between 1-99 should be given.
requestInfo	Y	1	requestInfo Object		The content of the requestInfo Object

...

Attribute	Required?	Cardinality	Content	Values	Description
domainType	Y	1	String	AN/TN-FH/TN-MH/TN-BH/CN		Sub-net type
capabilityDetails	Y	1	JSON BLOB		A JSON object containing capability parameters

...

Attribute	Required?	Cardinality	Content	Description
UUID	Y	1	UUID/String	UUID of NST
invariantUUID	Y	1	UUID/String	Invariant UUID
name	Y	1	string	name of the NST model

nsstInfo Object

Attribute	Required?	Cardinality	Content	Description
UUID	Y	1	UUID/String	UUID of NSST
invariantUUID	Y	1	UUID/String	Invariant UUID
name	Y	1	string	name of the NSST model

RequestInfo Object

Attribute	Required?	Cardinality	Content	Description
transactionId	Y	1	UUID/String	A unique ID to track an ONAP transaction.
requestId	Y	1	UUID/String	A unique ID to track multiple requests associated with a transaction.
callbackUrl	Y	1	URL	The end point of a callback service where recommendations are posted.
callbackHeader	Y	1	JSON blob	The header information a client expecting in a async callback.
sourceId	Y	1	String	The unique ID of a client making an optimization call.
numSolutions	Y	1	Integer	Expected number of solutions. numSolution can also be specified using an optimization query policies, where the default configured value is 1. The value from a request gets higher precedence over the value defined in a policy.
timeout	N	1	Integer	A tolerance window (in secs) for expecting solutions. Default is 600 secs.
addtnlArgs	N	1	JSON BLOB	Any additional parameters that have to be considered for NSI selection

...

Attribute	Required?	Cardinality	Content	Values	Description
requestId	Y	1	UUID/String		A unique Id for an ONAP transaction.
transactionId	Y	1	UUID/String		A unique ID to track multiple requests associated with a transaction.
statusMessage	N	1	String		Reasoning if requestStatus is failed.
requestStatus	Y	1	String	completed, failed, pending	The status of a request.
solutions	Y	10..N	List of Solution Object		Solutions related to a request.

Solution Object

Attribute	Required?	Cardinality	Content	Values	Description
existingNSI	Y	1	Boolean	True/False		True/False	true if sharedNSISolution is present, false if newNSISolution is present
sharedNSISolution	sharedNSIsolution	N	1	sharedNSISolution Object		A list of matching NSIs from existing NSIsNSIs
newNSISolution	N	1	newNSISolution Object		Details of the constituents of the new NSIs that can be instantiated to meet the request

sharedNSISolution Object

Attribute	Required?	Cardinality	Content	Description
invariantUUID	Y	1	UUID/String	Invariant UUID
UUID	Y	1	UUID/String	UUID of NSI
NSIName	Y	1	String	Name of NSI
NSIId	Y	1	String	Id of NSI
matchLevel	Y	1	JSON BLOB	Details of match of requirements in service profile, and recommendation rank (future enhancement, based on telemetry, capacity, etc.)

...

Attribute

Required?

Cardinality

Content

Values

Description

SliceProfileListSliceProfiles

Y

1..N

JSON BLOB

List of SliceProfile objects

List of JSON objects A JSON object containing slice profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.

Assumption: Slice profile contains sub-net type. If not, this should also be included.

matchLevel

Y

1

JSON BLOB

Details of match of requirements in service profile, and recommendation rank (future enhancement, based on telemetry, capacity, etc.)

3. Select NSSI API

Interface Definition	Description
Content-Type	application/json
Operation Type	POST
URI	https://{host}:{port}/api/oof/v1/selection/nssi/v1

3.1. Request Header

Header	Required	Description
Accept	N	Determines the format of the body of the response. Valid value is “application/json”
Authorization	Y	Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.
Content-Length	N	Number of bytes in the body of the request. Note that content length is limited to 1 MB.
Content-Type	Y	Determines the format of the request content. Only application/json is supported.

...

response is returned.
Content-Length	N	Number of bytes in the body of the request. Note that content length is limited to 1 MB.
Content-Type	Y	Determines the format of the request content. Only application/json is supported.

3.2. Request Body

Attribute	Required?	Cardinality	Content	Description
sliceProfile	Y	1	JSON Blob	A JSON object containing slice profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.
NSSTInfo	Y	1	nsstInfo Object	The content of nsstInfo Object
requestInfo	Y	1	requestInfo Object	The content of the requestInfo Object

nsstInfo Object

Attribute	Required?	Cardinality	Content	Values	Description

sliceProfile

UUID

Y

1

sliceProfile ObjectThe content of the sliceProfile ObjectNSSTInfo

UUID/String		UUID of NSST
invariantUUID	Y	1

nsstInfo ObjectThe content of nsstInfo ObjectconstituentNSSTListN1..NnsstInfo ObjectThe details of NSSTs inside the NSST (if present)subnetCapabilityListN1..NsubnetCapabilityObjectSubnet capabilities (if NSST contains constituent NSSTs)solutionPref

UUID/String		Invariant UUID
name	Y	1	string		name of the NSST model

RequestInfo Object

Attribute	Required?	Cardinality	Content	Values	Description
transactionId	Y	1

Integer0-100Preference for new or existing NSSI solutions. 0 indicates preference only for existing NSSI solutions, and 100 indicates preference only for new solutions, If both should be provided (subject to the rank), a value between 1-99 should be given.

UUID/String		A unique ID to track an ONAP transaction.
requestId	Y	1	UUID/String	A unique ID to track multiple requests associated with a transaction.
callbackUrl

requestInfo

Y

1

requestInfo Object

URL

The

content of the requestInfo Object

sliceProfile Object

...

Attribute

...

Required?

...

Cardinality

...

Content

...

Values

...

Description

...

sliceProfileParameters

...

Y

...

1

...

JSON BLOB

...

A JSON object containing slice profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.

end point of a callback service where recommendations are posted.
callbackHeader	N	1	JSON blob	The header information a client expecting in a async callback.
sourceId	Y	1	String	The unique ID of a client making an optimization call.
numSolutions	Y	1	Integer	Expected number of solutions. numSolutions can also be specified using an optimization query policies, where the default configured value is 1. The value from a request gets higher precedence over the value defined in a policy.
timeout	N	1	Integer	A tolerance window (in secs) for expecting solutions. Default is 600 secs.
addtnlArgs	N	1	JSON BLOB	Any additional parameters that have to be considered for NSSI selection

3.3. Synchronous Response Body

nsstInfo Object

...

Attribute

...

Required?

...

Cardinality

...

Content

...

Values

...

Description

...

UUID

...

Y

...

1

...

UUID/String

...

UUID of NSST

...

Attribute
Required?
Cardinality
Content
Values
Description
transactionId
requestId
Y
1
UUID/String

A unique
ID to track
Id for an ONAP transaction.
requestId
transactionId
Y
1
UUID/String

A unique ID to track multiple requests associated with a transaction.
callbackUrl
statusMessage
Y
N
1
URL
The end point of a callback service where recommendations are posted.
callbackHeaderN1JSON blobThe header information a client expecting in a async callback.
sourceId
Y
1
String
The unique ID of a client making an optimization call.
numSolutionsY1IntegerExpected number of solutions. numSolutions can also be specified using an optimization query policies, where the default configured value is 1. The value from a request gets higher precedence over the value defined in a policy.
timeout
N
1
Integer
A tolerance window (in secs) for expecting solutions. Default is 600 secs.
addtnlArgsN1JSON BLOBAny additional parameters that have to be considered for NSSI selection
...
String

Reasoning if a requestStatus is failed.
requestStatus
Y
1
String
accepted, failed
The status of a request.

3.4. Asynchronous Response Header

Header Name	Required?	Description
Accept	N	Determines the format of the body of the response. Valid value is “application/json”
Authorization	Y	Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.
Content-Type	Y	Determines the format of the request content. Only application/json is supported.
Attribute	N	Attribute and respective value that a client has sent in the callbackHeader field of a request.
Content-Length	N	Number of bytes in the body of the request. Note that content length is limited to 1 MB.

3.5. Asynchronous Response Body

Attribute	Required?	Cardinality	Content	Description
requestId	Y	1	UUID/String	A unique Id for an ONAP transaction.
transactionId	Y	1	UUID/String	A unique ID to track multiple requests associated with a transaction.
statusMessage	N	1	String	Reasoning if

a

requestStatus is failed.
requestStatus	Y	1	String

accepted

completed, failed

, pending	The status of a request.
solutions	Y	0..N	List of sharedNSSISolution Objects		Solutions related to

The status of

a request.

3.4. Asynchronous Response Header

sharedNSSISolution Object

Attribute

Header Name

	Required?

Description

Cardinality

Accept

Content

N

Determines the format of the body of the response. Valid value is “application/json”

Authorization

Y

Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.

Content-Type

Y

Determines the format of the request content. Only application/json is supported.

AttributeNAttribute and respective value that a client has sent in the callbackHeader field of a request.

Content-Length

N

Number of bytes in the body of the request. Note that content length is limited to 1 MB.

3.5. Asynchronous Response Body

...

Attribute

...

Required?

...

Cardinality

...

Content

...

Values

...

Description

...

requestId

...

Y

...

1

...

UUID/String

...

A unique Id for an ONAP transaction.

...

transactionId

...

Y

...

1

...

UUID/String

...

A unique ID to track multiple requests associated with a transaction.

...

statusMessage

...

N

...

1

...

String

...

Reasoning if requestStatus is failed.

...

requestStatus

...

Y

...

1

...

String

...

completed, failed, pending

...

The status of a request.

Values	Description
invariantUUID	Y	1	UUID/String	Invariant UUID
UUID	Y	1	UUID/String	UUID of NSSI
NSSIName	Y	1	String	Name of NSSI
NSSIId	Y	1	String	Id of NSSI
matchLevel	Y	1	JSON BLOB	Details of match of requirements in service profile, and recommendation rank (future enhancement, based on telemetry, capacity, etc.)

4. Terminate NxI (x=S, SS)

Interface Definition	Description
Content-Type	application/json
Operation Type	POST
URI	https://{host}:{port}/api/oof/terminate/nxi/v1

4.1. Request Header

Header	Required	Description
Accept	N	Determines the format of the body of the response. Valid value is “application/json”
Authorization	Y	Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.
Content-Length	N	Number of bytes in the body of the request. Note that content length is limited to 1 MB.
Content-Type	Y	Determines the format of the request content. Only application/json is supported.

4.2. Request Body

...

NSSIsolutions

...

Y

...

1..N

...

List of NSSISolution Objects

...

Solutions related to a request.

NSSISolution Object

Attribute	Required?	Cardinality	Content

Values

Description

existingNSSIY1BooleanTrue/FalseNote: In case of Core and Transport, if no existing NSSI matches, this field will be "false", and no other info will be present. From this, NSSMF has to infer that a new NSSI has to be created, for which it shall invoke the appropriate procedures.

sharedNSSIsolution

N

1

sharedNSSISolution Object

A list of matching NSSIs from existing NSSIs

newNSSISolutionN1newNSSISolution ObjectDetails of the constituents of the new NSSIs that can be instantiated to meet the request. This shall be returned only in the case of RAN NSSI selection for deployment option 1.

...

	Values	Description
type	Y	1	String	NSI, NSSI
invariantUUID	N	1	UUID/String		Invariant UUID
UUID	N	1	UUID/String		UUID of NSI/NSSI
NxIId	Y	1	String		Id of NSI/NSSI
requestInfo	Y	1	requestInfo Object		The content of the requestInfo Object

RequestInfo Object

Attribute	Required?	Cardinality	Content	Values	Description

invariantUUID

transactionId

Y

1

UUID/String

Invariant UUID

UUID

Y

1

UUID/String

UUID of NSSI

NSSIName

	A unique ID to track an ONAP transaction.
requestId	Y	1	UUID/String

Name of NSSINSSIId

	A unique ID to track multiple requests associated with a transaction.
callbackUrl	N

Y

1

String

URL

Id of NSSImatchLevel

	The end point of a callback service where recommendations are posted.
callbackHeader	N

Y

1

JSON

BLOBDetails of match of requirements in service profile, and recommendation rank (future enhancement, based on telemetry, capacity, etc.)

newNSSISolution Object

...

Attribute

...

Required?

...

Cardinality

...

Content

...

Values

...

Description

...

A JSON object containing slice profile parameters of the constituents. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.

Assumption: Slice profile contains sub-net type. If not, this should also be included.

blob		The header information a client expecting in a async callback.
sourceId	Y	1	String	The unique ID of a client making an optimization call.
timeout	N	1	Integer	A tolerance window (in secs) for expecting solutions. Default is 600 secs.
addtnlArgs	N	1	JSON BLOB	Any additional parameters that have to be considered for NSSI selection

4.3. Synchronous Response Body

Attribute	Required?	Cardinality	Content	Values	Description
requestId	Y	1	UUID/String		A unique Id for an ONAP transaction.
transactionId	Y	1	UUID/String		A unique ID to track multiple requests associated with a transaction.
statusMessage	N	1	String		Reasoning if a requestStatus is failed.
requestStatus	Y	1	String	accepted, failed	The status of a request.
terminateResponse	Y	1	Boolean
reason	N	1	String		Reason if false is sent (example, "Restricted by Policy")

5.

...

4. Terminate NxI (x=S, SS)

...

Interface Definition

...

Description

...

Content-Type

...

application/json

...

Operation Type

...

POST

...

URI

...

https://{host}:{port}/api/oof/v1/terminate/nxi

4.1. Request Header

...

Header

...

Required

...

Description

...

Accept

...

N

...

Determines the format of the body of the response. Valid value is “application/json”

...

Authorization

...

Y

...

Supplies Basic Authentication credentials for the request. If the Authorization header is missing, then an HTTP 400 Invalid Request response is returned. If the string supplied is invalid, then an HTTP 401 Unauthorized response is returned.

...

Content-Length

...

N

...

Number of bytes in the body of the request. Note that content length is limited to 1 MB.

...

Content-Type

...

Y

...

Determines the format of the request content. Only application/json is supported.

HTTP Response Code

HTTP Code	Response Phrase	Description
201	Created	An optimization solution is found.
202	Accepted	An optimization request is accepted.
400	Bad request	Bad request.
401	Unauthorized	Request body is not compliant with the API definition.
404	Not found	The server cannot find the requested URI.
405	Method not found	The requested method is not supported by a server.
500	Internal server error	The server encountered an internal server error or timed out.
520	Solver error	Requested number of solutions cannot be found.

...

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 11

New Version Current

Key

1. Select NST API

NOTE

SAMPLE API

SAMPLE NSI API ( preferReuse : true )

SAMPLE NSI API ( preferReuse : false )

SAMPLE NSSI API

Sample NxI API(NSI Termination)

Sample NxI API(NSSI Termination)

1. Select NST API

1.1. Request Header

1.1. Request Header

RequestInfo Object

1.5. Asynchronous Response Body

Solution Object

2.1. Request Header

nsstInfo Object

RequestInfo Object

Solution Object

sharedNSISolution Object

3. Select NSSI API

3.1. Request Header

3.2. Request Body

nsstInfo Object

RequestInfo Object

sliceProfile Object

3.3. Synchronous Response Body

nsstInfo Object

3.4. Asynchronous Response Header

3.5. Asynchronous Response Body

3.4. Asynchronous Response Header

sharedNSSISolution Object

3.5. Asynchronous Response Body

4. Terminate NxI (x=S, SS)

4.1. Request Header

4.2. Request Body

NSSISolution Object

RequestInfo Object

newNSSISolution Object

4.3. Synchronous Response Body

5.

4. Terminate NxI (x=S, SS)

4.1. Request Header

HTTP Response Code