f5xc_certified_hardware Data Source - terraform-provider-f5xc

f5xc_certified_hardware (Data Source)

Retrieves information about a Certified Hardware resource in F5 Distributed Cloud for get certified hardware object. configuration. (read-only data source)

~> Note For more information about this data source, please refer to the F5 XC API Documentation.

Example Usage

# Certified Hardware Data Source Example
# Retrieves information about an existing Certified Hardware

terraform {
  required_version = ">= 1.0"

  required_providers {
    f5xc = {
      source  = "f5xc-salesdemos/f5xc"
      version = ">= 0.1.0"
    }
  }
}

# Look up an existing Certified Hardware by name
data "f5xc_certified_hardware" "example" {
  name      = "example-certified-hardware"
  namespace = "staging"
}

output "certified_hardware_id" {
  value = data.f5xc_certified_hardware.example.id
}

Argument Reference

Metadata Argument Reference

• name - Required String
Name of the CertifiedHardware to look up

• namespace - Required String
Namespace of the CertifiedHardware

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• annotations - Optional Map
Annotations

• certified_hardware_type - Optional String Defaults to VOLTMESH
Possible values are VOLTMESH, VOLTSTACK_COMBO, CLOUD_MARKET_PLACE
[Enum: VOLTMESH|VOLTSTACK_COMBO|CLOUD_MARKET_PLACE] Different type of certified HW for billing rate

• description - Optional String
Description

• devices - Optional String
List of supported devices in this model

• id - Optional String
Unique identifier

• image_list - Optional String
List of image names with providers for this certified hardware, e.g. AWS ami-0f99d090261d2acd5

• internal_usb_device_rule - Optional String
List of internal USB device rules for server

• labels - Optional Map
Labels

• mem_page_number - Optional String
Number of pages allocated in this certified hardware for Hugepages. Each page size is defined above in ‘mem_page_size’ Total memory reserved for Hugepages is ‘mem_page_size * mem_page_number’

• mem_page_size - Optional String Defaults to HARDWARE_MEM_PAGE_SIZE_INVALID
Possible values are HARDWARE_MEM_PAGE_SIZE_INVALID, HARDWARE_MEM_PAGE_SIZE_4KB, HARDWARE_MEM_PAGE_SIZE_2MB, HARDWARE_MEM_PAGE_SIZE_1GB
[Enum: HARDWARE_MEM_PAGE_SIZE_INVALID|HARDWARE_MEM_PAGE_SIZE_4KB|HARDWARE_MEM_PAGE_SIZE_2MB|HARDWARE_MEM_PAGE_SIZE_1GB] Memory for packets buffers etc are allocated in blocks of pages. Size of each memory page is defined here. Invalid Page size Page size of 4KB Page size of 2MB Page size of 1GB

• numa_mem - Optional String
List of Numa nodes with the number of MB of instance memory to map to node instance If not specified, memory is evenly divided among available NUMA nodes

• numa_nodes - Optional String
The number of host NUMA nodes used in certified hardware

• vendor_model_list - Optional String
List of supported hardware vendor and model for this certified hardware

Common Types

The following type definitions are used throughout this resource. See the full definition here rather than repeated inline.

Object Reference {#common-object-reference}

Object references establish a direct reference from one configuration object to another in F5 Distributed Cloud. References use the format tenant/namespace/name.

Field	Type	Description
`name`	String	Name of the referenced object
`namespace`	String	Namespace containing the referenced object
`tenant`	String	Tenant of the referenced object (system-managed)

Transformers {#common-transformers}

Transformers apply transformations to input values before matching. Multiple transformers can be applied in order.

Value	Description
`LOWER_CASE`	Convert to lowercase
`UPPER_CASE`	Convert to uppercase
`BASE64_DECODE`	Decodebase64 content
`NORMALIZE_PATH`	Normalize URL path
`REMOVE_WHITESPACE`	Remove whitespace characters
`URL_DECODE`	Decode URL-encoded characters
`TRIM_LEFT`	Trim leading whitespace
`TRIM_RIGHT`	Trim trailing whitespace
`TRIM`	Trim both leading and trailing whitespace

HTTP Methods {#common-http-methods}

HTTP methods used for request matching.

Value	Description
`ANY`	Match any HTTP method
`GET`	HTTP GET request
`HEAD`	HTTP HEAD request
`POST`	HTTP POST request
`PUT`	HTTP PUT request
`DELETE`	HTTP DELETE request
`CONNECT`	HTTP CONNECT request
`OPTIONS`	HTTP OPTIONS request
`TRACE`	HTTP TRACE request
`PATCH`	HTTP PATCH request
`COPY`	HTTP COPY request (WebDAV)

TLS Fingerprints {#common-tls-fingerprints}

TLS fingerprint categories for malicious client detection.

Value	Description
`TLS_FINGERPRINT_NONE`	No fingerprint matching
`ANY_MALICIOUS_FINGERPRINT`	Match any known malicious fingerprint
`ADWARE`	Adware-associated fingerprints
`DRIDEX`	Dridex malware fingerprints
`GOOTKIT`	Gootkit malware fingerprints
`RANSOMWARE`	Ransomware-associated fingerprints
`TRICKBOT`	Trickbot malware fingerprints

IP Threat Categories {#common-ip-threat-categories}

IP address threat categories for security filtering.

Value	Description
`SPAM_SOURCES`	Known spam sources
`WINDOWS_EXPLOITS`	Windows exploit sources
`WEB_ATTACKS`	Web attack sources
`BOTNETS`	Known botnet IPs
`SCANNERS`	Network scanner IPs
`REPUTATION`	Poor reputation IPs
`PHISHING`	Phishing-related IPs
`PROXY`	Anonymous proxy IPs
`MOBILE_THREATS`	Mobile threat sources
`TOR_PROXY`	Tor exit nodes
`DENIAL_OF_SERVICE`	DoS attack sources
`NETWORK`	Known bad network ranges