Dell Technologies – Data Sources

V1.2.4: ome_application_certificate data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_application_certificate (Data Source)

This terraform DataSource is used to query the existing application certificate data from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# Get application certificate information of ome
data "ome_application_certificate" "cert_info" {
}

output "fetched_cert" {
  value = {
    "valid_to" : data.ome_application_certificate.cert.valid_to,
    "valid_from" : data.ome_application_certificate.cert.valid_from,
    "issued_to_distinguished_name" : data.ome_application_certificate.cert.issued_to.distinguished_name,
    "issued_by_distinguished_name" : data.ome_application_certificate.cert.issued_by.distinguished_name
  }
}

After the successful execution of above said block, We can see the output value by executing terraform output command. Also, we can use the fetched information by the variable data.ome_application_certificate.cert_info

Schema

Read-Only

id (String) ID for application certificate data source.
issued_by (Attributes) List of the device servicetags associated with any of the groups. (see below for nested schema)
issued_to (Attributes) List of the device id(s) associated with any of the groups. (see below for nested schema)
valid_from (String) Map of the groups fetched keyed by its name.
valid_to (String) List of the device group names.

Nested Schema for `issued_by`

Optional:

distinguished_name (String) Distinguished Name.

Read-Only:

business_name (String) Business Name.
country (String) Country of the business.
department_name (String) Department Name.
email (String) Email address.
locality (String) Locality of the business.
state (String) State of the business.
subject_alternate_names (List of String) Subject Alternate names.

Nested Schema for `issued_to`

Optional:

distinguished_name (String) Distinguished Name.

Read-Only:

business_name (String) Business Name.
country (String) Country of the business.
department_name (String) Department Name.
email (String) Email address.
locality (String) Locality of the business.
state (String) State of the business.
subject_alternate_names (List of String) Subject Alternate names.

V1.2.4: ome_configuration_report_info data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_configuration_report_info (Data Source)

This Terraform DataSource is used to query compliance configuration report of a compliance template baseline data from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# Get configuration compliance report for a baseline
data "ome_configuration_report_info" "cr" {
  baseline_name = "BaselineName"
}

Schema

Required

baseline_name (String) Name of the Baseline.

Optional

fetch_attributes (Boolean) Fetch device compliance attribute report.
id (String) ID for baseline compliance data source.

Read-Only

compliance_report_device (Attributes List) Device compliance report. (see below for nested schema)

Nested Schema for `compliance_report_device`

Read-Only:

compliance_status (String) Device compliance status.
device_compliance_details (String) Device compliance details.
device_id (Number) Device ID
device_name (String) Device Name.
device_servicetag (String) Device servicetag.
device_type (Number) Device type
inventory_time (String) Inventory Time.
model (String) Device model.

V1.2.4: ome_device data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_device (Data Source)

This Terraform DataSource is used to query devices from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# get device by ids
data "ome_device" "devi" {
  filters = {
    ids = [1001, 1002, 1003]
  }
}

# get device by their network
data "ome_device" "devn" {
  filters = {
    ip_expressions = [
      "10.10.10.10",
      "10.36.0.0-192.36.0.255",
      "fe80::ffff:ffff:ffff:ffff",
      "fe80::ffff:192.0.2.0/125",
      "fe80::ffff:ffff:ffff:1111-fe80::ffff:ffff:ffff:ffff"
    ]
  }
}

# get device by service tags
data "ome_device" "devs" {
  filters = {
    device_service_tags = ["CZNF1T2", "CZMC1T2"]
  }
}

# get device by valid OME OData filter query
data "ome_device" "devf" {
  filters = {
    filter_expression = "Model eq 'PowerEdge MX840c'"
  }
}

# get all devices in the CIDR "10.10.10.10/26" with model PowerEdge MX840c

data "ome_device" "devs" {
  filters = {
    ip_expressions    = ["10.10.10.10/26"]
    filter_expression = "Model eq 'PowerEdge MX840c'"
  }
}

# get device with inventory
# to get inventory of a device, query only one device per datasource

data "ome_device" "dev_invent_full" {
  filters = {
    ip_expressions = ["10.10.10.10"]
  }
}

data "ome_device" "dev_invent" {
  filters = {
    ip_expressions = ["10.10.10.10"]
  }
  inventory_types = ["serverNetworkInterfaces", "serverArrayDisks"]
}

output "dev_inv_out" {
  value = {
    full                    = data.ome_device.dev_invent_full.devices.detailed_inventory
    serverNetworkInterfaces = data.ome_device.dev_invent.devices.detailed_inventory.nics
    serverArrayDisks        = data.ome_device.dev_invent.devices.detailed_inventory.disks
  }
}

Schema

Optional

filters (Attributes) Filters to apply while fetching devices. Only one among filter_expression, ids and device_service_tags can be configured. (see below for nested schema)
inventory_types (List of String) The types of inventory types to fetch. Accepted values are serverDeviceCards, serverProcessors, serverDellVideos, serverNetworkInterfaces, serverFcCards, serverOperatingSystems, serverVirtualFlashes, serverPowerSupplies, serverArrayDisks, serverRaidControllers, serverMemoryDevices, serverStorageEnclosures, serverSupportedPowerStates, deviceLicense, deviceCapabilities, deviceFru, deviceManagement, deviceSoftware, subsystemRollupStatus, deviceInventory. If not configured, all inventory types are fetched.

Read-Only

devices (Attributes List) Devices fetched. (see below for nested schema)
id (Number) Dummy ID of the datasource.

Nested Schema for `filters`

Optional:

device_service_tags (List of String) Service tags of the devices to fetch.
filter_expression (String) OData $filter compatible expression to be used for querying devices.
ids (List of Number) IDs of the devices to fetch.
ip_expressions (List of String) IP expressions of the devices to fetch. Supported expressions are IPv4, IPv6, CIDRs and IP ranges.

Nested Schema for `devices`

Read-Only:

asset_tag (String) Asset Tag of the device.
chassis_ip (String) Chassis IP of the device.
chassis_service_tag (String) Chassis Service Tag of the device.
connection_state (Boolean) Connection State of the device.
connection_state_reason (Number) Connection State Reason of the device.
detailed_inventory (Attributes) Detailed inventory of the device. Detailed inventory is only fetched if only a single device is fetched by this datasource. (see below for nested schema)
device_capabilities (List of Number) Device Capabilities of the device.
device_management (Attributes List) Device Management of the device. (see below for nested schema)
device_name (String) Device Name of the device.
device_service_tag (String) Device Service Tag of the device.
device_subscription (String) Device Subscription of the device.
discovery_configuration_job_information (Attributes List) Discovery Configuration Job Info of the device. (see below for nested schema)
enabled (Boolean) Whether the device is enabled or not.
id (Number) ID of the device.
identifier (String) Identifier of the device.
last_inventory_time (String) Last Inventory Time of the device.
last_status_time (String) Last Status Time of the device.
managed_state (Number) Managed State of the device.
model (String) Model of the device.
power_state (Number) Power State of the device.
slot_configuration (Attributes) Slot Configuration of the device. (see below for nested schema)
status (Number) Status of the device.
system_id (Number) System ID of the device.
type (Number) Type of the device.

Nested Schema for `devices.detailed_inventory`

Read-Only:

capabilities (Attributes List) Device Capabilities (see below for nested schema)
cpus (Attributes List) CPU related Information. (see below for nested schema)
disks (Attributes List) Disk related Information. (see below for nested schema)
fcis (Attributes List) FCI related Information. (see below for nested schema)
frus (Attributes List) Device FRUs (see below for nested schema)
licenses (Attributes List) Device Licenses (see below for nested schema)
locations (Attributes List) Device Locations (see below for nested schema)
management_info (Attributes List) Device Management (see below for nested schema)
memory (Attributes List) Memory Information. (see below for nested schema)
nics (Attributes List) NIC related Information. (see below for nested schema)
os (Attributes List) OS related Information. (see below for nested schema)
power_state (Attributes List) Server Power States (see below for nested schema)
power_supply (Attributes List) Power Supply related Information. (see below for nested schema)
raid_controllers (Attributes List) RAIDController Information. (see below for nested schema)
server_device_cards (Attributes List) Server Device Cards. (see below for nested schema)
softwares (Attributes List) Device Softwares (see below for nested schema)
storage_enclosures (Attributes List) Storage Enclosure Information. (see below for nested schema)
subsytem_rollup_status (Attributes List) Sub System Rollup Status (see below for nested schema)

Nested Schema for `devices.detailed_inventory.capabilities`

Read-Only:

capability_type (Attributes) Capability Type (see below for nested schema)
id (Number) ID

Nested Schema for `devices.detailed_inventory.capabilities.capability_type`

Read-Only:

capability_id (Number) Capability ID
description (String) Description
id_owner (Number) IDOwner
name (String) Name

Nested Schema for `devices.detailed_inventory.cpus`

Read-Only:

brand_name (String) Brand Name
current_speed (Number) Current Speed
family (String) Family
id (Number) ID
instance_id (String) Instance ID
max_speed (Number) Max Speed
model_name (String) Model Name
number_of_cores (Number) Number Of Cores
number_of_enabled_cores (Number) Number Of Enabled Cores
slot_number (String) Slot Number
status (Number) Status
voltage (String) Voltage

Nested Schema for `devices.detailed_inventory.disks`

Read-Only:

bus_type (String) Bus Type
channel (Number) Channel
disk_number (String) Disk Number
enclosure_id (String) Enclosure ID
encryption_ability (Boolean) Encryption Ability
form_factor (String) Form Factor
free_space (String) Free Space
id (Number) ID
manufactured_day (Number) Manufactured Day
manufactured_week (Number) Manufactured Week
manufactured_year (Number) Manufactured Year
media_type (String) Media Type
model_number (String) Model Number
part_number (String) Part Number
predictive_failure_state (String) Predictive Failure State
raid_status (String) Raid Status
remaining_read_write_endurance (String) Remaining Read Write Endurance
revision (String) Revision
sas_address (String) Sas Address
security_state (String) Security State
serial_number (String) Serial Number
size (String) Size
slot_number (Number) Slot Number
status (Number) Status
status_string (String) Status String
used_space (String) Used Space
vendor_name (String) Vendor Name

Nested Schema for `devices.detailed_inventory.fcis`

Read-Only:

device_description (String) Device Description
device_name (String) Device Name
first_fctarget_lun (String) First Fctarget Lun
first_fctarget_wwpn (String) First Fctarget Wwpn
fqdd (String) Fqdd
id (Number) ID
link_status (String) Link Status
port_number (Number) Port Number
port_speed (String) Port Speed
second_fctarget_lun (String) Second Fctarget Lun
second_fctarget_wwpn (String) Second Fctarget Wwpn
vendor_name (String) Vendor Name
virtual_wwn (String) Virtual Wwn
virtual_wwpn (String) Virtual Wwpn
wwn (String) Wwn
wwpn (String) Wwpn

Nested Schema for `devices.detailed_inventory.frus`

Read-Only:

id (Number) ID
manufacturer (String) Manufacturer
name (String) Name
part_number (String) Part Number
revision (String) Revision
serial_number (String) Serial Number

Nested Schema for `devices.detailed_inventory.licenses`

Read-Only:

assigned_devices (String) Assigned Devices
entitlement_id (String) Entitlement Id
eval_time_remaining (Number) Eval Time Remaining
license_bound (Number) License Bound
license_description (String) License Description
license_status (Number) License Status
license_type (Attributes) License Type (see below for nested schema)
sold_date (String) Sold Date

Nested Schema for `devices.detailed_inventory.licenses.license_type`

Read-Only:

license_id (Number) License Id
name (String) Name

Nested Schema for `devices.detailed_inventory.locations`

Read-Only:

aisle (String) Aisle
datacenter (String) Datacenter
id (Number) ID
management_system_unit (Number) Management System Unit
rack (String) Rack
rackslot (String) Rackslot
room (String) Room

Nested Schema for `devices.detailed_inventory.management_info`

Read-Only:

dns_name (String) DNSName
end_point_agents (Attributes List) End Point Agents (see below for nested schema)
instrumentation_name (String) Instrumentation Name
ip_address (String) IPAddress
mac_address (String) MACAddress
management_id (Number) Management ID
management_type (Attributes) Management Type (see below for nested schema)

Nested Schema for `devices.detailed_inventory.management_info.end_point_agents`

Read-Only:

agent_name (String) Agent Name
has_creds (Number) Has Creds
management_profile_id (Number) Management Profile ID
management_url (String) Management URL
profile_id (String) Profile ID
status (Number) Status
status_date_time (String) Status Date Time
version (String) Version

Nested Schema for `devices.detailed_inventory.management_info.management_type`

Read-Only:

description (String) Description
management_type (Number) Management Type
name (String) Name

Nested Schema for `devices.detailed_inventory.memory`

Read-Only:

bank_name (String) Bank Name
current_operating_speed (Number) Current Operating Speed
device_description (String) Device Description
id (Number) ID
instance_id (String) Instance ID
manufacturer (String) Manufacturer
manufacturer_date (String) Manufacturer Date
name (String) Name
part_number (String) Part Number
rank (String) Rank
serial_number (String) Serial Number
size (Number) Size
speed (Number) Speed
status (Number) Status
type_details (String) Type Details

Nested Schema for `devices.detailed_inventory.nics`

Read-Only:

nic_id (String) Nic ID
ports (Attributes List) Ports (see below for nested schema)
vendor_name (String) Vendor Name

Nested Schema for `devices.detailed_inventory.nics.ports`

Read-Only:

link_speed (Number) Link Speed
link_status (String) Link Status
partitions (Attributes List) Partitions (see below for nested schema)
port_id (String) Port ID
product_name (String) Product Name

Nested Schema for `devices.detailed_inventory.nics.ports.partitions`

Read-Only:

current_mac_address (String) Current Mac Address
fcoe_mode (String) Fcoe Mode
fqdd (String) Fqdd
iscsi_mode (String) Iscsi Mode
max_bandwidth (Number) Max Bandwidth
min_bandwidth (Number) Min Bandwidth
nic_mode (String) Nic Mode
permanent_fcoe_mac_address (String) Permanent Fcoe Mac Address
permanent_iscsi_mac_address (String) Permanent Iscsi Mac Address
permanent_mac_address (String) Permanent Mac Address
virtual_mac_address (String) Virtual Mac Address
virtual_wwn (String) Virtual Wwn
virtual_wwpn (String) Virtual Wwpn
wwn (String) Wwn
wwpn (String) Wwpn

Nested Schema for `devices.detailed_inventory.os`

Read-Only:

hostname (String) Hostname
id (Number) ID
os_name (String) Os Name
os_version (String) Os Version

Nested Schema for `devices.detailed_inventory.power_state`

Read-Only:

id (Number) ID
power_state (Number) Power State

Nested Schema for `devices.detailed_inventory.power_supply`

Read-Only:

ac_input (Boolean) Ac Input
ac_output (Boolean) Ac Output
active_input_voltage (String) Active Input Voltage
firmware_version (String) Firmware Version
id (Number) ID
input_power_units (String) Input Power Units
input_voltage (Number) Input Voltage
location (String) Location
manufacturer (String) Manufacturer
model (String) Model
name (String) Name
operational_status (String) Operational Status
output_watts (Number) Output Watts
power_supply_type (Number) Power Supply Type
range1_max_input_power_watts (Number) Range1Max Input Power Watts
range1_max_input_voltage_high_milli_volts (Number) Range1Max Input Voltage High Milli Volts
rated_max_output_power (Number) Rated Max Output Power
redundancy_state (String) Redundancy State
requested_state (Number) Requested State
serial_number (String) Serial Number
state (String) State
status (Number) Status
switching_supply (Boolean) Switching Supply

Nested Schema for `devices.detailed_inventory.raid_controllers`

Read-Only:

cache_size_in_mb (Number) Cache Size In Mb
device_description (String) Device Description
driver_version (String) Driver Version
firmware_version (String) Firmware Version
fqdd (String) Fqdd
id (Number) ID
name (String) Name
pci_slot (String) Pci Slot
rollup_status (Number) Rollup Status
rollup_status_string (String) Rollup Status String
server_virtual_disks (Attributes List) Server Virtual Disks (see below for nested schema)
status (Number) Status
status_type (String) Status Type
storage_assignment_allowed (String) Storage Assignment Allowed

Nested Schema for `devices.detailed_inventory.raid_controllers.server_virtual_disks`

Read-Only:

cache_policy (String) Cache Policy
device_id (Number) Device ID
fqdd (String) Fqdd
id (Number) ID
layout (String) Layout
lock_status (String) Lock Status
media_type (String) Media Type
name (String) Name
raid_controller_id (Number) Raid Controller ID
read_policy (String) Read Policy
rollup_status (Number) Rollup Status
size (String) Size
state (String) State
status (Number) Status
stripe_size (String) Stripe Size
target_id (Number) Target ID
write_policy (String) Write Policy

Nested Schema for `devices.detailed_inventory.server_device_cards`

Read-Only:

databus_width (String) Databus Width
description (String) Description
id (Number) ID
manufacturer (String) Manufacturer
slot_length (String) Slot Length
slot_number (String) Slot Number
slot_type (String) Slot Type

Nested Schema for `devices.detailed_inventory.softwares`

Read-Only:

component_id (String) Component ID
device_description (String) Device Description
installation_date (String) Installation Date
instance_id (String) Instance ID
pci_device_id (String) Pci Device ID
software_type (String) Software Type
status (String) Status
sub_device_id (String) Sub Device ID
sub_vendor_id (String) Sub Vendor ID
vendor_id (String) Vendor ID
version (String) Version

Nested Schema for `devices.detailed_inventory.storage_enclosures`

Read-Only:

backplane_part_num (String) Backplane Part Num
channel_number (String) Channel Number
id (Number) ID
name (String) Name
number_of_fan_packs (Number) Number Of Fan Packs
rollup_status (Number) Rollup Status
slot_count (Number) Slot Count
status (Number) Status
status_type (String) Status Type String
version (String) Version

Nested Schema for `devices.detailed_inventory.subsytem_rollup_status`

Read-Only:

id (Number) ID
status (Number) Status
subsystem_name (String) Subsystem Name

Nested Schema for `devices.device_management`

Read-Only:

dns_name (String) DNSName
instrumentation_name (String) Instrumentation Name
mac_address (String) Mac Address
management_id (Number) Management ID
management_profile (Attributes Set) Management Profile (see below for nested schema)
management_type (Number) Management Type
network_address (String) Network Address

Nested Schema for `devices.device_management.management_profile`

Read-Only:

agent_name (String) Agent Name
has_creds (Number) Has Creds
management_id (Number) Management ID
management_profile_id (Number) Management Profile ID
management_url (String) Management URL
profile_id (String) Profile ID
status (Number) Status
status_date_time (String) Status Date Time
version (String) Version

Nested Schema for `devices.discovery_configuration_job_information`

Read-Only:

created_by (String) Created By
discovery_job_name (String) Discovery Job Name
group_id (String) Group ID

Nested Schema for `devices.slot_configuration`

Read-Only:

chassis_name (String) Chassis Name

V1.2.4: ome_device_compliance_report data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_device_compliance_report (Data Source)

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

// Get the details of the device compliance report from device id, service tag or group name
data "ome_device_compliance_report" "device_compliance_report_data" {
  // This will get the device compliance report for devices based on the filters used. 
  // Only one of the below filters can be used at a time.
  # device_ids = [10102]
  # device_service_tags = ["HRPB0M3"]
  # device_group_names = ["Servers"]
}

output "device_compliance_report_data" {
  value = data.ome_device_compliance_report.device_compliance_report_data
}

After the successful execution of above said block, We can see the output value by executing terraform output command.

Schema

Optional

device_group_names (List of String) Group names is the list of group names that you want to that you want get the compliance report for. One of device_ids or device_service_tags or device_group_names is required
device_ids (List of Number) Device Ids is the list of device ids that you want get the compliance report for. One of device_ids or device_service_tags or device_group_names is required
device_service_tags (List of String) Device service tags is the list of device service tags that you want get the compliance report for. One of device_ids or device_service_tags or device_group_names is required

Read-Only

device_compliance_reports (Attributes List) Reports fetched. (see below for nested schema)
id (Number) Dummy ID of the datasource.

Nested Schema for `device_compliance_reports`

Read-Only:

compliance_status (String) Compliance Status
component_compliance_reports (Attributes List) Component Compliance Reports (see below for nested schema)
device_firmware_update_capable (Boolean) Device Firmware Update Capable
device_id (Number) Device Id
device_model (String) Device Model
device_name (String) Device Name
device_type_id (Number) Device Type Id
device_type_name (String) Device Type Name
device_user_firmware_update_capable (Boolean) Device User Firmware Update Capable
firmware_status (String) Firmware Status
id (Number) Id
reboot_required (Boolean) Reboot Required
service_tag (String) Service Tag

Nested Schema for `device_compliance_reports.component_compliance_reports`

Read-Only:

compliance_dependencies (Attributes List) Compliance Dependencies (see below for nested schema)
compliance_status (String) Compliance Status
component_type (String) Component Type
criticality (String) Criticality
current_version (String) Current Version
dependency_upgrade_required (Boolean) Dependency Upgrade Required
id (Number) Id
impact_assessment (String) Impact Assessment
name (String) Name
path (String) Path
prerequisite_info (String) Prerequisite Info
reboot_required (Boolean) Reboot Required
source_name (String) Source Name
target_identifier (String) Target Identifer
unique_identifier (String) Unique Identifier
update_action (String) Update Action
uri (String) Uri
version (String) Version

Nested Schema for `device_compliance_reports.component_compliance_reports.compliance_dependencies`

Read-Only:

compliance_dependency_id (Number) Compliance Dependency Id
is_hard_dependency (Boolean) Is Hard Dependency
name (String) Name
path (String) Path
reboot_required (Boolean) Reboot Required
source_name (String) Source Name
unique_identifier (String) Unique Identifier
update_action (String) Update Action
uri (String) Uri
version (String) Version

V1.2.4: ome_firmware_baseline_compliance_report data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_firmware_baseline_compliance_report (Data Source)

This Terraform DataSource is used to query firmware baseline compliance report of OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# Gets the firmware baseline compliance report
data "ome_firmware_baseline_compliance_report" "report1" {
  baseline_name = "tfacc_baseline_dell_1"

  # Supported filter keys are: DeviceName, DeviceModel, ServiceTag
  # Only one filter key/value can be used at a time
  # filter {
			# key = "DeviceModel"
			# value = "Valid Name"
	# }
}

output "all" {
  value = data.ome_firmware_baseline_compliance_report.report1
}

After the successful execution of above said block, We can see the output value by executing terraform output command.

Schema

Required

baseline_name (String) Name of the Baseline.

Optional

filter (Block, Optional) (see below for nested schema)

Read-Only

firmware_compliance_reports (Attributes List) Firmware Baseline Compliance Reports (see below for nested schema)
id (Number) Compliance Status

Nested Schema for `filter`

Optional:

key (String) Firmware Baseline Compliance Reports with filter key and value pair. Supported filter keys are: DeviceName, DeviceModel, ServiceTag
value (String) The value for the filter key

Nested Schema for `firmware_compliance_reports`

Read-Only:

compliance_status (String) Compliance Status
component_compliance_reports (Attributes List) Component Compliance Reports (see below for nested schema)
device_firmware_update_capable (Boolean) Device Firmware Update Capable
device_id (Number) Device ID
device_model (String) Device Model
device_name (String) Device Name
device_type_id (Number) Device Type ID
device_type_name (String) Device Type Name
device_user_firmware_update_capable (Boolean) Device User Firmware Update Capable
firmware_status (String) Firmware Status
id (Number) ID
reboot_required (Boolean) Reboot Required
service_tag (String) Service Tag

Nested Schema for `firmware_compliance_reports.component_compliance_reports`

Read-Only:

compliance_dependencies (Attributes List) Compliance Dependencies (see below for nested schema)
compliance_status (String) Compliance Status
component_type (String) Component Type
criticality (String) Criticality
current_version (String) Current Version
dependency_upgrade_required (Boolean) Dependency Upgrade Required
id (Number) ID
impact_assessment (String) Impact Assessment
name (String) Name
path (String) Path
prerequisite_info (String) Prerequisite Info
reboot_required (Boolean) Reboot Required
source_name (String) Source Name
target_identifier (String) Target Identifier
unique_identifier (String) Unique Identifier
update_action (String) Update Action
uri (String) URI
version (String) Version

Nested Schema for `firmware_compliance_reports.component_compliance_reports.compliance_dependencies`

Read-Only:

compliance_dependency_id (String) Compliance Dependency Id
is_hard_dependency (Boolean) Is Hard Dependency
name (String) Name
path (String) Path
reboot_required (Boolean) Reboot Required
source_name (String) Source Name
unique_identifier (String) Unique Identifier
update_action (String) Update Action
uri (String) Uri
version (String) Version

V1.2.4: ome_firmware_catalog data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_firmware_catalog (Data Source)

This Terraform DataSource is used to query firmware catalog from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# Get details of all the firmware catalogs 
data "ome_firmware_catalog" "data-catalog" {
  # Can filter based on the catalog name
  # If at least one of the filtered names is invalid, the terraform command will return an error
  # If you want to get all catalogs remove the names filter completely
  names = ["example_catalog_1", "example_catalog_2"]
}

output "data-catalog" {
  value = data.ome_firmware_catalog.data-catalog
}

After the successful execution of above said block, We can see the output value by executing terraform output command.

Schema

Optional

names (Set of String) A list of catalog names which can filter the datasource

Read-Only

firmware_catalogs (Attributes List) Devices fetched. (see below for nested schema)
id (Number) Dummy ID of the datasource.

Nested Schema for `firmware_catalogs`

Read-Only:

associated_baselines (Attributes List) Associated Baselines. (see below for nested schema)
baseline_location (String) Baseline Location.
bundles_count (Number) Bundles Count.
create_date (String) Create Date.
filename (String) Filename.
id (Number) id.
last_update (String) Last Update.
manifest_identifier (String) Manifest Identifier.
manifest_version (String) Manifest Version.
next_update (String) Next Update.
owner_id (Number) Owner ID.
predcessor_identifier (String) Predcessor Identifier.
release_identifier (String) Release Identifier.
repository (Attributes) Repository. (see below for nested schema)
schedule (Attributes) Schedule. (see below for nested schema)
source_path (String) Source path.
status (String) Status.
task_id (Number) Task ID.

Nested Schema for `firmware_catalogs.associated_baselines`

Read-Only:

baseline_id (Number) Baseline ID.
baseline_name (String) Baseline Name.

Nested Schema for `firmware_catalogs.repository`

Read-Only:

backup_existing_catalog (Boolean) Backup Existing Catalog.
check_certificate (Boolean) Check Certificate.
description (String) Description.
domain_name (String) Domain Name.
editable (Boolean) Editable.
id (Number) ID.
name (String) Name.
repository_type (String) Repository Type.
source (String) Source.
username (String) Username.

Nested Schema for `firmware_catalogs.schedule`

Read-Only:

cron (String) Cron.
end_time (String) End Time.
run_later (Boolean) Run later.
run_now (Boolean) Run Now.
start_time (String) Start Time.

V1.2.4: ome_firmware_repository data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_firmware_repository (Data Source)

This Terraform DataSource is used to query the firmware baseline compliance repository from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# Get details of all the firmware repositories 
data "ome_firmware_repository" "fbc-repository-all" {

}
output "fbc-repository" {
  value = data.ome_firmware_repository.fbc-repository-all
}

# Get filtered Repositories
# data "ome_firmware_repository" "firmware-repository-name-filter" {
#        # If names filter is added, it should atleast have one name.Otherwise you will see an error.
#        # If you do not want to filter and get all repositories then do not pass the name filter(Above configuration)
#         names = [
#           "tfacc_catalog_1",
#           "tfacc_catalog_dell_online_1",
#         ]
# }
# output "fbc-repository-name" {
#   value = data.ome_firmware_repository.firmware-repository-name-filter
# }

After the successful execution of above said block, We can see the output value by executing terraform output command.

Schema

Optional

names (Set of String) A list of repository names which can filter the datasource. Length should be at least 1.

Read-Only

fbc_repositories (Attributes List) Repositories fetched. (see below for nested schema)
id (Number) Dummy ID of the datasource.

Nested Schema for `fbc_repositories`

Read-Only:

backup_existing_catalog (Boolean) Catalog will take backup automatically if it is true.
check_certificate (Boolean) If certificate check must be done for HTTPS repository.
description (String) Description of the repository.
domain_name (String) Domain Name for user credentials.
editable (Boolean) True, if the catalog can be editable.
id (Number) ID of the repository.
name (String) Unique name of the repository.
repository_type (String) Source of the repository.
source (String) URL or IP or FQDN of the repository host.
username (String) Username to access the share containing the catalog (CIFS/HTTPS).

V1.2.4: ome_groupdevices_info data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_groupdevices_info (Data Source)

This Terraform DataSource is used to query groups and their devices from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# Get Group Info, Deviceids and servicetags of all devices that belong to a specified list of groups
data "ome_groupdevices_info" "gd" {
  device_group_names = ["WINDOWS", "WINDOWS-10"]
}

output "out" {
  value = {
    "common_device_ids"            = data.ome_groupdevices_info.gd.device_ids,
    "common_device_scvtags"        = data.ome_groupdevices_info.gd.device_servicetags,
    "group_windows"                = data.ome_groupdevices_info.gd.device_groups["WINDOWS"],
    "group_windows_subgroup_names" = data.ome_groupdevices_info.gd.device_groups["WINDOWS"].sub_groups[*].name,
    "group_windows_device_ids"     = data.ome_groupdevices_info.gd.device_groups["WINDOWS"].devices[*].id,
  }
}

# Get Sub Group Info of all specified groups
locals {
  # gd_names_with_non_zero_children is the subset of the specified list of group names where the group
  # has one or more child groups.
  # In the below code, we iterate over the specified list of groups and check if the sub_groups
  # field for that group in the ome_groupdevices_info data source has any entries. If it does, then that name is added
  # to a list. Then we use the to_set function to convert the list of names to a set to ensure that there is no 
  # duplication of names. Then that set is assigned to gd_names_with_non_zero_children.
  gd_names_with_non_zero_children = toset([for i in data.ome_groupdevices_info.gd.device_group_names : i if
  length(data.ome_groupdevices_info.gd.device_groups[i].sub_groups) > 0])
}

data "ome_groupdevices_info" "gd_children" {
  id                 = "1"
  device_group_names = data.ome_groupdevices_info.gd.device_groups[each.key].sub_groups[*].name
  for_each           = local.gd_names_with_non_zero_children
}

Schema

Required

device_group_names (Set of String) List of the device group names.

Optional

id (String) ID for group devices data source.

Read-Only

device_groups (Attributes Map) Map of the groups fetched keyed by its name. (see below for nested schema)
device_ids (List of Number) List of the device id(s) associated with any of the groups.
device_servicetags (List of String) List of the device servicetags associated with any of the groups.

Nested Schema for `device_groups`

Read-Only:

created_by (String) The user who created the group.
creation_time (String) Creation time of the group.
definition_description (String) Definition description of the group.
definition_id (Number) Definition ID of the group.
description (String) Description of the group.
devices (Attributes Set) Devices of the group. (see below for nested schema)
global_status (Number) global_status of the group.
has_attributes (Boolean) If the group has attributes.
id (Number) ID of the group.
id_owner (Number) ID Owner of the group.
is_access_allowed (Boolean) If access of this group is allowed.
membership_type_id (Number) Membership Type ID of the group.
name (String) Name of the group.
parent_id (Number) Parent ID of the group.
sub_groups (Attributes Set) Sub Groups of the group. (see below for nested schema)
type_id (Number) Type ID of the group.
updated_by (String) The user who updated the group.
updated_time (String) Last updation time of the group.
visible (Boolean) If the group is visible or not.

Nested Schema for `device_groups.devices`

Read-Only:

id (Number) ID of the device.
servicetag (String) Service Tag of the device

Nested Schema for `device_groups.sub_groups`

Read-Only:

id (Number) ID of the sub group.
name (String) Name of the sub group.

V1.2.4: ome_template_info data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_template_info (Data Source)

This Terraform DataSource is used to query templates from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# get the template details 
data "ome_template_info" "data-template-1" {
  name = "template_1"
}

Schema

Required

name (String) Name of the template.

Optional

attributes (List of Object) List of attributes associated with template. (see below for nested schema)
content (String) The XML content of template from which the template will be created
description (String) Description for the template.
id (String) ID of the template data source.
refdevice_id (Number) Target device id from which the template is created.
vlan (Object) VLAN details to be attached with template. (see below for nested schema)

Read-Only

device_type_id (Number) Template type ID, indicating the type of device for which configuration is supported, current supported device is server
identity_pool_id (Number) ID of the Identity Pool attached with template.
view_type_id (Number) OME template view type id.

Nested Schema for `attributes`

Optional:

attribute_id (Number)
display_name (String)
is_ignored (Boolean)
value (String)

Nested Schema for `vlan`

Optional:

bonding_technology (String)
propogate_vlan (Boolean)
vlan_attributes (List of Object) (see below for nested schema)

Nested Schema for `vlan.vlan_attributes`

Optional:

is_nic_bonded (Boolean)
nic_identifier (String)
port (Number)
tagged_networks (List of Number)
untagged_network (Number)

V1.2.4: ome_vlannetworks_info data source

Mon, 01 Jan 0001 00:00:00 +0000

ome_vlannetworks_info (Data Source)

This Terraform DataSource is used to query templates from OME. The information fetched from this data source can be used for getting the details / for further processing in resource block.

Example Usage

/*
Copyright (c) 2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public 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://mozilla.org/MPL/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.
*/

# get details of all the vlan networks 
data "ome_vlannetworks_info" "data-vlans" {
}

Schema

Read-Only

id (String) ID for vlan networks data source.
vlan_networks (Attributes List) List of vlan networks (see below for nested schema)

Nested Schema for `vlan_networks`

Read-Only:

description (String) Description of the vlan network.
internal_ref_nwuu_id (String) Reference ID for a vlan.
name (String) Name of the vlan network.
type (Number) Type of vlan.
vlan_id (Number) Unique ID for the vlan network.
vlan_maximum (Number) Vlan maximum.
vlan_minimum (Number) Vlan minimum.

Dell Technologies – Data Sources

V1.2.4: ome_application_certificate data source

ome_application_certificate (Data Source)

Example Usage

Schema

Read-Only

Nested Schema for issued_by

Nested Schema for issued_to

V1.2.4: ome_configuration_report_info data source

ome_configuration_report_info (Data Source)

Example Usage

Schema

Required

Optional

Read-Only

Nested Schema for compliance_report_device

V1.2.4: ome_device data source

ome_device (Data Source)

Example Usage

Schema

Optional

Read-Only

Nested Schema for filters

Nested Schema for devices

Nested Schema for devices.detailed_inventory

Nested Schema for devices.detailed_inventory.capabilities

Nested Schema for devices.detailed_inventory.capabilities.capability_type

Nested Schema for devices.detailed_inventory.cpus

Nested Schema for devices.detailed_inventory.disks

Nested Schema for devices.detailed_inventory.fcis

Nested Schema for devices.detailed_inventory.frus

Nested Schema for devices.detailed_inventory.licenses

Nested Schema for devices.detailed_inventory.licenses.license_type

Nested Schema for devices.detailed_inventory.locations

Nested Schema for devices.detailed_inventory.management_info

Nested Schema for devices.detailed_inventory.management_info.end_point_agents

Nested Schema for devices.detailed_inventory.management_info.management_type

Nested Schema for devices.detailed_inventory.memory

Nested Schema for devices.detailed_inventory.nics

Nested Schema for devices.detailed_inventory.nics.ports

Nested Schema for devices.detailed_inventory.nics.ports.partitions

Nested Schema for devices.detailed_inventory.os

Nested Schema for devices.detailed_inventory.power_state

Nested Schema for devices.detailed_inventory.power_supply

Nested Schema for devices.detailed_inventory.raid_controllers

Nested Schema for devices.detailed_inventory.raid_controllers.server_virtual_disks

Nested Schema for devices.detailed_inventory.server_device_cards

Nested Schema for devices.detailed_inventory.softwares

Nested Schema for devices.detailed_inventory.storage_enclosures

Nested Schema for devices.detailed_inventory.subsytem_rollup_status

Nested Schema for devices.device_management

Nested Schema for devices.device_management.management_profile

Nested Schema for devices.discovery_configuration_job_information

Nested Schema for devices.slot_configuration

V1.2.4: ome_device_compliance_report data source

ome_device_compliance_report (Data Source)

Example Usage

Schema

Optional

Read-Only

Nested Schema for device_compliance_reports

Nested Schema for device_compliance_reports.component_compliance_reports

Nested Schema for device_compliance_reports.component_compliance_reports.compliance_dependencies

V1.2.4: ome_firmware_baseline_compliance_report data source

ome_firmware_baseline_compliance_report (Data Source)

Example Usage

Schema

Required

Optional

Read-Only

Nested Schema for filter

Nested Schema for firmware_compliance_reports

Nested Schema for firmware_compliance_reports.component_compliance_reports

Nested Schema for firmware_compliance_reports.component_compliance_reports.compliance_dependencies

V1.2.4: ome_firmware_catalog data source

ome_firmware_catalog (Data Source)

Example Usage

Schema

Optional

Read-Only

Nested Schema for `issued_by`

Nested Schema for `issued_to`

Nested Schema for `compliance_report_device`

Nested Schema for `filters`

Nested Schema for `devices`

Nested Schema for `devices.detailed_inventory`

Nested Schema for `devices.detailed_inventory.capabilities`

Nested Schema for `devices.detailed_inventory.capabilities.capability_type`

Nested Schema for `devices.detailed_inventory.cpus`

Nested Schema for `devices.detailed_inventory.disks`

Nested Schema for `devices.detailed_inventory.fcis`

Nested Schema for `devices.detailed_inventory.frus`

Nested Schema for `devices.detailed_inventory.licenses`

Nested Schema for `devices.detailed_inventory.licenses.license_type`

Nested Schema for `devices.detailed_inventory.locations`

Nested Schema for `devices.detailed_inventory.management_info`

Nested Schema for `devices.detailed_inventory.management_info.end_point_agents`

Nested Schema for `devices.detailed_inventory.management_info.management_type`

Nested Schema for `devices.detailed_inventory.memory`

Nested Schema for `devices.detailed_inventory.nics`

Nested Schema for `devices.detailed_inventory.nics.ports`

Nested Schema for `devices.detailed_inventory.nics.ports.partitions`

Nested Schema for `devices.detailed_inventory.os`

Nested Schema for `devices.detailed_inventory.power_state`

Nested Schema for `devices.detailed_inventory.power_supply`

Nested Schema for `devices.detailed_inventory.raid_controllers`

Nested Schema for `devices.detailed_inventory.raid_controllers.server_virtual_disks`

Nested Schema for `devices.detailed_inventory.server_device_cards`

Nested Schema for `devices.detailed_inventory.softwares`

Nested Schema for `devices.detailed_inventory.storage_enclosures`

Nested Schema for `devices.detailed_inventory.subsytem_rollup_status`

Nested Schema for `devices.device_management`

Nested Schema for `devices.device_management.management_profile`

Nested Schema for `devices.discovery_configuration_job_information`

Nested Schema for `devices.slot_configuration`

Nested Schema for `device_compliance_reports`

Nested Schema for `device_compliance_reports.component_compliance_reports`

Nested Schema for `device_compliance_reports.component_compliance_reports.compliance_dependencies`

Nested Schema for `filter`

Nested Schema for `firmware_compliance_reports`

Nested Schema for `firmware_compliance_reports.component_compliance_reports`

Nested Schema for `firmware_compliance_reports.component_compliance_reports.compliance_dependencies`

Nested Schema for `firmware_catalogs`

Nested Schema for `firmware_catalogs.associated_baselines`

Nested Schema for `firmware_catalogs.repository`

Nested Schema for `firmware_catalogs.schedule`

Nested Schema for `fbc_repositories`

Nested Schema for `device_groups`

Nested Schema for `device_groups.devices`

Nested Schema for `device_groups.sub_groups`

Nested Schema for `attributes`

Nested Schema for `vlan`

Nested Schema for `vlan.vlan_attributes`

Nested Schema for `vlan_networks`