io.enterpriseai.resources.SchedulesClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/SchedulesClient.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 SchedulesClient
Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox.
Constructeur SchedulesClient
SchedulesClient(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. |
SchedulesClient.create
JsonNode create(Object body)
Créer une planification. Planifie des runs d'un agent à partir d'une expression cron évaluée dans un fuseau horaire ; la première échéance next_run_at est calculée (422 invalid_cron). Quand Temporal est configuré, la planification y est créée (503 scheduler_unavailable en cas d'échec). Demande tenant_admin, developer ou application_owner. 404 agent_not_found. Audité sous schedule.create.
Route : /v1/schedules (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Agent, expression cron, fuseau horaire, entrée du run et activation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Créer une planification ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SchedulesClient.create
JsonNode create(Object body, RequestOptions options)
Créer une planification. Planifie des runs d'un agent à partir d'une expression cron évaluée dans un fuseau horaire ; la première échéance next_run_at est calculée (422 invalid_cron). Quand Temporal est configuré, la planification y est créée (503 scheduler_unavailable en cas d'échec). Demande tenant_admin, developer ou application_owner. 404 agent_not_found. Audité sous schedule.create.
Route : /v1/schedules (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Agent, expression cron, fuseau horaire, entrée du run et activation. | |
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 planification ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SchedulesClient.delete
void delete(String id)
Supprimer une planification. Supprime la planification ; elle ne lance plus aucun run. Demande tenant_admin, developer ou application_owner. Quand la planification est portée par Temporal, elle y est aussi supprimée (503 scheduler_unavailable si Temporal est injoignable). 404 schedule_not_found. Audité sous schedule.delete.
Route : /v1/schedules/{schedule_id} (DELETE).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la planification. |
Retour : void.
Erreurs levées : les erreurs typées du transport (Erreurs).
SchedulesClient.list
Page<JsonNode> list()
Lister les planifications. Planifications cron du tenant, de la plus ancienne à la plus récente, éventuellement pour un seul agent. Une seule page.
Route : /v1/schedules (GET).
Cet élément ne prend aucun paramètre.
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les planifications ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SchedulesClient.list
Page<JsonNode> list(Map<String, ?> query)
Lister les planifications. Planifications cron du tenant, de la plus ancienne à la plus récente, éventuellement pour un seul agent. Une seule page.
Route : /v1/schedules (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 planifications ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SchedulesClient.update
JsonNode update(String id, Object body)
Modifier une planification. Modifie l'expression cron, le fuseau horaire, l'entrée ou l'activation. La prochaine échéance est recalculée (422 invalid_cron pour une expression ou un fuseau invalide) et la planification Temporal est mise à jour quand Temporal la porte (503 scheduler_unavailable). Demande tenant_admin, developer ou application_owner. Audité sous schedule.update.
Route : /v1/schedules/{schedule_id} (PATCH).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la planification. | |
body | Object | oui | Champs à modifier ; ceux omis sont conservés. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Modifier une planification ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SchedulesClient.update
JsonNode update(String id, Object body, RequestOptions options)
Modifier une planification. Modifie l'expression cron, le fuseau horaire, l'entrée ou l'activation. La prochaine échéance est recalculée (422 invalid_cron pour une expression ou un fuseau invalide) et la planification Temporal est mise à jour quand Temporal la porte (503 scheduler_unavailable). Demande tenant_admin, developer ou application_owner. Audité sous schedule.update.
Route : /v1/schedules/{schedule_id} (PATCH).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la planification. | |
body | Object | oui | Champs à modifier ; ceux omis sont conservés. | |
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 « Modifier une planification ».
Erreurs levées : les erreurs typées du transport (Erreurs).