truenas_tools.py v2.1.2: автоматический fallback POST→GET при 405 + новые пути API

This commit is contained in:
2026-08-03 00:21:36 +03:00
parent bc99c6f982
commit 70314a0097
+48 -64
View File
@@ -1,64 +1,48 @@
# ----------------------------------------------------------------- def _rest_request(self, method: str, endpoint: str, payload: Optional[dict] = None, timeout: Optional[int] = None) -> Optional[Any]:
# Каталоги и приложения (v2.1+) method = method.upper()
# ----------------------------------------------------------------- if method not in ("POST", "PUT", "DELETE", "PATCH", "GET"):
def discover_app_endpoints(self) -> str: self._last_error = f"_rest_request: неподдерживаемый метод {method}"
""" return None
Диагностический метод: проверяет разные эндпоинты API каталога приложений url = f"{self._base}/api/v2.0/{endpoint}"
и сообщает, какие из них реально работают на этой версии TrueNAS. t = timeout if timeout is not None else self.valves.request_timeout
Полезно при обновлении truenas_tools.py или при ошибках в list_app_catalog. try:
""" r = requests.request(method, url, headers=self._headers, json=payload if payload is not None else {}, timeout=t, verify=self.valves.verify_ssl)
candidates_get = [ # v2.1.2: автоматический fallback POST → GET при 405 (Method Not Allowed).
"app/available", "app/available_apps", "app/list_apps", # Это часто встречается в TrueNAS 25.10: некоторые эндпоинты каталога
"chart/release/names", "chart/release", "chart/release/list", # исторически были POST, но в новых версиях стали GET.
"catalog", "catalog?label=TRUENAS", "catalog/items", if r.status_code == 405 and method == "POST":
"catalogs", "app/catalog", try:
] r2 = requests.get(url, headers=self._headers, params=payload or {}, timeout=t, verify=self.valves.verify_ssl)
candidates_post = [ if r2.status_code in (200, 201, 202, 204):
("app/available", {"catalog_name": "TRUENAS", "retrieve_all_trains": True}), if not r2.text:
("app/available", {}), return {"status": "ok", "http_code": r2.status_code, "via": "GET-fallback"}
("app.available", {"catalog_name": "TRUENAS"}), try:
("chart/release/names", {"catalog_name": "TRUENAS"}), data = r2.json()
("chart.release.names", {}), if isinstance(data, dict):
("chart_release/names", {"catalog_name": "TRUENAS"}), data["_via"] = "GET-fallback"
("catalog/items", {"label": "TRUENAS"}), return data
] except Exception:
lines = ["🔍 ДИАГНОСТИКА ЭНДПОИНТОВ КАТАЛОГА", ""] return {"status": "ok", "text": r2.text, "http_code": r2.status_code, "_via": "GET-fallback"}
lines.append("=== GET ===") except Exception:
for ep in candidates_get: pass # вернёмся к исходной ошибке ниже
url = f"{self._base}/api/v2.0/{ep}" if r.status_code in (200, 201, 202, 204):
try: if not r.text:
r = requests.get(url, headers=self._headers, timeout=self.valves.request_timeout, verify=self.valves.verify_ssl) return {"status": "ok", "http_code": r.status_code}
if r.status_code == 200: try:
body = r.text[:120].replace("\n", " ") return r.json()
lines.append(f"{ep:35s} HTTP 200 | {body}") except Exception:
elif r.status_code == 404: return {"status": "ok", "text": r.text, "http_code": r.status_code}
lines.append(f"{ep:35s} HTTP 404") self._last_error = f"{method} {endpoint} HTTP {r.status_code}: {r.text[:400]}"
elif r.status_code in (401, 403): return None
lines.append(f"🔑 {ep:35s} HTTP {r.status_code} (нет прав)") except requests.exceptions.SSLError as e:
else: self._last_error = f"SSL-ошибка {method} {endpoint}: {e}"
lines.append(f"⚠️ {ep:35s} HTTP {r.status_code}") return None
except Exception as e: except requests.exceptions.ConnectionError as e:
lines.append(f"💥 {ep:35s} ошибка: {type(e).__name__}") self._last_error = f"Соединение {method} {endpoint}: {e}"
lines.append("") return None
lines.append("=== POST ===") except requests.exceptions.Timeout:
for ep, payload in candidates_post: self._last_error = f"Таймаут {method} {endpoint} (> {t}с)"
url = f"{self._base}/api/v2.0/{ep}" return None
try: except Exception as e:
r = requests.post(url, headers=self._headers, json=payload, timeout=self.valves.request_timeout, verify=self.valves.verify_ssl) self._last_error = f"{method} {endpoint}: {type(e).__name__}: {e}"
if r.status_code == 200: return None
body = r.text[:120].replace("\n", " ")
lines.append(f"{ep:35s} HTTP 200 | {body}")
elif r.status_code == 404:
lines.append(f"{ep:35s} HTTP 404")
elif r.status_code in (401, 403):
lines.append(f"🔑 {ep:35s} HTTP {r.status_code} (нет прав)")
else:
lines.append(f"⚠️ {ep:35s} HTTP {r.status_code}")
except Exception as e:
lines.append(f"💥 {ep:35s} ошибка: {type(e).__name__}")
lines.append("")
lines.append("ℹ️ Также можно посмотреть Swagger-документацию API:")
lines.append(f" {self._base}/api/docs/")
return "\n".join(lines)
def list_catalogs(self) -> str: