io.enterpriseai.resources.ApprovalsClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/ApprovalsClient.java. Retour à l'index de la référence du SDK Java.
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 ApprovalsClient
Validations. Humain dans la boucle : demandes de validation des actions sensibles, avec séparation des tâches, quorum et expiration. Les exécutions d'agents qui atteignent un outil soumis à validation, les promotions de modèles, d'agents, d'outils, de compétences, de serveurs MCP ou de plugins, les accès d'urgence et les mandats créent tous leurs demandes de validation ici.
Constructeur ApprovalsClient
ApprovalsClient(Transport transport)
Crée le client sur le transport partagé ; EnterpriseAIClient le construit, on y accède par l'accesseur du même nom.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
transport | Transport | oui | Transport partagé par les sous-clients d'un même client. |
ApprovalsClient.cancel
JsonNode cancel(String id, Object body)
Annuler une demande de validation. Retire une demande en attente. Autorisé à son demandeur, à un tenant_admin ou à un security_officer (403 forbidden sinon, le refus étant audité). La demande finit cancelled et son sujet réagit comme à un refus : une exécution en attente échoue (approval_cancelled), un accès d'urgence ou un mandat en attente est refusé. Une demande qui n'est plus en attente répond 409 approval_closed. Écrit l'événement d'audit approval.cancel avec la raison. La réponse porte run_state quand une exécution est rattachée.
Route : /v1/approvals/{approval_id}/cancel (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la demande de validation. | |
body | Object | oui | Raison de l'annulation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Annuler une demande de validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.cancel
JsonNode cancel(String id, Object body, RequestOptions options)
Annuler une demande de validation. Retire une demande en attente. Autorisé à son demandeur, à un tenant_admin ou à un security_officer (403 forbidden sinon, le refus étant audité). La demande finit cancelled et son sujet réagit comme à un refus : une exécution en attente échoue (approval_cancelled), un accès d'urgence ou un mandat en attente est refusé. Une demande qui n'est plus en attente répond 409 approval_closed. Écrit l'événement d'audit approval.cancel avec la raison. La réponse porte run_state quand une exécution est rattachée.
Route : /v1/approvals/{approval_id}/cancel (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la demande de validation. | |
body | Object | oui | Raison de l'annulation. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Annuler une demande de validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.create
JsonNode create(Object body)
Demander une validation. Crée une demande de validation en attente. Exige tenant_admin, developer, agent, security_officer ou finops.
Route : /v1/approvals (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Action, ressource, quorum, valideurs et expiration de la demande. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Demander une validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.create
JsonNode create(Object body, RequestOptions options)
Demander une validation. Crée une demande de validation en attente. Exige tenant_admin, developer, agent, security_officer ou finops.
Route : /v1/approvals (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Action, ressource, quorum, valideurs et expiration de la demande. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Demander une validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.decide
JsonNode decide(String id, Object body)
Approuver ou refuser une demande. Enregistre la décision de l'appelant sur une demande en attente.
Route : /v1/approvals/{approval_id}/decide (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la demande de validation. | |
body | Object | oui | Décision et commentaire facultatif. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Approuver ou refuser une demande ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.decide
JsonNode decide(String id, Object body, RequestOptions options)
Approuver ou refuser une demande. Enregistre la décision de l'appelant sur une demande en attente.
Route : /v1/approvals/{approval_id}/decide (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la demande de validation. | |
body | Object | oui | Décision et commentaire facultatif. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Approuver ou refuser une demande ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.get
JsonNode get(String id)
Lire une demande de validation. Renvoie une demande de validation avec ses décisions (valideur, décision, commentaire, date) et approvals_count. Une demande en attente dont l'expiration est passée est marquée expired et son exécution en attente échoue. Ouvert à tout membre du tenant. Répond 404 approval_not_found.
Route : /v1/approvals/{approval_id} (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la demande de validation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire une demande de validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.list
Page<JsonNode> list()
Lister les demandes de validation. Liste les demandes de validation du tenant, les plus récentes d'abord, paginées, éventuellement filtrées par statut. Les demandes en attente dont l'expiration est passée sont d'abord marquées expired. Chaque élément porte ses decisions et approvals_count. Ouvert à tout membre du tenant.
Route : /v1/approvals (GET).
Cet élément ne prend aucun paramètre.
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les demandes de validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ApprovalsClient.list
Page<JsonNode> list(Map<String, ?> query)
Lister les demandes de validation. Liste les demandes de validation du tenant, les plus récentes d'abord, paginées, éventuellement filtrées par statut. Les demandes en attente dont l'expiration est passée sont d'abord marquées expired. Chaque élément porte ses decisions et approvals_count. Ouvert à tout membre du tenant.
Route : /v1/approvals (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
query | Map<String, ?> | oui | Paramètres de la chaîne de requête de la route. |
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les demandes de validation ».
Erreurs levées : les erreurs typées du transport (Erreurs).