io.enterpriseai.resources.DelegationsClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/DelegationsClient.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 DelegationsClient
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 DelegationsClient
DelegationsClient(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. |
DelegationsClient.authorize
JsonNode authorize(Object body)
Autoriser une action sous une délégation. Calcule la permission effective d'une action : utilisateur ET agent ET délégation ET restriction de ressource ET relation (OpenFGA ou les tuples intégrés) ET politique (OPA ou intégrée). Donnez delegation_id, ou run_id pour utiliser la délégation d'une exécution (400 invalid_request sans l'un ni l'autre ; 403 delegation_required pour une exécution sans délégation).
Route : /v1/delegations/authorize (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Action, délégation ou exécution, et la portée, la ressource, la relation, l'audience et la classification à vérifier. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Autoriser une action sous une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.authorize
JsonNode authorize(Object body, RequestOptions options)
Autoriser une action sous une délégation. Calcule la permission effective d'une action : utilisateur ET agent ET délégation ET restriction de ressource ET relation (OpenFGA ou les tuples intégrés) ET politique (OPA ou intégrée). Donnez delegation_id, ou run_id pour utiliser la délégation d'une exécution (400 invalid_request sans l'un ni l'autre ; 403 delegation_required pour une exécution sans délégation).
Route : /v1/delegations/authorize (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Action, délégation ou exécution, et la portée, la ressource, la relation, l'audience et la classification à vérifier. | |
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 « Autoriser une action sous une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.create
JsonNode create(Object body)
Créer une délégation. Crée une délégation racine de l'appelant vers un délégataire. Ouvert aux membres du tenant ; un agent ne peut pas créer seul une délégation racine (403 delegation_root_forbidden).
Route : /v1/delegations (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Délégataire, droits, limites et expiration de la délégation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Créer une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.create
JsonNode create(Object body, RequestOptions options)
Créer une délégation. Crée une délégation racine de l'appelant vers un délégataire. Ouvert aux membres du tenant ; un agent ne peut pas créer seul une délégation racine (403 delegation_root_forbidden).
Route : /v1/delegations (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Délégataire, droits, limites et expiration de la délégation. | |
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 « Créer une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.get
JsonNode get(String delegationId)
Lire une délégation. Renvoie la délégation avec la vérification de sa chaîne depuis la racine (chaque maillon actif, non expiré, du même tenant, couvert par son parent). Visible par sa racine, son créateur et la personne représentée, ainsi que par tenant_admin, security_officer, auditor et agent ; sinon 404 delegation_not_found.
Route : /v1/delegations/{delegation_id} (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
delegationId | String | oui | Identifiant (UUID) de la délégation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.list
JsonNode list()
Lister les délégations. Liste les délégations, les plus récentes d'abord, paginées : toutes pour tenant_admin, security_officer et auditor, sinon celles dont l'appelant est la racine, le créateur ou la personne représentée. Un statut inconnu répond 400.
Route : /v1/delegations (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les délégations ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.list
JsonNode list(Map<String, ?> query)
Lister les délégations. Liste les délégations, les plus récentes d'abord, paginées : toutes pour tenant_admin, security_officer et auditor, sinon celles dont l'appelant est la racine, le créateur ou la personne représentée. Un statut inconnu répond 400.
Route : /v1/delegations (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 délégations ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.restrict
JsonNode restrict(String delegationId, Object body)
Restreindre une délégation pour un sous-délégataire. Crée une délégation enfant, toujours couverte par son parent : un sous-agent n'obtient jamais de droits plus larges. Autorisé à la racine ou au créateur du parent, à un agent, à un tenant_admin ou à un security_officer (403 forbidden).
Route : /v1/delegations/{delegation_id}/restrict (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
delegationId | String | oui | Identifiant (UUID) de la délégation parente. | |
body | Object | oui | Sous-délégataire et droits plus étroits. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Restreindre une délégation pour un sous-délégataire ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.restrict
JsonNode restrict(String delegationId, Object body, RequestOptions options)
Restreindre une délégation pour un sous-délégataire. Crée une délégation enfant, toujours couverte par son parent : un sous-agent n'obtient jamais de droits plus larges. Autorisé à la racine ou au créateur du parent, à un agent, à un tenant_admin ou à un security_officer (403 forbidden).
Route : /v1/delegations/{delegation_id}/restrict (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
delegationId | String | oui | Identifiant (UUID) de la délégation parente. | |
body | Object | oui | Sous-délégataire et droits plus étroits. | |
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 « Restreindre une délégation pour un sous-délégataire ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.revoke
JsonNode revoke(String delegationId, Object body)
Révoquer une délégation. Révoque la délégation et tous ses descendants ; leurs contextes d'exécution sont révoqués avec eux, avec effet à l'action suivante. Autorisé à sa racine, à son créateur ou à la personne représentée, ainsi qu'à tenant_admin et security_officer (403 forbidden). Écrit l'événement d'audit delegation.revoke.
Route : /v1/delegations/{delegation_id}/revoke (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
delegationId | String | oui | Identifiant (UUID) de la délégation. | |
body | Object | oui | Raison facultative. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Révoquer une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.revoke
JsonNode revoke(String delegationId, Object body, RequestOptions options)
Révoquer une délégation. Révoque la délégation et tous ses descendants ; leurs contextes d'exécution sont révoqués avec eux, avec effet à l'action suivante. Autorisé à sa racine, à son créateur ou à la personne représentée, ainsi qu'à tenant_admin et security_officer (403 forbidden). Écrit l'événement d'audit delegation.revoke.
Route : /v1/delegations/{delegation_id}/revoke (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
delegationId | String | oui | Identifiant (UUID) de la délégation. | |
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 une délégation ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.revokePrincipal
JsonNode revokePrincipal(Object body)
Révoquer toutes les délégations d'un principal. Révoque toutes les délégations actives dont un principal est la racine ou qui agissent pour lui, avec leurs descendants et leurs contextes d'exécution, par exemple au départ d'un utilisateur ou après la compromission d'un compte. Exige tenant_admin ou security_officer. Écrit l'événement d'audit delegation.revoke_principal.
Route : /v1/delegations/revoke-principal (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Principal et raison. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Révoquer toutes les délégations d'un principal ».
Erreurs levées : les erreurs typées du transport (Erreurs).
DelegationsClient.revokePrincipal
JsonNode revokePrincipal(Object body, RequestOptions options)
Révoquer toutes les délégations d'un principal. Révoque toutes les délégations actives dont un principal est la racine ou qui agissent pour lui, avec leurs descendants et leurs contextes d'exécution, par exemple au départ d'un utilisateur ou après la compromission d'un compte. Exige tenant_admin ou security_officer. Écrit l'événement d'audit delegation.revoke_principal.
Route : /v1/delegations/revoke-principal (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Principal et raison. | |
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 toutes les délégations d'un principal ».
Erreurs levées : les erreurs typées du transport (Erreurs).