--- /dev/null
+/*
+ * ================================================================================
+ * Copyright (C) 2018 AT&T Intellectual Property. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+*/
+
+package org.onap.oof.osdf.policies.placement
+
+import java.util.UUID
+
+annotation "http://org.onap" as onap
+annotation "http://org.onap.policy" as policy
+
+type UUID wraps UUID
+
+/*
+ * Comparison operators
+ */
+enum ComparisonOperator{
+ less=1, grater=2, lessEqual=3, greaterEqual=4, equal=5, notEqual=6
+}
+
+enum TenantType{
+ GW_TENANT_ID=1, PORTAL_TENANT_ID=2
+}
+
+/*
+ * Computational operators
+ */
+enum ComputationalOperator{
+ sum=1, product=2
+}
+
+
+/*
+ * Qualifier types
+ */
+enum Qualifier{
+ same=1, different=2
+}
+
+/*
+ * Zone category
+ */
+enum ZoneCategory{
+ disaster=1, region=2, complex=3, time=4, maintenance=5
+}
+
+/*
+ * Geographical region types
+ */
+enum GeoRegion{
+ US=1, EMEA=2, AP=3, CALA=4, CA=5, INTERNATIONAL=6
+}
+
+/*
+ * Parameters
+ */
+enum Parameter{
+ distance=0, latency=1, cloud_version=2
+ //thoughput=1, geoDistance=1, airDistance=2, latency=3, bandwidth=4
+}
+
+
+/*
+ * The type of inventory defined in cloud
+ */
+enum InventoryType{
+ service=1, cloud=2
+}
+
+/*
+ * The type of network
+ */
+ enum NetworkType{
+ ip=1
+ }
+
+/*
+ * Objective functions.
+ */
+
+enum ObjectiveFunction{
+ minimize=1, maximize=2
+}
+
+/*
+ * This is a model of a condition.
+ * @param parameter This is the parameter of interest.
+ * @param operator This is a comparison operator.
+ * @param value This is a value of a parameter
+ */
+class ConditionalInfo{
+ @onap(^type = "configuration")
+ Parameter parameter
+ @onap(^type = "configuration")
+ ComparisonOperator operator
+ @onap(^type = "configuration")
+ String value
+}
+
+enum LocationInfo{
+ customer_loc=1, none=2, customer_pref_loc=3
+}
+
+
+/*
+ * Model for distance to location property.
+ * @param distanceCondition This is a distance condition.
+ * @param locationInfo This is a location with respect to which distance condition is applied.
+ */
+class DistanceToLocationProperty{
+ //distanceCondition.parameter must be distance.
+ @onap(^type = "configuration")
+ contains ConditionalInfo distanceCondition
+ @onap(^type = "configuration")
+ LocationInfo locationInfo
+}
+
+enum DistanceToLocationPolicyType{
+ distance_to_location=1
+}
+
+/*
+ * Model for distance to location policy.
+ * @param identity This is an identity created by a user.
+ * @param type This is the type of a policy.
+ * @param resourceInstance This is a list of resource instances over which this policy is applied.
+ * @param distanceToLocationProperty This is the distance properties of the policy.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class DistanceToLocationPolicy extends OOFPolicyMetaInfo{
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ DistanceToLocationPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains DistanceToLocationProperty distanceToLocationProperty
+}
+
+/*
+ * The property associated with the NetworkBetweenDemandsPolicy.
+ * @param latencyCondition The latency property associated with the policy.
+ * @param locationInfo The customer location information.
+ */
+class NetworkToLocationProperty{
+ //latencyCondition.parameter must be latency.
+ @onap(^type = "configuration")
+ contains ConditionalInfo latencyCondition
+ @onap(^type = "configuration")
+ LocationInfo locationInfo
+}
+
+enum NetworkToLocationPolicyType{
+ network_to_location=1
+}
+
+/*
+ * Network between demands policy.
+ * @param type The type of a policy.
+ * @param resourceInstanceType The resources associated with a policy.
+ * @param networkToLocationProperty The property associated with the policy.
+ */
+
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class NetworkToLocationPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ NetworkToLocationPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains NetworkToLocationProperty networkToLocationProperty
+}
+
+/*
+ * The property associated with the NetworkBetweenDemandsPolicy.
+ * @param latencyCondition The latency property associated with the policy.
+ */
+class NetworkBetweenDemandsProperty{
+ //latencyCondition.parameter must be latency.
+ @onap(^type = "configuration")
+ contains ConditionalInfo latencyCondition
+}
+
+enum NetworkBetweenDemandsPolicyType{
+ network_between_demands=1
+}
+
+/*
+ * Network between demands policy.
+ * @param type The type of a policy.
+ * @param resourceInstanceType The resources associated with a policy.
+ * @param networkBetweenDemandsProperty The property associated with the policy.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class NetworkBetweenDemandsPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ NetworkBetweenDemandsPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains NetworkBetweenDemandsProperty networkBetweenDemandsProperty
+}
+
+
+/*
+ * Network roles supported a VNF placement
+ * @param all A list of network roles.
+ */
+class NetworkRoles{
+ @onap(^type = "configuration")
+ String[] all
+}
+
+/*
+ * Complex names supported by a VNF placement
+ * @param any A list of complex names.
+ */
+class Complex{
+ @onap(^type = "configuration")
+ String[] any
+}
+/*
+ * This are the cloud properties.
+ * @param cloudVersion This is the version of cloud.
+ * @param cloudType This is the type of cloud.
+ * @param dataPlace This is the type of data plane.
+ * @param hypervisor This is the type of hypervisor.
+ * @param networkRoles This is a list of connected networks.
+ * @param exclusivityGroups This is an exclusivity group Id
+ * @param state State in which a VNF should be located.
+ * @param country Country in which a VNF should be located.
+ * @param getRegion Geographical region in which a VNF should be located.
+ */
+class cloudAttributeProperty{
+ //cloudVersionCondition.parameter must be cloudVersion.
+ @onap(^type = "configuration")
+ String cloudVersion
+ @onap(^type = "configuration")
+ String cloudType
+ @onap(^type = "configuration")
+ String dataPlane
+ @onap(^type = "configuration")
+ String hypervisor
+ @onap(^type = "configuration")
+ contains NetworkRoles networkRoles
+ @onap(^type = "configuration")
+ contains Complex complex
+ @onap(^type = "configuration")
+ String exclusivityGroups
+ @onap(^type = "configuration")
+ String state
+ @onap(^type = "configuration")
+ String country
+ @onap(^type = "configuration")
+ GeoRegion geoRegion
+ @onap(^type = "configuration")
+ String replicationRole
+
+}
+
+enum cloudAttributePolicyType{
+ attribute=1
+}
+
+/*
+ * Model for the cloud attribute policy.
+ * @param type This is the type of a policy.
+ * @param resourceInstance This is a list of resources over which the policy is applied.
+ * @param cloudAttributeProperty This is the properties associated with the policy.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class cloudAttributePolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ cloudAttributePolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains cloudAttributeProperty cloudAttributeProperty
+}
+
+/*
+ * The property associated with the capacity policy.
+ * @param tenant The tenant whose capacity needs to be checked.
+ * @param description The location of a heat template.
+ */
+class CapacityProperty{
+ @onap(^type = "configuration")
+ TenantType tenant
+ @onap(^type = "configuration")
+ String description
+}
+
+enum CapacityPolicyType{
+ cloud_capacity=1
+}
+
+/*
+ * Capacity policy
+ * @param type The type of a policy.
+ * @param resourceInstanceType The type of resources associated with a policy.
+ * @param capacityProperty The property associated with a policy.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class CapacityPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ CapacityPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains CapacityProperty capacityProperty
+}
+
+enum InventoryGroupPolicyType{
+ inventory_group = 1
+}
+
+/*
+ * Model for the inventory group policy.
+ * @param type This is the type of a policy.
+ * @param resourceInstance This is a list of resources that must be grouped/paired
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class InventoryGroupPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ InventoryGroupPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+}
+
+/*
+ * This is the property associated with this policy.
+ * @param controller onap controller.
+ * @param request This should be key-value pairs to be sent in a request.
+ */
+class ResourceInstanceProperty{
+ @onap(^type = "configuration")
+ String controller
+ @onap(^type = "configuration")
+ String request
+}
+
+enum ResourceInstancePolicyType{
+ instance_fit=1
+}
+/*
+ * Model for the resource instance policy.
+ * @param type This is the type of a policy.
+ * @param resourceInstance This is a list of resources.
+ * @param resourceInstanceProperty This is a property associated with each resource in the list.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class ResourceInstancePolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ ResourceInstancePolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains ResourceInstanceProperty resourceInstanceProperty
+
+}
+
+/*
+ * This is the property associated with this policy.
+ * @param controller onap controller
+ * @param request This should be key-value pairs to be sent in a request.
+ */
+class ResourceRegionProperty{
+ @onap(^type = "configuration")
+ String controller
+ @onap(^type = "configuration")
+ String request
+}
+
+enum ResourceRegionPolicyType{
+ region_fit=1
+}
+
+/*
+ * Model for the resource region policy
+ * @param type This is the type of a policy.
+ * @param resourceInstance This is a list of resources.
+ * @param resourceRegionProperty This is a property associated with this policy.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class ResourceRegionPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ ResourceRegionPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains ResourceRegionProperty resourceRegionProperty
+}
+
+/*
+ * This is the property associated with zone policy.
+ * @param qualifier This is the qualifier.
+ * @param category This is the category of a zone.
+ */
+class ZoneProperty{
+ @onap(^type = "configuration")
+ Qualifier qualifier
+ @onap(^type = "configuration")
+ ZoneCategory category
+}
+
+enum ZonePolicyType{
+ zone=1
+}
+
+/*
+ * Model of the zone policy.
+ * @param type This is the type of a policy.
+ * @param resourceInstanceType This is a list of resources.
+ * @param zoneProperty This is the property associated with the policy.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+
+class ZonePolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ ZonePolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains ZoneProperty zoneProperty
+}
+
+/*
+ * The property associated with a VNF type.
+ * @param inventoryProvider The onap entity providing inventory information.
+ * @param inventoryType The type of an inventory.
+ * @param serviceId The id of a service.
+ */
+class VNFPolicyProperty{
+ @onap(^type = "configuration")
+ String inventoryProvider
+ @onap(^type = "configuration")
+ InventoryType inventoryType
+ @onap(^type = "configuration")
+ contains Attributes attributes
+}
+
+/*
+ * The property associated with a Subscriber type.
+ * @param subscriberName The name of a subscriber.
+ * @param subscriberRole The role of a subscriber.
+ * @param provStatus The provisioning status of a subscriber.
+ */
+class SubscriberPolicyProperty{
+ @onap(^type = "configuration")
+ String[] subscriberName
+ @onap(^type = "configuration")
+ String[] subscriberRole
+ @onap(^type = "configuration")
+ String[] provStatus
+}
+
+enum VNFPolicyType{
+ vnfPolicy=1
+}
+
+enum SubscriberPolicyType{
+ subscriberPolicy=1
+}
+
+class Attributes{
+ @onap(^type = "configuration")
+ String globalCustomerId
+ @onap(^type = "configuration")
+ String operationalStatus
+ @onap(^type = "configuration")
+ String[] orchestrationStatus
+ @onap(^type = "configuration")
+ String modelInvariantId
+ @onap(^type = "configuration")
+ String modelVersionId
+ @onap(^type = "configuration")
+ String equipmentRole
+}
+
+/*
+ * Policy associated with a VNF.
+ * @param resourceInstance This parameter identifies a specific VNF.
+ * @param inventoryProvider This is the provider of inventory.
+ * @param inventoryType This is the type of inventory.
+ * @param serviceType The service associated with a VNF.
+ * @param serviceId The Id associated with a service.
+ * @param globalCustomerId The global id of a customer.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class VNFPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ VNFPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains VNFPolicyProperty[] property
+}
+
+/*
+ * Policy associated with a Subscriber.
+ * @param subscriberName The name of a subscriber.
+ * @param subscriberRole The role of a subscriber.
+ * @param provStatus The provisioning status of a subscriber.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class SubscriberPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ SubscriberPolicyType ^type
+ @onap(^type = "configuration")
+ contains SubscriberPolicyProperty[] property
+}
+
+
+/*
+ * This is the property associated with this policy.
+ * @param providerUrl This is the url of provider to check the capacity.
+ * @param request This should be key-value pairs to be sent in a request.
+ */
+class InstanceReservationProperty{
+ @onap(^type = "configuration")
+ String controller
+ @onap(^type = "configuration")
+ String request
+}
+
+enum InstanceReservationPolicyType{
+ instance_reservation=1
+}
+/*
+ * Model for the resource instance policy.
+ * @param identity This is an identity created by a user.
+ * @param type This is the type of a policy.
+ * @param resourceInstance This is a list of resources.
+ * @param resourceInstanceProperty This is a property associated with each resource in the list.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class InstanceReservationPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ InstanceReservationPolicyType ^type
+ @onap(^type = "configuration")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ contains InstanceReservationProperty instanceReservationProperty
+
+}
+
+/*
+ * This is a model of an operand.
+ * @param parameter This is a parameter.
+ * @param associativity This is a list of entities with which a parameter is associated.
+ */
+ /*
+class Operand{
+ @onap(^type = "configuration")
+ Parameter parameter
+ @onap(^type = "configuration")
+ Entity associativity
+}
+*/
+
+/*
+ * This is the optimization function.
+ * @param identity This is an identity of a function.
+ * @param operation This is a computational operator.
+ * @param leftOperand This is a left operand of a function.
+ * @param rightOperand This is a right operand of a function.
+ */
+/*
+class OptimizationFunction{
+ @onap(^type = "configuration")
+ ExpressionIdentity identity
+ @onap(^type = "configuration")
+ ComputationalOperator operation
+ @onap(^type = "configuration")
+ contains Operand[] operands
+}
+*/
+
+/*
+ * Properties associated with a sub-expression.
+ * @param weight The weight of an expression.
+ * @param parameter The parameter involved in an expression.
+ * @param entity The entities involved in an expression.
+ * @param operator The operator of an expression.
+ * @param customerLocationInfo The location of a customer.
+ */
+class AttributeProperty{
+ @onap(^type = "configuration")
+ double weight
+ @onap(^type = "configuration")
+ Parameter parameter
+ @onap(^type = "configuration")
+ String[] resource
+ @onap(^type = "configuration")
+ ComputationalOperator operator
+ @onap(^type = "configuration")
+ LocationInfo customerLocationInfo
+}
+
+enum PlacementOptimizationPolicyType{
+ placementOptimization=1
+}
+
+/*
+ * @param operator An operator in an expression.
+ * @param parameterAttributes Represents sub-expression
+ */
+class ObjectiveParameter{
+ @onap(^type = "configuration")
+ ComputationalOperator operator
+ @onap(^type = "configuration")
+ contains AttributeProperty[] parameterAttributes
+}
+
+/*
+ * Model of the placement optimization policy.
+ * @param type This is the type of a policy.
+ * @param objective This is an objective function.
+ * @param objectiveParameter The parameter/expression to be optimized.
+ */
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+
+class PlacementOptimizationPolicy extends OOFPolicyMetaInfo{
+ @policy (matching = "true")
+ @onap(^type = "configuration")
+ PlacementOptimizationPolicyType ^type
+ @onap(^type = "configuration")
+ ObjectiveFunction objective
+ @onap(^type = "configuration")
+ contains ObjectiveParameter objectiveParameter
+}
+
+
+/*
+ * Meta information required for oof policies.
+ * @param identity This is a user-defined identity.
+ * @param policyScope The scope of a policy
+ */
+
+@policy (
+ policyTemplate = "OOF-PLACEMENT"
+)
+class OOFPolicyMetaInfo{
+ @onap(^type = "configuration")
+ String identity
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ contains Scope policyScope
+}
+
+/*
+ * Scopes in which a policy is applicable.
+ * @param serviceType The type of a service.
+ * @param networkType The type of a network
+ * @param geoRigion The geographical region.
+ * @param resourceInstanceType The resources associated with a policy/
+ * @param subscriberRole
+ */
+class Scope{
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ String[] serviceType
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ String[] networkType
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ String[] geoRegion
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ String[] resourceInstanceType
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ String[] modelInvariantId
+ @onap(^type = "configuration")
+ @policy (matching = "true")
+ String[] subscriberRole
+}
Code Review / optf / osdf.git / blobdiff