Skip to content

Services

dvn_service

create, update, or destroy DVN services

Synopsis

  • Create a new service
  • Delete an existing service
  • Update an exiting service
  • Add a service to a service group
  • Remove as service from a service group

Options

Parameter Required? Default Choices Comments
username service-prov administrator username. If not specified as a parameter, the environment variable DVNREST_USER will be used.
password service-prov password If not specified as a parameter, the environment variable DVNREST_PASSWORD will be used.
url service-prov url. If not specified as a parameter, the environment variable DVNREST_URL will be used.
validate_certs True Check certs. Use false to allow self-signed. If not specified as a parameter, the environment variable VALIDATE_CERTS will be used.
state present
  • present
  • absent
 specify state of the VTC
service_id yes Unique ID for service object
vtc_id yes Unique ID for VTC host object
service_class yes
  • client
  • l3gw
  • icmp
  • l2gw
  • l2mlx
  • l3ws
 Type of DVN service to create
service_parameters yes Service parameters specific to each service_class as key-value pairs
common_name no Optional label for service
crypto_level encrypt
  • encrypt
  • authenticate
 Crypto level for service
ecdh False
  • True
  • False
 Whether or not to use ECDH
pbr_type wan
  • wan
  • mpls
  • wan_protected
  • mpls_protected
  • all
 Policy-based routing type
service_groups specify service group(s) to place VTC into

Examples


  - name: create a Round-Robin protected L3GW service
    dvn_service:
      url: "{{rest_url}}"
      username: "{{rest_user}}"
      password: "{{rest_pass}}"
      service_id: test-l3gw
      service_class: l3gw
      vtc_id: [test2, test1]
      service_parameters:
        gateway_ip: 172.16.230.1
        gateway_netmask: 255.255.255.0
      validate_certs: false

  - name: create an L2MLX service
    dvn_service:
      url: "{{rest_url}}"
      username: "{{rest_user}}"
      password: "{{rest_pass}}"
      service_id: test-l2mlx
      service_class: l2mlx
      vtc_id: test1
      service_parameters:
        bridge_intf: br0
        vlan_id: 444
      validate_certs: false

  - name: create a client service
    dvn_service:
      url: "{{rest_url}}"
      username: "{{rest_user}}"
      password: "{{rest_pass}}"
      service_id: test-client
      service_class: client
      vtc_id: test1
      service_parameters:
        network_ip: 172.16.230.1
        network_first_port: 1
        network_last_port: 64444
        intercept_ip: 1.2.3.4
        intercept_first_port: 1
        intercept_last_port: 64444
      validate_certs: false