dellemc.openmanage.ome_network_vlan – Create, modify & delete a VLAN
Note
This plugin is part of the dellemc.openmanage collection (version 3.6.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install dellemc.openmanage
.
To use it in a playbook, specify: dellemc.openmanage.ome_network_vlan
.
New in version 2.1.0: of dellemc.openmanage
Synopsis
This module allows to,
Create a VLAN on OpenManage Enterprise.
Modify or delete an existing VLAN on OpenManage Enterprise.
Requirements
The below requirements are needed on the host that executes this module.
python >= 2.7.17
Parameters
Parameter |
Comments |
---|---|
Short description of the VLAN to be created or modified. |
|
OpenManage Enterprise or OpenManage Enterprise Modular IP address or hostname. |
|
Provide the name of the VLAN to be created, deleted or modified. |
|
Provide the name of the VLAN to be modified. |
|
OpenManage Enterprise or OpenManage Enterprise Modular password. |
|
OpenManage Enterprise or OpenManage Enterprise Modular HTTPS port. Default: 443 |
|
WARNING Deleting a VLAN can impact the network infrastructure. Choices:
|
|
Types of supported VLAN networks. For the description of each network type, use API https://%5C%20:emphasis:%60hostname%60%5C%20/api/NetworkConfigurationService/NetworkTypes. Choices:
|
|
OpenManage Enterprise or OpenManage Enterprise Modular username. |
|
The maximum VLAN value of the range. A single value VLAN is created if the vlan_maximum and vlan_minmum values are the same. |
|
The minimum VLAN value of the range. |
Notes
Note
Run this module from a system that has direct access to DellEMC OpenManage Enterprise.
This module supports
check_mode
.
Examples
---
- name: Create a VLAN range
dellemc.openmanage.ome_network_vlan:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
state: present
name: "vlan1"
description: "VLAN desc"
type: "General Purpose (Bronze)"
vlan_minimum: 35
vlan_maximum: 40
tags: create_vlan_range
- name: Create a VLAN with a single value
dellemc.openmanage.ome_network_vlan:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
state: present
name: "vlan2"
description: "VLAN desc"
type: "General Purpose (Bronze)"
vlan_minimum: 127
vlan_maximum: 127
tags: create_vlan_single
- name: Modify a VLAN
dellemc.openmanage.ome_network_vlan:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
state: present
name: "vlan1"
new_name: "vlan_gold1"
description: "new description"
type: "General Purpose (Gold)"
vlan_minimum: 45
vlan_maximum: 50
tags: modify_vlan
- name: Delete a VLAN
dellemc.openmanage.ome_network_vlan:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
state: "absent"
name: "vlan1"
tags: delete_vlan
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Details of the HTTP Error. Returned: on HTTP error Sample: {“@Message.ExtendedInfo”: [{“Message”: “Unable to create or update the network because the entered VLAN minimum 0 is not within a valid range ( 1 - 4000 or 4021 - 4094 ).”, “MessageArgs”: [“0”, “1”, “4000”, “4021”, “4094”], “MessageId”: “CTEM1043”, “RelatedProperties”: [], “Resolution”: “Enter a valid VLAN minimum as identified in the message and retry the operation.”, “Severity”: “Warning”}], “code”: “Base.1.0.GeneralError”, “message”: “A general error has occurred. See ExtendedInfo for more information.”} |
|
Overall status of the VLAN operation. Returned: always Sample: “Successfully created the VLAN.” |
|
Details of the VLAN that is either created or modified. Returned: when state=present Sample: {“@odata.context”: “/api/$metadata#NetworkConfigurationService.Network”, “@odata.id”: “/api/NetworkConfigurationService/Networks(1234)”, “@odata.type”: “#NetworkConfigurationService.Network”, “CreatedBy”: “admin”, “CreationTime”: “2020-01-01 05:54:36.113”, “Description”: “VLAN description”, “Id”: 1234, “InternalRefNWUUId”: “6d6effcc-eca4-44bd-be07-1234ab5cd67e”, “Name”: “vlan1”, “Type”: 1, “UpdatedBy”: null, “UpdatedTime”: “2020-01-01 05:54:36.113”, “VlanMaximum”: 130, “VlanMinimum”: 140} |
Authors
Jagadeesh N V(@jagadeeshnv)