{"record":{"id":"a68d62f6abf3ff36","repo":"home-assistant/core","slug":"error-a68d62","errorCode":null,"errorMessage":"{error}","messagePattern":"\\{error\\}","errorType":"exception","errorClass":"UpdateFailed","httpStatus":null,"severity":"error","filePath":"homeassistant/components/airzone_cloud/coordinator.py","lineNumber":54,"sourceCode":"        self.airzone = airzone\n        self.airzone.set_update_callback(self.async_set_updated_data)\n\n        super().__init__(\n            hass,\n            _LOGGER,\n            config_entry=config_entry,\n            name=DOMAIN,\n            update_interval=SCAN_INTERVAL,\n        )\n\n    @override\n    async def _async_update_data(self) -> dict[str, Any]:\n        \"\"\"Update data via library.\"\"\"\n        async with timeout(AIOAIRZONE_CLOUD_TIMEOUT_SEC):\n            try:\n                await self.airzone.update()\n            except AirzoneCloudError as error:\n                raise UpdateFailed(error) from error\n            return self.airzone.data()\n","sourceCodeStart":36,"sourceCodeEnd":56,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/airzone_cloud/coordinator.py#L36-L56","documentation":"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.","triggerScenarios":"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.","commonSituations":"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.","solutions":["Check Airzone Cloud status / the app to confirm the service is up.","If auth-related, re-authenticate the integration via HA's notification flow.","Let the coordinator retry with backoff for transient outages.","If timeouts dominate, verify HA's outbound internet and consider a stable network path."],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try:\n    await coordinator.async_config_entry_first_refresh()\nexcept ConfigEntryNotReady as err:\n    _LOGGER.warning(\"Airzone Cloud refresh failed: %s\", err)","preventionTips":["Rely on coordinator backoff for cloud transients instead of custom loops.","Distinguish auth errors (re-auth flow) from generic AirzoneCloudError in logs.","Monitor Aladdin/Airzone cloud status pages during incidents."],"tags":["airzone-cloud","coordinator","update-failed","cloud","timeout"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}