Skip to content

Feature/integrations pt4 jobs#196

Open
PaperMtn wants to merge 48 commits intogoogle:mainfrom
PaperMtn:feature/integrations-pt4-jobs
Open

Feature/integrations pt4 jobs#196
PaperMtn wants to merge 48 commits intogoogle:mainfrom
PaperMtn:feature/integrations-pt4-jobs

Conversation

@PaperMtn
Copy link
Contributor

Implement All Integration Management Functions - Pt 4: Jobs

Summary

This PR Adds Integration Jobs capabilities to the SecOps SDK. It includes:

  • SDK modules
  • ChronicleClient methods
  • CLI commands
  • Unit tests
  • Full documentation.

New SDK Modules (src/secops/chronicle/integration/)

Module Description
jobs.py CRUD, test execution, and template fetching for integration jobs
job_revisions.py List, create, delete, and rollback job revisions
job_context_properties.py CRUD and bulk-delete for job context properties
job_instances.py CRUD, on-demand execution for job instances
job_instance_logs.py List and get job instance logs

CLI Commands (src/secops/cli/commands/integration/)

Added a complete secops integration CLI command tree with 21 subcommand modules, all registered via integration_client.py:

CLI Subcommand Operations
secops integration jobs list, get, create, update, delete, test, template
secops integration job-revisions list, create, delete, rollback
secops integration job-context-properties list, get, create, update, delete, delete-all
secops integration job-instance-logs list, get
secops integration job-instances list, get, create, update, delete, run-on-demand

Tests

Unit Tests - SDK Modules (tests/chronicle/integration/)

  • test_jobs.py, test_job_revisions.py
  • test_job_context_properties.py, test_job_instance_logs.py, test_job_instances.py

Documentation Updates

README.md

SDK usage examples for every new module, following the established format:

  • Jobs (CRUD, test, template)
  • Job Revisions, Context Properties, Instance Logs, Instances

CLI.md

CLI usage documentation with bash examples for all integration subcommands, including workflow examples for revision-based safe updates.


ChronicleClient Updates

  • client.py - All new integration module functions added as ChronicleClient methods with full docstrings
  • __init__.py - All new functions exported in __all__ and publicly importable from secops.chronicle

API Version Support

All integration modules support both v1beta (default) and v1alpha via the api_version parameter

@PaperMtn PaperMtn requested a review from mihirvala08 as a code owner March 10, 2026 16:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant