Versions Compared

Key

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

...

The picture below shows a high level architecture of the N-ENG micro-service.


Interface Details

This interface has two different types of operations:

  • assign/generate request to generate names
  • unassign/delete/release request to release a name from the network

Assign/Generate Operation

This is an HTTP POST operation.

Here is a sample request:

{ 
"elements": [
    {
      "external-key": "VRZQWUKKMAAZZ",
      "policy-instance-name": "JQIN1806SRIOV.Config_MS_1806SRIOV_VPE_AVPN_MoWJson.6.xml",
      "COMPLEX": "TRLAKDG",
      "NF-NAMING-CODE": "ESP",
      "CLOUD_REGION_ID": "A1235Z",
      "NF_CODE": "BMNO",
      "resource-name": "vnf-name",
      "naming-type": "VNF"
    } 
]
}

The request contains an array of 'elements', each item of which contains the data to generate a name,

Each item of the 'elements' array has these required fields:

  • external-key – This is the ID/key the caller/client uses to identify a name.
  • policy-instance-name – This is the name of the policy used for name generation.
  • resource-name – The name of the resource to be generated.
  • naming-type – The naming type as defined in the policy.

The request can also have any additional fields (as name-value pairs) that are needed for name generation, as defined by the policy. If the policy specifies that a field is needed, and if the client/caller doesn't pass such a field, the generation will fail. The fields in the sample above that have upper-case names are examples of such fields.

Here is a sample response:

{
  "elements": [
    {
      "resource-value": "trlakdg014esp",
      "resource-name": "vnf-name",
      "external-key": "VRZQWUKKMAAZZ"
    }
  ]
}


The response contains a similar array of 'elements', corresponding to the array in the request. Each array element will have the following fields:

  • external-key – This is the ID/key the caller/client uses to identify a name.
  • resource-name – The name of the type of the resource generated.
  • resource-value – The generated resource name value.

Unassign/Delete/Release Operation

This is an HTTP DELETE operation.

Here is a sample request:

{ 
"elements": [
    {
      "external-key": "VRZQWUKKMAAZZ"
        }
  ]
}

The request contains an array of 'elements', each item of which contains the external key that was used to generate the name.

Here is a sample response:

{
  "elements": [
    {
      "resource-value": "trlakdg014esp",
      "resource-name": "vnf-name",
      "external-key": "VRZQWUKKMAAZZ"
    }
  ]
}


The response contains a similar array of 'elements', corresponding to the array in the request. Each array element will have the following fields:

  • external-key – This is the ID/key the caller/client uses to identify a name.
  • resource-name – The name of the type of the resource deleted.
  • resource-value – The deleted resource name value.

Contacts

 Yuriy Malakov, Jiejenny Qin and Biju Thomas