AAICustomQueries.pdf

Casablanca API Doc (HTML) | Swagger API (YAML)

AAI v14 REST API Doc

Released version 1.3.3:

OXM files: https://gerrit.onap.org/r/gitweb?p=aai/aai-common.git;a=tree;f=aai-schema/src/main/resources/onap/oxm

XSD files: https://gerrit.onap.org/r/gitweb?p=aai/aai-common.git;a=tree;f=aai-schema/src/main/resources/onap/aai_schema


Casablanca supports v11, v12, v13, and v14 of the API. v14 is the preferred version.

Attachments

  File Modified
PDF File AAICustomQueries.pdf Sep 12, 2018 by James Forsyth
HTML File aai_v14.html Sep 27, 2018 by James Forsyth
File aai_swagger_v14.yaml Nov 07, 2018 by James Forsyth
HTML File aai_swagger_v14.html Nov 07, 2018 by James Forsyth

2 Comments

  1. There appears to be a mismatch between the REST documentation and what is actually returned from AAI, for example:

    The generic-vnf object contains

    relationship-list:
      type: array
        items:
          $ref: "#/definitions/relationship"

    which indicates the relationship-list is an array, however when I make a call to /aai/v14/network/generic-vnfs/generic-vnf/<vnfId>/ the relationship-list in the returned generic-vnf is a json object rather than an array

    Is this a fault in the documentation or the implementation? or am I reading this wrong?

    {
        "vnf-id": "c617497e-53d9-4fe1-a3f1-572501881a7a",
        "vnf-name": "SimpleServiceAlaCarte010",
        "vnf-type": "SimpleServiceAlaCarte/SimpleServiceVSP 0",
        "service-id": "34131fa7-6d37-466c-9e93-971f76c071d1",
        "prov-status": "PREPROV",
        "orchestration-status": "Created",
        "in-maint": false,
        "is-closed-loop-disabled": false,
        "resource-version": "1543488843765",
        "model-invariant-id": "1cd6c63b-0277-4d18-813e-6d85d3735472",
        "model-version-id": "28619bc5-889e-4427-87ce-d952c063b7aa",
        "model-customization-id": "1cf7c5a6-c202-4b8d-adb7-fc341c7eb4a7",
        "nf-type": "UserDefinedNfType",
        "nf-function": "UserDefinedNfFunction",
        "nf-role": "UserDefinedNfRole",
        "nf-naming-code": "UserDefinedNfCode",
        "relationship-list": {                                         ←  note "{" rather than "["
             "relationship": [
                {
                     "related-to": "service-instance",
                     "relationship-label": "org.onap.relationships.inventory.ComposedOf",
                     "related-link": "/aai/v14/business/customers/customer/Demonstration/service-subscriptions/service-subscription/vCPE/service-instances/service-instance/84003b26-6b76-4c75-b805-7b14ab4ffaef",
                     "relationship-data": [
                         {
                             "relationship-key": "customer.global-customer-id",
                             "relationship-value": "Demonstration"
                         },
                         {
                             "relationship-key": "service-subscription.service-type",
                             "relationship-value": "vCPE"
                         },
                         {
                             "relationship-key": "service-instance.service-instance-id",
                             "relationship-value": "84003b26-6b76-4c75-b805-7b14ab4ffaef"
                          }
                     ],
                     "related-to-property": [
                         {
                             "property-key": "service-instance.service-instance-name",
                             "property-value": "NewFlow"
                          }
                     ]
               },
               {
                     "related-to": "platform",
                     "relationship-label": "org.onap.relationships.inventory.Uses",
                     "related-link": "/aai/v14/business/platforms/platform/PLATFORM_APP_ID_1",
                     "relationship-data": [
                         {
                             "relationship-key": "platform.platform-name",
                              "relationship-value": "PLATFORM_APP_ID_1"
                         }
                     ]
               }
           ]
        }
    }


    1. Hi Michael Morris,

      You may be onto something here, so I raised  AAI-2001 - Getting issue details... STATUS  to investigate and fix.

      Keong