IM Attribute Discussion
This page is used for discussing attributes to be added into to the information model.
Note: the attribute marked as blue is expected for moving into the clean version
IM Table Format
attribute table
attribute name | cardinality | data type | constraint | description | provider | consumer | note |
---|---|---|---|---|---|---|---|
name of the attribute | allowed range of occurrence, format: an exact number, or min...max | data type of the attribute | usage constraint | description of the attribute | who provides the value of the attribute | who consumes the value of the attribute | note, reference, comment, etc... |
(example) | |||||||
vnfdInvariantId | 1 | invariant identifier of the VNF model | vendor | SDC, AAI? | SDC: invariantUUID | ||
vnfName | 0..1 | name of the VNF | vendor | SDC, AAI? | SDC: nf_naming, ETSI IFA011v231: vnfProductName | ||
vnfdVersion | 1 | version of the VNF model | vendor | SDC, AAI? | SDC: version, ETSI IFA011v231: vnfdVersion |
relationship table
class name | relationship | source/target | cardinality |
---|---|---|---|
name of the class | category of the relationship, e.g., association, generalization | whether the described class is source or target of this relationship | allowed range of occurrence, format: an exact number, or min...max |
(example) | |||
VnfcDesc | association | target | 1..N |
VnfVlDesc | association | target | 1..N |
NFC/VNFC Run Time Model
AAI (aai_schema_v11 vnfc) | ECOMP IM (VNFC Instance) | ETSI IFA008 (VnfcInfo) | Comment | Description |
---|---|---|---|---|
orchestration-status | vnfcState | @Xu Yang: Is it the same as vnfcState (i.e., start or stop)? @Xu Yang: vnfcState describes the state of a VNFC instance, possible values are: STARTED, STOPPED. STARTED means the VNFC instance is up and running, and STOPPED means the VNFC instance has been shut down (but not terminated/deleted). Similar to the VM power on/off concept. | Orchestration status of this VNF, mastered by APP-C | |
group-notation | @Xu Yang: need further clarification on how this attribute is used | Group notation of VNFC | ||
model-version-id | the SDC model version for this resource model | |||
relationship-list | association (VM, Docker, LXC) | AAI: relationship with vserver, vf-module and generic-vnf |
NFC/VNFC Design Time Model
SDC (abstract.nodes.VFC) | ECOMP IM (VNFCCatalogItem) | ETSI IFA011 (VDU/VduProfile) | Comment | Description |
---|---|---|---|---|
Vm_type_tag | Mandatory String property that indicates the vm-type as was defined by vendor | |||
bootOrder | The key indicates the boot index (lowest index defines highest boot priority). The Value references a descriptor from which a valid boot device is created e.g. VirtualStorageDesc from which a VirtualStorage instance is created. | |||
nfviConstraint | Describes constraints on the NFVI for the VNFC instance(s) created from this Vdu. | |||
configurableProperties | Describes the configurable properties of all VNFC instances based on this VDU. |
VNF Run Time Model
AAI (generic_vnf) | ECOMP IM (VNF instance) | ETSI IFA007 (VnfInfo) | Comment | Description |
---|---|---|---|---|
orchestration-status | @Xu Yang: only used by SO? @Xu Yang: could you elaborate more on the valid values and their meaning? | Orchestration status of this VNF, used by SO. | ||
management-option | @Xu Yang: Need clarification on how this attribute is used. | identifier of managed by service provider or customer | ||
ipv4-loopback0-address | @Xu Yang: same as above | v4 Loopback address | ||
nm-lan-v6-address | @Xu Yang: same as above | v6 Loopback address | ||
vcpu | @Xu Yang: only used by uCPE? | number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE | ||
vcpu-units | @Xu Yang: only used by uCPE? | units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE | ||
vmemory | @Xu Yang: only used by uCPE? | number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE | ||
vmemory-units | @Xu Yang: only used by uCPE? | units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE | ||
vdisk | @Xu Yang: only used by uCPE? | number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE | ||
vdisk-units | @Xu Yang: only used by uCPE? | units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE | ||
resource-version | @Xu Yang: Is it used internally in AAI? can be omitted in the general model. | Used for optimistic concurrency. Must be empty on create, valid on update and delete. | ||
model-customization-id | captures the id of all the configuration used to customize the resource for the service | |||
as-number | @Xu Yang: Please clarify the usage of this attribute. | as-number of the VNF | ||
regional-resource-subzone | Regional way of organizing pservers, source of truth should define values | |||
nf-type | @Xu Yang: What's the difference between vnf-type and nf-type? | Generic description of the type of NF | ||
nf-role | NetworkRole | role in the network that this model will be providing | ||
selflink | @Xu Yang: what controller? | Path to the controller object | ||
vlan-id-outer | @Xu Yang: only used by VCE? | Temporary location for S-TAG to get to VCE | ||
nm-profile-name | Network Management profile of this VNF | |||
relationship-list | @Xu Yang: Is the description correct? | relationship with l-interface, availability-zone, lag-interface, l3-network, pserver, vserver, service-instance, vf-module, volume-group, vnfc and logical-link | ||
l-interfaces | logical interfaces | |||
lag-interfaces | Collection of link aggregate interfaces | |||
vf-modules | a deployment unit of VNFCs | |||
licenses | license information | |||
entitlements | entitlement information | |||
HomingPolicy | Reference to VNF-level homing policy that ECOMP will use when VNF deployment target node is auto-selected | |||
TargetNodePrompt | "Y" indicates operator-supplied VNF instance target deployment node required. Present prompt to operator: "Enter target node for deployment of this VNF instance" "N" indicates that the target deployment node for this VNF instance will be auto-selected by ECOMP | |||
VLAN Range Plan | Identifies the VNF-level VLAN Range Plan that must be used by ECOMP to assign VLAN tags to an instance of this VNF type | |||
VNF Name Prompt | "Y" indicates operator-supplied VNF name required. Present prompt to operator: "Enter the name for this VNF instance" "N" indicates that the name for the VNF instance will be auto-generated by ECOMP | |||
VNF Naming Policy | Reference to VNF-level naming policy that ECOMP will use when VNF-level name is auto-generated | |||
VNF Network Tag | Must correlate to the set of defined “network-role” identifiers from the associated HEAT templates | |||
metadata | Additional VNF-specific metadata describing the VNF instance. | |||
extension | VNF-specific attributes that affect the lifecycle management of this VNF instance by the VNFM, or the lifecycle management scripts. |
VNF Design Time Model
ONAP VNFD IM - based on IFA011 v231.docx
ONAP VNFD IM draft based on IFA011 v231 format and models: for discussion
ExternalVirtualLink Design Time Mode
SDC | AAI | ECOMP IM | ETSI IFA014 | Comments | Confirmed | Description |
invariantUUID | invariantUUID | Constant identifier of the external virtual link | ||||
UUID | virtualLinkDescId | vldId | Versioned identifier of the external virtual link | |||
customizationUUID | @maopeng zhang is the resource instance referred to the run-time resource instance? If it is in the run-time, why is it in the design time? | Identifier of the resource instance (uuid of the specific use of the resource model in this service). This identifier is regenerated whenever a user makes a change on the resource instance. | ||||
version | virtuaLinkDescVersion | version | The version of the external virtual link | |||
name | name | The name of the external virtual link | ||||
description | description | The description of the external virtual link | ||||
type | The type of resource. Resource type can be either VF, VFC, VFCMT, CP or VL. | |||||
category | Category of the resource | |||||
subcategory | Sub-category of the resource | |||||
resourceVendor | specifies the vendor providing this asset | |||||
resourceVendorRelease | specifies the release version given by the vendor (no exact correlation to the version of the asset in the SDC catalog) | |||||
resourceVendorModelNumber | Metadata of resources (VFs, VFCs, PNF) will include new field resourceVendorModelNumber. The value for this field is the part number defined by the vendor, e.g. “MX960”. | |||||
network_type | network_type | specifies the nature of the physical network in the underlying cloud infra-structure. Examples are flat, vlan, gre or vxlan. For flat and vlan types, physical_network should be provided too. | ||||
network_role | Unique label that defines the role that this network performs. example: vce oam network, vnat sr-iov1 network | |||||
network_scope | Uniquely identifies the network scope. Valid values for the network scope includes: VF - VF-level network. Intra-VF network which connects the VFCs (VMs) inside the VF. SERVICE - Service-level network. Intra-Service network which connects the VFs within the service GLOBAL - Global network which can be shared by multiple services | |||||
network_technology | ECOMP supported network technology | |||||
network_ecomp_naming | ||||||
network_homing | ||||||
network_assignments | ||||||
provider_network | ||||||
network_flows | ||||||
vendor | vitualLinkDescProvider | |||||
vl_name | same with the name | |||||
ip_version | ip_version | The IP version of the requested network. | ||||
cidr | cidr | The cidr block of the requested network. | ||||
start_ip | start_ip | The IP address to be used as the 1st one in a pool of addresses derived from the cidr block full IP range. | ||||
end_ip | end_ip | The IP address to be used as the last one in a pool of addresses derived from the cidr block full IP range. | ||||
gateway_ip | gateway_ip | The gateway IP address. | ||||
network_name | network_name | An Identifier that represents an existing Network instance in the underlying cloud infrastructure - OR - be used as the name of the new created network. | ||||
network_id | network_id | An Identifier that represents an existing Network instance in the underlying cloud infrastructure. This property is mutually exclusive with all other properties except network_name. | ||||
segmentation_id | segmentation_id | A segmentation identifier in the underlying cloud infrastructure (e.g., VLAN id, GRE tunnel id). If the segmentation_id is specified, the network_type or physical_network properties should be provided as well. | ||||
physical_network | physical_network | identifies the physical network on top of which the network is implemented, e.g. physnet1. This property is required if network_type is flat or vlan. | ||||
dhcp_enabled | dhcp_enabled | Indicates the TOSCA container to create a virtual network instance with or without a DHCP service. | ||||
testAccess | ||||||
virtualLinkDf | ||||||
ConnectivityType | ||||||
security |
ExternalVirtualLink Run Time Model
AAI | ECOMP IM | ETSI IFA013 (VirtualLink) | Comments | Confirmed | Description |
network-id | nsVirtualLinkInstanceId | virtualLinkInstanceId | |||
network-name | description | description | |||
network-role | |||||
network-technology | |||||
neutron-network-id | ResourceHandle | ||||
is-bound-to-vpn | |||||
service-id | nsInstanceId | componentInstanceId | |||
network-role-instance | |||||
resource-version | |||||
orchestration-status | |||||
heat-stack-id | |||||
mso-catalog-key | |||||
contrail-network-fqdn | |||||
model-invariant-id | invariantUUID | ||||
model-version-id | UUID | ||||
persona-model-version | version | ||||
model-customization-id | |||||
widget-model-id | |||||
widget-model-version | |||||
physical-network-name | |||||
is-provider-network | |||||
is-shared-network | |||||
is-external-network | |||||
selflink | selfLink | ||||
operational-status | status | ||||
nslinkport |