home-assistant/core · error · UpdateFailed

{error}

Error message

{error}

What it means

UpdateFailed raised by the Airzone Cloud DataUpdateCoordinator when airzone.update() raises AirzoneCloudError. It tells HA the cloud poll failed; the message is the library error itself ({error}). The poll is bounded by AIOAIRZONE_CLOUD_TIMEOUT_SEC.

Source

Thrown at homeassistant/components/airzone_cloud/coordinator.py:54

        self.airzone = airzone
        self.airzone.set_update_callback(self.async_set_updated_data)

        super().__init__(
            hass,
            _LOGGER,
            config_entry=config_entry,
            name=DOMAIN,
            update_interval=SCAN_INTERVAL,
        )

    @override
    async def _async_update_data(self) -> dict[str, Any]:
        """Update data via library."""
        async with timeout(AIOAIRZONE_CLOUD_TIMEOUT_SEC):
            try:
                await self.airzone.update()
            except AirzoneCloudError as error:
                raise UpdateFailed(error) from error
            return self.airzone.data()

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Check Airzone Cloud status / the app to confirm the service is up.
2. If auth-related, re-authenticate the integration via HA's notification flow.
3. Let the coordinator retry with backoff for transient outages.
4. If timeouts dominate, verify HA's outbound internet and consider a stable network path.

try:
    await coordinator.async_config_entry_first_refresh()
except ConfigEntryNotReady as err:
    _LOGGER.warning("Airzone Cloud refresh failed: %s", err)

When it happens

Trigger: Cloud API returning 5xx, rate-limiting, auth token problems surfaced as AirzoneCloudError by aioairzone-cloud, or the request exceeding the timeout and being wrapped by the library.

Common situations: Airzone Cloud service outage or maintenance; expired credentials (the library raises auth errors that usually map to ConfigEntryAuthFailed elsewhere, but generic AirzoneCloudError lands here); slow mobile-grade links hitting the timeout.

Related errors

• {error}
• Unable find multi-factor auth module: {mfa_module_id}
• Failed to connect
• Failed to set {self.entity_id} params: {error}
• Error communicating with API: {err}

AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14). Data as JSON: /api/errors/a68d62f6abf3ff36. Report an issue: GitHub.