enterprise_ai.plugins

Source : sdks/python/src/enterprise_ai/plugins/__init__.py. Retour à l'index de la référence du SDK Python.

remarque

Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.

Classe PluginsClient

Plugins. Registre et cycle de vie d'exécution des plugins : des images OCI signées exécutées par la plateforme dans une sandbox (classe de runtime gVisor, Kata ou Wasm), avec un Deployment et une NetworkPolicy Kubernetes générés à partir du manifeste.

Resource

PluginsClient.create

create(manifest: dict[str, Any]) -> Any

Enregistrer un plugin. Applique un manifeste Plugin : crée le plugin ou le met à jour (retour à registered, un plugin bloqué reste blocked), avec la signature vérifiée et enregistrée. Refus : 422 pack_requires_marketplace pour un pack, 422 invalid_manifest quand l'empreinte de oci_ref diffère de artifact.digest, qu'une liste d'autorisation manque pour egress_allowlist ou que les limites dépassent le maximum de la plateforme (4 CPU, 8Gi de mémoire, 3600 s, 1 GPU) ; 409 plugin_installed tant qu'il est installé. Demande tenant_admin, developer ou application_owner ; l'appelant devient propriétaire ReBAC. Audité sous plugin.apply.

Route : /v1/plugins (POST).

Nom	Type	Défaut	Requis	Description
manifest	dict[str, Any]		oui	Plugin Manifest du nouveau plugin, envoyé comme corps de la requête.

Retour : Any. Réponse JSON décodée de l'opération « Enregistrer un plugin ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PluginsClient.get

get(name: str) -> Any

Lire un plugin. Renvoie le plugin avec son manifeste, son résultat de vérification et son déploiement généré. Demande la relation ReBAC viewer. 404 plugin_not_found.

Route : /v1/plugins/{name} (GET).

Nom	Type	Défaut	Requis	Description
name	str		oui	Nom du plugin.

Retour : Any. Réponse JSON décodée de l'opération « Lire un plugin ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PluginsClient.install

install(name: str) -> Any

Installer un plugin. Installe le plugin dans sa sandbox. Demande tenant_admin et la relation ReBAC owner. Étapes : 1. Un plugin blocked répond 403 plugin_blocked ; un plugin déjà installé est renvoyé tel quel. 2. La signature est revérifiée (403 plugin_unsigned en cas d'échec, audité comme refus). 3. Le Deployment (classe de runtime de la sandbox, système de fichiers racine en lecture seule par défaut) et la NetworkPolicy sont générés, puis appliqués quand Kubernetes est configuré (status: failed avec l'erreur si l'application échoue). Renvoie l'état d'exécution. Audité sous plugin.install.

Route : /v1/plugins/{name}/install (POST).

Nom	Type	Défaut	Requis	Description
name	str		oui	Nom du plugin.

Retour : Any. Réponse JSON décodée de l'opération « Installer un plugin ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PluginsClient.list

list(**page: Any) -> Any

Lister les plugins. Plugins du tenant dans l'ordre des noms, avec version, empreinte, vérification et statut. Une seule page.

Route : /v1/plugins (GET).

Nom	Type	Défaut	Requis	Description
**page	Any		non	Options de pagination transmises à la liste : limit (nombre maximal d'éléments par page) et cursor (le next_cursor de la page précédente). Itérer sur la page renvoyée suit tous les curseurs.

Retour : Any. Réponse JSON décodée de l'opération « Lister les plugins ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PluginsClient.status

status(name: str) -> Any

Lire l'état d'exécution d'un plugin. Vue d'exécution : statut, indicateur de vérification, empreinte, date d'installation, classe de runtime, objets rendered (générés) ou applied (appliqués) sur Kubernetes, Deployment et NetworkPolicy et dernière erreur. Demande la relation ReBAC viewer.

Route : /v1/plugins/{name}/status (GET).

Nom	Type	Défaut	Requis	Description
name	str		oui	Nom du plugin.

Retour : Any. Réponse JSON décodée de l'opération « Lire l'état d'exécution d'un plugin ».

Erreurs levées : les erreurs typées du transport (Erreurs).

PluginsClient.uninstall

uninstall(name: str) -> Any

Désinstaller un plugin. Supprime le Deployment et la NetworkPolicy de Kubernetes s'il est configuré (502 upstream_error en cas d'échec) et passe le plugin à uninstalled. Seulement pour un plugin installed, installing ou failed (sinon 409 plugin_not_installed). Demande tenant_admin et la relation ReBAC owner. Audité sous plugin.uninstall.

Route : /v1/plugins/{name}/uninstall (POST).

Nom	Type	Défaut	Requis	Description
name	str		oui	Nom du plugin.

Retour : Any. Réponse JSON décodée de l'opération « Désinstaller un plugin ».

Erreurs levées : les erreurs typées du transport (Erreurs).