dellemc.openmanage.ome_smart_fabric_info 模块 – 获取 OpenManage Enterprise Modular 清点的智能光纤信息

注意

此模块是 dellemc.openmanage 集合（版本 9.9.0）的一部分。

如果您正在使用 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install dellemc.openmanage。您需要更多要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定：dellemc.openmanage.ome_smart_fabric_info。

dellemc.openmanage 7.1.0 中的新功能

概要

  • 此模块检索 OpenManage Enterprise Modular 清单中的智能光纤列表。

要求

在执行此模块的主机上需要以下要求。

  • python >= 3.9.6

参数

参数

注释

ca_path

路径

在 dellemc.openmanage 5.0.0 中添加

包含用于验证的 CA 证书的 Privacy Enhanced Mail (PEM) 文件。

fabric_id

字符串

光纤的唯一 ID。

fabric_id 与 fabric_name 互斥。

fabric_name

字符串

光纤的名称。

fabric_name 与 fabric_id 互斥。

hostname

字符串 / 必需

OpenManage Enterprise Modular IP 地址或主机名。

password

字符串

OpenManage Enterprise Modular 密码。

如果未提供密码，则使用环境变量 OME_PASSWORD。

示例：export OME_PASSWORD=密码

port

整数

OpenManage Enterprise Modular HTTPS 端口。

默认值： 443

timeout

整数

在 dellemc.openmanage 5.0.0 中添加

套接字级别的超时时间，以秒为单位。

默认值： 30

username

字符串

OpenManage Enterprise Modular 用户名。

如果未提供用户名，则使用环境变量 OME_USERNAME。

示例：export OME_USERNAME=用户名

validate_certs

布尔值

在 dellemc.openmanage 5.0.0 中添加

如果为 false，则不会验证 SSL 证书。

仅在个人控制的站点上使用自签名证书时才配置 false。

在集合版本 5.0.0 之前，validate_certs 默认为 false。

选项

  • false

  • true ← (默认)

x_auth_token

字符串

在 dellemc.openmanage 9.3.0 中添加

身份验证令牌。

如果未提供 x_auth_token，则使用环境变量 OME_X_AUTH_TOKEN。

示例：export OME_X_AUTH_TOKEN=x_auth_token

注释

注意

  • 从可以直接访问 Dell OpenManage Enterprise Modular 的系统运行此模块。

  • 此模块支持 check_mode。

示例

---
- name: Retrieve details of all smart fabrics
  dellemc.openmanage.ome_smart_fabric_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"

- name: Retrieve details of a specific smart fabric identified by its fabric ID
  dellemc.openmanage.ome_smart_fabric_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    fabric_id: "61c20a59-9ed5-4ae5-b850-5e5acf42d2f2"

- name: Retrieve details of a specific smart fabric identified by its fabric name
  dellemc.openmanage.ome_smart_fabric_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    fabric_name: "f1"

返回值

常见返回值记录在此处，以下是此模块特有的字段

键

描述

error_info

字典

HTTP 错误的详细信息。

返回： 发生 HTTP 错误时

示例： {"error": {"@Message.ExtendedInfo": [{"Message": "由于资源 URI 不存在或未实现，无法完成请求。", "MessageArgs": [], "MessageId": "CGEN1006", "RelatedProperties": [], "Resolution": "检查请求资源 URI。有关资源 URI 及其属性的更多信息，请参阅 OpenManage Enterprise-Modular 用户指南。", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "发生了一般错误。有关更多信息，请参阅 ExtendedInfo。"}}

msg

字符串

智能架构信息检索状态。

返回: 始终

示例: "成功检索了智能架构信息。"

smart_fabric_info

列表 / 元素=字符串

返回有关智能架构的信息。

返回: 成功

Sample: [{"Description": "Fabric f1", "FabricDesign": [{"Actions": {"#NetworkService.GetApplicableNodes": {"target": "/api/NetworkService/Fabrics('61c20a59-9ed5-4ae5-b850-5e5acf42d2f2')/FabricDesign/NetworkService.GetApplicableNodes"}, "Oem": {}}, "FabricDesignNode": [{"ChassisName": "Chassis-X", "NodeName": "Switch-B", "Slot": "Slot-A2", "Type": "WeaverSwitch"}, {"ChassisName": "Chassis-X", "NodeName": "Switch-A", "Slot": "Slot-A1", "Type": "WeaverSwitch"}], "Name": "2xMX9116n_Fabric_Switching_Engines_in_same_chassis", "NetworkLink": [{"DestinationInterface": "ethernet1/1/38", "DestinationNode": "Switch-B", "SourceInterface": "ethernet1/1/38", "SourceNode": "Switch-A"}, {"DestinationInterface": "ethernet1/1/37", "DestinationNode": "Switch-B", "SourceInterface": "ethernet1/1/37", "SourceNode": "Switch-A"}, {"DestinationInterface": "ethernet1/1/39", "DestinationNode": "Switch-B", "SourceInterface": "ethernet1/1/39", "SourceNode": "Switch-A"}, {"DestinationInterface": "ethernet1/1/40", "DestinationNode": "Switch-B", "SourceInterface": "ethernet1/1/40", "SourceNode": "Switch-A"}]}], "FabricDesignMapping": [{"DesignNode": "Switch-A", "PhysicalNode": "NODEID1"}, {"DesignNode": "Switch-B", "PhysicalNode": "NODEID2"}], "Health": {"Issues": [{"Category": "Audit", "DetailedDescription": "The SmartFabric is not healthy because the interface for an uplink mentioned in the message is not in operational status.", "Message": "The SmartFabric is not healthy because the interface JRWSV43:ethernet1/1/35 for uplink 1ad54420-b145-49a1-9779-21a579ef6f2d is not in operational status.", "MessageArgs": [], "MessageId": "NFAB0016", "Resolution": "Make sure that all the uplink interfaces are in operational status.", "Severity": "Warning", "TimeStamp": "2019-09-25T11:50:06Z"}, {"Category": "Audit", "DetailedDescription": "The SmartFabric is not healthy because one or more VLTi links are not connected.", "Message": "The SmartFabric is not healthy because all InterSwitch Links are not connected.", "MessageArgs": [], "MessageId": "NFAB0017", "Resolution": "Make sure that the VLTi cables for all ISLs are connected and operational as per the selected fabric design.", "Severity": "Warning", "TimeStamp": "2019-09-25T11:50:06Z"}, {"Category": "Audit", "DetailedDescription": "The SmartFabric is not healthy because the interface for an uplink mentioned in the message is not in operational status.", "Message": "The SmartFabric is not healthy because the interface 6H7J6Z2:ethernet1/1/35 for uplink 1ad54420-b145-49a1-9779-21a579ef6f2d is not in operational status.", "MessageArgs": [], "MessageId": "NFAB0016", "Resolution": "Make sure that all the uplink interfaces are in operational status.", "Severity": "Warning", "TimeStamp": "2019-09-25T11:50:06Z"}, {"Category": "Audit", "DetailedDescription": "The SmartFabric is not healthy because one or more of the uplink interfaces are not bonded.", "Message": "The SmartFabric is not healthy because the uplink 1ad54420-b145-49a1-9779-21a579ef6f2d interface 6H7J6Z2:ethernet1/1/35 is not bonded to the other interfaces in the uplink.", "MessageArgs": [], "MessageId": "NFAB0019", "Resolution": "Make sure that the Link Aggregation Control Protocol (LACP) is enabled on all ports on the remote switch to which the uplink ports from the fabric are connected.", "Severity": "Warning", "TimeStamp": "2019-09-25T11:50:06Z"}, {"Category": "Audit", "DetailedDescription": "The SmartFabric is not healthy because one or more of the uplink interfaces are not bonded.", "Message": "The SmartFabric is not healthy because the uplink 1ad54420-b145-49a1-9779-21a579ef6f2d interface JRWSV43:ethernet1/1/35 is not bonded to the other interfaces in the uplink.", "MessageArgs": [], "MessageId": "NFAB0019", "Resolution": "Make sure that the Link Aggregation Control Protocol (LACP) is enabled on all ports on the remote switch to which the uplink ports from the fabric are connected.", "Severity": "Warning", "TimeStamp": "2019-09-25T11:50:06Z"}], "Status": "4000"}, "Id": "61c20a59-9ed5-4ae5-b850-5e5acf42d2f2", "LifeCycleStatus": [{"Activity": "Create", "Status": "2060"}], "Multicast": [{"FloodRestrict": true, "IgmpVersion": "3", "MldVersion": "2"}], "Name": "f1", "OverrideLLDPConfiguration": "Disabled", "ScaleVLANProfile": "Enabled", "Servers": [{"ChassisServiceTag": "6H5S6Z2", "ConnectionState": true, "ConnectionStateReason": 101, "DeviceCapabilities": [1, 2, 3, 4, 7, 8, 9, 41, 10, 11, 12, 13, 14, 15, 208, 16, 17, 18, 212, 30, 31], "DeviceManagement": [{"DnsName": "iDRAC-6GZK6Z2", "InstrumentationName": "", "MacAddress": "4c:d9:8f:7a:7c:43", "ManagementId": 135185, "ManagementProfile": [{"AgentName": "iDRAC", "HasCreds": 0, "ManagementId": 135185, "ManagementProfileId": 135185, "ManagementURL": "https://[2607:f2b1:f081:9:4ed9:8fff:fe7a:7c43]:443/", "ProfileId": "WSMAN_OOB", "Status": 1000, "StatusDateTime": "2019-10-29 09:30:38.552", "Version": "3.20.21.20"}], "ManagementType": 2, "NetworkAddress": "100.96.24.28"}, {"DnsName": "iDRAC-6GZK6Z2", "InstrumentationName": "", "MacAddress": "4c:d9:8f:7a:7c:43", "ManagementId": 135186, "ManagementProfile": [{"AgentName": "iDRAC", "HasCreds": 0, "ManagementId": 135186, "ManagementProfileId": 135186, "ManagementURL": "https://[2607:f2b1:f081:9:4ed9:8fff:fe7a:7c43]:443/", "ProfileId": "WSMAN_OOB", "Status": 1000, "StatusDateTime": "2019-10-29 09:30:38.552", "Version": "3.20.21.20"}], "ManagementType": 2, "NetworkAddress": "[2607:f2b1:f081:9:4ed9:8fff:fe7a:7c43]"}], "DeviceName": "MX-6H5S6Z2:Sled-1", "DeviceServiceTag": "6GZK6Z2", "Enabled": true, "Id": 10071, "Identifier": "6GZK6Z2", "LastInventoryTime": "2019-10-29 09:30:38.552", "LastStatusTime": "2019-10-29 09:41:51.051", "ManagedState": 3000, "Model": "PowerEdge MX840c", "PowerState": 17, "SlotConfiguration": {"ChassisId": "10072", "ChassisName": "MX-6H5S6Z2", "ChassisServiceTag": "6H5S6Z2", "DeviceType": "1000", "SledBlockPowerOn": "None blocking", "SlotId": "10084", "SlotName": "Sled-1", "SlotNumber": "1", "SlotType": "2000"}, "Status": 1000, "SystemId": 1894, "Type": 1000}], "Summary": {"NodeCount": 2, "ServerCount": 1, "UplinkCount": 1}, "Switches": [{"ChassisServiceTag": "6H5S6Z2", "ConnectionState": true, "ConnectionStateReason": 101, "DeviceCapabilities": [1, 2, 3, 5, 7, 8, 9, 207, 18, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622], "DeviceManagement": [{"DnsName": "", "InstrumentationName": "MX9116n Fabric Engine", "MacAddress": "20:04:0F:4F:4E:04", "ManagementId": 135181, "ManagementProfile": [{"HasCreds": 0, "ManagementId": 135181, "ManagementProfileId": 135181, "ManagementURL": "", "ProfileId": "", "Status": 1000, "StatusDateTime": "2019-10-29 09:30:36.273"}], "ManagementType": 2, "NetworkAddress": "100.96.24.36"}, {"DnsName": "", "InstrumentationName": "MX9116n Fabric Engine", "MacAddress": "20:04:0F:4F:4E:04", "ManagementId": 135182, "ManagementProfile": [{"HasCreds": 0, "ManagementId": 135182, "ManagementProfileId": 135182, "ManagementURL": "", "ProfileId": "", "Status": 1000, "StatusDateTime": "2019-10-29 09:30:36.273"}], "ManagementType": 2, "NetworkAddress": ""}], "DeviceName": "MX-6H5S6Z2:IOM-A2", "DeviceServiceTag": "6H7J6Z2", "Enabled": true, "Id": 10074, "Identifier": "6H7J6Z2", "LastInventoryTime": "2019-10-29 09:30:36.332", "LastStatusTime": "2019-10-29 09:31:00.931", "ManagedState": 3000, "Model": "MX9116n Fabric Engine", "PowerState": 17, "SlotConfiguration": {"ChassisId": "10072", "ChassisName": "MX-6H5S6Z2", "ChassisServiceTag": "6H5S6Z2", "DeviceType": "4000", "SledBlockPowerOn": "null", "SlotId": "10079", "SlotName": "IOM-A2", "SlotNumber": "2", "SlotType": "4000"}, "Status": 1000, "SystemId": 2031, "Type": 4000}, {"ChassisServiceTag": "6H5S6Z2", "ConnectionState": true, "ConnectionStateReason": 101, "DeviceCapabilities": [1, 2, 3, 5, 7, 8, 9, 207, 18, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622], "DeviceManagement": [{"DnsName": "", "InstrumentationName": "MX9116n Fabric Engine", "MacAddress": "E8:B5:D0:52:61:46", "ManagementId": 135183, "ManagementProfile": [{"HasCreds": 0, "ManagementId": 135183, "ManagementProfileId": 135183, "ManagementURL": "", "ProfileId": "", "Status": 1000, "StatusDateTime": "2019-10-29 09:30:37.115"}], "ManagementType": 2, "NetworkAddress": "100.96.24.37"}, {"DnsName": "", "InstrumentationName": "MX9116n Fabric Engine", "MacAddress": "E8:B5:D0:52:61:46", "ManagementId": 135184, "ManagementProfile": [{"HasCreds": 0, "ManagementId": 135184, "ManagementProfileId": 135184, "ManagementURL": "", "ProfileId": "", "Status": 1000, "StatusDateTime": "2019-10-29 09:30:37.115"}], "ManagementType": 2, "NetworkAddress": ""}], "DeviceName": "MX-6H5S6Z2:IOM-A1", "DeviceServiceTag": "JRWSV43", "Enabled": true, "Id": 20881, "Identifier": "JRWSV43", "LastInventoryTime": "2019-10-29 09:30:37.172", "LastStatusTime": "2019-10-29 09:31:00.244", "ManagedState": 3000, "Model": "MX9116n Fabric Engine", "PowerState": 17, "SlotConfiguration": {"ChassisId": "10072", "ChassisName": "MX-6H5S6Z2", "ChassisServiceTag": "6H5S6Z2", "DeviceType": "4000", "SledBlockPowerOn": "null", "SlotId": "10078", "SlotName": "IOM-A1", "SlotNumber": "1", "SlotType": "4000"}, "Status": 1000, "SystemId": 2031, "Type": 4000}], "Uplinks": [{"Id": "1ad54420-b145-49a1-9779-21a579ef6f2d", "MediaType": "Ethernet", "Name": "u1", "NativeVLAN": 1, "Summary": {"NetworkCount": 1, "PortCount": 2}, "UfdEnable": "Disabled"}]}]

作者

  • Kritika Bhateja(@Kritka-Bhateja)