io.enterpriseai.resources.MandatesClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/MandatesClient.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 MandatesClient
Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés.
Constructeur MandatesClient
MandatesClient(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. |
MandatesClient.create
JsonNode create(Object body)
Demander un mandat pour un agent. Demande un mandat pour qu'un agent (éventuellement l'une de ses planifications) s'exécute de façon autonome sous une identité de service. Exige tenant_admin, developer ou security_officer.
Route : /v1/mandates (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Agent, identité de service, planification, droits, finalité et durée du mandat. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Demander un mandat pour un agent ».
Erreurs levées : les erreurs typées du transport (Erreurs).
MandatesClient.create
JsonNode create(Object body, RequestOptions options)
Demander un mandat pour un agent. Demande un mandat pour qu'un agent (éventuellement l'une de ses planifications) s'exécute de façon autonome sous une identité de service. Exige tenant_admin, developer ou security_officer.
Route : /v1/mandates (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Agent, identité de service, planification, droits, finalité et durée du mandat. | |
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 un mandat pour un agent ».
Erreurs levées : les erreurs typées du transport (Erreurs).
MandatesClient.get
JsonNode get(String mandateId)
Lire un mandat. Renvoie un mandat : agent, planification, identité de service, portées, audience, ressources, plafond de classification, profondeur, finalité, statut, validation et expiration. Ouvert à tout membre du tenant. Répond 404 mandate_not_found.
Route : /v1/mandates/{mandate_id} (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
mandateId | String | oui | Identifiant (UUID) du mandat. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire un mandat ».
Erreurs levées : les erreurs typées du transport (Erreurs).
MandatesClient.list
JsonNode list()
Lister les mandats. Liste les mandats du tenant, les plus récents d'abord, éventuellement pour un agent, avec leur statut effectif (pending, approved, rejected, revoked ou expired). Ouvert à tout membre du tenant.
Route : /v1/mandates (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les mandats ».
Erreurs levées : les erreurs typées du transport (Erreurs).
MandatesClient.list
JsonNode list(Map<String, ?> query)
Lister les mandats. Liste les mandats du tenant, les plus récents d'abord, éventuellement pour un agent, avec leur statut effectif (pending, approved, rejected, revoked ou expired). Ouvert à tout membre du tenant.
Route : /v1/mandates (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
query | Map<String, ?> | oui | Paramètres de la chaîne de requête de la route. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les mandats ».
Erreurs levées : les erreurs typées du transport (Erreurs).
MandatesClient.revoke
JsonNode revoke(String mandateId, Object body)
Révoquer un mandat. Révoque le mandat et les délégations qui en découlent : la prochaine exécution planifiée de l'agent est refusée (mandate_required). Autorisé au demandeur, à un tenant_admin ou à un security_officer (403 forbidden). Un mandat révoqué ou refusé répond 409 mandate_closed. Écrit l'événement d'audit mandate.revoke.
Route : /v1/mandates/{mandate_id}/revoke (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
mandateId | String | oui | Identifiant (UUID) du mandat. | |
body | Object | oui | Raison facultative. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Révoquer un mandat ».
Erreurs levées : les erreurs typées du transport (Erreurs).
MandatesClient.revoke
JsonNode revoke(String mandateId, Object body, RequestOptions options)
Révoquer un mandat. Révoque le mandat et les délégations qui en découlent : la prochaine exécution planifiée de l'agent est refusée (mandate_required). Autorisé au demandeur, à un tenant_admin ou à un security_officer (403 forbidden). Un mandat révoqué ou refusé répond 409 mandate_closed. Écrit l'événement d'audit mandate.revoke.
Route : /v1/mandates/{mandate_id}/revoke (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
mandateId | String | oui | Identifiant (UUID) du mandat. | |
body | Object | oui | Raison facultative. | |
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 « Révoquer un mandat ».
Erreurs levées : les erreurs typées du transport (Erreurs).