Skip to content

Feature/integrations pt4 jobs - #196

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

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

Conversation

@PaperMtn

Copy link
Copy Markdown
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/)

ModuleDescription
jobs.pyCRUD, test execution, and template fetching for integration jobs
job_revisions.pyList, create, delete, and rollback job revisions
job_context_properties.pyCRUD and bulk-delete for job context properties
job_instances.pyCRUD, on-demand execution for job instances
job_instance_logs.pyList 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 SubcommandOperations
secops integration jobslist, get, create, update, delete, test, template
secops integration job-revisionslist, create, delete, rollback
secops integration job-context-propertieslist, get, create, update, delete, delete-all
secops integration job-instance-logslist, get
secops integration job-instanceslist, 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

Sign up for freeto 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

@PaperMtn