io.enterpriseai.resources.RiskClient

Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/RiskClient.java. Retour à l'index de la référence du SDK Java.

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 RiskClient

Risques et conformité. Gestion des risques des systèmes d'IA du tenant : évaluations au titre de l'AI Act européen, contrôles rattachés à l'ISO/IEC 42001, au NIST AI RMF, au RGPD et à l'AI Act, preuves et dérogations limitées dans le temps.

Constructeur RiskClient

RiskClient(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.

RiskClient.createAssessment

JsonNode createAssessment(Object body)

Évaluer le risque d'un système d'IA. Classe la cible au titre de l'AI Act européen et enregistre l'évaluation. Exige tenant_admin, security_officer, developer ou ai_governance_officer ; le statut approved exige tenant_admin, security_officer ou ai_governance_officer (403 forbidden).

Route : /v1/risk/assessments (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Cible, cas d'usage, réponses, responsable, statut et preuves de l'évaluation.

Retour : JsonNode. Réponse JSON décodée de l'opération « Évaluer le risque d'un système d'IA ».

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

RiskClient.createAssessment

JsonNode createAssessment(Object body, RequestOptions options)

Évaluer le risque d'un système d'IA. Classe la cible au titre de l'AI Act européen et enregistre l'évaluation. Exige tenant_admin, security_officer, developer ou ai_governance_officer ; le statut approved exige tenant_admin, security_officer ou ai_governance_officer (403 forbidden).

Route : /v1/risk/assessments (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Cible, cas d'usage, réponses, responsable, statut et preuves de l'évaluation.
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 « Évaluer le risque d'un système d'IA ».

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

RiskClient.createControl

JsonNode createControl(Object body)

Adopter ou modifier un contrôle. Crée ou modifie le contrôle du code donné. Pour un code du catalogue, le titre et les référentiels valent par défaut ceux du catalogue. Exige tenant_admin ou security_officer. Erreurs 400 invalid_request : statut autre que planned, implemented, partially_implemented ou not_applicable ; absence de titre pour un code personnalisé ; référentiel autre que iso_42001, nist_ai_rmf, gdpr ou eu_ai_act. Les preuves fournies sont ajoutées. Écrit l'événement d'audit risk.control.upsert.

Route : /v1/risk/controls (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Code, titre, référentiels, statut, responsable et preuves du contrôle.

Retour : JsonNode. Réponse JSON décodée de l'opération « Adopter ou modifier un contrôle ».

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

RiskClient.createControl

JsonNode createControl(Object body, RequestOptions options)

Adopter ou modifier un contrôle. Crée ou modifie le contrôle du code donné. Pour un code du catalogue, le titre et les référentiels valent par défaut ceux du catalogue. Exige tenant_admin ou security_officer. Erreurs 400 invalid_request : statut autre que planned, implemented, partially_implemented ou not_applicable ; absence de titre pour un code personnalisé ; référentiel autre que iso_42001, nist_ai_rmf, gdpr ou eu_ai_act. Les preuves fournies sont ajoutées. Écrit l'événement d'audit risk.control.upsert.

Route : /v1/risk/controls (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Code, titre, référentiels, statut, responsable et preuves du contrôle.
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 « Adopter ou modifier un contrôle ».

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

RiskClient.createException

JsonNode createException(Object body)

Demander une dérogation à un contrôle. Enregistre une dérogation limitée dans le temps sur un contrôle (control_id ou control_code) ou sur une cible (target_ref). Exige tenant_admin, security_officer ou developer.

Route : /v1/risk/exceptions (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Contrôle ou cible, raison, contrôles compensatoires, approbateur et expiration.

Retour : JsonNode. Réponse JSON décodée de l'opération « Demander une dérogation à un contrôle ».

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

RiskClient.createException

JsonNode createException(Object body, RequestOptions options)

Demander une dérogation à un contrôle. Enregistre une dérogation limitée dans le temps sur un contrôle (control_id ou control_code) ou sur une cible (target_ref). Exige tenant_admin, security_officer ou developer.

Route : /v1/risk/exceptions (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Contrôle ou cible, raison, contrôles compensatoires, approbateur et expiration.
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 dérogation à un contrôle ».

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

RiskClient.evidence

JsonNode evidence()

Lire les preuves de conformité. Renvoie les preuves enregistrées sur les contrôles et les évaluations, les plus récentes d'abord, plus les preuves collectées automatiquement sur la plateforme et rattachées aux contrôles du catalogue : nombres d'agents, d'outils, de modèles, d'évaluations, de règles DLP et de politiques de conservation actives, de clés, d'événements et d'exports d'audit avec l'état de la chaîne d'audit, d'évaluations, de campagnes de red team, d'incidents et de validations. Ouvert à tout membre du tenant.

Route : /v1/risk/evidence (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire les preuves de conformité ».

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

RiskClient.listAssessments

Page<JsonNode> listAssessments()

Lister les évaluations de risques. Liste les évaluations du tenant, les plus récentes d'abord, 500 au plus, éventuellement pour une seule cible. Chaque élément donne la cible, eu_ai_act_category (aussi en risk_level), les cas d'usage, les réponses, la justification, les obligations, le statut et le responsable. Ouvert à tout membre du tenant. next_cursor vaut toujours null.

Route : /v1/risk/assessments (GET).

Cet élément ne prend aucun paramètre.

Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les évaluations de risques ».

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

RiskClient.listAssessments

Page<JsonNode> listAssessments(Map<String, ?> query)

Lister les évaluations de risques. Liste les évaluations du tenant, les plus récentes d'abord, 500 au plus, éventuellement pour une seule cible. Chaque élément donne la cible, eu_ai_act_category (aussi en risk_level), les cas d'usage, les réponses, la justification, les obligations, le statut et le responsable. Ouvert à tout membre du tenant. next_cursor vaut toujours null.

Route : /v1/risk/assessments (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 évaluations de risques ».

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

RiskClient.listControls

Page<JsonNode> listControls()

Lister les contrôles. Liste les contrôles adoptés par le tenant, triés par code, chacun avec evidence_count, ses exceptions et active_exceptions, ainsi que le catalog intégré où adopted indique ceux que le tenant utilise. Ouvert à tout membre du tenant.

Route : /v1/risk/controls (GET).

Cet élément ne prend aucun paramètre.

Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les contrôles ».

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

RiskClient.listExceptions

io.enterpriseai.Page<JsonNode> listExceptions(Map<String, ?> query)

Lister les dérogations. Liste les dérogations du tenant triées par expiration, chacune avec son status calculé : active, expired ou revoked. Ouvert à tout membre du tenant. next_cursor vaut toujours null.

Route : /v1/risk/exceptions (GET).

Nom	Type	Défaut	Requis	Description
query	Map<String, ?>		oui	Paramètres de la chaîne de requête de la route.

Retour : io.enterpriseai.Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les dérogations ».

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