path: root/common/onap-tosca-datatype/src/main/resources/globalTypes/openecomp/data.yml

#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

tosca_definitions_version: tosca_simple_yaml_1_1

metadata:
  filename: openecomp/data.yml
  version: '1.0'

imports:
- openecomp_index:
    file: _index.yml

data_types:

  org.openecomp.datatypes.network.ProviderNetwork:
    derived_from: org.openecomp.datatypes.Root
    properties:
      is_provider_network:
        description: \"true\" indicates that this a Neutron provider type of network
        type: boolean
        required: true
      physical_network_name:
        description: |
          Identifies the NUMA processor cluster to which this physical network interface belongs. NUMA instance correlates to the first digit of the Physical Network Name suffix (e.g. \"01\" = NUMA 0, \"11\" = NUMA 1)
        type: string
        required: false
        constraints:
        - valid_values:
          - Physnet41
          - Physnet42
          - Physnet43
          - Physnet44
          - Physnet21
          - Physnet22
          - sriovnet1
          - sriovnet2
          - oam
      numa:
        description: |
          PNIC instance within the NUMA processor cluster PNIC Instance correlates to the second digit of the Physical Network Name suffix (e.g. "01" = PNIC 1, "02" = "PNIC 2)
        type: string
        required: false
        constraints:
        - valid_values:
          - NUMA 0
          - NUMA 1
      pnic_instance:
        description: PNIC instance within the NUMA processor cluster
        type: integer
        required: false

  org.openecomp.datatypes.DeploymentFlavor:
    derived_from: tosca.datatypes.Root
    description: Deployment Flavor
    properties:
      name:
        description: Deployment Flavor Name
        type: string
        status: supported
        required: true
      license_feature_group:
        description: license feature group associated with Deployment Flavor
        type: org.openecomp.datatypes.FeatureGroup
        status: supported
        required: true
      compute_size:
        description: Size of VM
        type: org.openecomp.datatypes.ComputeFlavor
        status: supported
        required: true

  org.openecomp.datatypes.FeatureGroup:
    derived_from: tosca.datatypes.Root
    description: License Feature Group
    properties:
      license_feature_group_ref:
        description: Deployment Flavor Name
        type: string
        status: supported
        required: true
      part_number:
        description: refrence part number related to feature group
        type: string
        status: supported
        required: true

  org.openecomp.datatypes.CSProperties:
    derived_from: org.openecomp.datatypes.Root
    properties:
      sNSSAI:
        type: string
        required: true
        description: sNSSAI
      maxNumberofUEs:
        type: integer
        required: true
        default: 1000
        description: maxNumberofUEs
      latency:
        type: integer
        required: true
        default: 30
        description: latency
      expDataRateDL:
        type: integer
        required: false
        description: expDataRateDL
      expDataRateUL:
        type: integer
        required: false
        description: expDataRateUL
      coverageAreaList:
        type: string
        required: true
        description: coverageAreaList
      uEMobilityLevel:
        type: string
        constraints:
          - valid_values: ["stationary", "nomadic","restricted mobility","fully mobility"]
        required: false
        description: uEMobilityLevel
      useInterval:
        type: string
        required: true
        description: useInterval
      resourceSharingLevel:
        type: string
        required: true
        default: "Shared"
        constraints:
          - valid_values: ["Shared", "Non-shared"]
        description: resourceSharingLevel

  org.openecomp.datatypes.NSCapabilities:
    derived_from: org.openecomp.datatypes.Root
    properties:
      pLMNIdList:
        type: string
        required: true
        description: pLMNIdList
      maxNumberofUEs:
        type: integer
        required: true
        default: 1000
        description: maxNumberofUEs
      latency:
        type: integer
        required: true
        default: 30
        description: latency
      uEMobilityLevel:
        type: string
        constraints:
          - valid_values: ["stationary", "nomadic","restricted mobility","fully mobility"]
        required: false
        description: uEMobilityLevel
      resourceSharingLevel:
        type: string
        required: true
        default: "Shared"
        constraints:
          - valid_values: ["Shared", "Non-shared"]
        description: resourceSharingLevel
      sST:
        type: string
        required: true
        default: "eMBB"
        constraints:
          - valid_values: ["eMBB", "uRLLC", "mIot"]
        description: sST
      availability:
        type: float
        required: false
        description: availability
      dLThptPerUE:
        type: integer
        required: false
        description: dLThptPerUE
      uLThptPerUE:
        type: integer
        required: false
        description: uLThptPerUE
      maxPktSize:
        type: integer
        required: false
        description: maxPktSize
      termDensity:
        type: integer
        required: false
        description: termDensity
      activityFactor:
        type: integer
        required: false
        description: activityFactor
      jitter:
        type: integer
        required: false
        description: jitter
      survivalTime:
        type: string
        required: false
        description: survivalTime
      reliability:
        type: string
        required: false
        description: reliability
      dLThptPerSlice:
        type: integer
        required: false
        description: dLThptPerSlice
      uLThptPerSlice:
        type: integer
        required: false
        description: uLThptPerSlice
      maxNumberofConns:
        type: integer
        required: false
        description: maxNumberofConns

  org.openecomp.datatypes.NSSCapabilities:
    derived_from: org.openecomp.datatypes.Root
    properties:
      pLMNIdList:
        type: string
        required: true
        description: pLMNIdList
      maxNumberofUEs:
        type: integer
        required: true
        default: 10000
        description: maxNumberofUEs
      latency:
        type: integer
        required: true
        default: 30
        description: latency
      uEMobilityLevel:
        type: string
        constraints:
          - valid_values: ["stationary", "nomadic","restricted mobility","fully mobility"]
        required: false
        description: uEMobilityLevel
      resourceSharingLevel:
        type: string
        required: true
        default: "Shared"
        constraints:
          - valid_values: ["Shared", "Non-shared"]
        description: resourceSharingLevel
      sST:
        type: string
        required: true
        default: "eMBB"
        constraints:
          - valid_values: ["eMBB", "uRLLC", "mIot"]
        description: sST
      expDataRateDL:
        type: integer
        required: false
        description: expDataRateDL
      expDataRateUL:
        type: integer
        required: false
        description: expDataRateUL
      areaTrafficCapDL:
        type: integer
        required: false
        description: areaTrafficCapDL
      areaTrafficCapUL:
        type: integer
        required: false
        description: areaTrafficCapUL
      overallUserDensity:
        type: integer
        required: false
        description: overallUserDensity
      activityFactor:
        type: integer
        required: false
        description: activityFactor
      cSAvailabilityTarget:
        type: float
        required: false
        description: cSAvailabilityTarget
      cSReliabilityMeanTime:
        type: string
        required: false
        description: cSReliabilityMeanTime
      expDataRate:
        type: integer
        required: false
        description: expDataRate
      msgSizeByte:
        type: string
        required: false
        description: msgSizeByte
      transferIntervalTarget:
        type: string
        required: false
        description: transferIntervalTarget
      survivalTime:
        type: string
        required: false
        description: survivalTime
      maxNumberofPDUSession:
        type: integer
        required: false
        description: maxNumberofPDUSession

  org.openecomp.datatypes.ServiceProfile:
    derived_from: org.openecomp.datatypes.Root
    properties:
      sNSSAI:
        type: string
        required: true
        description: sNSSAI
      pLMNIdList:
        type: string
        required: true
        description: pLMNIdList
      maxNumberofUEs:
        type: integer
        required: true
        default: 1000
        description: maxNumberofUEs
      latency:
        type: integer
        required: true
        default: 30
        description: latency
      activityFactor:
        type: integer
        constraints:
          - in_range: [0,100]
        required: false
        default: 20
        description: activityFactor
      coverageAreaTAList:
        type: string
        required: false
        description: coverageAreaTAList
      uEMobilityLevel:
        type: string
        constraints:
          - valid_values: ["stationary", "nomadic","restricted mobility","fully mobility"]
        required: false
        description: uEMobilityLevel
      resourceSharingLevel:
        type: string
        required: true
        default: "Shared"
        constraints:
          - valid_values: ["Shared", "Non-shared"]
        description: resourceSharingLevel
      sST:
        type: string
        required: true
        default: "eMBB"
        constraints:
          - valid_values: ["eMBB", "uRLLC", "mIot"]
        description: sST
      availability:
        type: float
        required: false
        description: availability
      reliability:
        type: string
        required: false
        description: reliability
      dLThptPerUE:
        type: integer
        required: false
        description: dLThptPerUE
      uLThptPerUE:
        type: integer
        required: false
        description: uLThptPerUE
      maxPktSize:
        type: integer
        required: false
        description: maxPktSize
      termDensity:
        type: integer
        required: false
        description: termDensity
      jitter:
        type: integer
        required: false
        description: jitter
      survivalTime:
        type: string
        required: false
        description: survivalTime
      dLThptPerSlice:
        type: integer
        required: false
        description: dLThptPerSlice
      uLThptPerSlice:
        type: integer
        required: false
        description: uLThptPerSlice
      maxNumberofConns:
        type: integer
        required: false
        description: maxNumberofConns

  org.openecomp.datatypes.SliceProfile:
    derived_from: org.openecomp.datatypes.Root
    properties:
      sNSSAI:
        type: string
        required: true
        description: sNSSAI
      pLMNIdList:
        type: string
        required: true
        description: pLMNIdList
      maxNumberofUEs:
        type: integer
        required: true
        default: 1000
        description: maxNumberofUEs
      latency:
        type: integer
        required: true
        default: 30
        description: latency
      expDataRateDL:
        type: integer
        required: false
        description: expDataRateDL
      expDataRateUL:
        type: integer
        required: false
        description: expDataRateUL
      areaTrafficCapDL:
        type: integer
        required: false
        description: areaTrafficCapDL
      areaTrafficCapUL:
        type: integer
        required: false
        description: areaTrafficCapUL
      overallUserDensity:
        type: integer
        required: false
        description: overallUserDensity
      activityFactor:
        type: integer
        required: false
        description: activityFactor
      coverageAreaTAList:
        type: string
        required: false
        description: coverageAreaTAList
      uEMobilityLevel:
        type: string
        constraints:
          - valid_values: ["stationary", "nomadic","restricted mobility","fully mobility"]
        required: false
        description: uEMobilityLevel
      resourceSharingLevel:
        type: string
        required: true
        default: "Shared"
        constraints:
          - valid_values: ["Shared", "Non-shared"]
        description: resourceSharingLevel
      sST:
        type: string
        required: true
        default: "eMBB"
        constraints:
          - valid_values: ["eMBB", "uRLLC", "mIot"]
        description: sST
      cSAvailabilityTarget:
        type: float
        required: false
        description: cSAvailabilityTarget
      cSReliabilityMeanTime:
        type: string
        required: false
        description: cSReliabilityMeanTime
      expDataRate:
        type: integer
        required: false
        description: expDataRate
      msgSizeByte:
        type: string
        required: false
        description: msgSizeByte
      transferIntervalTarget:
        type: string
        required: false
        description: transferIntervalTarget
      survivalTime:
        type: string
        required: false
        description: survivalTime
      maxNumberofPDUSession:
        type: integer
        required: false
        description: maxNumberofPDUSession

  org.openecomp.datatypes.EcompHoming:
    derived_from: org.openecomp.datatypes.Root
    properties:
      ecomp_selected_instance_node_target:
        description: |
          "true" indicates that the target deployment node for this instance will be auto-selected by OPENECOMP "false" indicates operator-supplied instance target deployment node required (e.g. VID will present a prompt to operator and collect the operator-selected target node for the deployment of this Network instance).
        type: boolean
        default: false
        required: true
      homing_policy:
        description: Referenc to a service level homing policy that OPENECOMP will use for instance deployment target node
        type: string
        required: false
      instance_node_target:
        description: Instance target deployment node
        type: string
        required: false

  org.openecomp.datatypes.AssignmentRequirements:
    derived_from: org.openecomp.datatypes.Root
    properties:
      is_required:
        description: |
          "true" indicates that assignment is required
        type: boolean
        default: false
        required: true
      count:
        description: number of assignments required
        type: integer
        required: false

  org.openecomp.resource.abstract.nodes.PNF:
    derived_from: tosca.nodes.Root
    properties:
      nf_function:
        type: string
      nf_role:
        type: string
      nf_type:
        type: string


  org.openecomp.datatypes.network.IpRequirements:
    derived_from: org.openecomp.datatypes.Root
    properties:
      ip_version:
        type: integer
        required: true
        constraints:
          - valid_values:
            - 4
            - 6
      ip_count:
        description: identifies the number of ip address to assign to the CP from the plan
        type: integer
        required: false
      floating_ip_count:
        type: integer
        required: false
      subnet_role:
        type: string
        required: false
      assingment_method:
        type: string
        required: true
        constraints:
          - valid_values:
            - fixed
            - dhcp
      dhcp_enabled:
        type: boolean
        required: false
      ip_count_required:
        description: identifies the number of ip address to assign to the CP from the plan
        type: org.openecomp.datatypes.AssignmentRequirements
        required: false
      floating_ip_count_required:
        type: org.openecomp.datatypes.AssignmentRequirements
        required: false
      ip_address_plan_name:
        type: string
        required: false
      vrf_name:
        type: string
        required: false

  org.openecomp.datatypes.network.PhysicalNetwork:
    derived_from: org.openecomp.datatypes.Root
    properties:
      provider_network:
        description: true indicates that this a Neutron provider type of network
        type: boolean
        required: true
      physical_network_name:
        description: |
          Identifies the NUMA processor cluster to which this physical network interface belongs. NUMA instance correlates to the first digit of the Physical Network Name suffix (e.g. "01" = NUMA 0, "11" = NUMA 1)
        type: string
        required: false
        constraints:
        - valid_values:
          - Physnet-SRIOV-1
          - Physnet-SRIOV-2
          - Physnet-SRIOV-11
          - Physnet-SRIOV-12
      numa:
        description: |
          PNIC instance within the NUMA processor cluster PNIC Instance correlates to the second digit of the Physical Network Name suffix (e.g. "01" = PNIC 1, "02" = "PNIC 2)
        type: string
        required: false
        constraints:
        - valid_values:
          - NUMA 0
          - NUMA 1
      pnic_instance:
        description: PNIC instance within the NUMA processor cluster
        type: integer
        required: false

  org.openecomp.datatypes.network.VlanRequirements:
    derived_from: org.openecomp.datatypes.Root
    properties:
      vlan_range_plan:
        description: reference to a vlan range plan
        type: string
        required: true
      vlan_type:
        description: identifies the vlan type (e.g., c-tag)
        type: string
        required: true
        constraints:
        - valid_values:
          - c-tag
          - s-tag
      vlan_count:
        description: identifies the number of vlan tags to assign to the CP from the plan
        type: integer
        required: true

  org.openecomp.datatypes.ComputeFlavor:
    derived_from: tosca.datatypes.Root
    description: Compute Flavor (Size)
    properties:
      name:
        description: Compute Flavor Name
        type: string
        status: supported
        required: true
      num_cpus:
        description: Number of cpu
        type: integer
        status: supported
        required: true
      disk_size:
        description: Disk size
        type: scalar-unit.size
        status: supported
        required: true
      mem_size:
        description: Memory size
        type: scalar-unit.size
        status: supported
        required: true

  org.openecomp.datatypes.network.MacAssignments:
    derived_from: org.openecomp.datatypes.Root
    properties:
      mac_range_plan:
        description: reference to a MAC address range plan
        type: string
        required: true
      mac_count:
        description: identifies the number of MAC addresses to assign to the CP from the plan
        type: integer
        required: false
      mac_count_required:
        description: identifies the number of MAC addresses to assign to the CP from the plan
        type: org.openecomp.datatypes.AssignmentRequirements
        required: false

  org.openecomp.datatypes.network.MacRequirements:
    derived_from: org.openecomp.datatypes.Root
    properties:
      mac_range_plan:
        description: reference to a MAC address range plan
        type: string
        required: true
      mac_count:
        description: identifies the number of MAC addresses to assign to the CP from the plan
        type: integer
        required: false
      mac_count_required:
        description: identifies the number of MAC addresses to assign to the CP from the plan
        type: org.openecomp.datatypes.AssignmentRequirements
        required: false

  org.openecomp.datatypes.network.SubnetAssignments:
    derived_from: org.openecomp.datatypes.Root
    properties:
      ip_network_address_plan:
        description: Reference to EIPAM, VLAN or other address plan ID used to assign subnets to this network
        type: string
        required: false
      dhcp_enabled:
        description: \"true\" indicates the network has 1 or more policies
        type: boolean
        required: false
      ip_version:
        description: The IP version of the subnet
        type: integer
        required: true
        constraints:
        - valid_values:
          - 4
          - 6
      cidr_mask:
        description: The default subnet CIDR mask
        type: integer
        required: true
      min_subnets_count:
        description: Quantity of subnets that must be initially assigned
        type: integer
        default: 1
        required: true

  org.openecomp.datatypes.Artifact:
    derived_from: org.openecomp.datatypes.Root
    properties:
      artifact_name:
        description: Artifcat name
        type: string
        required: true
      artifact_type:
        description: Artifcat type
        type: string
        required: true
      artifact_uuid:
        description: Artifcat UUID
        type: string
        required: true
      artifact_checksum:
        description: Artifact checksum
        type: string
        required: true
      artifact_url:
        description: Artifcay URL. Can also include only the file name
        type: string
        required: true

  org.openecomp.datatypes.network.IPv4SubnetAssignments:
    derived_from: org.openecomp.datatypes.network.SubnetAssignments
    properties:
      use_ipv4:
        description: Indicates IPv4 subnet assignments
        type: boolean
        required: true

  org.openecomp.datatypes.Root:
    derived_from: tosca.datatypes.Root
    description: |
      The AT&T root Data Type all other Data Types derive from
    properties:
      supplemental_data:
        type: map
        entry_schema:
          type: string
          description: |
            A placeholder for missing properties that would be included in future OPENecomp model
            versions. fromat <key>:<value>


  org.openecomp.datatypes.substitution.SubstitutionFiltering:
    derived_from: tosca.datatypes.Root
    description: Substitution Filter
    properties:
      substitute_service_template:
        description: Substitute Service Template
        type: string
        status: supported
        required: true
      index_value:
        description: Index value of the substitution service template runtime instance
        type: integer
        status: supported
        default: 0
        required: false
        constraints:
        - greater_or_equal: 0
      count:
        description: Count
        type: integer
        status: supported
        default: 1
        required: false
      scaling_enabled:
        description: Indicates whether service scaling is enabled
        type: boolean
        status: supported
        default: true
        required: false
      mandatory:
        description: Mandatory
        type: boolean
        status: supported
        required: false

  org.openecomp.datatypes.network.NetworkFlows:
    derived_from: org.openecomp.datatypes.Root
    properties:
      is_network_policy:
        description: true indicates the network has 1 or more policies
        type: boolean
        default: false
        required: false
      network_policy:
        description: Identifies the specific OPENECOMP Contrail network policy that must be applied to this network (source - from Policy Manager)
        type: string
        required: false
      vpn_binding:
        description: Identifies the specific VPN Binding entry in A&AI that must be applied when creating this network (source - A&AI)
        type: string
        required: false

  org.openecomp.datatypes.network.NetworkAssignments:
    derived_from: org.openecomp.datatypes.Root
    properties:
      ecomp_generated_network_assignment:
        description: |
          "true" indicates that the network assignments will be auto-generated by OPENECOMP "false" indicates operator-supplied Network assignments file upload is required (e.g. VID will present prompt to operator to upload operator-supplied Network assignments file).
        type: boolean
        default: false
        required: true
      network_assignments_file:
        description: Filename of the template that specifies all of the configurable name/value pairs of Network assignments in this Network model
        type: string
        required: false
      multi_tenant:
        description: true means this network is shared by multiple Openstack tenants
        type: boolean
        default: true
        required: true
      min_subnets_count:
        description: Quantity of subnets that must be initially assigned
        type: integer
        required: true
      ip_network_address_plan:
        description: Reference to EIPAM, VLAN or other address plan ID used to assign subnets to this network
        type: string
        required: true
      vlan_network_address_plan:
        description: Reference to VLAN or other address plan ID used to assign subnets to this network
        type: string
        required: true
      related_networks:
        type: list
        description: Related Networks List.
        required: false
        entry_schema:
          type: org.openecomp.datatypes.network.RelatedNetworksAssignments
      is_trunked:
        type: boolean
        required: true
        description: \"true\" indicates that network is trunked
        default: false

  org.openecomp.datatypes.network.RelatedNetworksAssignments:
    derived_from: org.openecomp.datatypes.Root
    properties:
      related_network_role:
        description: The network role of the related network, sharing provider network
        type: string
        required: false

  org.openecomp.datatypes.network.IPv6SubnetAssignments:
    derived_from: org.openecomp.datatypes.network.SubnetAssignments
    properties:
      use_ipv6:
        description: Indicates IPv6 subnet assignments
        type: boolean
        required: true

  org.openecomp.datatypes.EcompNaming:
    derived_from: org.openecomp.datatypes.Root
    properties:
      ecomp_generated_naming:
        description: |
          "true" indicates that the name for the instance will be auto-generated by OPENECOMP. "false" indicates operator-supplied name required (e.g. VID will present prompt to operator and collect the operator-supplied instance name).
        type: boolean
        default: true
        required: true
      naming_policy:
        description: Referenc to naming policy that OPENECOMP will use when the name is auto-generated
        type: string
        required: false

  org.openecomp.datatypes.Naming:
    derived_from: org.openecomp.datatypes.Root
    properties:
      ecomp_generated_naming:
        description: |
          "true" indicates that the name for the instance will be auto-generated by OPENECOMP. "false" indicates operator-supplied name required (e.g. VID will present prompt to operator and collect the operator-supplied instance name).
        type: boolean
        default: true
        required: true

  org.openecomp.datatypes.EcompGeneratedNaming:
    derived_from: org.openecomp.datatypes.Naming
    properties:
      naming_policy:
        description: Referenc to naming policy that OPENECOMP will use when the name is auto-generated
        type: string
        required: false

  org.openecomp.datatypes.UserDefinedNaming:
    derived_from: org.openecomp.datatypes.Naming
    properties:
      instance_name:
        description: Reference to naming policy that OPENECOMP will use when the name is auto-generated
        type: string
        required: false

  org.openecomp.datatypes.flavors.DeploymentFlavor:
    properties:
      sp_part_number:
        type: string
        description: Part number of the feature group associated with the deployment flavor
      vendor_info:
        type: org.openecomp.datatypes.flavors.VendorInfo
        description: Vendor information for the deployment flavor
      compute_flavor:
        type: org.openecomp.datatypes.flavors.ComputeFlavor
        description: Compute information for the deployment flavor
      license_flavor:
        type: org.openecomp.datatypes.flavors.LicenseFlavor
        description: License information for the deployment flavor
        required: false

  org.openecomp.datatypes.flavors.ComputeFlavor:
    properties:
      num_cpus:
        type: integer
        description: Number of CPUs for the VM
      disk_size:
        type: scalar-unit.size
        description: Disk size of the VM
      mem_size:
        type: scalar-unit.size
        description: Memory size of the VM

  org.openecomp.datatypes.flavors.LicenseFlavor:
    properties:
      feature_group_uuid:
        type: string
        description: Feature Group Id

  org.openecomp.datatypes.flavors.VendorInfo:
    properties:
      manufacturer_reference_number:
        type: string
        description: Manufacturer reference number
      vendor_model:
        type: string
        description: Vendor License Model Id

  org.openecomp.datatypes.ImageInfo:
    properties:
      software_version:
        type: string
        description: Image version
      file_name:
        type: string
        description: Image file name
      file_hash:
        type: string
        description: checksum/signature
      file_hash_type:
        type: string
        description: Hash type
        required: false
        default: md5

  # New data types for Port Mirroring
  org.openecomp.datatypes.PortMirroringConnectionPointDescription:
    properties:
      nf_type:
        type: string
        description: deprecated
      nfc_type:
        type: string
        description: deprecated
      nf_naming_code:
        type: string
      nfc_naming_code:
        type: string
      network_role:
        type: string
      pps_capacity:
        type: string

  tosca.datatypes.network.NetworkInfo:
    properties:
      network_id:
        required: false
        type: string
      addresses:
        entry_schema:
          type: string
        required: false
        type: list
      network_name:
        required: false
        type: string
  tosca.datatypes.network.PortInfo:
    properties:
      port_name:
        required: false
        type: string
      network_id:
        required: false
        type: string
      addresses:
        entry_schema:
          type: string
        required: false
        type: list
      mac_address:
        required: false
        type: string
      port_id:
        required: false
        type: string