A La Carte mode Service Instantiation via ONAP SO API

Using ONAP SO API in “A La Carte” mode, the user needs to send a request to instantiate the service object but also for each VNF/VF-module and network that compose the Service.

ONAP will instantiate resources on Cloud platforms only when user is requesting to instantiate VF-module or Network (openstack neutron or contrail).

To instantiate a VF-module, it is required to have instantiated a VNF object.

To instantiate a VNF object, it is required to have instantiated a Service object.

To instantiate a Network object, it is required to have instantiated a Service object.

Requests

Request to instantiate Service object
Request to instantiate VNF object
Requests to instantiate VF-module object
Requests to instantiate Neutron Network object
Requests to instantiate a Contrail Network object

Request to instantiate Service object

Example to request a service instance directly to ONAP SO

curl -X POST \
  http://so.api.simpledemo.onap.org:30277/onap/so/infra/serviceInstantiation/v7/serviceInstances \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==' \
  -H 'Content-Type: application/json' \
  -H 'X-ONAP-PartnerName: NBI' \
  -H 'cache-control: no-cache' \
  -d '{
  "requestDetails": {
    "requestInfo": {
      "instanceName": "integration_test_service_instance_001",
      "source": "VID",
      "suppressRollback": false,
      "requestorId": "demo"
    },
    "modelInfo": {
      "modelType": "service",
      "modelInvariantId": "48d7ceec-7975-406c-8b96-cb3fbdbcfa33",
      "modelVersionId": "33a99ef7-b5a3-4603-b21e-790582b4567e",
      "modelName": "integration_test_service_ubuntu16",
      "modelVersion": "1.0"
    },
        "cloudConfiguration": {
            "tenantId": "dd8fce79e74a4989a6be6b6c5e55acef",
            "cloudOwner": "cloudOwner",
            "lcpCloudRegionId": "RegionOne"
        },
    "requestParameters": {
      "userParams": [],
      "testApi": "VNF_API",
      "subscriptionServiceType": "integration_test_service_ubuntu16",
      "aLaCarte": true
    },
    "subscriberInfo": {
      "globalSubscriberId": "integration_test_customer"
    },
    "project": {
      "projectName": "integration_test_project"
    },
    "owningEntity": {
      "owningEntityId": "8874891f-5120-4b98-b452-46284513958d",
      "owningEntityName": "OE-Generic"
    }
  }
}'

In the response, you will obtain the serviceOrderId value.

Then you have the possibility to check about the SO request (here after the requestId=e3ad8df6-ea0d-4384-be95-bcb7dd39bbde).

This will allow you to get the serviceOrder Status (completed, failed…)

curl -X GET \
  http://so.api.simpledemo.onap.org:30277/onap/so/infra/orchestrationRequests/v6/e3ad8df6-ea0d-4384-be95-bcb7dd39bbde \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==' \
  -H 'Content-Type: application/json' \
  -H 'X-FromAppId: AAI' \
  -H 'X-TransactionId: get_aai_subscr' \
  -H 'cache-control: no-cache'

Request to instantiate VNF object

To instantiate a VNF, you need to build an other request. All necessary parameters are available in the Tosca service template generated by SDC when you defined your service model.

curl -X POST \
  http://so.api.simpledemo.onap.org:30277/onap/so/infra/serviceInstantiation/v7/serviceInstances/7d550d9e-e1c4-4a21-a2bb-1c3ced8a8722/vnfs \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==' \
  -H 'Content-Type: application/json' \
  -H 'X-ONAP-PartnerName: NBI' \
  -H 'cache-control: no-cache' \
  -d '{
  "requestDetails": {
    "requestInfo": {
      "instanceName": "integration_test_vnf_instance_002",
      "source": "VID",
      "suppressRollback": false,
      "requestorId": "test",
    "productFamilyId": "1234"
    },
  "modelInfo": {
    "modelType": "vnf",
    "modelInvariantId": "661a34ce-6f76-4ebf-ad94-814a9fc8a2aa",
      "modelVersionId": "7e7d453c-0085-4df2-b4b5-91281ea2e710",
      "modelName": "integration_test_VF_ubuntu16_2",
      "modelVersion": "1.0",
      "modelCustomizationId": "342c14b4-8a24-46dd-a8c3-ff39dd7949e9",
      "modelCustomizationName": "integration_test_VF_ubuntu16_2 0"
    },
    "requestParameters": {
      "userParams": [],
      "aLaCarte": true,
    "testApi": "VNF_API"
    },
    "cloudConfiguration": {
      "lcpCloudRegionId": "RegionOne",
      "cloudOwner": "cloudOwner",
      "tenantId": "dd8fce79e74a4989a6be6b6c5e55acef"
    },
    "lineOfBusiness": {
      "lineOfBusinessName": "integration_test_LOB"
    },
    "platform": {
      "platformName": "integration_test_platform"
    },
    "relatedInstanceList": [{
      "relatedInstance": {
        "instanceId": "7d550d9e-e1c4-4a21-a2bb-1c3ced8a8722",
        "modelInfo": {
          "modelType": "service",
          "modelName": "integration_test_service_ubuntu16",
          "modelInvariantId": "48d7ceec-7975-406c-8b96-cb3fbdbcfa33",
          "modelVersion": "1.0",
          "modelVersionId": "33a99ef7-b5a3-4603-b21e-790582b4567e"
        }
      }
    }]
  }
}

'

Requests to instantiate VF-module object

To instantiate a VF module, you need to build two complex requests All necessary parameters are available in the Tosca service template generated by SDC when you defined your service model.

1st request is called a “SDNC-preload” for a VNF object and is used to store in SDNC some VNF parameters values that will be needed for the instantiation

curl -X POST \
  https://sdnc.api.simpledemo.onap.org:30267/restconf/operations/VNF-API:preload-vnf-topology-operation \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic YWRtaW46S3A4Yko0U1hzek0wV1hsaGFrM2VIbGNzZTJnQXc4NHZhb0dHbUp2VXkyVQ==' \
  -H 'Content-Type: application/json' \
  -H 'X-FromAppId: API client' \
  -H 'X-TransactionId: 0a3f6713-ba96-4971-a6f8-c2da85a3176e' \
  -H 'cache-control: no-cache' \
  -d '{
    "input": {
        "request-information": {
            "notification-url": "onap.org",
            "order-number": "1",
            "order-version": "1",
            "request-action": "PreloadVNFRequest",
            "request-id": "test"
        },
        "sdnc-request-header": {
            "svc-action": "reserve",
            "svc-notification-url": "http:\/\/onap.org:8080\/adapters\/rest\/SDNCNotify",
            "svc-request-id": "test"
        },
        "vnf-topology-information": {
            "vnf-assignments": {
                "availability-zones": [],
                "vnf-networks": [],
                "vnf-vms": []
            },
            "vnf-parameters": [],
            "vnf-topology-identifier": {
                "generic-vnf-name": "integration_test_vnf_instance_002",
                "generic-vnf-type": "integration_test_VF_ubuntu16_2 0",
                "service-type": "7d550d9e-e1c4-4a21-a2bb-1c3ced8a8722",
                "vnf-name": "integration_test_vfmodule_002",
                "vnf-type": "IntegrationTestVfUbuntu162..base_ubuntu16..module-0"
            }
        }
    }
}'

The 2nd request is to instantiate the VF module via ONAP SO (instance name must be identical in both requests)

curl -X POST \
  http://so.api.simpledemo.onap.org:30277/onap/so/infra/serviceInstantiation/v7/serviceInstances/7d550d9e-e1c4-4a21-a2bb-1c3ced8a8722/vnfs/9764c2af-e4b0-413d-80cd-b65014ea0926/vfModules \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==' \
  -H 'Content-Type: application/json' \
  -H 'X-ONAP-PartnerName: NBI' \
  -H 'cache-control: no-cache' \
  -d '{
  "requestDetails": {
    "requestInfo": {
      "instanceName": "integration_test_vfmodule_002",
      "source": "VID",
      "suppressRollback": false,
      "requestorId": "test"
    },
  "modelInfo": {
    "modelType": "vfModule",
    "modelInvariantId": "273bef63-1f26-4b14-91e0-003fa203ead2",
    "modelVersionId": "7cdf75de-ff3c-4a7d-a7e0-ecbc00693e8e",
    "modelName": "IntegrationTestVfUbuntu162..base_ubuntu16..module-0",
    "modelVersion": "1",
    "modelCustomizationId": "470956aa-b739-4cdd-b114-7ce032f65b18",
    "modelCustomizationName": "IntegrationTestVfUbuntu162..base_ubuntu16..module-0"
  },
  "requestParameters": {
    "userParams": [],
    "testApi": "VNF_API",
    "usePreload": true
  },
    "cloudConfiguration": {
      "lcpCloudRegionId": "RegionOne",
      "cloudOwner": "cloudOwner",
      "tenantId": "dd8fce79e74a4989a6be6b6c5e55acef"
    },
    "relatedInstanceList": [{
      "relatedInstance": {
        "instanceId": "7d550d9e-e1c4-4a21-a2bb-1c3ced8a8722",
        "modelInfo": {
          "modelType": "service",
          "modelName": "integration_test_service_ubuntu16",
          "modelInvariantId": "48d7ceec-7975-406c-8b96-cb3fbdbcfa33",
          "modelVersion": "1.0",
          "modelVersionId": "33a99ef7-b5a3-4603-b21e-790582b4567e"
        }
      }
    },
    {
      "relatedInstance": {
        "instanceId": "9764c2af-e4b0-413d-80cd-b65014ea0926",
        "modelInfo": {
          "modelType": "vnf",
          "modelName": "integration_test_VF_ubuntu16_2",
          "modelInvariantId": "661a34ce-6f76-4ebf-ad94-814a9fc8a2aa",
          "modelVersion": "1.0",
          "modelVersionId": "7e7d453c-0085-4df2-b4b5-91281ea2e710",
          "modelCustomizationId": "342c14b4-8a24-46dd-a8c3-ff39dd7949e9",
          "modelCustomizationName": "integration_test_VF_ubuntu16_2 0"
        }
      }
    }]
  }
}'

Requests to instantiate Neutron Network object

To instantiate a Neutron Network, you need to build two complex request. All necessary parameters are available in the Tosca service template generated by SDC when you defined your service model.

1st request is the “SDNC-preload” for a neutron network object:

curl -X POST \
http://sdnc.api.simpledemo.onap.org:30202/restconf/operations/VNF-API:preload-network-topology-operation \
-H 'Accept: application/json' \
-H 'Authorization: Basic YWRtaW46S3A4Yko0U1hzek0wV1hsaGFrM2VIbGNzZTJnQXc4NHZhb0dHbUp2VXkyVQ==' \
-H 'Content-Type: application/json' \
-H 'X-FromAppId: API client' \
-H 'X-TransactionId: 0a3f6713-ba96-4971-a6f8-c2da85a3176e' \
-H 'cache-control: no-cache' \
-d '{
"input": {
  "request-information": {
    "request-id": "postman001",
    "notification-url": "http://so.onap.org",
    "order-number": "postman001",
    "request-sub-action": "SUPP",
    "request-action": "PreloadNetworkRequest",
    "source": "postman",
    "order-version": "1.0"
  },
  "network-topology-information": {
    "network-policy": [],
    "route-table-reference": [],
    "vpn-bindings": [],
    "network-topology-identifier": {
      "network-role": "integration_test_net",
      "network-technology": "neutron",
      "service-type": "my-service-2",
      "network-name": "my_network_01",
      "network-type": "Generic NeutronNet"
    },
    "provider-network-information": {
      "is-external-network": "false",
      "is-provider-network": "false",
      "is-shared-network": "false"
    },
    "subnets": [
      {
    "subnet-name": "my_subnet_01",
    "subnet-role": "OAM",
        "start-address": "192.168.90.0",
        "cidr-mask": "24",
        "ip-version": "4",
        "dhcp-enabled": "Y",
    "dhcp-start-address": "",
    "dhcp-end-address": "",
        "gateway-address": "192.168.90.1",
    "host-routes":[]
      }
            ]
  },
  "sdnc-request-header": {
    "svc-action": "reserve",
    "svc-notification-url": "http://so.onap.org",
    "svc-request-id": "postman001"
  }
}
}'

2nd request is to instantiate the neutron network via ONAP SO (instance name must be identical in both requests)

curl -X POST \
http://so.api.simpledemo.onap.org:30277/onap/so/infra/serviceInstantiation/v7/95762b50-0244-4723-8fde-35f911db9263/networks \
-H 'Accept: application/json' \
-H 'Authorization: Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==' \
-H 'Content-Type: application/json' \
-H 'X-FromAppId: AAI' \
-H 'X-TransactionId: get_aai_subscr' \
-H 'cache-control: no-cache' \
-d '{
"requestDetails": {
    "requestInfo": {
        "instanceName": "my_network_01",
        "source": "VID",
        "suppressRollback": false,
        "requestorId": "demo"
    },
    "modelInfo": {
        "modelType": "network",
        "modelInvariantId": "0070b65c-48cb-4985-b4df-7c67ca99cd95",
        "modelVersionId": "4f738bed-e804-4765-8d22-07bb4d11f14b",
        "modelName": "Generic NeutronNet",
        "modelVersion": "1.0",
        "modelCustomizationId": "95534a95-dc8d-4ffb-89c7-091e2c49b55d",
        "modelCustomizationName": "Generic NeutronNet 0"
    },
  "requestParameters": {
    "userParams": [],
    "aLaCarte": true,
  "testApi": "VNF_API"
  },
  "cloudConfiguration": {
    "lcpCloudRegionId": "my_cloud_site",
    "tenantId": "5906b9b8fd9642df9ba1c9e290063439"
  },
    "lineOfBusiness": {
        "lineOfBusinessName": "Test_LOB"
    },
    "platform": {
        "platformName": "Test_platform"
    },
    "relatedInstanceList": [{
        "relatedInstance": {
            "instanceId": "95762b50-0244-4723-8fde-35f911db9263",
            "modelInfo": {
                "modelType": "service",
                "modelName": "my_service_model_name",
                "modelInvariantId": "11265d8c-2cc2-40e5-95d8-57cad81c18da",
                "modelVersion": "1.0",
                "modelVersionId": "0d463b0c-e559-4def-8d7b-df64cfbd3159"
            }
        }
    }]
  }
}'

It is then possible to get information about that network from AAI: replace {{virtual_link_UUID}} by the UUID of the virtual link

curl -X GET \
  https://aai.api.sparky.simpledemo.onap.org:30233/aai/v16/network/l3-networks/l3-network/{{virtual_link_UUID}} \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic QUFJOkFBSQ==' \
  -H 'Content-Type: application/json' \
  -H 'X-FromAppId: AAI' \
  -H 'X-TransactionId: get_aai_subscr' \
  -H 'cache-control: no-cache'

And also about subnet:

curl -X GET \
  https://aai.api.sparky.simpledemo.onap.org:30233/aai/v16/network/l3-networks/l3-network/{{virtual_link_UUID}}/subnets \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic QUFJOkFBSQ==' \
  -H 'Content-Type: application/json' \
  -H 'X-FromAppId: AAI' \
  -H 'X-TransactionId: get_aai_subscr' \
  -H 'cache-control: no-cache'

Requests to instantiate a Contrail Network object

TO BE COMPLETED