diff options
Diffstat (limited to 'catalog-be/src/main/resources/import/tosca')
22 files changed, 1452 insertions, 396 deletions
diff --git a/catalog-be/src/main/resources/import/tosca/artifact-types/artifactTypes.yml b/catalog-be/src/main/resources/import/tosca/artifact-types/artifactTypes.yml index df5cf0ab75..bfd078923b 100644 --- a/catalog-be/src/main/resources/import/tosca/artifact-types/artifactTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/artifact-types/artifactTypes.yml @@ -30,4 +30,10 @@ tosca.artifacts.Implementation: description: This artifact type represents the parent type for all implementation artifacts in TOSCA. These artifacts are used to implement operations of TOSCA interfaces either directly (e.g., scripts) or indirectly (e.g., config. files). tosca.artifacts.nfv.SwImage: - derived_from: tosca.artifacts.Deployment.Image
\ No newline at end of file + derived_from: tosca.artifacts.Deployment.Image + description: describes the software image which is directly loaded on the virtualisation container realizing of the VDU or is to be loaded on a virtual +tosca.artifacts.Implementation.nfv.Mistral: + derived_from: tosca.artifacts.Implementation + description: artifacts for Mistral workflows + mime_type: application/x-yaml + file_ext: [ yaml ] diff --git a/catalog-be/src/main/resources/import/tosca/capability-types/capabilityTypes.yml b/catalog-be/src/main/resources/import/tosca/capability-types/capabilityTypes.yml index 384b7e1248..b6c2de81cd 100644 --- a/catalog-be/src/main/resources/import/tosca/capability-types/capabilityTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/capability-types/capabilityTypes.yml @@ -1,4 +1,4 @@ -tosca.capabilities.Root: +tosca.capabilities.Root: description: The TOSCA root Capability Type all other TOSCA base Capability Types derive from tosca.capabilities.Attachment: derived_from: tosca.capabilities.Root @@ -7,7 +7,7 @@ tosca.capabilities.Node: tosca.capabilities.Container: derived_from: tosca.capabilities.Root properties: - num_cpus: + num_cpus: type: integer required: false constraints: @@ -17,12 +17,12 @@ tosca.capabilities.Container: required: false constraints: - greater_or_equal: 0.1 GHz - disk_size: + disk_size: type: scalar-unit.size required: false constraints: - greater_or_equal: 0 MB - mem_size: + mem_size: type: scalar-unit.size required: false constraints: @@ -30,7 +30,7 @@ tosca.capabilities.Container: org.openecomp.capabilities.PortMirroring: derived_from: tosca.capabilities.Root properties: - connection_point: + connection_point: type: org.openecomp.datatypes.PortMirroringConnectionPointDescription tosca.capabilities.Endpoint: derived_from: tosca.capabilities.Root @@ -44,15 +44,15 @@ tosca.capabilities.Endpoint: secure: type: boolean default: false - url_path: + url_path: type: string required: false - port_name: + port_name: type: string required: false network_name: type: string - required: false + required: false default: PRIVATE initiator: type: string @@ -77,15 +77,15 @@ tosca.capabilities.Endpoint.Public: # Change the default network_name to use the first public network found network_name: PUBLIC floating: - description: > + description: > indicates that the public address should be allocated from a pool of floating IPs that are associated with the network. type: boolean default: false status: experimental dns_name: - description: The optional name to register with DNS + description: The optional name to register with DNS type: string - required: false + required: false status: experimental tosca.capabilities.Endpoint.Admin: derived_from: tosca.capabilities.Endpoint @@ -93,13 +93,13 @@ tosca.capabilities.Endpoint.Admin: properties: secure: true tosca.capabilities.Endpoint.Database: - derived_from: tosca.capabilities.Endpoint + derived_from: tosca.capabilities.Endpoint tosca.capabilities.OperatingSystem: derived_from: tosca.capabilities.Root properties: architecture: type: string - required: false + required: false type: type: string required: false @@ -226,54 +226,71 @@ org.openecomp.capabilities.FabricConfiguration: #ONAP types tosca.capabilities.nfv.VirtualStorage: - derived_from: tosca.capabilities.Root -tosca.capabilities.nfv.VirtualCompute: derived_from: tosca.capabilities.Root + description: Describes the attachment capabilities related to Vdu.Storage +tosca.capabilities.nfv.VirtualCompute: + derived_from: tosca.capabilities.Node + description: Describes the capabilities related to virtual compute resources properties: logical_node: - type: tosca.datatypes.nfv.LogicalNodeData - required: false - compute_requirements: type: map - entry_schema: - type: string + description: Describes the Logical Node requirements required: false + entry_schema: + type: tosca.datatypes.nfv.LogicalNodeData requested_additional_capabilities: type: map + description: Describes additional capability for a particular VDU + required: false entry_schema: - type: tosca.datatypes.nfv.RequestedAdditionalCapability + type: tosca.datatypes.nfv.RequestedAdditionalCapability + compute_requirements: + type: map required: false + entry_schema: + type: string virtual_memory: type: tosca.datatypes.nfv.VirtualMemory + description: Describes virtual memory of the virtualized compute required: true virtual_cpu: type: tosca.datatypes.nfv.VirtualCpu + description: Describes virtual CPU(s) of the virtualized compute required: true + virtual_local_storage: + type: list + description: A list of virtual system disks created and destroyed as part of the VM lifecycle + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualBlockStorageData + description: virtual system disk definition tosca.capabilities.nfv.VirtualBindable: - derived_from: tosca.capabilities.Root + derived_from: tosca.capabilities.Node + description: Indicates that the node that includes it can be pointed by a tosca.relationships.nfv.VirtualBindsTo relationship type which is used to model the VduHasCpd association tosca.capabilities.nfv.VirtualLinkable: derived_from: tosca.capabilities.Root + description: A node type that includes the VirtualLinkable capability indicates that it can be pointed by tosca.relationships.nfv.VirtualLinksTo relationship type tosca.capabilities.nfv.ExtVirtualLinkable: derived_from: tosca.capabilities.Root -tosca.capabilities.nfv.Forwarder: +tosca.capabilities.nfv.Forwarder: derived_from: tosca.capabilities.Root -tosca.capabilities.nfv.ext.GuestOs: +tosca.capabilities.nfv.ext.GuestOs: derived_from: tosca.capabilities.Root -tosca.capabilities.nfv.ext.ImageFile: +tosca.capabilities.nfv.ext.ImageFile: derived_from: tosca.capabilities.Root -tosca.capabilities.nfv.ext.LocalAttachment: +tosca.capabilities.nfv.ext.LocalAttachment: derived_from: tosca.capabilities.Root -tosca.capabilities.nfv.ext.Compute.Container.Architecture: +tosca.capabilities.nfv.ext.Compute.Container.Architecture: derived_from: tosca.capabilities.Root - properties: - num_cpus: + properties: + num_cpus: type: string required: false - flavor_extra_specs: + flavor_extra_specs: type: map required: false - entry_schema: + entry_schema: type: string - mem_size: + mem_size: type: string required: false diff --git a/catalog-be/src/main/resources/import/tosca/data-types/dataTypes.yml b/catalog-be/src/main/resources/import/tosca/data-types/dataTypes.yml index 8d9f136427..85591fa2bf 100644 --- a/catalog-be/src/main/resources/import/tosca/data-types/dataTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/data-types/dataTypes.yml @@ -34,16 +34,16 @@ scalar-unit.time: scalar-unit.frequency: derived_from: scalar-unit -tosca.datatypes.Credential: +tosca.datatypes.Credential: derived_from: tosca.datatypes.Root - properties: - protocol: + properties: + protocol: type: string required: false - token_type: + token_type: type: string default: password - token: + token: type: string keys: type: map @@ -61,7 +61,7 @@ org.openecomp.datatypes.PortMirroringConnectionPointDescription: type: string nfc_naming_code: type: string - network_role: + network_role: type: string pps_capacity: type: string @@ -72,38 +72,38 @@ org.openecomp.datatypes.PortMirroringConnectionPointDescription: type: string description: deprecated -tosca.datatypes.TimeInterval: +tosca.datatypes.TimeInterval: derived_from: tosca.datatypes.Root properties: - start_time: + start_time: type: timestamp required: true - end_time: + end_time: type: timestamp required: true tosca.datatypes.network.NetworkInfo: derived_from: tosca.datatypes.Root properties: - network_name: + network_name: type: string - network_id: + network_id: type: string addresses: type: list entry_schema: type: string -tosca.datatypes.network.PortInfo: +tosca.datatypes.network.PortInfo: derived_from: tosca.datatypes.Root - properties: - port_name: + properties: + port_name: type: string - port_id: + port_id: type: string - network_id: + network_id: type: string - mac_address: + mac_address: type: string addresses: type: list @@ -112,22 +112,22 @@ tosca.datatypes.network.PortInfo: tosca.datatypes.network.PortDef: derived_from: integer - constraints: + constraints: - in_range: [ 1, 65535 ] -tosca.datatypes.network.PortSpec: +tosca.datatypes.network.PortSpec: derived_from: tosca.datatypes.Root - properties: - protocol: + properties: + protocol: type: string required: true default: tcp constraints: - valid_values: [ udp, tcp, igmp ] - target: + target: type: tosca.datatypes.network.PortDef target_range: - type: range + type: range constraints: - in_range: [ 1, 65535 ] source: @@ -168,7 +168,7 @@ org.openecomp.datatypes.heat.network.subnet.HostRoute: description: The next hop for the destination required: false status: SUPPORTED - + org.openecomp.datatypes.heat.network.AllocationPool: derived_from: tosca.datatypes.Root description: The start and end addresses for the allocation pool @@ -246,7 +246,7 @@ org.openecomp.datatypes.heat.network.neutron.Subnet: default: [] status: SUPPORTED entry_schema: - type: string + type: string host_routes: type: list description: The gateway IP address @@ -868,7 +868,7 @@ org.openecomp.datatypes.Root: supplemental_data: type: map entry_schema: - description: > + description: > A placeholder for missing properties that would be included in future ecomp model versions. fromat <key>:<value> type: string @@ -885,15 +885,15 @@ org.openecomp.datatypes.AssignmentRequirements: count: description: number of assignments required type: integer - required: false - + required: false + org.openecomp.datatypes.network.SubnetAssignments: derived_from: org.openecomp.datatypes.Root properties: ip_network_address_plan: type: string required: false - description: Reference to EIPAM, VLAN or other address plan ID used to assign subnets to this network + description: Reference to EIPAM, VLAN or other address plan ID used to assign subnets to this network dhcp_enabled: type: boolean required: false @@ -907,7 +907,7 @@ org.openecomp.datatypes.network.SubnetAssignments: cidr_mask: type: integer required: true - description: The default subnet CIDR mask + description: The default subnet CIDR mask min_subnets_count: type: integer default: 1 @@ -967,7 +967,7 @@ org.openecomp.datatypes.network.NetworkAssignments: is_trunked: type: boolean required: true - description: \"true\" indicates that network is trunked + description: \"true\" indicates that network is trunked default: false org.openecomp.datatypes.network.ProviderNetwork: @@ -976,7 +976,7 @@ org.openecomp.datatypes.network.ProviderNetwork: is_provider_network: type: boolean required: true - description: \"true\" indicates that this a Neutron provider type of network + description: \"true\" indicates that this a Neutron provider type of network physical_network_name: type: string required: false @@ -1291,126 +1291,164 @@ org.openecomp.datatypes.network.RelatedNetworksAssignments: type: string description: The network role of the related network, sharing provider network. required: false - -#ONAP types + +#ONAP types +tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties: + derived_from: tosca.datatypes.Root + description: VnfcAdditionalConfigurableProperties type is an empty base type for deriving data types for describing additional configurable properties for a given VNFC. + # below description properties added as optional, since atleast one property required to define a dataType in SDC + properties: + description: + type: string + required: false tosca.datatypes.nfv.VnfcConfigurableProperties: derived_from: tosca.datatypes.Root + description: Defines the configurable properties of a VNFC properties: additional_vnfc_configurable_properties: - type: map - entry_schema: - type: string + type: tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties + description: Describes additional configuration for VNFC that can be modified using the ModifyVnfInfo operation required: false + # derived types are expected to introduce + # additional_vnfc_configurable_properties with its type derived from + # tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties tosca.datatypes.nfv.RequestedAdditionalCapability: derived_from: tosca.datatypes.Root + description: describes requested additional capability for a particular VDU properties: - #name: - # key of containing map + requested_additional_capability_name: + type: string + description: Identifies a requested additional capability for the VDU. + required: true support_mandatory: type: boolean + description: Indicates whether the requested additional capability is mandatory for successful operation. required: true min_requested_additional_capability_version: type: string + description: Identifies the minimum version of the requested additional capability. required: false preferred_requested_additional_capability_version: type: string + description: Identifies the preferred version of the requested additional capability. required: false - requested_additional_capability_name: - type: string - required: true target_performance_parameters: type: map + description: Identifies specific attributes, dependent on the requested additional capability type. + required: true entry_schema: type: string - required: true tosca.datatypes.nfv.VirtualMemory: - derived_from: tosca.datatypes.Root - properties: - # Number - virtual_mem_size: - type: scalar-unit.size - required: true - virtual_mem_oversubscription_policy: + derived_from: tosca.datatypes.Root + description: supports the specification of requirements related to virtual memory of a virtual compute resource + properties: + virtual_mem_size: + type: scalar-unit.size + description: Amount of virtual memory. + required: true + virtual_mem_oversubscription_policy: + type: string + description: The memory core oversubscription policy in terms of virtual memory to physical memory on the platform. + required: false + vdu_mem_requirements: + type: map + description: The hardware platform specific VDU memory requirements. A map of strings that contains a set of key-value pairs that describes hardware platform specific VDU memory requirements. + required: false + entry_schema: type: string - required: false - vdu_memory_requirements: - type: map - entry_schema: - type: string - required: false - numa_enabled: - type: boolean - required: false + numa_enabled: + type: boolean + description: It specifies the memory allocation to be cognisant of the relevant process/core allocation. + required: false + default: false tosca.datatypes.nfv.VirtualCpuPinning: derived_from: tosca.datatypes.Root + description: Supports the specification of requirements related to the virtual CPU pinning configuration of a virtual compute resource properties: - cpu_pinning_policy: - type: string # CpuPinningPolicy + virtual_cpu_pinning_policy: + type: string + description: 'Indicates the policy for CPU pinning. The policy can take values of "static" or "dynamic". In case of "dynamic" the allocation of virtual CPU cores to logical CPU cores is decided by the VIM. (e.g.: SMT (Simultaneous Multi-Threading) requirements). In case of "static" the allocation is requested to be according to the virtual_cpu_pinning_rule.' + required: false constraints: - valid_values: [ static, dynamic ] + virtual_cpu_pinning_rule: + type: list + description: Provides the list of rules for allocating virtual CPU cores to logical CPU cores/threads required: false - cpu_pinning_map: - type: map entry_schema: type: string - required: false tosca.datatypes.nfv.VirtualCpu: derived_from: tosca.datatypes.Root + description: Supports the specification of requirements related to virtual CPU(s) of a virtual compute resource properties: cpu_architecture: type: string + description: CPU architecture type. Examples are x86, ARM required: false num_virtual_cpu: type: integer + description: Number of virtual CPUs required: true + constraints: + - greater_than: 0 virtual_cpu_clock: type: scalar-unit.frequency + description: Minimum virtual CPU clock rate required: false virtual_cpu_oversubscription_policy: type: string + description: CPU core oversubscription policy e.g. the relation of virtual CPU cores to physical CPU cores/threads. required: false vdu_cpu_requirements: type: map + description: The hardware platform specific VDU CPU requirements. A map of strings that contains a set of key-value pairs describing VDU CPU specific hardware platform requirements. + required: false entry_schema: type: string - required: false virtual_cpu_pinning: type: tosca.datatypes.nfv.VirtualCpuPinning + description: The virtual CPU pinning configuration for the virtualised compute resource. required: false tosca.datatypes.nfv.LogicalNodeData: derived_from: tosca.datatypes.Root + description: Describes compute, memory and I/O requirements associated with a particular VDU. properties: logical_node_requirements: - type: map # not defined in SOL001 v.6.0 + type: map + description: The logical node-level compute, memory and I/O requirements. A map of strings that contains a set of key-value pairs that describes hardware platform specific deployment requirements, including the number of CPU cores on this logical node, a memory configuration specific to a logical node or a requirement related to the association of an I/O device with the logical node. + required: false entry_schema: type: string - required: false tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements: derived_from: tosca.datatypes.Root - properties: - name: + description: Describes requirements on a virtual network interface + properties: + name: type: string - required: false - description: + description: Provides a human readable name for the requirement. + required: false + description: type: string + description: Provides a human readable description of the requirement. required: false support_mandatory: type: boolean + description: Indicates whether fulfilling the constraint is mandatory (TRUE) for successful operation or desirable (FALSE). required: true - requirement: - type: string # not specified - required: false network_interface_requirements: type: map + description: The network interface requirements. A map of strings that contain a set of key-value pairs that describes the hardware platform specific network interface deployment requirements. + required: true entry_schema: type: string - required: true nic_io_requirements: type: tosca.datatypes.nfv.LogicalNodeData + description: references (couples) the CP with any logical node I/O requirements (for network devices) that may have been created. Linking these attributes is necessary so that so that I/O requirements that need to be articulated at the logical node level can be associated with the network interface requirements associated with the CP. required: false + tosca.datatypes.nfv.injectFile: #used for vCPE usecase derived_from: tosca.datatypes.Root - properties: + properties: source_path: type: string required: true @@ -1419,61 +1457,77 @@ tosca.datatypes.nfv.injectFile: #used for vCPE usecase required: true tosca.datatypes.nfv.L2AddressData: derived_from: tosca.datatypes.Root + description: Describes the information on the MAC addresses to be assigned to a connection point. properties: - mac_address_assignment: + mac_address_assignment: type: boolean + description: Specifies if the address assignment is the responsibility of management and orchestration function or not. If it is set to True, it is the management and orchestration function responsibility required: true - address: - type: string - required: false tosca.datatypes.nfv.L3AddressData: derived_from: tosca.datatypes.Root - properties: - ip_address_assignment: + description: Provides information about Layer 3 level addressing scheme and parameters applicable to a CP + properties: + ip_address_assignment: type: boolean + description: Specifies if the address assignment is the responsibility of management and orchestration function or not. If it is set to True, it is the management and orchestration function responsibility required: true - floating_ip_activated: + floating_ip_activated: type: boolean + description: Specifies if the floating IP scheme is activated on the Connection Point or not required: true ip_address_type: type: string + description: Defines address type. The address type should be aligned with the address type supported by the layer_protocols properties of the parent VnfExtCp required: false constraints: - - valid_values: [ipv4, ipv6] + - valid_values: [ ipv4, ipv6 ] number_of_ip_address: type: integer + description: Minimum number of IP addresses to be assigned required: false - fixed_ip_address: #used for vCPE usecase + constraints: + - greater_than: 0 + fixed_ip_address: #Introduced from Beijing release, only used for vCPE usecase type: list entry_schema: type: string required: false tosca.datatypes.nfv.AddressData: - properties: - address_type: - constraints: - - valid_values: [mac_address, ip_address] + derived_from: tosca.datatypes.Root + description: Describes information about the addressing scheme and parameters applicable to a CP + properties: + address_type: type: string + description: Describes the type of the address to be assigned to a connection point. The content type shall be aligned with the address type supported by the layerProtocol property of the connection point required: true - l2_address_data: - required: false + constraints: + - valid_values: [ mac_address, ip_address ] + l2_address_data: type: tosca.datatypes.nfv.L2AddressData - l3_address_data: + description: Provides the information on the MAC addresses to be assigned to a connection point. required: false + l3_address_data: type: tosca.datatypes.nfv.L3AddressData + description: Provides the information on the IP addresses to be assigned to a connection point + required: false tosca.datatypes.nfv.ConnectivityType: derived_from: tosca.datatypes.Root - properties: - layer_protocol: - type: string + description: describes additional connectivity information of a virtualLink + properties: + layer_protocols: + type: list + description: Identifies the protocol a virtualLink gives access to (ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire).The top layer protocol of the virtualLink protocol stack shall always be provided. The lower layer protocols may be included when there are specific requirements on these layers. required: true - constraints: - - valid_values: [ethernet, mpls, odu2, ipv4, ipv6, pseudo_wire] - flow_pattern: + entry_schema: + type: string + constraints: + - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] + flow_pattern: type: string + description: Identifies the flow pattern of the connectivity required: false - constraints: # not defined in IFA011 v2.4.1 and SOL001 v.6.0 - - valid_values: [Line, Tree, Mesh] + constraints: + - valid_values: [ line, tree, mesh ] tosca.datatypes.nfv.VlFlavour: derived_from: tosca.datatypes.Root properties: @@ -1481,169 +1535,267 @@ tosca.datatypes.nfv.VlFlavour: type: string tosca.datatypes.nfv.ext.AddressPairs: properties: - ip: + ip: type: string required: false - mac: + mac: type: string required: false tosca.datatypes.nfv.ext.FloatingIP: properties: - external_network: + external_network: type: string required: false - ip_address: + ip_address: type: string required: false tosca.datatypes.nfv.ext.LocationInfo: properties: - availability_zone: + availability_zone: type: string required: false - vimid: + vimid: type: integer required: false - tenant: + tenant: type: string required: false tosca.datatypes.nfv.ext.HostRouteInfo: properties: - destination: + destination: type: string required: false - nexthop: + nexthop: type: string required: false tosca.datatypes.nfv.ext.InjectData: properties: - file_name: + file_name: type: string required: false - file_data: + file_data: type: string required: false tosca.datatypes.nfv.ext.zte.WatchDog: properties: - enable_delay: + enable_delay: type: integer required: false - action: + action: type: string required: false tosca.datatypes.nfv.ext.LocalAffinityOrAntiAffinityRule: properties: - scope: + scope: type: string required: false - affinity_antiaffinity: + affinity_antiaffinity: type: string required: false tosca.datatypes.nfv.VduProfile: derived_from: tosca.datatypes.Root + description: describes additional instantiation data for a given Vdu.Compute used in a specific deployment flavour. properties: min_number_of_instances: type: integer + description: Minimum number of instances of the VNFC based on this Vdu.Compute that is permitted to exist for a particular VNF deployment flavour. required: true + constraints: + - greater_or_equal: 0 max_number_of_instances: type: integer + description: Maximum number of instances of the VNFC based on this Vdu.Compute that is permitted to exist for a particular VNF deployment flavour. required: true - #localAffinityOrAntiAffinityRule: # not defined in SOL001 v.6.0 - # type: tosca.datatypes.nfv.LocalAffinityOrAntiAffinityRule - # required: true - #affinityOrAntiAffinityGroupId: # not defined in SOL001 v.6.0 - # type: string - # required: true - watchdog: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 + constraints: + - greater_or_equal: 0 + watchdog: #Introduced from Beijing release, only used for vCPE usecase, outside the scope of SOL001 v2.5.1 type: string required: true - vmBootUpTimeOut: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 + vmBootUpTimeOut: #Introduced from Beijing release, only used for vCPE usecase, outside the scope of SOL001 v2.5.1 type: integer required: false -tosca.datatypes.nfv.LinkBitRateRequirements: +tosca.datatypes.nfv.LinkBitrateRequirements: derived_from: tosca.datatypes.Root + description: describes the requirements in terms of bitrate for a virtual link properties: root: - type: integer + type: integer # in bits per second + description: Specifies the throughput requirement in bits per second of the link (e.g. bitrate of E-Line, root bitrate of E-Tree, aggregate capacity of E-LAN). required: true + constraints: + - greater_or_equal: 0 leaf: - type: integer - required: true + type: integer # in bits per second + description: Specifies the throughput requirement in bits per second of leaf connections to the link when applicable to the connectivity type (e.g. for E-Tree and E LAN branches). + required: false + constraints: + - greater_or_equal: 0 tosca.datatypes.nfv.Qos: derived_from: tosca.datatypes.Root + description: describes QoS data for a given VL used in a VNF deployment flavour properties: latency: - type: integer #Number [ms] + type: scalar-unit.time #Number [ms] + description: Specifies the maximum latency required: true + constraints: + - greater_than: 0 s packet_delay_variation: - type: integer #Number [ms] + type: scalar-unit.time #Number [ms] + description: Specifies the maximum jitter required: true + constraints: + - greater_or_equal: 0 s packet_loss_ratio: type: float #Number [0 ..1] + description: Specifies the maximum packet loss ratio + required: false constraints: - in_range: [ 0.0, 1.0 ] - required: false -tosca.datatypes.nfv.VlProfile: + +tosca.datatypes.nfv.IpAllocationPool: derived_from: tosca.datatypes.Root + description: Specifies a range of IP addresses properties: - max_bit_rate_requirements: - type: tosca.datatypes.nfv.LinkBitRateRequirements + start_ip_address: + type: string + description: The IP address to be used as the first one in a pool of addresses derived from the cidr block full IP range required: true - min_bit_rate_requirements: - type: tosca.datatypes.nfv.LinkBitRateRequirements + end_ip_address: + type: string + description: The IP address to be used as the last one in a pool of addresses derived from the cidr block full IP range required: true - qos: - type: tosca.datatypes.nfv.Qos - required: false - initiationParameters: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 - type: map - entry_schema: - type: string - required: false - cidr: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 +tosca.datatypes.nfv.L2ProtocolData: + derived_from: tosca.datatypes.Root + description: describes L2 protocol data for a given virtual link used in a specific VNF deployment flavour. + properties: + name: type: string + description: Identifies the network name associated with this L2 protocol. required: false - networkName: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 + network_type: type: string + description: Specifies the network type for this L2 protocol.The value may be overridden at run-time. required: false - startIp: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 - type: string + constraints: + - valid_values: [ flat, vlan, vxlan, gre ] + vlan_transparent: + type: boolean + description: Specifies whether to support VLAN transparency for this L2 protocol or not. + required: false + default: false + mtu: + type: integer + description: Specifies the maximum transmission unit (MTU) value for this L2 protocol. required: false - endIp: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 + constraints: + - greater_than: 0 + segmentation_id: #Introduced from Beijing release, only used for vCPE usecase, outside the scope of SOL001 v2.5.1 + type: integer + required: false + physical_network: #Introduced from Beijing release, only used for vCPE usecase, outside the scope of SOL001 v2.5.1 type: string required: false - gatewayIp: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 +tosca.datatypes.nfv.L3ProtocolData: + derived_from: tosca.datatypes.Root + description: describes L3 protocol data for a given virtual link used in a specific VNF deployment flavour. + properties: + name: type: string + description: Identifies the network name associated with this L3 protocol. required: false - segmentationId: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 - type: integer + ip_version: + type: string + description: Specifies IP version of this L3 protocol.The value of the ip_version property shall be consistent with the value of the layer_protocol in the connectivity_type property of the virtual link node. + required: true + constraints: + - valid_values: [ ipv4, ipv6 ] + cidr: + type: string + description: Specifies the CIDR (Classless Inter-Domain Routing) of this L3 protocol. The value may be overridden at run-time. + required: true + ip_allocation_pools: + type: list + description: Specifies the allocation pools with start and end IP addresses for this L3 protocol. The value may be overridden at run-time. required: false - physicalNetwork: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 + entry_schema: + type: tosca.datatypes.nfv.IpAllocationPool + gateway_ip: type: string + description: Specifies the gateway IP address for this L3 protocol. The value may be overridden at run-time. required: false - networkType: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 + dhcp_enabled: + type: boolean + description: Indicates whether DHCP (Dynamic Host Configuration Protocol) is enabled or disabled for this L3 protocol. The value may be overridden at run-time. + required: false + ipv6_address_mode: type: string + description: Specifies IPv6 address mode. May be present when the value of the ipVersion attribute is "ipv6" and shall be absent otherwise. The value may be overridden at run-time. required: false constraints: - - valid_values: [VLAN, VXLAN] - dhcpEnabled: # not defined in IFA011 v2.4.1 and SOL001 v.6.0 - type: boolean + - valid_values: [ slaac, dhcpv6-stateful, dhcpv6-stateless ] +tosca.datatypes.nfv.VirtualLinkProtocolData: + derived_from: tosca.datatypes.Root + description: describes one protocol layer and associated protocol data for a given virtual link used in a specific VNF deployment flavour + properties: + associated_layer_protocol: + type: string + description: Identifies one of the protocols a virtualLink gives access to (ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire) as specified by the connectivity_type property. + required: true + constraints: + - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] + l2_protocol_data: + type: tosca.datatypes.nfv.L2ProtocolData + description: Specifies the L2 protocol data for a virtual link. Shall be present when the associatedLayerProtocol attribute indicates a L2 protocol and shall be absent otherwise. + required: false + l3_protocol_data: + type: tosca.datatypes.nfv.L3ProtocolData + description: Specifies the L3 protocol data for this virtual link. Shall be present when the associatedLayerProtocol attribute indicates a L3 protocol and shall be absent otherwise. + required: false + +tosca.datatypes.nfv.VlProfile: + derived_from: tosca.datatypes.Root + description: Describes additional instantiation data for a given VL used in a specific VNF deployment flavour. + properties: + max_bitrate_requirements: + type: tosca.datatypes.nfv.LinkBitrateRequirements + description: Specifies the maximum bitrate requirements for a VL instantiated according to this profile. + required: true + min_bitrate_requirements: + type: tosca.datatypes.nfv.LinkBitrateRequirements + description: Specifies the minimum bitrate requirements for a VL instantiated according to this profile. + required: true + qos: + type: tosca.datatypes.nfv.Qos + description: Specifies the QoS requirements of a VL instantiated according to this profile. required: false - vlanTransparent: #Align with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v.6.0 - type: boolean + virtual_link_protocol_data: + type: list + description: Specifies the protocol data for a virtual link. required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkProtocolData tosca.datatypes.nfv.VduLevel: derived_from: tosca.datatypes.Root + description: Indicates for a given Vdu.Compute in a given level the number of instances to deploy properties: number_of_instances: type: integer + description: Number of instances of VNFC based on this VDU to deploy for this level. required: true + constraints: + - greater_or_equal: 0 tosca.datatypes.nfv.ScaleInfo: derived_from: tosca.datatypes.Root + description: Indicates for a given scaleAspect the corresponding scaleLevel properties: - scaleLevel: + scale_level: type: integer + description: The scale level for a particular aspect required: true -tosca.datatypes.nfv.ScaleAspect: + constraints: + - greater_or_equal: 0 +tosca.datatypes.nfv.ScalingAspect: derived_from: tosca.datatypes.Root properties: name: @@ -1652,131 +1804,460 @@ tosca.datatypes.nfv.ScaleAspect: description: type: string required: true - associated_group: - type: string #Identifier - required: false max_scale_level: - type: integer #PositiveInteger + type: integer # positiveInteger required: true + constraints: + - greater_or_equal: 0 + step_deltas: + type: list + required: false + entry_schema: + type: string # Identifier tosca.datatypes.nfv.InstantiationLevel: derived_from: tosca.datatypes.Root + description: Describes the scale level for each aspect that corresponds to a given level of resources to be instantiated within a deployment flavour in term of the number VNFC instances properties: description: type: string + description: Human readable description of the level required: true - vdu_levels: - type: map # key: vduId - required: true - entry_schema: - type: tosca.datatypes.nfv.VduLevel scale_info: type: map # key: aspectId + description: Represents for each aspect the scale level that corresponds to this instantiation level. scale_info shall be present if the VNF supports scaling. required: false entry_schema: type: tosca.datatypes.nfv.ScaleInfo -#tosca.datatypes.nfv.VnfInstantiateOperationConfiguration: -# derived_from: tosca.datatypes.Root - #properties: - #parameters: - #modeled as part of operation parameter list + +tosca.datatypes.nfv.VnfInstantiateOperationConfiguration: + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the InstantiateVnf operation. + properties: + description: + type: string + required: false tosca.datatypes.nfv.VnfScaleOperationConfiguration: derived_from: tosca.datatypes.Root + description: Represents information that affect the invocation of the ScaleVnf operation properties: - #parameters: - #modeled as part of the operation parameter list scaling_by_more_than_one_step_supported: type: boolean + description: Signals whether passing a value larger than one in the numScalingSteps parameter of the ScaleVnf operation is supported by this VNF. + required: false + default: false tosca.datatypes.nfv.VnfScaleToLevelOperationConfiguration: derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the ScaleVnfToLevel operation properties: - #parameters: - #modeled as part of the operation parameter list arbitrary_target_levels_supported: type: boolean + description: Signals whether scaling according to the parameter "scaleInfo" is supported by this VNF + required: true tosca.datatypes.nfv.VnfHealOperationConfiguration: derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the HealVnf operation properties: - #parameters: - #modeled as part of the operation parameter list causes: type: list + description: Supported "cause" parameter values + required: false entry_schema: type: string tosca.datatypes.nfv.VnfTerminateOperationConfiguration: derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the TerminateVnf properties: min_graceful_termination_timeout: - type: integer + type: scalar-unit.time # For TOSCA V1.2 use type as scalar-unit.time instead of integer + description: Minimum timeout value for graceful termination of a VNF instance + required: true max_recommended_graceful_termination_timeout: - type: integer + type: scalar-unit.time # For TOSCA V1.2 use type as scalar-unit.time instead of integer + description: Maximum recommended timeout value that can be needed to gracefully terminate a VNF instance of a particular type under certain conditions, such as maximum load condition. This is provided by VNF provider as information for the operator facilitating the selection of optimal timeout value. This value is not used as constraint + required: false tosca.datatypes.nfv.VnfOperateOperationConfiguration: derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the OperateVnf operation properties: - min_graceful_termination_timeout: + min_graceful_stop_timeout: + type: scalar-unit.time + description: Minimum timeout value for graceful stop of a VNF instance + required: true + max_recommended_graceful_stop_timeout: + type: scalar-unit.time + description: Maximum recommended timeout value that can be needed to gracefully stop a VNF instance of a particular type under certain conditions, such as maximum load condition. This is provided by VNF provider as information for the operator facilitating the selection of optimal timeout value. This value is not used as constraint + required: false +tosca.datatypes.nfv.VnfChangeFlavourOperationConfiguration: + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the ChangeVnfFlavour operation + properties: + description: + type: string + required: false +tosca.datatypes.nfv.VnfProfile: + derived_from: tosca.datatypes.Root + description: describes a profile for instantiating VNFs of a particular NS DF according to a specific VNFD and VNF DF. + properties: + instantiation_level: + type: string + description: Identifier of the instantiation level of the VNF DF to be used for instantiation. If not present, the default instantiation level as declared in the VNFD shall be used. + required: false + min_number_of_instances: type: integer - max_recommended_graceful_termination_timeout: - type: integer + description: Minimum number of instances of the VNF based on this VNFD that is permitted to exist for this VnfProfile. + required: true + constraints: + - greater_or_equal: 0 + max_number_of_instances: + type: integer + description: Maximum number of instances of the VNF based on this VNFD that is permitted to exist for this VnfProfile. + required: true + constraints: + - greater_or_equal: 0 +tosca.datatypes.nfv.UriAuthority: + derived_from: tosca.datatypes.Root + description: information that corresponds to the authority component of a URI as specified in IETF RFC 3986 [8] + properties: + user_info: + type: string # shall comply with IETF RFC 3986 + description: user_info field of the authority component of a URI + required: false + host: + type: string # shall comply with IETF RFC 3986 + description: host field of the authority component of a URI + required: false + port: + type: string # shall comply with IETF RFC 3986 + description: port field of the authority component of a URI + required: false +tosca.datatypes.nfv.UriComponents: + derived_from: tosca.datatypes.Root + description: information used to build a URI that complies with IETF RFC 3986 [8]. + properties: + scheme: + type: string # shall comply with IETF RFC3986 + description: scheme component of a URI. + required: true + authority: + type: tosca.datatypes.nfv.UriAuthority + description: Authority component of a URI + required: false + path: + type: string # shall comply with IETF RFC 3986 + description: path component of a URI. + required: false + query: + type: string # shall comply with IETF RFC 3986 + description: query component of a URI. + required: false + fragment: + type: string # shall comply with IETF RFC 3986 + description: fragment component of a URI. + required: false +tosca.datatypes.nfv.InterfaceDetails: + derived_from: tosca.datatypes.Root + description: information used to access an interface exposed by a VNF + properties: + uri_components: + type: tosca.datatypes.nfv.UriComponents + description: Provides components to build a Uniform Ressource Identifier (URI) where to access the interface end point. + required: false + interface_specific_data: + type: map + description: Provides additional details that are specific to the type of interface considered. + required: false + entry_schema: + type: string +tosca.datatypes.nfv.VirtualLinkMonitoringParameter: + derived_from: tosca.datatypes.Root + description: Represents information on virtualised resource related performance metrics applicable to the VNF. + properties: + name: + type: string + description: Human readable name of the monitoring parameter + required: true + performance_metric: + type: string + description: Identifies a performance metric derived from those defined in ETSI GS NFV-IFA 027.The packetOutgoingVirtualLink and packetIncomingVirtualLink metrics shall be obtained by aggregation the PacketOutgoing and PacketIncoming measurements defined in clause 7.1 of GS NFV-IFA 027 of all virtual link ports attached to the virtual link to which the metrics apply. + required: true + constraints: + - valid_values: [ packet_outgoing_virtual_link, packet_incoming_virtual_link ] + collection_period: + type: scalar-unit.time + description: Describes the recommended periodicity at which to collect the performance information. + required: false + constraints: + - greater_than: 0 s +tosca.datatypes.nfv.VnfcMonitoringParameter: + derived_from: tosca.datatypes.Root + description: Represents information on virtualised resource related performance metrics applicable to the VNF. + properties: + name: + type: string + description: Human readable name of the monitoring parameter + required: true + performance_metric: + type: string + description: Identifies the performance metric, according to ETSI GS NFV-IFA 027. + required: true + constraints: + - valid_values: [ v_cpu_usage_mean_vnf, v_cpu_usage_peak_vnf, v_memory_usage_mean_vnf, v_memory_usage_peak_vnf, v_disk_usage_mean_vnf, v_disk_usage_peak_vnf, byte_incoming_vnf_int_cp, byte_outgoing_vnf_int_cp, packet_incoming_vnf_int_cp, packet_outgoing_vnf_int_cp ] + collection_period: + type: scalar-unit.time + description: Describes the recommended periodicity at which to collect the performance information. + required: false + constraints: + - greater_than: 0 s +tosca.datatypes.nfv.VnfChangeExtConnectivityOperationConfiguration: + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the ChangeExtVnfConnectivity operation + properties: + description: + type: string + required: false +tosca.datatypes.nfv.VnfMonitoringParameter: + derived_from: tosca.datatypes.Root + description: Represents information on virtualised resource related performance metrics applicable to the VNF. + properties: + name: + type: string + description: Human readable name of the monitoring parameter + required: true + performance_metric: + type: string + description: Identifies the performance metric, according to ETSI GS NFV-IFA 027. + required: true + constraints: + - valid_values: [ v_cpu_usage_mean_vnf, v_cpu_usage_peak_vnf, v_memory_usage_mean_vnf, v_memory_usage_peak_vnf, v_disk_usage_mean_vnf, v_disk_usage_peak_vnf, byte_incoming_vnf_ext_cp, byte_outgoing_vnf_ext_cp, packet_incoming_vnf_ext_cp, packet_outgoing_vnf_ext_cp ] + collection_period: + type: scalar-unit.time + description: Describes the recommended periodicity at which to collect the performance information. + required: false + constraints: + - greater_than: 0 s tosca.datatypes.nfv.VnfLcmOperationsConfiguration: derived_from: tosca.datatypes.Root + description: Represents information to configure lifecycle management operations properties: -# instantiate: -# type: tosca.datatypes.nfv.VnfInstantiateOperationConfiguration + instantiate: + type: tosca.datatypes.nfv.VnfInstantiateOperationConfiguration + description: Configuration parameters for the InstantiateVnf operation + required: false scale: type: tosca.datatypes.nfv.VnfScaleOperationConfiguration + description: Configuration parameters for the ScaleVnf operation + required: false scale_to_level: type: tosca.datatypes.nfv.VnfScaleToLevelOperationConfiguration + description: Configuration parameters for the ScaleVnfToLevel operation + required: false + change_flavour: + type: tosca.datatypes.nfv.VnfChangeFlavourOperationConfiguration + description: Configuration parameters for the changeVnfFlavourOpConfig operation + required: false heal: type: tosca.datatypes.nfv.VnfHealOperationConfiguration + description: Configuration parameters for the HealVnf operation + required: false terminate: type: tosca.datatypes.nfv.VnfTerminateOperationConfiguration + description: Configuration parameters for the TerminateVnf operation + required: false operate: type: tosca.datatypes.nfv.VnfOperateOperationConfiguration + description: Configuration parameters for the OperateVnf operation + required: false + change_ext_connectivity: + type: tosca.datatypes.nfv.VnfChangeExtConnectivityOperationConfiguration + description: Configuration parameters for the changeExtVnfConnectivityOpConfig operation + required: false tosca.datatypes.nfv.CpProtocolData: derived_from: tosca.datatypes.Root + description: Describes and associates the protocol layer that a CP uses together with other protocol and connection point information properties: - asscociated_layer_protocol: + associated_layer_protocol: type: string - constraints: - - valid_values: [ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] required: true + description: One of the values of the property layer_protocols of the CP + constraints: + - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] address_data: - type: tosca.datatypes.nfv.AddressData + type: list + description: Provides information on the addresses to be assigned to the CP + entry_schema: + type: tosca.datatypes.nfv.AddressData + required: false +tosca.datatypes.nfv.VnfAdditionalConfigurableProperties: + derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing additional configurable properties for a given VNF + # below description properties added as optional, since atleast one property required to define a dataType in SDC + properties: + description: + type: string required: false -#tosca.datatypes.nfv.VnfAdditionalConfigurableProperties: -# derived_from: tosca.datatypes.Root tosca.datatypes.nfv.VnfConfigurableProperties: derived_from: tosca.datatypes.Root + description: indicates configuration properties for a given VNF (e.g. related to auto scaling and auto healing). properties: is_autoscale_enabled: type: boolean + description: It permits to enable (TRUE)/disable (FALSE) the auto-scaling functionality. If the properties is not present for configuring, then VNF property is not supported required: false is_autoheal_enabled: type: boolean + description: It permits to enable (TRUE)/disable (FALSE) the auto-healing functionality. If the properties is not present for configuring, then VNF property is not supported + required: false + additional_configurable_properties: + description: It provides VNF specific configurable properties that can be modified using the ModifyVnfInfo operation required: false -# additional_configurable_properties: -# type: tosca.datatypes.nfv.VnfAdditionalConfigurableProperties -# required: false + type: tosca.datatypes.nfv.VnfAdditionalConfigurableProperties + # derived types are expected to introduce + # additional_configurable_properties with its type derived from + # tosca.datatypes.nfv.VnfAdditionalConfigurableProperties tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions: derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing VNF-specific extension + # below description properties added as optional, since atleast one property required to define a dataType in SDC properties: description: type: string required: false tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata: derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing VNF-specific metadata + # below description properties added as optional, since atleast one property required to define a dataType in SDC properties: description: type: string required: false tosca.datatypes.nfv.VnfInfoModifiableAttributes: derived_from: tosca.datatypes.Root + description: Describes VNF-specific extension and metadata for a given VNF properties: extensions: type: tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions + description: \"Extension\" properties of VnfInfo that are writeable required: false + # derived types are expected to introduce + # extensions with its type derived from + # tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions metadata: type: tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata + description: \"Metadata\" properties of VnfInfo that are writeable + required: false + # derived types are expected to introduce + # metadata with its type derived from + # tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata + +tosca.datatypes.nfv.VirtualLinkBitrateLevel: + derived_from: tosca.datatypes.Root + description: Describes bitrate requirements applicable to the virtual link instantiated from a particicular VnfVirtualLink + properties: + description: + type: string + required: false + bitrate_requirements: + type: tosca.datatypes.nfv.LinkBitrateRequirements + description: Virtual link bitrate requirements for an instantiation level or bitrate delta for a scaling step + required: true + +tosca.datatypes.nfv.VnfOperationAdditionalParameters: + derived_from: tosca.datatypes.Root + description: Is an empty base type for deriving data type for describing VNF-specific parameters to be passed when invoking lifecycle management operations + # below description properties added as optional, since atleast one property required to define a dataType in SDC + properties: + description: + type: string required: false +tosca.datatypes.nfv.VirtualFileStorageData: + derived_from: tosca.datatypes.Root + description: VirtualFileStorageData describes file storage requirements associated with compute resources in a particular VDU + properties: + size_of_storage: + type: scalar-unit.size + description: Size of virtualized storage resource + required: true + file_system_protocol: + type: string + description: The shared file system protocol (e.g. NFS, CIFS) + required: true +tosca.datatypes.nfv.VirtualObjectStorageData: + derived_from: tosca.datatypes.Root + description: VirtualObjectStorageData describes object storage requirements associated with compute resources in a particular VDU + properties: + max_size_of_storage: + type: scalar-unit.size + description: Maximum size of virtualized storage resource + required: false +tosca.datatypes.nfv.VirtualBlockStorageData: + derived_from: tosca.datatypes.Root + description: VirtualBlockStorageData describes block storage requirements associated with compute resources in a particular VDU, either as a local disk or as virtual attached storage + properties: + size_of_storage: + type: scalar-unit.size + description: Size of virtualised storage resource + required: true + vdu_storage_requirements: + type: map + description: The hardware platform specific storage requirements. A map of strings that contains a set of key-value pairs that represents the hardware platform specific storage deployment requirements. + required: false + entry_schema: + type: string + rdma_enabled: + type: boolean + description: Indicates if the storage support RDMA + required: false + default: false +tosca.datatypes.nfv.SwImageData: + derived_from: tosca.datatypes.Root + description: describes information related to a software image artifact + properties: # in SOL001 v0.8.0: "properties or metadata:" + name: + type: string + description: Name of this software image + required: true + version: + type: string + description: Version of this software image + required: true + checksum: + type: string + description: Checksum of the software image file + required: true + container_format: + type: string + description: The container format describes the container file format in which software image is provided + required: true + constraints: + - valid_values: [ aki, ami, ari, bare, docker, ova, ovf ] + disk_format: + type: string + description: The disk format of a software image is the format of the underlying disk image + required: true + constraints: + - valid_values: [ aki, ami, ari, iso, qcow2, raw, vdi, vhd, vhdx, vmdk ] + min_disk: + type: scalar-unit.size # Number + description: The minimal disk size requirement for this software image + required: true + min_ram: + type: scalar-unit.size # Number + description: The minimal RAM requirement for this software image + required: false + size: + type: scalar-unit.size # Number + description: The size of this software image + required: true + operating_system: + type: string + description: Identifies the operating system used in the software image + required: false + supported_virtualisation_environments: + type: list + description: Identifies the virtualisation environments (e.g. hypervisor) compatible with this software image + required: false + entry_schema: + type: string ### Data types used by Policy TCA model for closed loop ### diff --git a/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.json b/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.json index caea6a8063..c2e5aee81d 100644 --- a/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.json +++ b/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.json @@ -3,6 +3,10 @@ "displayName": "Root", "icon": "group-root" }, + "tosca.groups.nfv.PlacementGroup": { + "displayName": "NFV PlacementGroup", + "icon": "group-nfv-placementgroup" + }, "org.openecomp.groups.heat.HeatStack": { "displayName": "Heat Stack", "icon": "group-heat-stack" @@ -19,4 +23,4 @@ "displayName": "Vfc Instance", "icon": "group-vfc-instance" } -}
\ No newline at end of file +} diff --git a/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.yml b/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.yml index 394ffb1f6e..b8d5954fde 100644 --- a/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/group-types/groupTypes.yml @@ -1,8 +1,17 @@ tosca.groups.Root: description: The TOSCA Group Type all other TOSCA Group Types derive from - interfaces: + interfaces: Standard: type: tosca.interfaces.node.lifecycle.Standard +tosca.groups.nfv.PlacementGroup: + derived_from: tosca.groups.Root + description: PlacementGroup is used for describing the affinity or anti-affinity relationship applicable between the virtualization containers to be created based on different VDUs, or between internal VLs to be created based on different VnfVirtualLinkDesc(s) + properties: + description: + type: string + description: Human readable description of the group + required: true + members: [ tosca.nodes.nfv.Vdu.Compute, tosca.nodes.nfv.VnfVirtualLink ] org.openecomp.groups.heat.HeatStack: derived_from: tosca.groups.Root description: Grouped all heat resources which are in the same heat stack @@ -16,7 +25,7 @@ org.openecomp.groups.heat.HeatStack: type: string description: group description required: true - status: SUPPORTED + status: SUPPORTED org.openecomp.groups.VfModule: derived_from: tosca.groups.Root description: Grouped all heat resources which are in the same VF Module @@ -27,23 +36,23 @@ org.openecomp.groups.VfModule: required: true default: false status: SUPPORTED - vf_module_label: + vf_module_label: type: string required: true - description: > - Alternate textual key used to reference this VF-Module model. + description: > + Alternate textual key used to reference this VF-Module model. Must be unique within the VNF model vf_module_description: type: string required: true description: > - Description of the VF-modules contents and purpose + Description of the VF-modules contents and purpose (e.g. "Front-End" or "Database Cluster") min_vf_module_instances: type: integer required: true description: The minimum instances of this VF-Module - max_vf_module_instances: + max_vf_module_instances: type: integer required: false description: The maximum instances of this VF-Module @@ -51,7 +60,7 @@ org.openecomp.groups.VfModule: type: integer required: false description: > - The initial count of instances of the VF-Module. The value must be in the + The initial count of instances of the VF-Module. The value must be in the range between min_vfmodule_instances and max_vfmodule_instances. If no value provided the initial count is the min_vfmodule_instances. vf_module_type: @@ -64,19 +73,19 @@ org.openecomp.groups.VfModule: required: true default: false description: > - "true" indicates that this VF Module model requires attachment to a Volume - Group. - VID operator must select the Volume Group instance to attach to a VF-Module + "true" indicates that this VF Module model requires attachment to a Volume + Group. + VID operator must select the Volume Group instance to attach to a VF-Module at deployment time. availability_zone_count: type: integer required: false description: > - Quantity of Availability Zones needed for this VF-Module + Quantity of Availability Zones needed for this VF-Module (source: Extracted from VF-Module HEAT template) vfc_list: type: map - entry_schema: + entry_schema: description: <vfc_id>:<count> type: string required: false @@ -119,4 +128,4 @@ org.openecomp.groups.VfcInstanceGroup: type: org.openecomp.capabilities.VLANAssignment properties: vfc_instance_group_reference: - type: string
\ No newline at end of file + type: string diff --git a/catalog-be/src/main/resources/import/tosca/interface-lifecycle-types/interfaceLifecycleTypes.yml b/catalog-be/src/main/resources/import/tosca/interface-lifecycle-types/interfaceLifecycleTypes.yml index 2a304a0aa4..4e9993f84b 100644 --- a/catalog-be/src/main/resources/import/tosca/interface-lifecycle-types/interfaceLifecycleTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/interface-lifecycle-types/interfaceLifecycleTypes.yml @@ -53,6 +53,119 @@ tosca.interfaces.nfv.vnf.lifecycle.Nfv: description: Invoked before scale_to_level scale_to_level_end: description: Invoked after scale_to_level +tosca.interfaces.nfv.Vnflcm: + #derived_from: tosca.interfaces.Root + #description: This interface encompasses a set of TOSCA operations corresponding to the VNF LCM operations defined in ETSI GS NFV-IFA 007 as well as to preamble and postamble procedures to the execution of the VNF LCM operations. + instantiate: + description: Invoked upon receipt of an Instantiate VNF request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + instantiate_start: + description: Invoked before instantiate + instantiate_end: + description: Invoked after instantiate + terminate: + description: Invoked upon receipt Terminate VNF request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + terminate_start: + description: Invoked before terminate + terminate_end: + description: Invoked after terminate + modify_information: + description: Invoked upon receipt of a Modify VNF Information request + modify_information_start: + description: Invoked before modify_information + modify_information_end: + description: Invoked after modify_information + change_flavour: + description: Invoked upon receipt of a Change VNF Flavour request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + change_flavour_start: + description: Invoked before change_flavour + change_flavour_end: + description: Invoked after change_flavour + change_external_connectivity: + description: Invoked upon receipt of a Change External VNF Connectivity request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + change_external_connectivity_start: + description: Invoked before change_external_connectivity + change_external_connectivity_end: + description: Invoked after change_external_connectivity + operate: + description: Invoked upon receipt of an Operate VNF request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + operate_start: + description: Invoked before operate + operate_end: + description: Invoked after operate + heal: + description: Invoked upon receipt of a Heal VNF request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + heal_start: + description: Invoked before heal + heal_end: + description: Invoked after heal + scale: + description: Invoked upon receipt of a Scale VNF request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + scale_start: + description: Invoked before scale + scale_end: + description: Invoked after scale + scale_to_level: + description: Invoked upon receipt of a Scale VNF to Level request + # inputs: + # additional_parameters: + # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + # required: false + # derived types are expected to introduce additional_parameters with + # its type derived from + # tosca.datatypes.nfv.VnfOperationAdditionalParameters + scale_to_level_start: + description: Invoked before scale_to_level + scale_to_level_end: + description: Invoked after scale_to_level tosca.interfaces.node.lifecycle.Standard: create: description: Standard lifecycle create operation. diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/Cp/Cp.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/Cp/Cp.yml index 9cee00aaa9..79ae6f77ef 100644 --- a/catalog-be/src/main/resources/import/tosca/nfv-types/Cp/Cp.yml +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/Cp/Cp.yml @@ -2,30 +2,36 @@ tosca_definitions_version: tosca_simple_yaml_1_0_0 node_types: tosca.nodes.nfv.Cp: derived_from: tosca.nodes.Root + description: Provides information regarding the purpose of the connection point properties: - layer_protocol: - type: list - entry_schema: - type: string - constraints: - - valid_values: [ethernet, mpls, odu2, ipv4, ipv6, pseudo_wire ] - required: true - role: #Name in ETSI NFV IFA011 v0.7.3 cpRole + layer_protocols: + type: list + description: Identifies which protocol the connection point uses for connectivity purposes + required: true + entry_schema: type: string constraints: - - valid_values: [ root, leaf ] - required: false - description: - type: string - required: false - protocol_data: - type: list - entry_schema: - type: tosca.datatypes.nfv.CpProtocolData - required: true - trunk_mode: - type: boolean - required: true - allowed_address_data: # Aligned with ONAP R2 Im.not defined in IFA011 v2.4.1 and SOL001 v0.6.0. - type: tosca.datatypes.nfv.AddressData #In the IM, it is a array, but here it is not a array. TBD. - required: false + - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] + role: #Name in ETSI NFV IFA011 v0.7.3: cpRole + type: string + description: Identifies the role of the port in the context of the traffic flow patterns in the VNF or parent NS + required: false + constraints: + - valid_values: [ root, leaf ] + description: + type: string + description: Provides human-readable information on the purpose of the connection point + required: false + protocol: + type: list + description: Provides information on the addresses to be assigned to the connection point(s) instantiated from this Connection Point Descriptor + required: false + entry_schema: + type: tosca.datatypes.nfv.CpProtocolData + trunk_mode: + type: boolean + description: Provides information about whether the CP instantiated from this Cp is in Trunk mode (802.1Q or other), When operating in "trunk mode", the Cp is capable of carrying traffic for several VLANs. Absence of this property implies that trunkMode is not configured for the Cp i.e. It is equivalent to boolean value "false". + required: false + allowed_address_data: # #Introduced from Beijing release, align with resource IM, outside the scope of SOL001 v2.5.1 + type: tosca.datatypes.nfv.AddressData # In the IM, it is a array, but here it is not a array. TBD. + required: false diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/VNF/VNF.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/VNF/VNF.yml index 5eeedba2a9..fcc70b35cb 100644 --- a/catalog-be/src/main/resources/import/tosca/nfv-types/VNF/VNF.yml +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/VNF/VNF.yml @@ -1,65 +1,95 @@ tosca_definitions_version: tosca_simple_yaml_1_0_0 node_types: - tosca.nodes.nfv.VNF: - derived_from: tosca.nodes.Root - properties: - descriptor_id: # instead of vnfd_id - type: string # GUID - required: true - descriptor_version: # instead of vnfd_version + tosca.nodes.nfv.VNF: + derived_from: tosca.nodes.Root + description: The generic abstract type from which all VNF specific abstract node types shall be derived to form, together with other node types, the TOSCA service template(s) representing the VNFD + properties: + descriptor_id: # instead of vnfd_id + type: string # GUID + description: Globally unique identifier of the VNFD + required: true + descriptor_version: # instead of vnfd_version + type: string + description: Identifies the version of the VNFD + required: true + provider: # instead of vnf_provider + type: string + description: Provider of the VNF and of the VNFD + required: true + product_name: # instead of vnf_product_name + type: string + description: Human readable name for the VNF Product + required: true + software_version: # instead of vnf_software_version + type: string + description: Software version of the VNF + required: true + product_info_name: # instead of vnf_product_info_name + type: string + description: Human readable name for the VNF Product + required: false + product_info_description: # instead of vnf_product_info_description + type: string + description: Human readable description of the VNF Product + required: false + vnfm_info: + type: list + required: true + description: Identifies VNFM(s) compatible with the VNF + entry_schema: type: string - required: true - provider: # instead of vnf_provider - type: string - required: true - product_name: # instead of vnf_product_name - type: string - required: true - software_version: # instead of vnf_software_version - type: string - required: true - product_info_name: # instead of vnf_product_info_name - type: string - required: false - product_info_description: # instead of vnf_product_info_description - type: string - required: false - vnfm_info: - type: list - entry_schema: - type: string - required: true - localization_languages: - type: list - entry_schema: - type: string - required: false - default_localization_language: - type: string - required: false - configurable_properties: - type: tosca.datatypes.nfv.VnfConfigurableProperties - required: false - modifiable_attributes: - type: tosca.datatypes.nfv.VnfInfoModifiableAttributes - required: false # true in IFA011, but all of members are false. Align with the IM, it is false - flavour_id: - type: string - required: true - flavour_description: - type: string - required: true - #capabilities: - # monitoring_parameter: - # modelled as ad hoc capabilities in the VNF node template - requirements: - - virtual_link: - capability: tosca.capabilities.nfv.VirtualLinkable - relationship: tosca.relationships.nfv.VirtualLinksTo - node: tosca.nodes.nfv.VnfVirtualLink - occurrences: - - 0 - - UNBOUNDED - interfaces: - Nfv: - type: tosca.interfaces.nfv.vnf.lifecycle.Nfv + localization_languages: + type: list + description: Information about localization languages of the VNF + required: false + entry_schema: + type: string #IETF RFC 5646 string + default_localization_language: + type: string #IETF RFC 5646 string + description: Default localization language that is instantiated if no information about selected localization language is available + required: false + #configurable_properties: + #type: tosca.datatypes.nfv.VnfConfigurableProperties + #description: Describes the configurable properties of the VNF + #required: false + # derived types are expected to introduce configurable_properties + # with its type derived from + # tosca.datatypes.nfv.VnfConfigurableProperties + #modifiable_attributes: + #type: tosca.datatypes.nfv.VnfInfoModifiableAttributes + #description: Describes the modifiable attributes of the VNF + #required: false + # derived types are expected to introduce modifiable_attributes + # with its type derived from + # tosca.datatypes.nfv.VnfInfoModifiableAttributes + lcm_operations_configuration: + type: tosca.datatypes.nfv.VnfLcmOperationsConfiguration + description: Describes the configuration parameters for the VNF LCM operations + required: false + monitoring_parameters: + type: list + entry_schema: + type: tosca.datatypes.nfv.VnfMonitoringParameter + description: Describes monitoring parameters applicable to the VNF. + required: false + flavour_id: + type: string + description: Identifier of the Deployment Flavour within the VNFD + required: true + flavour_description: + type: string + description: Human readable description of the DF + required: true + #vnf_profile: + # type: tosca.datatypes.nfv.VnfProfile + # description: Describes a profile for instantiating VNFs of a particular NS DF according to a specific VNFD and VNF DF + # required: false + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + # Additional requirements shall be defined in the VNF specific node type (deriving from tosca.nodes.nfv.VNF) corresponding to NS virtual links that need to connect to VnfExtCps + interfaces: + Vnflcm: + type: tosca.interfaces.nfv.Vnflcm diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduCompute/vduCompute.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vduCompute/vduCompute.yml index 64bf536a0d..83bba36fe0 100644 --- a/catalog-be/src/main/resources/import/tosca/nfv-types/vduCompute/vduCompute.yml +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduCompute/vduCompute.yml @@ -2,64 +2,69 @@ tosca_definitions_version: tosca_simple_yaml_1_0_0 node_types: tosca.nodes.nfv.Vdu.Compute: derived_from: tosca.nodes.Root + description: Describes the virtual compute part of a VDU which is a construct supporting the description of the deployment and operational behavior of a VNFC properties: name: type: string + description: Human readable name of the VDU required: true description: type: string + description: Human readable description of the VDU required: true boot_order: - type: map + type: list # explicit index (boot index) not necessary, contrary to IFA011 + description: References a node template name from which a valid boot device is created + required: false entry_schema: type: string + nfvi_constraints: + type: list + description: Describes constraints on the NFVI for the VNFC instance(s) created from this VDU required: false - nfvi_constraints: - type: map # Align with IM, it shoul be a array of KeyValuePair/NameValuePair entry_schema: type: string + monitoring_parameters: + type: list + description: Describes monitoring parameters applicable to a VNFC instantiated from this VDU required: false - configurable_properties: - type: map #In the IM, the multipilicity of VnfcConfigurableProperties is 1, not a map. - entry_schema: - type: tosca.datatypes.nfv.VnfcConfigurableProperties - required: true - vdu_profile: - type: tosca.datatypes.nfv.VduProfile - required: true - inject_files: # Used for vCPE usecase Aligned with ONAP R2 IM. not defined in IFA011 v2.4.1 and SOL001 v0.6.0. - type: tosca.datatypes.nfv.injectFile - required: false #Aligned with ONAP R2 IM. it should be false. - meta_data: #metadata attached to the VM or container - type: map - entry_schema: - type: string - required: false - user_data: #cloudinit userdata script support + entry_schema: + type: tosca.datatypes.nfv.VnfcMonitoringParameter + #configurable_properties: + #type: tosca.datatypes.nfv.VnfcConfigurableProperties + #required: false + # derived types are expected to introduce + # configurable_properties with its type derived from + # tosca.datatypes.nfv.VnfcConfigurableProperties + vdu_profile: + type: tosca.datatypes.nfv.VduProfile + description: Defines additional instantiation data for the VDU.Compute node + required: true + sw_image_data: + type: tosca.datatypes.nfv.SwImageData + description: Defines information related to a SwImage artifact used by this Vdu.Compute node + required: false # property is required when the node template has an associated artifact of type tosca.artifacts.nfv.SwImage and not required otherwise + boot_data: type: string + description: Contains a string or a URL to a file contained in the VNF package used to customize a virtualised compute resource at boot time. The bootData may contain variable parts that are replaced by deployment specific values before being sent to the VIM. + required: false + inject_files: #Introduced from Beijing release, used for vCPE usecase, outside the scope of SOL001 v2.5.1 + type: tosca.datatypes.nfv.injectFile + required: false #Aligned with ONAP R2 IM. it should be false. + meta_data: #Introduced from Beijing release, used for metadata attached to the VM or container, outside the scope of SOL001 v2.5.1 + type: map + entry_schema: + type: string required: false capabilities: virtual_compute: type: tosca.capabilities.nfv.VirtualCompute + occurrences: [ 1, 1 ] virtual_binding: type: tosca.capabilities.nfv.VirtualBindable - occurrences: - - 1 - - UNBOUNDED - monitoring_parameter: - type: tosca.capabilities.nfv.Metric - occurrences: - - 0 - - UNBOUNDED + occurrences: [ 1, UNBOUNDED ] requirements: - virtual_storage: capability: tosca.capabilities.nfv.VirtualStorage - relationship: tosca.relationships.nfv.Vdu.AttachedTo - node: tosca.nodes.nfv.Vdu.VirtualStorage - occurences: - - 0 - - UNBOUNDED - #artifacts: artifacts should be defined in template file instead of node type - # - sw_image: - # file: - # type: tosca.artifacts.nfv.SwImage + relationship: tosca.relationships.nfv.AttachesTo + occurrences: [ 0, UNBOUNDED ] diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduCp/vduCp.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vduCp/vduCp.yml index 6924a28901..664c4f59d9 100644 --- a/catalog-be/src/main/resources/import/tosca/nfv-types/vduCp/vduCp.yml +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduCp/vduCp.yml @@ -2,31 +2,39 @@ tosca_definitions_version: tosca_simple_yaml_1_0_0 node_types: tosca.nodes.nfv.VduCp: derived_from: tosca.nodes.nfv.Cp + description: describes network connectivity between a VNFC instance based on this VDU and an internal VL properties: bitrate_requirement: - type: integer - required: false - vnic_name: # Aligned with ONAP R2 Im.not defined in IFA011 v2.4.1 and SOL001 v0.6.0. - type: string - required: false - vnic_order: # Aligned with ONAP R2 Im. not defined in IFA011 v2.4.1 and SOL001 v0.6.0. - type: integer + type: integer # in bits per second + description: Bitrate requirement in bit per second on this connection point required: false - vnic_type: # Aligned with ONAP R2 Im. not defined in IFA011 v2.4.1 and SOL001 v0.6.0 - type: string constraints: - - valid_values: [normal, macvtap, direct, baremetal, direct-physical, virtio-forwarder] - required: false + - greater_or_equal: 0 virtual_network_interface_requirements: type: list + description: Specifies requirements on a virtual network interface realising the CPs instantiated from this CPD + required: false entry_schema: type: tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements + order: + type: integer + description: The order of the NIC on the compute instance (e.g.eth2) + required: false + constraints: + - greater_or_equal: 0 + vnic_type: + type: string + description: Describes the type of the virtual network interface realizing the CPs instantiated from this CPD + required: false + constraints: + - valid_values: [ normal, virtio, direct-physical ] + vnic_name: # Introduced from Beijing release, aligned with ONAP resource IM, outside the scope of SOL001 v2.5.1 + type: string required: false requirements: - virtual_link: capability: tosca.capabilities.nfv.VirtualLinkable relationship: tosca.relationships.nfv.VirtualLinksTo - node: tosca.nodes.nfv.VnfVirtualLink - virtual_binding: capability: tosca.capabilities.nfv.VirtualBindable relationship: tosca.relationships.nfv.VirtualBindsTo diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualBlockStorage/vduVirtualBlockStorage.json b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualBlockStorage/vduVirtualBlockStorage.json new file mode 100644 index 0000000000..90776f08d0 --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualBlockStorage/vduVirtualBlockStorage.json @@ -0,0 +1,15 @@ +{ + "payloadName": "vduVirtualBlockStorage.yml", + "contactId": "jh0003", + "name": "VDU VirtualBlockStorage", + "description": "VDU VirtualBlockStorage", + "resourceIconPath": "objectStorage", + "resourceType": "VFC", + "categories": [{ + "name": "Generic", + "subcategories": [{ + "name": "Infrastructure" + }] + }], + "tags": ["VDU VirtualBlockStorage"] +} diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualBlockStorage/vduVirtualBlockStorage.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualBlockStorage/vduVirtualBlockStorage.yml new file mode 100644 index 0000000000..bffe3ce4fd --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualBlockStorage/vduVirtualBlockStorage.yml @@ -0,0 +1,18 @@ +tosca_definitions_version: tosca_simple_yaml_1_0_0 +node_types: + tosca.nodes.nfv.Vdu.VirtualBlockStorage: + derived_from: tosca.nodes.Root + description: This node type describes the specifications of requirements related to virtual block storage resources + properties: + virtual_block_storage_data: + type: tosca.datatypes.nfv.VirtualBlockStorageData + description: Describes the block storage characteristics. + required: true + sw_image_data: + type: tosca.datatypes.nfv.SwImageData + description: Defines information related to a SwImage artifact used by this Vdu.Compute node. + required: false # property is required when the node template has an associated artifact of type tosca.artifacts.nfv.SwImage and not required otherwise + capabilities: + virtual_storage: + type: tosca.capabilities.nfv.VirtualStorage + description: Defines the capabilities of virtual_storage. diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualFileStorage/vduVirtualFileStorage.json b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualFileStorage/vduVirtualFileStorage.json new file mode 100644 index 0000000000..fa45b7db85 --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualFileStorage/vduVirtualFileStorage.json @@ -0,0 +1,15 @@ +{ + "payloadName": "vduVirtualFileStorage.yml", + "contactId": "jh0003", + "name": "VDU VirtualFileStorage", + "description": "VDU VirtualFileStorage", + "resourceIconPath": "objectStorage", + "resourceType": "VFC", + "categories": [{ + "name": "Generic", + "subcategories": [{ + "name": "Infrastructure" + }] + }], + "tags": ["VDU VirtualFileStorage"] +} diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualFileStorage/vduVirtualFileStorage.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualFileStorage/vduVirtualFileStorage.yml new file mode 100644 index 0000000000..502de048a2 --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualFileStorage/vduVirtualFileStorage.yml @@ -0,0 +1,19 @@ +tosca_definitions_version: tosca_simple_yaml_1_0_0 +node_types: + tosca.nodes.nfv.Vdu.VirtualFileStorage: + derived_from: tosca.nodes.Root + description: This node type describes the specifications of requirements related to virtual file storage resources + properties: + virtual_file_storage_data: + type: tosca.datatypes.nfv.VirtualFileStorageData + description: Describes the file storage characteristics. + required: true + capabilities: + virtual_storage: + type: tosca.capabilities.nfv.VirtualStorage + description: Defines the capabilities of virtual_storage. + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + #description: Describes the requirements for linking to virtual link diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualObjectStorage/vduVirtualObjectStorage.json b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualObjectStorage/vduVirtualObjectStorage.json new file mode 100644 index 0000000000..b5fa625c1e --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualObjectStorage/vduVirtualObjectStorage.json @@ -0,0 +1,15 @@ +{ + "payloadName": "vduVirtualObjectStorage.yml", + "contactId": "jh0003", + "name": "VDU VirtualObjectStorage", + "description": "VDU VirtualObjectStorage", + "resourceIconPath": "objectStorage", + "resourceType": "VFC", + "categories": [{ + "name": "Generic", + "subcategories": [{ + "name": "Infrastructure" + }] + }], + "tags": ["VDU VirtualObjectStorage"] +} diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualObjectStorage/vduVirtualObjectStorage.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualObjectStorage/vduVirtualObjectStorage.yml new file mode 100644 index 0000000000..695c21d7f4 --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vduVirtualObjectStorage/vduVirtualObjectStorage.yml @@ -0,0 +1,14 @@ +tosca_definitions_version: tosca_simple_yaml_1_0_0 +node_types: + tosca.nodes.nfv.Vdu.VirtualObjectStorage: + derived_from: tosca.nodes.Root + description: This node type describes the specifications of requirements related to virtual object storage resources + properties: + virtual_object_storage_data: + type: tosca.datatypes.nfv.VirtualObjectStorageData + description: Describes the object storage characteristics. + required: true + capabilities: + virtual_storage: + type: tosca.capabilities.nfv.VirtualStorage + description: Defines the capabilities of virtual_storage. diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vnfExtCp/vnfExtCp.json b/catalog-be/src/main/resources/import/tosca/nfv-types/vnfExtCp/vnfExtCp.json new file mode 100644 index 0000000000..b50d159098 --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vnfExtCp/vnfExtCp.json @@ -0,0 +1,15 @@ +{ + "payloadName": "vnfExtCp.yml", + "contactId": "jh0003", + "name": "VNF External CP", + "description": "VNF External CP", + "resourceIconPath": "network", + "resourceType": "CP", + "categories": [{ + "name": "Generic", + "subcategories": [{ + "name": "Infrastructure" + }] + }], + "tags": ["VNF External CP"] +} diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vnfExtCp/vnfExtCp.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vnfExtCp/vnfExtCp.yml new file mode 100644 index 0000000000..c51e1b1539 --- /dev/null +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vnfExtCp/vnfExtCp.yml @@ -0,0 +1,19 @@ +tosca_definitions_version: tosca_simple_yaml_1_0_0 +node_types: + tosca.nodes.nfv.VnfExtCp: + derived_from: tosca.nodes.nfv.Cp + description: Describes a logical external connection point, exposed by the VNF enabling connection with an external Virtual Link + properties: + virtual_network_interface_requirements: + type: list + description: The actual virtual NIC requirements that is been assigned when instantiating the connection point + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements + requirements: + - external_virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + - internal_virtual_link: #name in ETSI NFV IFA011 v0.7.3: intVirtualLinkDesc + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo diff --git a/catalog-be/src/main/resources/import/tosca/nfv-types/vnfVirtualLink/vnfVirtualLink.yml b/catalog-be/src/main/resources/import/tosca/nfv-types/vnfVirtualLink/vnfVirtualLink.yml index dae0162435..2c92140158 100644 --- a/catalog-be/src/main/resources/import/tosca/nfv-types/vnfVirtualLink/vnfVirtualLink.yml +++ b/catalog-be/src/main/resources/import/tosca/nfv-types/vnfVirtualLink/vnfVirtualLink.yml @@ -2,26 +2,34 @@ tosca_definitions_version: tosca_simple_yaml_1_0_0 node_types: tosca.nodes.nfv.VnfVirtualLink: derived_from: tosca.nodes.Root + description: Describes the information about an internal VNF VL properties: connectivity_type: type: tosca.datatypes.nfv.ConnectivityType + description: Specifies the protocol exposed by the VL and the flow pattern supported by the VL required: true description: type: string + description: Provides human-readable information on the purpose of the VL required: false test_access: type: list + description: Test access facilities available on the VL + required: false entry_schema: type: string - required: false + constraints: + - valid_values: [ passive_monitoring, active_loopback ] vl_profile: type: tosca.datatypes.nfv.VlProfile + description: Defines additional data for the VL required: true + monitoring_parameters: + type: list + description: Describes monitoring parameters applicable to the VL + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkMonitoringParameter capabilities: - monitoring_parameter: # this is not a very clear data structure enough to be coded, suggest to be annotated. - type: tosca.capabilities.nfv.Metric - occurrences: - - 0 - - UNBOUNDED virtual_linkable: - type: tosca.capabilities.nfv.VirtualLinkable
\ No newline at end of file + type: tosca.capabilities.nfv.VirtualLinkable diff --git a/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.json b/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.json index 32a6593a93..1809bba71c 100644 --- a/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.json +++ b/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.json @@ -54,6 +54,54 @@ "onap.policy.monitoring.cdap.tca.hi.lo.app": { "displayName": "TCA", "icon": "policy-tca" + }, + "tosca.policies.nfv.InstantiationLevels": { + "displayName": "NFV InstantiationLevels", + "icon": "policy-nfv-instantiationlevels" + }, + "tosca.policies.nfv.VduInstantiationLevels": { + "displayName": "NFV Vdu InstantiationLevels", + "icon": "policy-nfv-vdu-instantiationlevels" + }, + "tosca.policies.nfv.VirtualLinkInstantiationLevels": { + "displayName": "NFV VirtualLink InstantiationLevels", + "icon": "policy-nfv-vl-instantiationlevels" + }, + "tosca.policies.nfv.ScalingAspects": { + "displayName": "NFV ScalingAspects", + "icon": "policy-nfv-scalingaspects" + }, + "tosca.policies.nfv.VduScalingAspectDeltas": { + "displayName": "NFV Vdu ScalingAspectDeltas", + "icon": "policy-nfv-vdu-scalingAspectdeltas" + }, + "tosca.policies.nfv.VirtualLinkBitrateScalingAspectDeltas": { + "displayName": "NFV VirtualLinkBitrate ScalingAspectDeltas", + "icon": "policy-nfv-vlbitrate-scalingAspectdeltas" + }, + "tosca.policies.nfv.VduInitialDelta": { + "displayName": "NFV Vdu InitialDelta", + "icon": "policy-nfv-vdu-initialdelta" + }, + "tosca.policies.nfv.VirtualLinkBitrateInitialDelta": { + "displayName": "NFV VirtualLinkBitrate InitialDelta", + "icon": "policy-nfv-vlbitrate-initialdelta" + }, + "tosca.policies.nfv.AffinityRule": { + "displayName": "NFV AffinityRule", + "icon": "policy-nfv-affinityrule" + }, + "tosca.policies.nfv.AntiAffinityRule": { + "displayName": "NFV AntiAffinityRule", + "icon": "policy-nfv-anti-affinityrule" + }, + "tosca.policies.nfv.SecurityGroupRule": { + "displayName": "NFV SecurityGroupRule", + "icon": "policy-nfv-securitygrouprule" + }, + "tosca.policies.nfv.SupportedVnfInterface": { + "displayName": "NFV Supported VnfInterface", + "icon": "policy-nfv-supported-vnfinterface" } -}
\ No newline at end of file +} diff --git a/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.yml b/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.yml index 0b60106a1e..53fa5937ba 100644 --- a/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/policy-types/policyTypes.yml @@ -128,4 +128,190 @@ onap.policy.monitoring.cdap.tca.hi.lo.app: type: map description: TCA Policy JSON entry_schema: - type: onap.datatypes.monitoring.tca_policy
\ No newline at end of file + type: onap.datatypes.monitoring.tca_policy + +## NFV policies ## +tosca.policies.nfv.InstantiationLevels: + derived_from: tosca.policies.Root + description: The InstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour and including default instantiation level in term of the number of VNFC instances to be created as defined in ETSI GS NFV-IFA 011 [1]. + properties: + levels: + type: map # key: levelId + description: Describes the various levels of resources that can be used to instantiate the VNF using this flavour. + required: true + entry_schema: + type: tosca.datatypes.nfv.InstantiationLevel + default_level: + type: string # levelId + description: The default instantiation level for this flavour. + required: false # required if multiple entries in levels +tosca.policies.nfv.VduInstantiationLevels: + derived_from: tosca.policies.Root + description: The VduInstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour in term of the number of VNFC instances to be created from each vdu.Compute. as defined in ETSI GS NFV-IFA 011 [1] + properties: + levels: + type: map # key: levelId + description: Describes the Vdu.Compute levels of resources that can be used to instantiate the VNF using this flavour + required: true + entry_schema: + type: tosca.datatypes.nfv.VduLevel + targets: [ tosca.nodes.nfv.Vdu.Compute ] + +tosca.policies.nfv.VirtualLinkInstantiationLevels: + derived_from: tosca.policies.Root + description: The VirtualLinkInstantiationLevels type is a policy type representing all the instantiation levels of virtual link resources to be instantiated within a deployment flavour as defined in ETSI GS NFV-IFA 011 [1]. + properties: + levels: + type: map # key: levelId + description: Describes the virtual link levels of resources that can be used to instantiate the VNF using this flavour. + required: true + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkBitrateLevel + targets: [ tosca.nodes.nfv.VnfVirtualLink ] +tosca.policies.nfv.ScalingAspects: + derived_from: tosca.policies.Root + description: The ScalingAspects type is a policy type representing the scaling aspects used for horizontal scaling as defined in ETSI GS NFV-IFA 011 [1]. + properties: + aspects: + type: map # key: aspectId + description: Describe maximum scale level for total number of scaling steps that can be applied to a particular aspect + required: true + entry_schema: + type: tosca.datatypes.nfv.ScalingAspect +tosca.policies.nfv.VduScalingAspectDeltas: + derived_from: tosca.policies.Root + description: The VduScalingAspectDeltas type is a policy type representing the Vdu.Compute detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + properties: + aspect: + type: string + description: Represents the scaling aspect to which this policy applies + required: true + deltas: + type: map # key: scalingDeltaId + description: Describes the Vdu.Compute scaling deltas to be applied for every scaling steps of a particular aspect. + required: true + entry_schema: + type: tosca.datatypes.nfv.VduLevel + targets: [ tosca.nodes.nfv.Vdu.Compute ] +tosca.policies.nfv.VirtualLinkBitrateScalingAspectDeltas: + derived_from: tosca.policies.Root + description: The VirtualLinkBitrateScalingAspectDeltas type is a policy type representing the VnfVirtualLink detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + properties: + aspect: + type: string + description: Represents the scaling aspect to which this policy applies. + required: true + deltas: + type: map # key: scalingDeltaId + description: Describes the VnfVirtualLink scaling deltas to be applied for every scaling steps of a particular aspect. + required: true + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkBitrateLevel + targets: [ tosca.nodes.nfv.VnfVirtualLink ] + +tosca.policies.nfv.VduInitialDelta: + derived_from: tosca.policies.Root + description: The VduInitialDelta type is a policy type representing the Vdu.Compute detail of an initial delta used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + properties: + initial_delta: + type: tosca.datatypes.nfv.VduLevel + description: Represents the initial minimum size of the VNF. + required: true + targets: [ tosca.nodes.nfv.Vdu.Compute ] + +tosca.policies.nfv.VirtualLinkBitrateInitialDelta: + derived_from: tosca.policies.Root + description: The VirtualLinkBitrateInitialDelta type is a policy type representing the VnfVirtualLink detail of an initial deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + properties: + initial_delta: + type: tosca.datatypes.nfv.VirtualLinkBitrateLevel + description: Represents the initial minimum size of the VNF. + required: true + targets: [ tosca.nodes.nfv.VnfVirtualLink ] + +tosca.policies.nfv.AffinityRule: + derived_from: tosca.policies.Placement + description: The AffinityRule describes the affinity rules applicable for the defined targets + properties: + scope: + type: string + description: scope of the rule is an NFVI_node, an NFVI_PoP, etc. + required: true + constraints: + - valid_values: [ nfvi_node, zone, zone_group, nfvi_pop ] + targets: [ tosca.nodes.nfv.Vdu.Compute, tosca.nodes.nfv.VnfVirtualLink, tosca.groups.nfv.PlacementGroup ] + +tosca.policies.nfv.AntiAffinityRule: + derived_from: tosca.policies.Placement + description: The AntiAffinityRule describes the anti-affinity rules applicable for the defined targets + properties: + scope: + type: string + description: scope of the rule is an NFVI_node, an NFVI_PoP, etc. + required: true + constraints: + - valid_values: [ nfvi_node, zone, zone_group, nfvi_pop ] + targets: [ tosca.nodes.nfv.Vdu.Compute, tosca.nodes.nfv.VnfVirtualLink, tosca.groups.nfv.PlacementGroup ] + +tosca.policies.nfv.SecurityGroupRule: + derived_from: tosca.policies.Root + description: The SecurityGroupRule type is a policy type specified the matching criteria for the ingress and/or egress traffic to/from visited connection points as defined in ETSI GS NFV-IFA 011 [1]. + properties: + description: + type: string + description: Human readable description of the security group rule. + required: false + direction: + type: string + description: The direction in which the security group rule is applied. The direction of 'ingress' or 'egress' is specified against the associated CP. I.e., 'ingress' means the packets entering a CP, while 'egress' means the packets sent out of a CP. + required: false + constraints: + - valid_values: [ ingress, egress ] + default: ingress + ether_type: + type: string + description: Indicates the protocol carried over the Ethernet layer. + required: false + constraints: + - valid_values: [ ipv4, ipv6 ] + default: ipv4 + protocol: + type: string + description: Indicates the protocol carried over the IP layer. Permitted values include any protocol defined in the IANA protocol registry, e.g. TCP, UDP, ICMP, etc. + required: false + constraints: + - valid_values: [ hopopt, icmp, igmp, ggp, ipv4, st, tcp, cbt, egp, igp, bbn_rcc_mon, nvp_ii, pup, argus, emcon, xnet, chaos, udp, mux, dcn_meas, hmp, prm, xns_idp, trunk_1, trunk_2, leaf_1, leaf_2, rdp, irtp, iso_tp4, netblt, mfe_nsp, merit_inp, dccp, 3pc, idpr, xtp, ddp, idpr_cmtp, tp++, il, ipv6, sdrp, ipv6_route, ipv6_frag, idrp, rsvp, gre, dsr, bna, esp, ah, i_nlsp, swipe, narp, mobile, tlsp, skip, ipv6_icmp, ipv6_no_nxt, ipv6_opts, cftp, sat_expak, kryptolan, rvd, ippc, sat_mon, visa, ipcv, cpnx, cphb, wsn, pvp, br_sat_mon, sun_nd, wb_mon, wb_expak, iso_ip, vmtp, secure_vmtp, vines, ttp, iptm, nsfnet_igp, dgp, tcf, eigrp, ospfigp, sprite_rpc, larp, mtp, ax.25, ipip, micp, scc_sp, etherip, encap, gmtp, ifmp, pnni, pim, aris, scps, qnx, a/n, ip_comp, snp, compaq_peer, ipx_in_ip, vrrp, pgm, l2tp, ddx, iatp, stp, srp, uti, smp, sm, ptp, isis, fire, crtp, crudp, sscopmce, iplt, sps, pipe, sctp, fc, rsvp_e2e_ignore, mobility, udp_lite, mpls_in_ip, manet, hip, shim6, wesp, rohc ] + default: tcp + port_range_min: + type: integer + description: Indicates minimum port number in the range that is matched by the security group rule. If a value is provided at design-time, this value may be overridden at run-time based on other deployment requirements or constraints. + required: false + constraints: + - greater_or_equal: 0 + - less_or_equal: 65535 + default: 0 + port_range_max: + type: integer + description: Indicates maximum port number in the range that is matched by the security group rule. If a value is provided at design-time, this value may be overridden at run-time based on other deployment requirements or constraints. + required: false + constraints: + - greater_or_equal: 0 + - less_or_equal: 65535 + default: 65535 + targets: [ tosca.nodes.nfv.VduCp, tosca.nodes.nfv.VnfExtCp ] + +tosca.policies.nfv.SupportedVnfInterface: + derived_from: tosca.policies.Root + description: this policy type represents interfaces produced by a VNF, the details to access them and the applicable connection points to use to access these interfaces + properties: + interface_name: + type: string + description: Identifies an interface produced by the VNF. + required: true + constraints: + - valid_values: [ vnf_indicator, vnf_configuration ] + details: + type: tosca.datatypes.nfv.InterfaceDetails + description: Provide additional data to access the interface endpoint + required: false + targets: [ tosca.nodes.nfv.VnfExtCp, tosca.nodes.nfv.VduCp ] diff --git a/catalog-be/src/main/resources/import/tosca/relationship-types/relationshipTypes.yml b/catalog-be/src/main/resources/import/tosca/relationship-types/relationshipTypes.yml index f446f21a62..a2c9d2b3ad 100644 --- a/catalog-be/src/main/resources/import/tosca/relationship-types/relationshipTypes.yml +++ b/catalog-be/src/main/resources/import/tosca/relationship-types/relationshipTypes.yml @@ -13,7 +13,7 @@ tosca.relationships.Root: default: initial interfaces: Configure: - type: tosca.interfaces.relationship.Configure + type: tosca.interfaces.relationship.Configure tosca.relationships.ConnectsTo: derived_from: tosca.relationships.Root @@ -118,16 +118,21 @@ org.openecomp.relationships.AssignsTo: org.openecomp.relationships.RoutesTo: derived_from: tosca.relationships.RoutesTo description: This type represents an intentional network routing between internal and external network - + tosca.relationships.nfv.VirtualBindsTo: - derived_from: tosca.relationships.DependsOn - valid_target_types: - - tosca.capabilities.nfv.VirtualBindable + derived_from: tosca.relationships.DependsOn + description: Represents an association relationship between Vdu.Compute and VduCp node types + valid_target_types: [ tosca.capabilities.nfv.VirtualBindable ] tosca.relationships.nfv.VirtualLinksTo: - derived_from: tosca.relationships.DependsOn - valid_target_types: - - tosca.capabilities.nfv.VirtualLinkable + derived_from: tosca.relationships.DependsOn + description: Represents an association relationship between the VduCp and VnfVirtualLink node types + valid_target_types: [ tosca.capabilities.nfv.VirtualLinkable ] + +tosca.relationships.nfv.AttachesTo: + derived_from: tosca.relationships.Root + description: Represents an association relationship between the Vdu.Compute and one of the node types, Vdu.VirtualBlockStorage, Vdu.VirtualObjectStorage or Vdu.VirtualFileStorage + valid_target_types: [ tosca.capabilities.nfv.VirtualStorage ] tosca.relationships.nfv.Vdu.AttachedTo: derived_from: tosca.relationships.DependsOn |