Versions Compared

Key

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

...

Code Block
titlevDNS Create Config API Call
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{

        "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevCPE\", \"description\": \"MicroService vCPE Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"Measurement_vGMUX\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ABATED\" }, { \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"GREATER\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" }] }] } } }",
        "policyConfigType": "MicroService",
        "policyName": "com.MicroServicevCPE",
        "onapName": "DCAE"
}' 'http://pdp:8081/pdp/api/createPolicy'

TODO - Get the payload from Marco Platania

Code Block
titlevDNS - Operational Policy
linenumberstrue
collapsetrue
controlLoop:
  version: 2.0.0
  controlLoopName: ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3
  trigger_policy: unique-policy-id-1-scale-up
  timeout: 1200
  abatement: false
policies:
  - id: unique-policy-id-1-scale-up
    name: Create Scalea outnew theVF VNFModule
    description:
    actor: SO
    recipe: VF Module scaleOutCreate
    target:
      type: VNF
    payload:
      # Need to get from Marco
# TODO convert to YAML
"requestParameters":{
         "userParams":[requestParameters: '{"usePreload":true,"userParams":[]}'
      configurationParameters: '[{"ip-addr":"$.vf-module-topology.vf-module-parameters.param[9]","oam-ip-addr":"$.vf-module-topology.vf-module-parameters.param[16]","enabled":"$.vf-module-topology.vf-module-parameters.param[23]"}]'
    retry: 0
    timeout: 1200
    success: final_success
    failure: final_failure
{    failure_timeout: final_failure_timeout
    failure_retries: final_failure_retries
    "name":"mmc",
failure_exception: final_failure_exception
    failure_guard: final_failure_guard
Code Block
titlevDNS Create Operational API Call
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json'  "value":"001"
            },--header 'Accept: text/html' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "policyConfigType": "BRMS_PARAM",
  {      "policyName": "com.BRMSParamvDNS",
        "namepolicyDescription": "mnc",BRMS Param      vDNS policy",
        "valuepolicyScope": "01com",
        "attributes": {
  },              "MATCHING": {
                "namecontroller" : "mme_addr",amsterdam"
            },
      "value":"vmme_private_ip_0"              },
  "RULE": {
         {                "nametemplateName":"gtp_bind_addr",
               "value":"vmme_private_ip_0"
            },
  "ClosedLoopControlName",
         {                "nameclosedLoopControlName":"n_prob",                "value":50
            },
"ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",
           {                 "namecontrolLoopYaml": "vnfHostIpAddress",
                "value": " veb_private_ip_0"
            }
         ],
         "usePreload":true
      }


    retry: 0
    timeout: 1200
    success: final_success
    failure: final_failure
    failure_timeout: final_failure_timeout
    failure_retries: final_failure_retries
    failure_exception: final_failure_exception
    failure_guard: final_failure_guard

TODO - Update the HTML escaped YAML

Code Block
titlevDNS Create Operational API Call
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/html' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "policyConfigType": "BRMS_PARAM",
        "policyName": "com.BRMSParamvDNS",controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3%0D%0A++trigger_policy%3A+unique-policy-id-1-scale-up%0D%0A++timeout%3A+1200%0D%0A++abatement%3A+false%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-scale-up%0D%0A++++name%3A+Create+a+new+VF+Module%0D%0A++++description%3A%0D%0A++++actor%3A+SO%0D%0A++++recipe%3A+VF+Module+Create%0D%0A++++target%3A%0D%0A++++++type%3A+VNF%0D%0A++++payload%3A%0D%0A++++++requestParameters%3A+%27%7B%22usePreload%22%3Atrue,%22userParams%22%3A%5B%5D%7D%27%0D%0A++++++configurationParameters%3A+%27%5B%7B%22availability-zone%22%3A%22$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone%5B0%5D%22,%22xtz-123%22%3A%22$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone%5B0%5D%22%7D%5D%27%0D%0A++++retry%3A+0%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard"
        "policyDescription": "BRMS Param vDNS policy",       }
 "policyScope": "com",      }
  "attributes": {
                "MATCHING": {
                "controller" : "amsterdam"
     }' 'http://pdp:8081/pdp/api/createPolicy'
Code Block
titlevDNS Guard - Min/Max Create API Call
collapsetrue
# PROTOTYPE - development needs to be done first

curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "policyClass": "Decision",
      },  "policyName": "com.vDNS.MinMax",
             "RULEpolicyDescription": {"Ensure number of instances within a range",
        "onapName": "PDPD",
        "templateNameruleProvider": "ClosedLoopControlNameGUARD_MIN_MAX",
        "attributes": {
                "closedLoopControlNameMATCHING": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3 {
                        "actor": "SO",
                        "recipe": "scaleOut",
                        "controlLoopYamltargets": "controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+.*",
                        "clname": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3%0D%0A++trigger_policy%3A+unique-policy-id-1-scale-up%0D%0A++timeout%3A+1200%0D%0A++abatement%3A+false%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-scale-up%0D%0A++++name%3A+Create+a+new+VF+Module%0D%0A++++description%3A%0D%0A++++actor%3A+SO%0D%0A++++recipe%3A+VF+Module+Create%0D%0A++++target%3A%0D%0A++++++type%3A+VNF%0D%0A++++retry%3A+0%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard"cc953cf779b3",
                        "min": "1",
                        "max": "5",
       }         } }' 'http://pdp:8081       "guardActiveStart": "00:00:01-05:00",
                        "guardActiveEnd": "00:00:00-05:00"
                }
        }
}' 'http://pdp:8081/pdp/api/createPolicy'


Code Block
titlevDNS Guard - Min/Max Frequency Limiter Create API Call
collapsetrue
# PROTOTYPEDRAFT - developmentthis needs to be donetested first

curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "policyClass": "Decision",
        "policyName": "com.vDNS.MinMaxFrequency",
        "policyDescription": "EnsureLimit numbervDNS ofScale instancesUp withinover atime rangeperiod",
        "ecompNameonapName": "PDPD",
        "ruleProvider": "GUARD_YAML",
        "attributes": {
                "MATCHING": {
                        "actor": "SO",
                        "recipe": "scaleOut",
                        "targets": ".*",
                        "clname": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",
                        "minlimit": "1",
                        "maxtimeWindow": "10",
                        "timeUnits": "5minute",
                        "guardActiveStart": "00:00:01-05:00",
                        "guardActiveEnd": "00:00:00-05:00"
                }
        }
}' 'http://pdp:8081/pdp/api/createPolicy'


Code Block
titlevDNS Guard - Frequency Limiter Create API CallPush Policies API call
linenumberstrue
collapsetrue
# DRAFT - this needs to be tested first
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "policyClass"pdpGroup": "Decisiondefault",
 
      "policyName": "com.vDNS.FrequencyBRMSParamvDNS",
  "policyType": "BRMS_Param"
}' 'http://pdp:8081/pdp/api/pushPolicy'


"policyDescription": "Limit vDNS Scale Up over time period",
        "ecompName": "PDPD",
        "ruleProvider": "GUARD_YAML",
        "attributes": {
                "MATCHING": {
                        "actor": "SO",
                        "recipe": "scaleOut",
                        "targets": ".*",
      
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.vDNS.MinMax",
  "policyType": "DECISION"
}' 'http://pdp:8081/pdp/api/pushPolicy'




curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.vDNS.Frequency",
  "policyType": "DECISION"
}' 'http://pdp:8081/pdp/api/pushPolicy'



curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.MicroServicevDNS",
  "policyType": "MicroService"
}' 'http://pdp:8081/pdp/api/pushPolicy'

DCAE Events and A&AI Enrichment (if necessary)

Code Block
titlevDNS - DCAE Control Loop Event (TCA) - vDNS (NOT Enriched with A&AI)
linenumberstrue
collapsetrue
{
                 "clnameclosedLoopEventClient": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",
      DCAE_INSTANCE_ID.dcae-tca",
                 "limitpolicyVersion": "1.0.0.5",
                "policyName": "vLoadBalancer",
        "timeWindow": "10",       "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop",
                "timeUnitstarget_type": "minuteVM",
                "AAI": {
                    "guardActiveStartvserver.vserver-name": "00:00:01-05:00",dfw1lb01lb01"
                },
                "guardActiveEndclosedLoopAlarmStart": "00:00:00-05:00" 1484677482204798,
                 }"closedLoopEventStatus": "ONSET",
        } }' 'http://pdp:8081/pdp/api/createPolicy'  
Code Block
titlevDNS Push Policies API call
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.BRMSParamvDNS",
  "policyType": "BRMS_Param"
}' 'http://pdp:8081/pdp/api/pushPolicy'



curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.vDNS.MinMax",
  "policyType": "DECISION"
}' 'http://pdp:8081/pdp/api/pushPolicy'




curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.vDNS.Frequency",
  "policyType": "DECISION"
}' 'http://pdp:8081/pdp/api/pushPolicy'



curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.MicroServicevDNS",
  "policyType": "MicroService"
}' 'http://pdp:8081/pdp/api/pushPolicy'

...

Code Block
titlevDNS - DCAE Control Loop Event (TCA) - vDNS (NOT Enriched with A&AI)
linenumberstrue
collapsetrue
{ "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",
                "version": "1.0.2",
                "target": "vserver.vserver-name",
                "requestID": "97964e10-686e-4790-8c45-bdfa61df770f",
                "from": "DCAE"
}
Code Block
titlevDNS - A&AI vserver query
linenumberstrue
collapsetrue
#PLD find the vserver version 


https://{aai}/aai/v11/nodes/vservers?vserver-name=dfw1lb01lb01



Code Block
titlevDNS - A&AI vserver query response
linenumberstrue
collapsetrue
{
    "vserver": [
        {
            "in-maint": false,
            "is-closed-loop-disabled": true,
            "prov-status": "ACTIVE",
            "relationship-list": {
                "relationship": [
                    {
      "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca",                 "policyVersionrelated-link": "1.0.0.5",/aai/v11/network/generic-vnfs/generic-vnf/807a3f02-f878-436b-870c-f0e91e81570d",
                        "policyNamerelated-to": "vLoadBalancergeneric-vnf",
                  "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop",      "related-to-property": [
                     "target_type": "VM",      {
          "AAI": {                     "vserver.vserverproperty-namekey": "dfw1lb01lb01"generic-vnf.vnf-name",
                },                 "closedLoopAlarmStartproperty-value": 1484677482204798,"vLoadBalancerMS-Vnf-0809-2"
                "closedLoopEventStatus": "ONSET",           }
     "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",                 "version": "1.0.2", ],
                        "targetrelationship-data": "vserver.vserver-name",[
                "requestID": "97964e10-686e-4790-8c45-bdfa61df770f",           {
     "from": "DCAE" }
Code Block
titlevDNS - A&AI vserver query
linenumberstrue
collapsetrue
#PLD find the vserver version    https://{aai}/aai/v11/nodes/vservers?vserver-name=dfw1lb01lb01    
Code Block
titlevDNS - A&AI vserver query response
linenumberstrue
collapsetrue
Code Block
titlevDNS DCAE Control Loop Event - Enriched A&AI
linenumberstrue
collapsetrue
{
                "closedLoopEventClientrelationship-key": "DCAE_INSTANCE_ID.dcae-tcageneric-vnf.vnf-id",
                "policyVersion": "1.0.0.5",
                "policyNamerelationship-value": "vLoadBalancer",807a3f02-f878-436b-870c-f0e91e81570d"
                 "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop",          }
      "target_type": "VM",                  ]
 "AAI": {                  },
  "vserver.vserver-name": "dfw1lb01lb01" # TODO - add in the enriched A&AI         {
       },                 "closedLoopAlarmStartrelated-link": 1484677482204798,"/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/6e219e86-cd94-4989-9119-def29aa10b12",
                  "closedLoopEventStatus      "related-to": "ONSETimage",
                       "closedLoopControlName": "ControlLooprelated-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",to-property": [
                         "version": "1.0.2",  {
              "target": "vserver.vserver-name",                 "requestIDproperty-key": "97964e10-686e-4790-8c45-bdfa61df770fimage.image-name",
                 "from": "DCAE"
}

SO API Interaction

...

titlevDNS - SO Request
linenumberstrue
collapsetrue

...

titlevDNS - SO Response ACCEPTED
linenumberstrue
collapsetrue

...

titlevDNS - SO Response SUCCESS
linenumberstrue
collapsetrue

vFirewall

Policy Creation

Code Block
titlevFirewall - TCA Configuration Policy Payload
linenumberstrue
collapsetrue
tca_policy: "{
  "domain": "measurementsForVfScaling",
  "metricsPerEventName": [              "property-value": "unknown"
        {       "eventName": "vFirewallBroadcastPackets",       "controlLoopSchemaType": "VNF",    }
  "policyScope": "DCAE",       "policyName": "DCAE.Config_tca-hi-lo",       "policyVersion": "v0.0.1",     ],
   "thresholds": [         {           "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a",relationship-data": [
                            {
                                "versionrelationship-key": "1.0.2cloud-region.cloud-owner",
          "fieldPath                      "relationship-value": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta"CloudOwner"
                            },
          "thresholdValue": 300,                  "direction": "LESS_OR_EQUAL",{
           "severity": "MAJOR",           "closedLoopEventStatus": "ONSET"         },"relationship-key": "cloud-region.cloud-region-id",
                                "relationship-value": "RegionOne"
                            },
                            {
                                "relationship-key": "image.image-id",
                                "relationship-value": "6e219e86-cd94-4989-9119-def29aa10b12"
                            }
                        ]
                    },
                    {
                        "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39",
                        "related-to": "flavor",
                        "related-to-property": [
                            {
                                "property-key": "flavor.flavor-name",
                                "property-value": "m1.medium"
                            }
                        ],
                        "relationship-data": [
                            {
                                "relationship-key": "cloud-region.cloud-owner",
                                "relationship-value": "CloudOwner"
                            },
                            {
                                "relationship-key": "cloud-region.cloud-region-id",
                                "relationship-value": "RegionOne"
                            },
                            {
                                "relationship-key": "flavor.flavor-id",
                                "relationship-value": "764efb04-5a46-4806-a766-2bdd24559f39"
                            }
                        ]
                    }
                ]
            },
            "resource-version": "1533850964910",
            "vserver-id": "1c94da3f-16f1-4fc7-9ed1-e018dfa62774",
            "vserver-name": "vlb-ms-0809-1",
            "vserver-name2": "vlb-ms-0809-7",
            "vserver-selflink": "http://localhost:8774/v2.1/4086f396c5e04caf9502c5fdeca575c4/servers/1c94da3f-16f1-4fc7-9ed1-e018dfa62774"
        }
    ]
}

Code Block
titlevDNS DCAE Control Loop Event - Enriched A&AI
linenumberstrue
collapsetrue
{
                "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca",
                "policyVersion": "1.0.0.5",
                "policyName": "vLoadBalancer",
                "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop",
                "target_type": "VM",
                "AAI": {
                    "vserver.vserver-name": "dfw1lb01lb01"
# TODO - add in the enriched A&AI
                },
                "closedLoopAlarmStart": 1484677482204798,
                "closedLoopEventStatus": "ONSET",
                "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3",
                "version": "1.0.2",
                "target": "vserver.vserver-name",
                "requestID": "97964e10-686e-4790-8c45-bdfa61df770f",
                "from": "DCAE"
}

A&AI API Interaction

Code Block
titlevDNS - A&AI vserver named query
linenumberstrue
collapsetrue
#PLD find the vserver version 


https://{aai}/aai/search/named-query

{
  "query-parameters": {
    "named-query": {
      "named-query-uuid": "4ff56a54-9e3f-46b7-a337-07a1d3c6b469"
    }
  },
  "instance-filters": {
    "instance-filter": [
      {
        "vserver": {
          "vserver-name": "vserver-71c978fb-29b8-437d-80e6-acf3a3a91e69"
        }
      }
    ]
  }
}

Code Block
titlevDNS - A&AI vserver named query response
linenumberstrue
collapsetrue
{
    "inventory-response-item": [
        {
            "vserver": {
                "vserver-id": "143473ac-1b32-47bc-aa07-10a680d2bbbb",
                "vserver-name": "vlb-ms-0706-1",
                "vserver-name2": "vlb-ms-0706-1",
                "prov-status": "ACTIVE",
                "vserver-selflink": "http://ecompctl1.research.att.com:8774/v2/3f2aaef74ecb4b19b35e26d0849fe9a2/servers/143473ac-1b32-47bc-aa07-10a680d2bbbb",
                "in-maint": false,
                "is-closed-loop-disabled": false,
                "resource-version": "1531949079952"
            },
            "extra-properties": {},
            "inventory-response-items": {
                "inventory-response-item": [
                    {
                        "model-name": "vLoadBalancerMS",
                        "generic-vnf": {
                            "vnf-id": "f524b92a-b5bd-4c9d-9c92-2ef672bc070f",
                            "vnf-name": "vLoadBalancerMS-Vnf-0706-1",
                            "vnf-type": "vLoadBalancerMS/vLoadBalancerMS 0",
                            "service-id": "50e1b0be-e0c9-48e2-9f42-15279a783ee8",
                            "prov-status": "PROV",
                            "orchestration-status": "Active",
                            "ipv4-oam-address": "10.0.150.1",
                            "in-maint": false,
                            "is-closed-loop-disabled": false,
                            "resource-version": "1533141664663",
                            "model-invariant-id": "32f7ec6a-1c54-4c06-a548-fe84832e3c40",
                            "model-version-id": "2db7689c-a979-4418-b71f-6a45a32f4791",
                            "model-customization-id": "f3af2f41-8ea2-4f3c-8d85-aaede9699a71",
                            "nf-type": "nf-type",
                            "nf-function": "nf-function",
                            "nf-role": "nf-role",
                            "nf-naming-code": ""
                        },
                        "extra-properties": {
                            "extra-property": [
                                {
                                    "property-name": "model-ver.model-version-id",
                                    "property-value": "2db7689c-a979-4418-b71f-6a45a32f4791"
                                },
                                {
                                    "property-name": "model-ver.model-name",
                                    "property-value": "vLoadBalancerMS"
                                },
                                {
                                    "property-name": "model.model-type",
                                    "property-value": "resource"
                                },
                                {
                                    "property-name": "model.model-invariant-id",
                                    "property-value": "32f7ec6a-1c54-4c06-a548-fe84832e3c40"
                                },
                                {
                                    "property-name": "model-ver.model-version",
                                    "property-value": "1.0"
                                }
                            ]
                        },
                        "inventory-response-items": {
                            "inventory-response-item": [
                                {
                                    "model-name": "vLoadBalancerMS",
                                    "service-instance": {
                                        "service-instance-id": "f242d516-7c96-4b02-a74d-4363b4267459",
                                        "service-instance-name": "vLoadBalancerMS-Service-0706-1",
                                        "environment-context": "General_Revenue-Bearing",
                                        "workload-context": "Production",
                                        "model-invariant-id": "2d4e2c32-2ffb-494a-9677-073a08f637dd",
                                        "model-version-id": "4dd37f02-7da5-451c-ba76-032a5b465c65",
                                        "resource-version": "1530889799597",
                                        "orchestration-status": "Active"
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "4dd37f02-7da5-451c-ba76-032a5b465c65"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "vLoadBalancerMS"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "service"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "2d4e2c32-2ffb-494a-9677-073a08f637dd"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1.0"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "c0831ca7-0a20-4f03-a183-1135381b8707",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_2",
                                        "heat-stack-id": "vLoadBalancerMS-Vnf-0706-1_2/122b563a-2c56-4804-aa81-970ba7741b55",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": false,
                                        "resource-version": "1531510457103",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef",
                                        "module-index": 0
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "50e6e588-fe87-4663-aa10-51964f51a67d",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_4",
                                        "heat-stack-id": "vLoadBalancerMS-Vnf-0706-1_4/ec246cff-38e3-4c89-99bf-21bc925b073c",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": false,
                                        "resource-version": "1531925572435",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef",
                                        "module-index": 2
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                               "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "8853e587-07d9-4081-9f90-61af87cd34bf",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_3",
                                        "heat-stack-id": "vLoadBalancerMS-Vnf-0706-1_3/10d56b1b-1d3e-4677-a31f-3449e1e3c457",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": false,
                                        "resource-version": "1531840660936",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef",
                                        "module-index": 1
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "51dbbf67-6e25-4d0c-8c18-ba7f21b8cfb3",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_6",
                                        "heat-stack-id": "vLoadBalancerMS-Vnf-0706-1_6/8486eafa-d860-4c17-a1bf-a1c436290806",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": false,
                                        "resource-version": "1532638352675",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef",
                                        "module-index": 4
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "c6256fd8-dfa7-49fd-a320-4be08bb3a49d",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_7",
                                        "heat-stack-id": "vLoadBalancerMS-Vnf-0706-1_7/8a587bc3-96b1-4ba7-9f4a-d40f669d08de",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": false,
                                        "resource-version": "1532702700715",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef",
                                        "module-index": 5
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "dummy_f524b92a-b5bd-4c9d-9c92-2ef672bc070f",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_0",
                                        "is-base-vf-module": false,
                                        "resource-version": "1537212348939",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef"
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..dnsscaling..module-1",
                                    "vf-module": {
                                        "vf-module-id": "aa9294f3-8cd6-483c-8165-8e303b7022a4",
                                        "vf-module-name": "vLoadBalancerMS-Vnf-0706-1_5",
                                        "heat-stack-id": "vLoadBalancerMS-Vnf-0706-1_5/39e7f1bd-1746-4370-aec5-1ff83a28a9a9",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": false,
                                        "resource-version": "1532616866686",
                                        "model-invariant-id": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b",
                                        "model-version-id": "3db507c6-bec6-47a3-9ac3-5978d3f03882",
                                        "model-customization-id": "1726b74e-8831-4b0a-a1f3-c254cc2e8fef",
                                        "module-index": 3
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "3db507c6-bec6-47a3-9ac3-5978d3f03882"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..dnsscaling..module-1"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                            {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "285adb8d-b6b4-41f6-8f28-48f86ad4fa3b"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "model-name": "Vloadbalancerms..base_vlb..module-0",
                                    "vf-module": {
                                        "vf-module-id": "155949a5-8494-45c8-84db-3675dcc5a64f",
                                        "vf-module-name": "Vfmodule_vLBMS-0706-1",
                                        "heat-stack-id": "Vfmodule_vLBMS-0706-1/76c42b6b-09b0-434b-85a7-2b226eb3d31c",
                                        "orchestration-status": "active",
                                        "is-base-vf-module": true,
                                        "resource-version": "1530890184655",
                                        "model-invariant-id": "f96252ec-2729-45c7-ae73-a4e4bf495838",
                                       "model-version-id": "75122eb8-1482-4c68-b7cf-dd8458f58ba5",
                                        "model-customization-id": "f979a817-584e-4857-b585-c8f409eccbdd",
                                        "module-index": 0
                                    },
                                    "extra-properties": {
                                        "extra-property": [
                                            {
                                                "property-name": "model-ver.model-version-id",
                                                "property-value": "75122eb8-1482-4c68-b7cf-dd8458f58ba5"
                                            },
                                            {
                                                "property-name": "model-ver.model-name",
                                                "property-value": "Vloadbalancerms..base_vlb..module-0"
                                            },
                                            {
                                                "property-name": "model.model-type",
                                                "property-value": "resource"
                                            },
                                           {
                                                "property-name": "model.model-invariant-id",
                                                "property-value": "f96252ec-2729-45c7-ae73-a4e4bf495838"
                                            },
                                            {
                                                "property-name": "model-ver.model-version",
                                                "property-value": "1"
                                            }
                                        ]
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "tenant": {
                            "tenant-id": "3f2aaef74ecb4b19b35e26d0849fe9a2",
                            "tenant-name": "ONAP-demo-test",
                            "resource-version": "1529419258510"
                        },
                        "extra-properties": {},
                        "inventory-response-items": {
                            "inventory-response-item": [
                                {
                                    "cloud-region": {
                                        "cloud-owner": "CloudOwner",
                                        "cloud-region-id": "RegionOne",
                                        "cloud-type": "openstack",
                                        "owner-defined-type": "owner type",
                                        "cloud-region-version": "v2.5",
                                        "cloud-zone": "zone-1",
                                        "sriov-automation": false,
                                        "resource-version": "1529419258443"
                                    },
                                    "extra-properties": {}
                                }
                            ]
                        }
                    }
                ]
            }
        }
    ]
}



SO API Interaction

Code Block
titlevDNS - SO Request
linenumberstrue
collapsetrue
https://{so}/serviceInstantiation/v7/3b12f31f-8f2d-4f5c-b875-61ff1194b941/vnfs/db373a8d-f7be-4d02-8ac8-6ca4c305d144/vfModules/scaleOut

{
  "requestDetails": {
    "modelInfo": {
      "modelType": "vfModule",
      "modelInvariantId": "356a1cff-71f2-4086-9980-a2927ce11c1c",
      "modelVersionId": "6b93d804-cfc8-4be3-92cc-9336d135859a",
      "modelName": "Vloadbalancer..dnsscaling..module-1",
      "modelVersion": "1"
    },
    "cloudConfiguration": {
      "lcpCloudRegionId": "RegionOne",
      "tenantId": "41d6d38489bd40b09ea8a6b6b852dcbd"
    },
    "requestInfo": {
      "instanceName": "my_module_3",
      "source": "POLICY",
      "suppressRollback": false,
      "requestorId": "policy"
    },
    "relatedInstanceList": [
      {
        "relatedInstance": {
          "instanceId": "3b12f31f-8f2d-4f5c-b875-61ff1194b941",
          "modelInfo": {
            "modelType": "service",
            "modelInvariantId": "1321d60d-f7ff-4300-96c2-6bf0b3268b7a",
            "modelVersionId": "732d4692-4b97-46f9-a996-0b3339e88c50",
            "modelName": "vLoadBalancer-1106",
            "modelVersion": "1.0"
          }
        }
      },
      {
        "relatedInstance": {
          "instanceId": "db373a8d-f7be-4d02-8ac8-6ca4c305d144",
          "modelInfo": {
            "modelType": "vnf",
            "modelInvariantId": "cee050ed-92a5-494f-ab04-234307a846dc",
            "modelVersionId": "fd65becc-6b2c-4fe8-ace9-cc29db9a3da2",
            "modelName": "vLoadBalancer",
            "modelVersion": "1.0",
            "modelCustomizationName": "vLoadBalancer 0"
          }
        }
      }
    ],
    "requestParameters": {
      "usePreload": true,
      "userParams": []
    },
    "configurationParameters": [
      {
        "availability-zone": "$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone[0]",
        "xtz-123": "$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone[0]"
      }
    ]
  }
}
Code Block
titlevDNS - SO Response ACCEPTED
linenumberstrue
collapsetrue
{
	"requestReferences": {
		"requestId": "60533ee3-814d-4949-be93-e6b26aace580"
	},
	"request": {
		"requestId":"d5bc27f2-1d5c-405d-a985-3e3f544c1582",
		"requestStatus": {
			"percentProgress": 0,
			"requestState": "IN_PROGRESS",
			"wasRolledBack": false
		}
	},
	"httpResponseCode": 0
}
Code Block
titlevDNS - SO Request Status Query (if not complete)
linenumberstrue
collapsetrue
https://{so}/orchestrationRequests/v5/60533ee3-814d-4949-be93-e6b26aace580
Code Block
titlevDNS - SO Response SUCCESS
linenumberstrue
collapsetrue
{
	"requestReferences": {
		"requestId": "60533ee3-814d-4949-be93-e6b26aace580"
	},
	"request": {
		"requestId":"d5bc27f2-1d5c-405d-a985-3e3f544c1582",
		"requestStatus": {
			"percentProgress": 100,
			"requestState": "COMPLETE",
			"wasRolledBack": false
		}
	},
	"httpResponseCode": 0
}




vFirewall

Policy Creation

Code Block
titlevFirewall - TCA Configuration Policy Payload
linenumberstrue
collapsetrue
tca_policy: "{
  "domain": "measurementsForVfScaling",
  "metricsPerEventName": [
    {
      "eventName": "vFirewallBroadcastPackets",
      "controlLoopSchemaType": "VNF",
      "policyScope": "DCAE",
      "policyName": "DCAE.Config_tca-hi-lo",
      "policyVersion": "v0.0.1",
 
      "thresholds": [
        {
          "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a",
          "version": "1.0.2",
          "fieldPath": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta",
          "thresholdValue": 300,
          "direction": "LESS_OR_EQUAL",
          "severity": "MAJOR",
          "closedLoopEventStatus": "ONSET"
        },
        {
          "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a",
          "version": "1.0.2",
          "fieldPath": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta",
          "thresholdValue": 700,
          "direction": "GREATER_OR_EQUAL",
          "severity": "CRITICAL",
          "closedLoopEventStatus": "ONSET"
        }
      ]
    }
  ]
 
}"
Code Block
titlevFirewall - Create Config Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevFirewall\", \"description\": \"MicroService vFirewall Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"vFirewallBroadcastPackets\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 300, \"direction\": \"LESS_OR_EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ONSET\" }, { \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 700, \"direction\": \"GREATER_OR_EQUAL\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" } ] }] } } }",
        "policyConfigType": "MicroService",
        "policyName": "com.MicroServicevFirewall",
        "onapName": "DCAE"
}' 'http://pdp:8081/pdp/api/createPolicy'

Code Block
titlevFirewall - Operational Policy
linenumberstrue
collapsetrue
controlLoop:
  version: 2.0.0
  controlLoopName: ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a
  trigger_policy: unique-policy-id-1-modifyConfig
  timeout: 1200
  abatement: false

policies:
  - id: unique-policy-id-1-modifyConfig
    name: modify packet gen config
    description:
    actor: APPC
    recipe: ModifyConfig
    target:
      # TBD - Cannot be known until instantiation is done
      resourceID: Eace933104d443b496b8.nodes.heat.vpg
	  type: VNF	
    retry: 0
    timeout: 300
    success: final_success
    failure: final_failure
    failure_timeout: final_failure_timeout
    failure_retries: final_failure_retries
    failure_exception: final_failure_exception
    failure_guard: final_failure_guard

Code Block
titlevFirewall - Create Operational Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{

        "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevFirewall\", \"description\": \"MicroService vFirewall Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"vFirewallBroadcastPackets\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 300, \"direction\": \"LESS_OR_EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ONSET\" }, { \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 700, \"direction\": \"GREATER_OR_EQUAL\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" } ] }] } } }",
        "policyConfigType": "MicroService",
        "policyName": "com.MicroServicevFirewall",
        "onapName": "DCAE"
}' 'http://pdp:8081/pdp/api/createPolicy'

Code Block
titlevFirewall - Push Policies
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.BRMSParamvFirewall",
  "policyType": "BRMS_Param"
}' 'http://pdp:8081/pdp/api/pushPolicy'

curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.MicroServicevFirewall",
  "policyType": "MicroService"
}' 'http://pdp:8081/pdp/api/pushPolicy'

DCAE Events and A&AI Enrichment (if necessary)

Code Block
titlevFirewall - DCAE Control Loop Event (NOT enriched with A&AI)
linenumberstrue
collapsetrue
{
    "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca",
    "policyVersion": "1.0.0.5",
    "policyName": "vFirewall",
    "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop",
    "target_type": "VNF",
    "AAI": {
        "generic-vnf.vnf-name": "zdfw1fwl01fwl02"
    },
    "closedLoopAlarmStart": 1484855291527925,
    "closedLoopEventStatus": "ONSET",
    "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a",
    "version": "1.0.2",
    "target": "generic-vnf.vnf-name",
    "requestID": "8c1b8bd8-06f7-493f-8ed7-daaa4cc481bc",
    "from": "DCAE"
}
Code Block
titlevFirewall - A&AI generic-vnf query
linenumberstrue
collapsetrue
https://{aai}/aai/v11/network/generic-vnfs/generic-vnf?vnf-name=zdfw1fwl01fwl02


Code Block
titlevFirewall - A&AI generic-vnf query response
linenumberstrue
collapsetrue
{
    "vnf-id": "4e46ad6c-cebe-4460-858e-b5806883271b",
    "vnf-name": "vfw7f5a57d6",
    "vnf-type": "da818f33-97e1-4edf-98a5/5759f208-b75c-4b35-9599 0",
    "service-id": "a322c144-537c-4532-bf1b-0a4889083388",
    "prov-status": "PREPROV",
    "orchestration-status": "Created",
    "in-maint": false,
    "is-closed-loop-disabled": false,
    "resource-version": "1521467089262",
    "model-invariant-id": "a1efbbdd-2077-4b86-9fc0-244af99760f0",
    "model-version-id": "34c3221b-1326-4f35-9ed7-6f2f7e59d788",
    "model-customization-id": "1798c9a9-eaae-438f-bac3-b013599e8909",
    "nf-type": "",
    "nf-function": "",
    "nf-role": "",
    "nf-naming-code": "",
    "relationship-list": {
        "relationship": [
            {
                "related-to": "service-instance",
                "related-link": "/aai/v11/business/customers/customer/DemoCust_7d454ef5-f5ea-4346-b2d3-e9797f5a57d6/service-subscriptions/service-subscription/vFW/service-instances/service-instance/7c45e4f7-aa7a-4130-9ee3-c5c1d81840df",
                "relationship-data": [
                    {
                        "relationship-key": "customer.global-customer-id",
                        "relationship-value": "DemoCust_7d454ef5-f5ea-4346-b2d3-e9797f5a57d6"
                    },
                    {
                        "relationship-key": "service-subscription.service-type",
                        "relationship-value": "vFW"
                    },
                    {
                        "relationship-key": "service-instance.service-instance-id",
                        "relationship-value": "7c45e4f7-aa7a-4130-9ee3-c5c1d81840df"
                    }
                ],
                "related-to-property": [
                    {
                        "property-key": "service-instance.service-instance-name",
                        "property-value": "Service_Ete_Name7d454ef5-f5ea-4346-b2d3-e9797f5a57d6"
                    }
                ]
            },
            {
                "related-to": "vserver",
                "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/3f3f3c72-269d-45e6-8953-692424f2df1f",
                "relationship-data": [
                    {
                        "relationship-key": "cloud-region.cloud-owner",
                        "relationship-value": "CloudOwner"
                    },
                    {
                        "relationship-key": "cloud-region.cloud-region-id",
                        "relationship-value": "RegionOne"
                    },
                    {
                        "relationship-key": "tenant.tenant-id",
                        "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1"
                    },
                    {
                        "relationship-key": "vserver.vserver-id",
                        "relationship-value": "3f3f3c72-269d-45e6-8953-692424f2df1f"
                    }
                ],
                "related-to-property": [
                    {
                        "property-key": "vserver.vserver-name",
                        "property-value": "demofwl01pgn"
                    }
                ]
            },
            {
                "related-to": "vserver",
                "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/4c45d0a4-a873-4d95-87ca-2a198322c9c4",
                "relationship-data": [
                    {
                        "relationship-key": "cloud-region.cloud-owner",
                        "relationship-value": "CloudOwner"
                    },
                    {
                        "relationship-key": "cloud-region.cloud-region-id",
                        "relationship-value": "RegionOne"
                    },
                    {
                        "relationship-key": "tenant.tenant-id",
                        "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1"
                    },
                    {
                        "relationship-key": "vserver.vserver-id",
                        "relationship-value": "4c45d0a4-a873-4d95-87ca-2a198322c9c4"
                    }
                ],
                "related-to-property": [
                    {
                        "property-key": "vserver.vserver-name",
                        "property-value": "demofwl01snk"
                    }
                ]
            },
            {
                "related-to": "vserver",
                "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/b96416ef-fc4e-49cb-8120-1d56686d2e90",
                "relationship-data": [
                    {
                        "relationship-key": "cloud-region.cloud-owner",
                        "relationship-value": "CloudOwner"
                    },
                    {
                        "relationship-key": "cloud-region.cloud-region-id",
                        "relationship-value": "RegionOne"
                    },
                    {
                        "relationship-key": "tenant.tenant-id",
                        "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1"
                    },
                    {
                        "relationship-key": "vserver.vserver-id",
                        "relationship-value": "b96416ef-fc4e-49cb-8120-1d56686d2e90"
                    }
                ],
                "related-to-property": [
                    {
                        "property-key": "vserver.vserver-name",
                        "property-value": "vfw7f5a57d6"
                    }
                ]
            }
        ]
    }
}

APPC API Interaction

Code Block
titlevFirewall - APPC Request
linenumberstrue
collapsetrue
{
    "CommonHeader": {
          "TimeStamp": 1500997725298,
          "APIver": "1.01",
          "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200",
          "RequestTrack": [],
          "Flags": []
    },
    "Action": "ModifyConfig",
    "Payload": {
        "generic-vnf.vnf-id": "fw0001vm001fw001",
        "pg-streams": {
            "pg-stream": [
            {
                "id": "fw_udp1",
                "is-enabled": "true"
            },
            {
                "id": "fw_udp2",
                "is-enabled": "true"
            },
            {
                "id": "fw_udp3",
                "is-enabled": "true"
            },
            {
                "id": "fw_udp4",
                "is-enabled": "true"
            },
            {
                "id": "fw_udp5",
                "is-enabled": "true"
            }]
        }
    }
}
Code Block
titlevFirewall - APPC Responses
linenumberstrue
collapsetrue
ACCEPT response
 
{
    "Status": {
        "Value": "ACCEPTED",
        "Code": "100"
    },
    "Payload": {
        "pg-streams": "{\\\"pg-streams\\\": {\\\"pg-stream\\\":[{\\\"id\\\":\\\"fw_udp1\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp2\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp3\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp4\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp5\\\", \\\"is-enabled\\\":\\\"true\\\"}]}}",
        "generic-vnf.vnf-id": "fw0001vm001fw001"
    },
    "CommonHeader": {
        "TimeStamp": "1493841850199",
        "APIver": "1.01",
        "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200",
        "SubrequestID": null,
        "OriginatorID": null
    }
}
 
 
SUCCESS response
 
 
{
    "Status": {
        "Value": "SUCCESS",
        "Code": "400"
    },
    "Payload": {
        "pg-streams": "{\\\"pg-streams\\\": {\\\"pg-stream\\\":[{\\\"id\\\":\\\"fw_udp1\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp2\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp3\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp4\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp5\\\", \\\"is-enabled\\\":\\\"true\\\"}]}}",
        "generic-vnf.vnf-id": "fw0001vm001fw001"
    },
    "CommonHeader": {
        "TimeStamp": "1493841850199",
        "APIver": "1.01",
        "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200",
        "SubrequestID": null,
        "OriginatorID": null
    }
}


TODO FAILED response


vCPE

Policy Creation and Pushing

Code Block
titlevCPE - TCA Configuration Policy Payload
linenumberstrue
collapsetrue
tca_policy: "{
       "domain": "measurementsForVfScaling",
       "metricsPerEventName": [{
              "eventName": "Measurement_vGMUX",
              "controlLoopSchemaType": "VNF",
              "policyScope": "DCAE",
              "policyName": "DCAE.Config_tca-hi-lo",
              "policyVersion": "v0.0.1",
              "thresholds": [{
                     "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",
                     "version": "1.0.2",
                     "fieldPath": "$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value",
                     "thresholdValue": 0,
                     "direction": "EQUAL",
                     "severity": "MAJOR",
                     "closedLoopEventStatus": "ABATED"
              }, {
                     "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",
                     "version": "1.0.2",
                     "fieldPath": "$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value",
                     "thresholdValue": 0,
                     "direction": "GREATER",
                     "severity": "CRITICAL",
                     "closedLoopEventStatus": "ONSET"
              }]
       }]
}"
Code Block
titlevCPE - Create Config Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{

        "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevCPE\", \"description\": \"MicroService vCPE Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"Measurement_vGMUX\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ABATED\" }, { \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"GREATER\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" }] }] } } }",
        "policyConfigType": "MicroService",
        "policyName": "com.MicroServicevCPE",
        "onapName": "DCAE"
}' 'http://pdp:8081/pdp/api/createPolicy'
Code Block
titlevCPE Operational Policy
linenumberstrue
collapsetrue
controlLoop:
  version: 2.0.0
  controlLoopName: ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e
  trigger_policy: unique-policy-id-1-restart
  timeout: 3600
  abatement: true

policies:
  - id: unique-policy-id-1-restart
    name: Restart the VM
    description:
    actor: APPC
    recipe: Restart
    target:
      type: VM
    retry: 3
    timeout: 1200
    success: final_success
    failure: final_failure
    failure_timeout: final_failure_timeout
    failure_retries: final_failure_retries
    failure_exception: final_failure_exception
    failure_guard: final_failure_guard
Code Block
titlevCPE - Create Operational Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/html' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
        "policyConfigType": "BRMS_PARAM",
        "policyName": "com.BRMSParamvCPE",
        "policyDescription": "BRMS Param vCPE policy",
        "policyScope": "com",
        "attributes": {
            "MATCHING": {
                "controller" : "amsterdam"
            },
                "RULE": {
                        "templateName": "ClosedLoopControlName",
                        "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",
                        "controlLoopYaml": "controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e%0D%0A++trigger_policy%3A+unique-policy-id-1-restart%0D%0A++timeout%3A+3600%0D%0A++abatement%3A+true%0D%0A+%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-restart%0D%0A++++name%3A+Restart+the+VM%0D%0A++++description%3A%0D%0A++++actor%3A+APPC%0D%0A++++recipe%3A+Restart%0D%0A++++target%3A%0D%0A++++++type%3A+VM%0D%0A++++retry%3A+3%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard"
        {        }
  "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a",     }
     "version": "1.0.2",
          "fieldPath": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta",
          "thresholdValue": 700,
          "direction": "GREATER_OR_EQUAL",
          "severity": "CRITICAL",
          "closedLoopEventStatus": "ONSET"
        }
      ]
    }
  ]
 
}"
Code Block
titlevFirewall - Create Config Policy
linenumberstrue
collapsetrue
}' 'http://pdp:8081/pdp/api/createPolicy'

Code Block
titlevCPE - Push Policies
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.BRMSParamvCPE",
  "policyType": "BRMS_Param"
}' 'http://pdp:8081/pdp/api/pushPolicy'


curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d ' -d '{
  "pdpGroup": "default",
  "policyName": "com.MicroServicevCPE",
  "policyType": "MicroService"
}' 'http://pdp:8081/pdp/api/pushPolicy'


DCAE Events and A&AI Enrichment (if necessary)

Code Block
titlevCPE - DCAE Control Loop Event (TCA) - NOT Enriched
linenumberstrue
collapsetrue
{
        "configBody": "{ \"service\": \"tca_policy\", \"location\closedLoopControlName": \"SampleServiceLocation\"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",
\"uuid\": \"test\", \"policyName\": \"MicroServicevFirewall\", \"description\": \"MicroService vFirewall Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.10.0\2", \"priority\": \"1\", \"policyScope\
            "requestID": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"vFirewallBroadcastPackets\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"0abc0000-b032-4e4b-bd30-88260f444888",
            "closedLoopAlarmStart": 1478189220547,
            "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca",
            "target_type": "VNF",
            "target": "generic-vnf.vnf-name",
            "AAI": {
               "generic-vnf.vnf-name" : "vCPE_Infrastructure_vGMUX_demo_app"
            },
            "from": "DCAE",
            "policyScope": "DCAE",
            "policyName": "DCAE.Config_tca-hi-lo\", \
            "policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \
            "closedLoopEventStatus": "ONSET"
}
Code Block
titlevCPE - A&AI generic-vnf query
linenumberstrue
collapsetrue
Code Block
titlevCPE - A&AI generic-vnf query response
linenumberstrue
collapsetrue
Code Block
titlevCPE - DCAE Control Loop Event (TCA) - A&AI Enriched
linenumberstrue
collapsetrue
Code Block
titleDCAE ABATED Control Loop Event
linenumberstrue
collapsetrue
{
            "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",
            "version": "1.0.2\",
\"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 300, \"direction\": \"LESS_OR_EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ONSET\" }, { \"closedLoopControlName\requestID": \"ControlLoop0abc0000-vFirewallb032-d0a1dfc64e4b-94f5-4fd4-a5b5-4630b438850a\bd30-88260f444888", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 700, \"direction\": \"GREATER_OR_EQUAL\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" } ] }] } } }",
            "closedLoopAlarmStart": 1478189220547,
            "closedLoopAlarmEnd": 1478589220547,
            "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca",
            "target_type": "VNF",
            "target": "generic-vnf.vnf-name",
            "AAI": {
"policyConfigType"
			"generic-vnf.vnf-name" : "MicroService",vCPE_Infrastructure_vGMUX_demo_app"
            },
            "policyNamefrom": "com.MicroServicevFirewallDCAE",
            "onapNamepolicyScope": "DCAE"
}' 'http://pdp:8081/pdp/api/createPolicy'

Code Block
titlevFirewall - Operational Policy
linenumberstrue
collapsetrue
controlLoop:,
    version: 2.0.0   controlLoopName: ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a   trigger_policy"policyName": unique-policy-id-1-modifyConfig"DCAE.Config_tca-hi-lo",
  timeout: 1200   abatement: false  policies:   - id: unique-policy-id-1-modifyConfig"policyVersion": "v0.0.1",
    name: modify packet gen config     description"closedLoopEventStatus": "ABATED"
}

 actor: APPC

APPC API Interaction

Code Block
titleAPPC request
linenumberstrue
collapsetrue
{
  "body": {
    recipe"input": ModifyConfig{
    target:  "common-header": {
   # TBD - Cannot be known until instantiation is done"timestamp": "2017-08-25T21:06:23.037Z",
        resourceID"api-ver": Eace933104d443b496b8.nodes.heat.vpg
	  type: VNF	"2.00",
        retry: 0"originator-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0",
    timeout: 300   "request-id":  success: final_success"a20e2073-30b1-4357-893b-f5ed57b66ef0",
        failure: final_failure"sub-request-id": "1",
     failure_timeout: final_failure_timeout  "flags": {}
 failure_retries: final_failure_retries    },
failure_exception: final_failure_exception     failure_guard: final_failure_guard

Code Block
titlevFirewall - Create Operational Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
"action": "Restart",
      "action-identifiers": {
        "vnf-id": "vCPE_Infrastructure_vGMUX_demo_app"
      }
    }
  },
"configBody": "{ \"service\version": \"tca_policy\"2.0",
 \"location\ "rpc-name": \"SampleServiceLocation\restart",
 \"uuid\ "correlation-id": \"test\", \"policyName\"a20e2073-30b1-4357-893b-f5ed57b66ef0-1",
  "type": \"MicroServicevFirewall\", \"description\": \"MicroService vFirewall Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"vFirewallBroadcastPackets\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 300, \"direction\": \"LESS_OR_EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ONSET\" }, { \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 700, \"direction\": \"GREATER_OR_EQUAL\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" } ] }] } } }",
        "policyConfigType": "MicroService",
        "policyName": "com.MicroServicevFirewall",
        "onapName": "DCAE"
}' 'http://pdp:8081/pdp/api/createPolicy'

Code Block
titlevFirewall - Push Policies
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.BRMSParamvFirewall",
  "policyType": "BRMS_Param"
}' 'http://pdp:8081/pdp/api/pushPolicy'

request"
}
Code Block
titleAPPC response
linenumberstrue
collapsetrue
{
  "body": {
    "output": {
      "common-header": {
        "timestamp": "2017-08-25T21:06:23.037Z",
        "api-ver": "2.00",
        "originator-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0",
        "request-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0",
        "sub-request-id": "1",
        "flags": {}
      },
      "status": {
        "code": 400,
        "message": "Restart Successful"
      }
    }
  },
  "version": "2.00",
  "rpc-name": "restart",
  "correlation-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0-1",
  "type": "response"
}

VOLTE

Policy Creation

NOTE: VOLTE Configuration Policy for Holmes does not exist. This gap should be addressed in the future.

Code Block
titleVOLTE - Operational Policy
linenumberstrue
collapsetrue
controlLoop:
  version: 2.0.0
  controlLoopName: ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b
  trigger_policy: unique-policy-id-1-restart
  timeout: 3600
  abatement: false

policies:
  - id: unique-policy-id-1-restart
    name: Restart the VM
    description:
    actor: VFC
    recipe: Restart
    target:
      type: VM
    retry: 3
    timeout: 1200
    success: final_success
    failure: final_failure
    failure_timeout: final_failure_timeout
    failure_retries: final_failure_retries
    failure_exception: final_failure_exception
    failure_guard: final_failure_guard
Code Block
titleVOLTE - Create Operational Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plainhtml' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.MicroServicevFirewall",
  "policyType": "MicroService"
}' 'http://pdp:8081/pdp/api/pushPolicy'

DCAE Events and A&AI Enrichment (if necessary)

Code Block
titlevFirewall - DCAE Control Loop Event (NOT enriched with A&AI)
linenumberstrue
collapsetrue
{ '{
        "closedLoopEventClientpolicyConfigType": "DCAE_INSTANCE_ID.dcae-tcaBRMS_PARAM",
        "policyVersionpolicyName": "1.0.0.5com.BRMSParamVOLTE",
        "policyNamepolicyDescription": "vFirewallBRMS Param VOLTE policy",
        "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoopcom",
    "target_type    "attributes": "VNF", {
                "AAIMATCHING": {
                "generic-vnf.vnf-name"controller" : "zdfw1fwl01fwl02amsterdam"
            },
         "closedLoopAlarmStart": 1484855291527925,       "RULE": {
                        "templateName": "ClosedLoopControlName",
                  "closedLoopEventStatus": "ONSET",     "closedLoopControlName": "ControlLoop-vFirewallVOLTE-d0a1dfc62179b738-94f5fd36-4fd44843-a5b5a71a-4630b438850aa8c24c70c55b",
    "version": "1.0.2",        "target": "generic-vnf.vnf-name",     "requestID": "8c1b8bd8-06f7-493f-8ed7-daaa4cc481bc",     "fromcontrolLoopYaml": "DCAE"
}
Code Block
titlevFirewall - A&AI generic-vnf query
linenumberstrue
collapsetrue
https://{aai}/aai/v11/network/generic-vnfs/generic-vnf?vnf-name=zdfw1fwl01fwl02


Code Block
titlevFirewall - A&AI generic-vnf query response
linenumberstrue
collapsetrue
{
    "vnf-id": "4e46ad6c-cebe-4460-858e-b5806883271b",
    "vnf-name": "vfw7f5a57d6",
    "vnf-type": "da818f33-97e1-4edf-98a5/5759f208-b75c-4b35-9599 0",
    "service-id": "a322c144-537c-4532-bf1b-0a4889083388",
    "prov-status": "PREPROV",
    "orchestration-status": "Created",
    "in-maint": false,
    "is-closed-loop-disabled": false,
    "resource-version": "1521467089262",
    "model-invariant-id": "a1efbbdd-2077-4b86-9fc0-244af99760f0",
    "model-version-id": "34c3221b-1326-4f35-9ed7-6f2f7e59d788",
    "model-customization-id": "1798c9a9-eaae-438f-bac3-b013599e8909",
    "nf-type": "",
    "nf-function": "",
    "nf-role": "",
    "nf-naming-code": "",
    "relationship-list": {
        "relationship": [
            {
                "related-to": "service-instance",
                "related-link": "/aai/v11/business/customers/customer/DemoCust_7d454ef5-f5ea-4346-b2d3-e9797f5a57d6/service-subscriptions/service-subscription/vFW/service-instances/service-instance/7c45e4f7-aa7a-4130-9ee3-c5c1d81840df",
                "relationship-data": [
                    {
                        "relationship-key": "customer.global-customer-id",
                        "relationship-value": "DemoCust_7d454ef5-f5ea-4346-b2d3-e9797f5a57d6"
                    },
                    {
                        "relationship-key": "service-subscription.service-type",
                        "relationship-value": "vFW"
                    },
                    {
                        "relationship-key": "service-instance.service-instance-id",
                        "relationship-value": "7c45e4f7-aa7a-4130-9ee3-c5c1d81840df"
 controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b%0D%0A++trigger_policy%3A+unique-policy-id-1-restart%0D%0A++timeout%3A+3600%0D%0A++abatement%3A+false%0D%0A+%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-restart%0D%0A++++name%3A+Restart+the+VM%0D%0A++++description%3A%0D%0A++++actor%3A+VFC%0D%0A++++recipe%3A+Restart%0D%0A++++target%3A%0D%0A++++++type%3A+VM%0D%0A++++retry%3A+3%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard"
                }
        }
}' 'http://pdp:8081/pdp/api/createPolicy'

Code Block
titleVOLTE - Push Operational Policy
linenumberstrue
collapsetrue
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{
  "pdpGroup": "default",
  "policyName": "com.BRMSParamVOLTE",
  "policyType": "BRMS_Param"
}' 'http://pdp:8081/pdp/api/pushPolicy'


DCAE Events and A&AI Enrichment (if necessary)

Code Block
titleDCAE Control Loop Event (HOLMES) - VOLTE
linenumberstrue
collapsetrue
{
	"closedLoopEventClient": "DCAE.HolmesInstance",
    "policyVersion": "1.0.0.5",
    "policyName": "vVOLTE",
    "policyScope": "resource=volte,service=VolteSErvice,type=SampleType,closedLoopControlName=CL-VOLTE-SIG-d925ed73-8231-4d02-9545-db4e101f88f8",
    "target_type": "VM",
    "AAI": {
		"vserver.vserver-name": "dfw1lb01lb01",
 		"service-instance.service-instance-id" : "TBD",
		"generic-vnf.vnf-id" : "TBD",
		"generic-vnf.vnf-name" : "TBD"
    },
    "closedLoopAlarmStart": 1484677482204798,
    "closedLoopEventStatus": "ONSET",
    "closedLoopControlName": "ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b",
    "version": "1.0.2",
    "target": "vserver.vserver-name",
    "requestID": "97964e10-686e-4790-8c45-bdfa61df770f",
    "from": "DCAE"
}
Code Block
titleA&AI Call
linenumberstrue
collapsetrue
This call is a simple GET in order to retrieve "is-closed-loop-diable" flag.
Code Block
titleA&AI Response
linenumberstrue
collapsetrue
Below is a sample GET response format. Field values are just examples. Will update to real values later.

{
   "vnf-id": "5e49ca06-2972-4532-9ed4-6d071588d792",
   "vnf-name": "USUCP0PCOIL0110UJRT01",
   "vnf-type": "RT",
   "service-id": "d7bb0a21-66f2-4e6d-87d9-9ef3ced63ae4",
   "equipment-role": "UCPE",
   "orchestration-status": "created",
   "management-option": "ATT",
   "ipv4-oam-address": "32.40.68.35",
   "ipv4-loopback0-address": "32.40.64.57",
   "nm-lan-v6-address": "2001:1890:e00e:fffe::1345",
   "management-v6-address": "2001:1890:e00e:fffd::36",
   "in-maint": false,
   "is-closed-loop-disabled": false,
   "resource-version": "1493389458092",
   "relationship-list": {"relationship": [
		{
         	"related-to": "service-instance",
       }                 ]	"related-link": "https://aai-int1.test.att.com:8443/aai/v9/business/customers/customer/1610_Func_Global_20160817084727/service-subscriptions/service-subscription/uCPE-VMS/service-instances/service-instance/USUCP0PCOIL0110UJZZ01",
                "related-to-property	"relationship-data": [
                    	{
                        "property"relationship-key": "service-instancecustomer.serviceglobal-instancecustomer-nameid",
       
                "propertyrelationship-value": "Service1610_Func_Ete_Name7d454ef5-f5ea-4346-b2d3-e9797f5a57d6Global_20160817084727"
                    }
                ]
            },
            {
                "relatedrelationship-tokey": "vserverservice-subscription.service-type",
                "relatedrelationship-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/3f3f3c72-269d-45e6-8953-692424f2df1f",
   value": "uCPE-VMS"
            "relationship-data": [},
            {
        {       "relationship-key": "service-instance.service-instance-id",
                "relationship-keyvalue": "cloud-region.cloud-owner",USUCP0PCOIL0110UJZZ01"
            }
         	],
         "related-to-property": [{"relationshipproperty-valuekey": "CloudOwner"service-instance.service-instance-name"}]
      	},
        {
    }     	"related-to": "vserver",
         	"related-link": "https://aai-int1.test.att.com:8443/aai/v9/cloud-infrastructure/cloud-regions/cloud-region/att-aic/AAIAIC25/tenants/tenant/USUCP0PCOIL0110UJZZ01%3A%3AuCPE-VMS/vservers/vserver/3b2558f4-39d8-40e7-bfc7-30660fb52c45",
           	"relationship-data": [
   {         {
               "relationship-key": "cloud-region.cloud-region-idowner",
        
               "relationship-value": "RegionOneatt-aic"
                    },
   
                {
        
               "relationship-key": "tenant.tenantcloud-region.cloud-region-id",
       
                "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1AAIAIC25"
  
                 },
      
             {
                        "relationship-key": "vservertenant.vservertenant-id",
        
               "relationship-value": "3f3f3c72-269d-45e6-8953-692424f2df1f"
                    }
                ],
                "related-to-property": [
 USUCP0PCOIL0110UJZZ01::uCPE-VMS"
            },
     {        {
                "propertyrelationship-key": "vserver.vserver-nameid",
        
               "propertyrelationship-value": "demofwl01pgn"
3b2558f4-39d8-40e7-bfc7-30660fb52c45"
                   }
                ]	],
         	"related-to-property": [  },    
        			{
                "related-to	"property-key": "vserver.vserver-name",
                "related-link	"property-value": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/4c45d0a4-a873-4d95-87ca-2a198322c9c4",USUCP0PCOIL0110UJZZ01-vsrx"
         	}]
      "relationship-data": [	}
          	]}
}


VFC API Interaction


CCVPN

Policy Creation

Code Block
languagetext
titleCCVPN - Operational Policy
collapsetrue
controlLoop:
  version: 2.0.0
  controlLoopName: ControlLoop-CCVPN-2179b738-fd36-4843-a71a-a8c24c70c55b
  {
trigger_policy: unique-policy-id-16-receateE2EService
  timeout: 3600
  abatement: false
   
policies:
  - id: unique-policy-id-16-recreateE2EService
     "relationship-key": "cloud-region.cloud-owner",
 name: Recreate E2E Service
    description:
    actor: SO
    recipe: Recreate_E2E_Service
     "relationship-value"target:
"CloudOwner"      type: VM
    retry: 3
    timeout: 1200
 },   success: final_success
    failure: final_failure
    failure_timeout: final_failure_timeout
    {
failure_retries: final_failure_retries
    failure_exception: final_failure_exception
            failure_guard: final_failure_guard


DCAE Events and A&AI Enrichment (if necessary)

Code Block
languagetext
titleCCVPN - DCAE CL Event
collapsetrue
{
    "relationship-keyclosedLoopEventClient": "cloud-region.cloud-region-idDCAE.HolmesInstance",
    "policyVersion": "1.0.0.5",
    "policyName": "CCVPN",
       "policyScope": "service=SOTNService,type=SampleType,closedLoopControlName=CL-CCVPN-d925ed73-8231-4d02-9545-db4e101f88f8",
    "relationship-valuetarget_type": "RegionOneVM",
    "AAI": {
              }"vserver.vserver-name": "TBD",
        "service-instance.service-instance-id" : "service-instance-example-1,service-instance-example-2,service-instance-example-3",
         {
"service-instance-example-1.input-parameters" : "input-parameters-1",
              "service-instance-example-2.input-parameters" : "input-parameters-2",
        "relationship-key"service-instance-example-3.input-parameters" : "tenant.tenant-id",input-parameters-3"
    },
    "closedLoopAlarmStart": 1484677482204798,
       "closedLoopEventStatus": "null",
     "relationship-valueclosedLoopControlName": "50b190410b2a4c229d8a6044a80ab7c1"ControlLoop-CCVPN-2179b738-fd36-4843-a71a-a8c24c70c55b",
    "version": "1.0.2",
    "target": "vserver.vserver-name",
        }"requestID": "97964e10-686e-4790-8c45-bdfa61df770f",
    "from": "DCAE"
}

Status Update

Code Block
languagetext
titleCCVPN - Update TP Status
collapsetrue
URL: https://<AAI            host>:<AAI port>/aai/v14/network/network-resources/network-resource/{networkId}/pnfs/pnf/{pnfName}/p-interfaces/p-interface/{ifName}
Method: PATCH
Request Body:
{
    "operational-status": "some status"
}
Code Block
languagetext
titleCCVPN - Update Logic-link Status
collapsetrue
URL: https://<AAI host>:<AAI port>/aai/v14/network/logical-links/logical-link/{linkName}
Method: PATCH
Request Body:
{
        "relationshipoperational-keystatus": "vserver.vserver-id",
                        "relationship-value": "4c45d0a4-a873-4d95-87ca-2a198322c9c4"
   some status"
}


Alarm Correlation

Code Block
languagetext
titleCCVPN - Query for Logical-links
collapsetrue
URL: https://<AAI host>:<AAI port>/aai/v14/network/pnfs/pnf/{pnfName}/p-interfaces?interface-name={ifName}&operational-status={status}
Method: GET
Resquest Body:
{
}
 
 
Response Body:
{   
    "results" : }[
        {
       ], "p-interface" : {
             "relatedinterface-to-propertyname":{ifName}", [                
    {         "network-ref": "some ref",
             "property-keytransparent": "vserver.vserver-namesome blue",
                        "property-value"operational-status": "demofwl01snk[status}",
             "speed-value" : "some speed",
   }          "relationship-list":
      ]          "relationship" : [
},             {       {
         "related-to": "vserver",
                "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/b96416ef-fc4e-49cb-8120-1d56686d2e90",            "related-to" : "logic-link",
                      "relationshiprelated-datalink" : ['url of logical-link",
                      "relationship-data":[
 {                         "relationship-key" : "cloudlogical-region.cloud-ownerlink.link.name",
                          "relationship-value":; "CloudOwnersome name"
                      },]
                    }
       {       ]
           }
     "relationship-key": "cloud-region.cloud-region-id",
                        "relationship-value": "RegionOne"]
}


Service Instance Information Queries

Code Block
languagetext
titleCCVPN - Get vpn-binding from TP
collapsetrue
URL: https://<AAI host>:<AAI port>/aai/v14/network/network-resources/network-resource/{networkId}/pnfs/pnf/{pnfName}/p-interfaces?interface-name={ifName}&operational-status={status}
Method: GET
Request Body:
{
}
 
Response Body:
{
    "results": [
      {
             },
                    {
      "p-interface": {
                 "relationship-key"interface-name": "tenant.tenant-id",
            {ifName}",
           "relationshipnetwork-valueref": "50b190410b2a4c229d8a6044a80ab7c1some ref",
          "transparent":          }"some value",
          "operational-status          {
             ": "{status}",
          "relationshipspeed-keyvalue": "vserver.vserver-idsome speed",
          "relationship-list": {
              "relationship-value" : "b96416ef-fc4e-49cb-8120-1d56686d2e90" [
                  {
      }                 ],"related-to": "vpn-binding",
                      "related-to-property": [link": "url of vpn-binding",
                       {"relationship-data": [
                         "propertyrelationship-key": "vservervpn-binding.vservervpn-nameid",
                         "propertyrelationship-value": "vfw7f5a57d6some id"
                    }  ]
              ]       }
     }         ]
    } }  

APPC API Interaction

Code Block
titlevFirewall - APPC Request
linenumberstrue
collapsetrue
{   }
 "CommonHeader": {      }
    "TimeStamp": 1500997725298, }
    ]
    "APIver": "1.01",
          "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200",
          "RequestTrack": [],
     }
Code Block
languagetext
titleCCVPN - Get connectivity from vpn-binding
collapsetrue
URL: https://<AAI host>:<AAI port>/aai/v14/network/vpn-bindings?vpn-id={vpnId}
Method: GET
Request Body:
{
}
 
Response Body:
{
    "Flagsresults": []
    },  {
  "Action": "ModifyConfig",     "Payloadvpn-binding": {
          "genericvpn-vnf.vnf-id": "fw0001vm001fw001{vpnId}",
          "pgvpn-streamsname": {
 "some name",
          "pgaccess-provider-streamid": [
 "provider id",
          {
                ""access-client-id": "fw_udp1client id",
     
          "isaccess-topology-enabledid": "true"
            }topology id",
            {
     "src-access-node-id": "src node id",
          "src-access-ltp-id": "fw_udp2src ltp id",
                "is-enabled"dst-access-node-id": "true"dst node id",
          },
  "dst-access-ltp-id": "dst ltp id,
         { "operational-status":    "some status",
           "idrelationship-list": "fw_udp3",{
                "is-enabledrelationship" : "true"[
            },       {
     {                 "idrelated-to": "fw_udp4connectivity",
                      "isrelated-enabledlink": "trueurl of connectivity",
            },          "relationship-data": [
   {                      "idrelationship-key": "fw_udp5",connectivity. connectivity-id",
                         "isrelationship-enabledvalue": "truesome id"
            }]          ]
  }     }
}
Code Block
ACCEPT response       {    }
"Status": {         "Value": "ACCEPTED",   ]
     "Code": "100"     },
     "Payload": {  }
      "pg-streams": "{\\\"pg-streams\\\": {\\\"pg-stream\\\":[{\\\"id\\\":\\\"fw_udp1\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp2\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp3\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp4\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp5\\\", \\\"is-enabled\\\":\\\"true\\\"}]}}",
        "generic-vnf.vnf-id": "fw0001vm001fw001"
    },
    "CommonHeader": {}
    ]
}
Code Block
languagetext
titleCCVPN - Query service instances by connectivity
collapsetrue
URL: https://<AAI host>:<AAI port>/aai/v14/network/connectivities/connectivity/{connectivityId}
Method: Get
Request Body:
{
}
Response Body:
{
    "results": [
      {
        "connectivity": {
          "TimeStampconnectivity-id": "1493841850199{connectivityId}",
          "APIverbandwidth-profile-name": "1.01some profile",
          "RequestIDvpn-type": "664be3d2-6c12-4f4b-a3e7-c349acced200some type",
          "SubrequestIDcir": "cir nullvalue",
          "OriginatorIDeir": null "eir value",
     } }    
SUCCESS response"cbs": "cbs value",
     {     "Statusebs": {"ebs value",
          "Valuecolor-aware": "SUCCESScolor value",
          "Codecoupling-flag": "400flag value",
     },     "Payloadetht-svc-name": {"some name",
         "pg-streams": "{\\\"pg-streams\\\": {\\\"pg-stream\\\":[{\\\"id\\\":\\\"fw_udp1\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp2\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp3\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp4\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp5\\\", \\\"is-enabled\\\":\\\"true\\\"}]}}",access-provider-id": "provider id",
          "access-client-id": "client id",
          "access-topology-id": "topology id",
          "access-node-id": "node id",
          "access-ltp-id": "ltp id",
          "connectivity-selflink": "some URL",
          "cvlan ": "some tag",
          "operational-status": "some status",
          "relationship-list": {
              "relationship" : [
                  {
                      "related-to": "service-instance",
                      "generic-vnf.vnf-idrelated-link": "fw0001vm001fw001"url of service-instance",
    },                  "CommonHeader": {relationship-data": [                        
        "TimeStamp": "1493841850199",         "APIver": "1.01",         "RequestIDrelationship-key": "664be3d2service-6c12instance.service-4f4binstance-a3e7-c349acced200id",                        "SubrequestID": null,
                            "OriginatorIDrelationship-value": null "some id"
         } }     TODO FAILED response

...

Policy Creation

Code Block
titlevCPE - TCA Configuration Policy Payload
linenumberstrue
collapsetrue
tca_policy: "{
     ]
      "domain": "measurementsForVfScaling",        "metricsPerEventName": [{  }
            "eventName": "Measurement_vGMUX", ]
          }
  "controlLoopSchemaType": "VNF",   }
    ]
Code Block
languagetext
titleCCVPN - Get all 3 services instances from CCVPN
collapsetrue
From service-instance URL:
 
URL:  "policyScope": "DCAE",
    https://<AAI host>:<AAI port>/aai/v14/business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances?service-instance-id={servId}
 
Derive the service-subscription URL:
URL: https://<AAI host>:<AAI port>/aai/v14/business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}
 
 
Method: GET
Request   "policyName": "DCAE.Config_tca-hi-lo",
    Body:
{
}
Response Body:
{
         "policyVersionresults": "v0.0.1",[
      {
        "thresholdsservice-subscription": [{
          "service-type": "{service-type}",
         "closedLoopControlName": "ControlLooptemp-vCPEub-48f0c2c3sub-a172-4192-9ae3-052274181b6e",
         account-id": "some sub account",
           "versionservice-instances": "1.0.2",{
                     "fieldPath"service-instance": "$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value",
                     "thresholdValue": 0,
  {
                  "directionservice-instance-id": "EQUALsome id 1",
                     "severity"service-instance-name": "MAJOR",some name  1",
                  "closedLoopEventStatusenvironment-context": "ABATED"some context 1",
                 }, {
   "workload-context": "some workload 1",
                  "closedLoopControlNamerelationship-list": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",{
                      "versionrelationship" : "1.0.2",[
                     "fieldPath": "$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value",]
                  }
      "thresholdValue": 0,         },
            "direction": "GREATER",   {
                  "severityservice-instance-id": "CRITICALsome id 2",

                    "closedLoopEventStatus"service-instance-name": "ONSET"some name 2",
                  }]
  "environment-context": "some context 2",
    }]
}"
Code Block
Code Block
titlevCPE Operational Policy
linenumberstrue
collapsetrue
controlLoop:      version: 2.0.0   controlLoopName: ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e   trigger_policy: unique-policy-id-1-restart
  timeout: 3600
  abatement: true

policies:
  - id: unique-policy-id-1-restart"workload-context": "some workload 2",
                  name"relationship-list": Restart{
the VM     description:     actor: APPC     recipe: Restart    "relationship" target: [
     type: VM     retry: 3     timeout: 1200    ]
success: final_success     failure: final_failure     failure_timeout: final_failure_timeout     failure_retries: final_failure_retries}
     failure_exception: final_failure_exception
    failure_guard: final_failure_guard

DCAE Events and A&AI Enrichment (if necessary)

Code Block
titlevCPE - DCAE Control Loop Event (TCA) - NOT Enriched
linenumberstrue
collapsetrue
{          },
       "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",        {
    "version": "1.0.2",             "requestIDservice-instance-id": "0abc0000-b032-4e4b-bd30-88260f444888",some id 3",
                  "closedLoopAlarmStartservice-instance-name": 1478189220547,"some name 3",
              "closedLoopEventClient    "environment-context": "DCAE_INSTANCE_ID.dcae-tca",some context 3",
                  "target_typeworkload-context": "VNFsome workload 3",
                  "targetrelationship-list": "generic-vnf.vnf-name", {
                      "AAIrelationship" : { [
                      ]
  "generic-vnf.vnf-name" : "vCPE_Infrastructure_vGMUX_demo_app"               },
             "from": "DCAE",  }
          "policyScope": "DCAE",   ]
         "policyName": "DCAE.Config_tca-hi-lo",
 },
           "policyVersionrelationship-list": "v0.0.1", {
              "closedLoopEventStatusrelationship" : "ONSET"
}
Code Block
titlevCPE - A&AI generic-vnf query
linenumberstrue
collapsetrue
Code Block
titlevCPE - A&AI generic-vnf query response
linenumberstrue
collapsetrue
Code Block
titlevCPE - DCAE Control Loop Event (TCA) - A&AI Enriched
linenumberstrue
collapsetrue
Code Block
titleDCAE ABATED Control Loop Event
linenumberstrue
collapsetrue
{ [
              ]
        "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e",
 }
        }
  "version": "1.0.2",   }
    ]
}

Code Block
languagetext
titleCCVPN - Query 'input-parameters' for 'service-instance'
collapsetrue
URL:  "requestID": "0abc0000-b032-4e4b-bd30-88260f444888",
       https://<AAI host>:<AAI port>/aai/v14/business/customers/customer/{global-custoner-id}/service-subscriptions/service-subscription/{service-type}/service-instances?service-instance-id={serviceId}
Method: GET
Request Body:
{
}
Response Body:
{
    "closedLoopAlarmStartservice-instance-id": 1478189220547"{service-instance-id}",
    "service-instance-name" : "instance name",
    "closedLoopAlarmEndservice-type": "some 1478589220547,
 type",
    "service-role": "some role",
    "model-invariant-id": "model id",
    "closedLoopEventClientmodel-version-id": "DCAE_INSTANCE_ID.dcae-tcamodel version",
    "input-parameters:"request parameters",  // ... This is  "target_type": "VNF",
       the service instance recreation input looked up by CL.
    "targetresource-version": "generic-vnf.vnf-name",
some version"
}
 
 
Example of response body:
{
  "AAI": {  			"genericservice-vnf.vnfinstance-nameid" : "vCPE_Infrastructure_vGMUX_demo_app"176d9eba-1662-4289-8396-0097b50fd485",
    "service-type":        }"E2E Service",
    "service-role": "E2E  Service",
    "frommodel-invariant-id": "DCAEc22a9483-d2b6-49cc-b1f7-ef34c93572a1",
      
     "policyScopemodel-version-id": "DCAE",
      "71d0e396-e246-4c23-aa57-6da2043d6209",
     "policyName"input-parameters: "DCAE.Config_tca-hi-lo.....;",             "policyVersion": "v0.0.1",
       // ... This is the service instance recreation input looked up by CL.
    "closedLoopEventStatusresource-version": "ABATED1528975017336"
}  

APPC API Interaction

Code Block
titleAPPC request
linenumberstrue
collapsetrue
{
  "bodyrelationship-list": {
         "inputrelationship": {[
      "common-header": {     {
   "timestamp": "2017-08-25T21:06:23.037Z",
        "apirelated-verto": "2.00pnf",
            "originatorrelated-idlink": "a20e2073-30b1-4357-893b-f5ed57b66ef0",
        "request-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0",/aai/v11/network/pnfs/pnf/MME-0001",
            "subrelationship-request-iddata": "1", [
            "flags": {}       },{    
  "action": "Restart",       "action-identifiers": {         "vnfrelationship-idkey": "vCPE_Infrastructure_vGMUX_demo_app"pnf.pnf-id",      
 }     }   },   "version": "2.0",   "rpc-name": "restart",   "correlationrelationship-idvalue": "a20e2073176d9eba-30b11662-43574289-893b8396-f5ed57b66ef0-1",0097b50fd466"
                  "type": "request"
}
Code Block
titleAPPC response
linenumberstrue
collapsetrue
{
  "body": { }
                ],
            "outputrelated-to-property": [
 {         "common-header": {          {
"timestamp": "2017-08-25T21:06:23.037Z",         "api-ver": "2.00",         "originatorproperty-idkey": "a20e2073-30b1-4357-893b-f5ed57b66ef0pnf.pnf-name",      
  "request-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0",         "sub-request-id": "1",         "flagsproperty-value": {}"MME-0001"
      },       "status": {      }
  "code": 400,         "message": "Restart Successful"  ]
    }     }   }, 
 "version": "2.00",   "rpc-name": "restart",  ]
"correlation-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0-1",   "type": "response"}
}

VOLTE

Policy Creation

...


SO API Interaction





requestParameters: '{}'