...
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. |
Content-Length | N | Number of bytes in the body of the request. Note that content length is limited to 1 MB. |
Request Body
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
requestInfo | MY | 1 | RequestInfo Object | The content of the RequestInfo object. | |
placementInfo | MY | 1 | PlacementInfo Object | The Content of the PlacementInfo object. | |
licenseInfo | MN | 1 | LicenseInfo Object | The Content of the LicenseInfo object. | |
serviceInfo | MY | 1 | ServiceInfo Object | The Content of the ServiceInfo object. |
RequestInfo Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
transactionId | MY | 1 | UUID/String | A unique ID to track an ONAP transaction. | |
requestId | MY | 1 | UUID/String | A unique ID to track multiple requests associated with a transaction. | |
callbackUrl | MY | 1 | URL | The 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 | MY | 1 | String | The unique ID of a client making an optimization call. | |
requestType | MY | 1 | String | create, update, delete | The type of a request |
numSolutions | ON | 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. | |
optimizers | MY | 1..N | List of Strings | placement | A list of optimization services. |
timeout | MY | 1 | Integer | A tolerance window (in min) for expecting solutions. |
PlacementInfo Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
requestParameters | MY | 1 | JSON BLOB | A service ordering information. | |
placementDemands | MY | 1..N | List of PlacementDemand Object | The resource information for a placement service. |
PlacementDemand Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
resourceModuleName | MY | 1 | String | A resource name as defined in a service model. | |
serviceResourceId | MY | 1 | String | A unique resource Id with a local scope between client and OOF. | |
tenantId | ON | 1 | String | A tenant Id as defined in the ordering system. | |
resourceModelInfo | MY | 1 | ModelMetaData Object | Resource model information as defined in SDC. | |
existingCandidates | ON | 1 | Candidates Object | The existing placement information of a resource. | |
excludedCandidates | ON | 1 | Candidates Object | Candidates that need to be excluded from solutions. | |
requiredCandidates | ON | 1 | Candidates Object | Candidates that must be included in solutions. |
ModelMetaData Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
modelInvariantId | MY | 1 | String | A model invariant Id as defined in a service model. | |
modelVersionId | MY | 1 | String | A unique model Id as defined in a service model. | |
modelName | ON | 1 | String | A model name as defined in a service model. | |
modelType | ON | 1 | String | A model type as defined in a service model. | |
modelVersion | ON | 1 | String | A model version as defined in a service model. | |
modelCustomizationName | ON | 1 | String | A model customization name as defined in a service model. |
Candidates Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
identifierType | MY | 1 | String | service_instance_id, vnf_name, cloud_region_id | The type of a candidate. |
identifiers | MY | 1..N | List of Strings | A list of identifiers. |
ServiceInfo Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
serviceInstanceId | MY | 1 | String | A service instance id associated with a request. | |
serviceModelInfo | MY | 1 | ModelMetaData Object | A list of identifiers. |
LicenseInfo Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
licenseDemands | MY | 1 | List of LicenseDemands Object | A list of resources for license selection. |
LicenseDemands Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
resourceModuleName | MY | 1 | String | A resource name as defined in a service model. | |
serviceResourceId | MY | 1 | String | A unique resource Id with a local scope between client and OOF. | |
resourceModelInfo | MY | 1 | ModelMetaData Object | Resource model information as defined in a service model. | |
existingLicenses | ON | 1 | LicenseModel Object | Existing license information assigned to a resource. |
LicenseModel Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
entitlementPoolUUID | MY | 1..N | List of Strings | Entitlement pool UUIDs associated with a resource. | |
licenseKeyGroupUUID | MY | 1..N | List of Strings | License key groups associated with a resource |
Synchronous Response Body
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
requestId | MY | 1 | UUID/String | A unique Id for an ONAP transaction. | |
transactionId | MY | 1 | UUID/String | A unique ID to track multiple requests associated with a transaction. | |
statusMessage | ON | 1 | String | Reasoning if a requestStatus is failure. | |
requestStatus | MY | 1 | String | success, failure | The status of a request. |
Asynchronous Response Body
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
requestId | MY | 1 | UUID/String | A unique Id for an ONAP transaction. | |
transactionId | MY | 1 | UUID/String | A unique ID to track multiple requests associated with a transaction. | |
statusMessage | ON | 1 | String | Reasoning if requestStatus is failure. | |
requestStatus | MY | 1 | String | success, failure, pending | The status of a request. |
solutions | MY | 1 | Solution Object | Solutions related to a request. |
Solution Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
placementSolutions | MY | 1..N | List of ComprehensiveSolution Object | A list of placement solutions. | |
licenseSolutions | MY | 1 | List of LicenseSolution Object | A list of license solutions |
ComprehensiveSolution Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
- | MY | 1..N | List of PlacementSolution Object | A list of placement solutions. |
PlacementSolution Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
resourceModuleName | MY | 1 | String | The name of a resource as defined in the service model. | |
serviceResourceId | MY | 1 | String | A resource Id as defined in a service model. | |
identifierType | MY | 1 | String | service_instance_id, cloud_region_id | The type of a candidate. |
identifier | MY | 1 | String | The id of a candidate. | |
assignmentInfo | ON | 1..N | List of AssignmentInfo object | Additional information related to a candidate. |
AssignmentInfo Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
key | MY | 1 | String | An attribute name. | |
value | MY | 1 | String | An attribute value. |
LicenseSolutions Object
AttributeQualifier | Required? | Cardinality | Content | Values | Description |
---|---|---|---|---|---|
resourceModuleName | MY | 1 | String | A resource name as defined in a service. | |
serviceResourceId | MY | 1 | String | A resource Id as defined in a service. | |
entitlementPoolUUID | MY | 1..N | List of String | A list of entitlementPoolUUIDs. | |
licenseKeyGroupUUID | MY | 1..N | List of String | A list of licenseKeyGroupUUID. | |
entitlementPoolInvariantUUID | MY | 1..N | List of String | A list of entitlementPoolInvariantUUID . | |
licenseKeyGroupInvariantUUID | MY | 1..N | List of String | A list of licenseKeyGroupInvariantUUID . |
...