mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
Update dnsip sensor component configuration (#7557)
* Update dnsip sensor component configuration
* ✏️ Fix error
This commit is contained in:
parent
022ab26a4c
commit
2318aee109
@ -13,7 +13,6 @@ ha_iot_class: "Cloud Polling"
|
||||
ha_release: "0.40"
|
||||
---
|
||||
|
||||
|
||||
The `dnsip` sensor will expose an IP address, fetched via DNS resolution, as its value. There are two operational modes:
|
||||
|
||||
1. When you enable the sensor with minimal configuration, it will query the [OpenDNS](https://www.opendns.com/) nameservers with the hostname `myip.opendns.com`, which will resolve to your external/public IP address.
|
||||
@ -31,14 +30,38 @@ sensor:
|
||||
- platform: dnsip
|
||||
```
|
||||
|
||||
Configuration variables:
|
||||
|
||||
- **hostname** (*Optional*): The hostname for which to perform the DNS query. Defaults to `myip.opendns.com` (special hostname that resolves to your public IP).
|
||||
- **name** (*Optional*): Name of the sensor. Defaults to `myip` or hostname without dots if specified.
|
||||
- **resolver** (*Optional*): The DNS server to target the query at. Defaults to `208.67.222.222` (OpenDNS).
|
||||
- **ipv6** (*Optional*): Set this to `true` or `false` if IPv6 should be used. When resolving the public IP, this will be the IP of the machine where Home Assistant is running on.
|
||||
- **resolver_ipv6** (*Optional*): The IPv6 DNS server to target the query at. Defaults to `2620:0:ccc::2` (OpenDNS).
|
||||
- **scan_interval** (*Optional*): Defines number of seconds for polling interval. Defaults to `120` seconds.
|
||||
{% configuration %}
|
||||
hostname:
|
||||
description: The hostname for which to perform the DNS query.
|
||||
required: false
|
||||
default: "`myip.opendns.com` (special hostname that resolves to your public IP)"
|
||||
type: string
|
||||
name:
|
||||
description: Name of the sensor.
|
||||
required: false
|
||||
default: "`myip` or hostname without dots if specified"
|
||||
type: string
|
||||
resolver:
|
||||
description: The DNS server to target the query at.
|
||||
required: false
|
||||
default: "`208.67.222.222` (OpenDNS)"
|
||||
type: string
|
||||
ipv6:
|
||||
description: Set this to `true` or `false` if IPv6 should be used. When resolving the public IP, this will be the IP of the machine where Home Assistant is running on.
|
||||
required: false
|
||||
default: false
|
||||
type: boolean
|
||||
resolver_ipv6:
|
||||
description: The IPv6 DNS server to target the query at.
|
||||
required: false
|
||||
default: "`2620:0:ccc::2` (OpenDNS)"
|
||||
type: string
|
||||
scan_interval:
|
||||
description: Defines number of seconds for polling interval.
|
||||
required: false
|
||||
default: "`120`"
|
||||
type: integer
|
||||
{% endconfiguration %}
|
||||
|
||||
## {% linkable_title Extended example %}
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user