ucmdb-rest 2.0.1__tar.gz

ucmdb_rest-2.0.1/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Keith Paschal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ucmdb_rest-2.0.1/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: ucmdb_rest
+Version: 2.0.1
+Summary: A modular Python client for the UCMDB REST API
+Author-email: Keith Paschal <kw.paschal@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kwpaschal/ucmdb_rest
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# UCMDB REST Python Library
+
+A modern, object-oriented Python 3.6+ wrapper for the OpenText Universal Configuration Management Database (UCMDB) REST API. This library centralizes UCMDB interactions through a unified client, providing type-safe Enums and automated pagination.
+## Setup and Authentication
+This library contains some examples that assume a `credentials.json` file is in the same direcory as the code.
+
+1. Copy `credentials.json.example` to `credentials.json`
+2. Update the values with your UCMDB server details
+
+| Key | Description |
+| :--- | :--- |
+| **user** | UCMDB Username |
+| **password** | UCMDB Password |
+| **server** | FQDN or IP of the UCMDB Server |
+| **port** | REST API port (Default 8443) |
+| **ssl_validation** | Boolean (false to skip certificate checks) |
+
+## Quick Start
+
+The library uses a central `UCMDBServer` to manage authentication and session persistence. 
+
+```python
+from ucmdb_rest import UCMDBServer
+
+# Initialize client (assumes credentials.json exists)
+client = UCMDBServer.from_json('credentials.json')
+
+# Quick connectivity check
+print(f"Connected to: {client.server_version}")
+
+# Get detailed version info
+version = client.system.getUCMDBVersion().json()
+print(f"Product: {version['productName']}")
+print(f"Content Pack: {version['contentPackVersion']}")
+```
+## Practical Examples
+To help you get started quickly, here are some example standalone scripts
+* **`add_cis.py`**: Create CIs and Relationships with custom properties
+* **`delete_cis.py`**: Delete CIs by their UCMDB ID
+* **`get_recon_rule.py`**: Display a reconciliation rule for a CI Type
+* **`initialize_get_version.py`**: Display version information about the UCMDB Server
+* **`query_topology`**: Run a UCMDB View and get the information
+* **`search_and_expose_ci.py`**: Search for a CI by name and get specific properties
+* **`show_content_packs.py`**: Display current content pack information
+* **`show_license_report.py`**: Display a license report from UCMDB
+
+see [Examplese Documentation](./examples/index.md) for detailed setup and usage.
+## Functional Modules
+
+The library is organized into specialized modules to mirror the UCMDB API ecosystem:
+
+| Module | Description |
+| :--- | :--- |
+| **client** | `UCMDBServer` class which acts as the entry point. |
+| **data_flow_management** | Operations affecting Data Flow Probes. |
+| **datamodel** | CRUD operations for Configuration Items (CIs) and Relations. |
+| **discovery** | Management of discovery jobs, probe status, and results. |
+| **expose_ci** | On-demand queries of the UCMDB database. |
+| **integration** | Operations affecting integration points. |
+| **ldap** | Operations affecting LDAP integration in UCMDB. |
+| **management_zone** | Operations affecting UCMDB UI zone-based discovery. |
+| **packages** | Deployment and management of UCMDB Content Packs. |
+| **policies** | Policy calculation and automated result chunking. |
+| **report** | Operations involving reports and data exports. |
+| **settings** | Operations involving infrastructure settings and recipients. |
+| **system** | Licensing, versioning, and ping operations. |
+| **topology** | TQL execution, ad-hoc queries, and fetching CI attributes. |
+| **utils** | Shared helper functions and internal constants. |
+
+## Documentation
+
+For detailed API references, view our [Interactive Documentation](reference/data_flow_management.md).
+
+### Documentation Workflow
+The docs are powered by `mkdocs` and `mkdocstrings`.
+- **Source**: Python Docstrings (numpy Style)
+- **Theme**: Material for MkDocs
+- **Customization**: Located in `docs/stylesheets/extra.css`
+
+## Development and Testing
+
+We use `pytest` for functional validation. To run the suite:
+```bash
+# Run all tests with coverage
+pytest --cov=ucmdb_rest
+
+# Preview documentation locally
+mkdocs serve
+
+## Release History
+
+## Release History
+* **2.0.1 (Current)**
+  * Fixed a bunch of failing tests
+  * Beginning to add Examples
+* **2.0.0**
+  * **Major Architecture Milestone**: Completed the migration of all legacy `rest.py` components.
+  * Re-engineered core modules into a modular, object-oriented framework.
+  * Standardized response handling using `requests.Response` objects across all modules.
+  * Enhanced code discoverability via the unified `UCMDBServer` entry point.
+* **1.7.0**
+  * (Internal version alignment release)
+* **1.6.0**
+  * Added Settings and Recipients management.
+* **1.5.0**
+  * Added Reports functionality and tests.
+* **1.4.0**
+  * Added Management Zone functionality and tests.
+* **1.3.0**
+  * Added LDAP configuration retrieval.
+* **1.2.0**
+  * Added integration point retrieval.
+* **1.1.0**
+  * Added ExposeCI ad-hoc query support.
+* **1.0.0**
+  * Initial stable release: Topology and Discovery modules complete.

ucmdb_rest-2.0.1/README.md

@@ -0,0 +1,116 @@
+# UCMDB REST Python Library
+
+A modern, object-oriented Python 3.6+ wrapper for the OpenText Universal Configuration Management Database (UCMDB) REST API. This library centralizes UCMDB interactions through a unified client, providing type-safe Enums and automated pagination.
+## Setup and Authentication
+This library contains some examples that assume a `credentials.json` file is in the same direcory as the code.
+
+1. Copy `credentials.json.example` to `credentials.json`
+2. Update the values with your UCMDB server details
+
+| Key | Description |
+| :--- | :--- |
+| **user** | UCMDB Username |
+| **password** | UCMDB Password |
+| **server** | FQDN or IP of the UCMDB Server |
+| **port** | REST API port (Default 8443) |
+| **ssl_validation** | Boolean (false to skip certificate checks) |
+
+## Quick Start
+
+The library uses a central `UCMDBServer` to manage authentication and session persistence. 
+
+```python
+from ucmdb_rest import UCMDBServer
+
+# Initialize client (assumes credentials.json exists)
+client = UCMDBServer.from_json('credentials.json')
+
+# Quick connectivity check
+print(f"Connected to: {client.server_version}")
+
+# Get detailed version info
+version = client.system.getUCMDBVersion().json()
+print(f"Product: {version['productName']}")
+print(f"Content Pack: {version['contentPackVersion']}")
+```
+## Practical Examples
+To help you get started quickly, here are some example standalone scripts
+* **`add_cis.py`**: Create CIs and Relationships with custom properties
+* **`delete_cis.py`**: Delete CIs by their UCMDB ID
+* **`get_recon_rule.py`**: Display a reconciliation rule for a CI Type
+* **`initialize_get_version.py`**: Display version information about the UCMDB Server
+* **`query_topology`**: Run a UCMDB View and get the information
+* **`search_and_expose_ci.py`**: Search for a CI by name and get specific properties
+* **`show_content_packs.py`**: Display current content pack information
+* **`show_license_report.py`**: Display a license report from UCMDB
+
+see [Examplese Documentation](./examples/index.md) for detailed setup and usage.
+## Functional Modules
+
+The library is organized into specialized modules to mirror the UCMDB API ecosystem:
+
+| Module | Description |
+| :--- | :--- |
+| **client** | `UCMDBServer` class which acts as the entry point. |
+| **data_flow_management** | Operations affecting Data Flow Probes. |
+| **datamodel** | CRUD operations for Configuration Items (CIs) and Relations. |
+| **discovery** | Management of discovery jobs, probe status, and results. |
+| **expose_ci** | On-demand queries of the UCMDB database. |
+| **integration** | Operations affecting integration points. |
+| **ldap** | Operations affecting LDAP integration in UCMDB. |
+| **management_zone** | Operations affecting UCMDB UI zone-based discovery. |
+| **packages** | Deployment and management of UCMDB Content Packs. |
+| **policies** | Policy calculation and automated result chunking. |
+| **report** | Operations involving reports and data exports. |
+| **settings** | Operations involving infrastructure settings and recipients. |
+| **system** | Licensing, versioning, and ping operations. |
+| **topology** | TQL execution, ad-hoc queries, and fetching CI attributes. |
+| **utils** | Shared helper functions and internal constants. |
+
+## Documentation
+
+For detailed API references, view our [Interactive Documentation](reference/data_flow_management.md).
+
+### Documentation Workflow
+The docs are powered by `mkdocs` and `mkdocstrings`.
+- **Source**: Python Docstrings (numpy Style)
+- **Theme**: Material for MkDocs
+- **Customization**: Located in `docs/stylesheets/extra.css`
+
+## Development and Testing
+
+We use `pytest` for functional validation. To run the suite:
+```bash
+# Run all tests with coverage
+pytest --cov=ucmdb_rest
+
+# Preview documentation locally
+mkdocs serve
+
+## Release History
+
+## Release History
+* **2.0.1 (Current)**
+  * Fixed a bunch of failing tests
+  * Beginning to add Examples
+* **2.0.0**
+  * **Major Architecture Milestone**: Completed the migration of all legacy `rest.py` components.
+  * Re-engineered core modules into a modular, object-oriented framework.
+  * Standardized response handling using `requests.Response` objects across all modules.
+  * Enhanced code discoverability via the unified `UCMDBServer` entry point.
+* **1.7.0**
+  * (Internal version alignment release)
+* **1.6.0**
+  * Added Settings and Recipients management.
+* **1.5.0**
+  * Added Reports functionality and tests.
+* **1.4.0**
+  * Added Management Zone functionality and tests.
+* **1.3.0**
+  * Added LDAP configuration retrieval.
+* **1.2.0**
+  * Added integration point retrieval.
+* **1.1.0**
+  * Added ExposeCI ad-hoc query support.
+* **1.0.0**
+  * Initial stable release: Topology and Discovery modules complete.

ucmdb_rest-2.0.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ucmdb_rest"
+version = "2.0.1"
+description = "A modular Python client for the UCMDB REST API"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Keith Paschal", email = "kw.paschal@gmail.com" }
+]
+requires-python = ">=3.6"
+dependencies = [
+    "requests>=2.25.0",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/kwpaschal/ucmdb_rest"
+
+[tool.setuptools.packages.find]
+include = ["ucmdb_rest*"]
+
+[tool.ruff]
+src = ["ucmdb_rest"]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["F401"]

ucmdb_rest-2.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ucmdb_rest-2.0.1/tests/__init__.py

@@ -0,0 +1,3 @@
+"""
+Test suite for ucmdb_rest library
+"""

ucmdb_rest-2.0.1/tests/conftest.py

@@ -0,0 +1,27 @@
+import json
+import os
+
+import pytest
+import urllib3
+from ucmdb_rest.client import UCMDBServer
+
+# Suppress SSL warnings globally for all tests
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+@pytest.fixture(scope="session")
+def creds():
+    """Load credentials from JSON."""
+    cred_path = os.path.join(os.path.dirname(__file__), 'credentials.json')
+    with open(cred_path, 'r') as f:
+        return json.load(f)
+
+@pytest.fixture(scope="session")
+def ucmdb_client(creds):
+    """Pass the 'creds' fixture into the client fixture."""
+    return UCMDBServer(
+        user=creds['user'],
+        password=creds['password'],
+        server=creds['server'],
+        port=creds.get('port', 8443),
+        ssl_validation=creds.get('ssl_validation', False)
+    )

ucmdb_rest-2.0.1/tests/test_client.py

@@ -0,0 +1,40 @@
+import pytest
+from ucmdb_rest.client import UCMDBAuthError, UCMDBServer
+
+
+def test_connection_and_auth(ucmdb_client):
+    """
+    This test verifies that the fixture in conftest.py successfully 
+    authenticated and returned a working client object.
+    """
+    # Verify the base URL was built
+    assert ucmdb_client.base_url.startswith("https://")
+    
+    # Verify the token is present in the session headers
+    auth_header = ucmdb_client.session.headers.get('Authorization')
+    assert auth_header is not None
+    assert auth_header.startswith("Bearer ")
+    
+    # Optional: Verify the token isn't just an empty string
+    assert len(auth_header) > 20
+
+def test_failed_connection_bad_server():
+    with pytest.raises(UCMDBAuthError) as excinfo:
+        UCMDBServer(
+            user="admin",
+            password="ucmdbadmin",
+            server="bad.server.local"
+        )
+    assert "Failed to resolve" in str(excinfo.value)
+
+# def test_failed_auth_bad_password(creds): 
+#     with pytest.raises(UCMDBAuthError) as excinfo:
+#         UCMDBServer(
+#             user=creds['user'],
+#             password="wrong_password",
+#             server=creds['server']
+#         )
+#    
+#    error_msg = str(excinfo.value)
+#    assert "Auth Failed" in error_msg
+#    assert "401" in error_msg

ucmdb_rest-2.0.1/tests/test_dataflowmanagement.py

@@ -0,0 +1,149 @@
+import pytest
+
+
+@pytest.fixture(scope="module")
+def active_probe_name(ucmdb_client):
+    """Fetches the first available probe name from the server."""
+    probes = ucmdb_client.data_flow.getProbeInfo()
+    probe_list = probes.json()
+    items = probe_list.get('items',[])
+    if not items:
+        pytest.skip("No probes found on the UCMDB server; skipping dependent tests.")
+    return items[0]['probeName']
+
+def test_getProbeRanges(ucmdb_client, active_probe_name):
+    ranges = ucmdb_client.data_flow.getProbeRanges(active_probe_name)
+    assert ranges.status_code == 200
+
+def test_addRange(ucmdb_client,active_probe_name):
+    RANGE_TO_ADD = [{
+        'range': '15.1.1.1-15.1.1.2',
+        'definitionType': 'IP_RANGE',
+        'ipVersion': 'IPV4',
+        'isIncluded': True,
+        'rangeType': 'DATA_CENTER',
+        'description': 'Test Range'
+    }]
+    result = ucmdb_client.data_flow.addRange(RANGE_TO_ADD, active_probe_name)
+    assert result.status_code == 200
+
+def test_updateRange(ucmdb_client, active_probe_name):
+    RANGE_TO_UPDATE = {
+            "oldRanges": [{
+                "probe": active_probe_name,
+                "range": "15.1.1.1-15.1.1.2",
+                "definitionType": "IP_RANGE",
+                "ipVersion": "IPV4",
+                "isIncluded": True
+            }],
+            "newRanges": [{
+                "probe": active_probe_name,
+                "range": "15.1.1.1-15.1.1.3",
+                "definitionType": "IP_RANGE",
+                "ipVersion": "IPV4",
+                "isIncluded": True,
+                "rangeType": "DATA_CENTER",
+                "description": "Updated via Test"
+            }]
+        }
+    result = ucmdb_client.data_flow.updateRange(RANGE_TO_UPDATE, active_probe_name)
+    assert result.status_code == 200
+
+def test_deleteRange(ucmdb_client,active_probe_name):
+    RANGE_TO_DELETE = [
+        {
+            "range": "15.1.1.1-15.1.1.3",
+            "definitionType": "IP_RANGE",
+            "ipVersion": "IPV4",
+            "isIncluded": True
+        }
+    ]
+    result = ucmdb_client.data_flow.deleteRange(RANGE_TO_DELETE, active_probe_name)
+    assert result.status_code == 200
+
+def test_getAllDomains(ucmdb_client):
+    result = ucmdb_client.data_flow.getAllDomains()
+    assert result.status_code == 200
+
+def test_getAllCredentials(ucmdb_client):
+    result = ucmdb_client.data_flow.getAllCredentials()
+    assert result.status_code == 200
+
+def test_getProbeInfo(ucmdb_client):
+    result = ucmdb_client.data_flow.getProbeInfo()
+    assert result.status_code == 200
+
+def test_getProtocol(ucmdb_client):
+    result = ucmdb_client.data_flow.getProtocol('ntadminprotocol')
+    assert result.status_code == 200
+
+def test_probeStatusDetails(ucmdb_client,active_probe_name):
+    result = ucmdb_client.data_flow.probeStatusDetails('DefaultDomain', active_probe_name)
+    assert result.status_code == 200
+
+def test_checkCredential_ad_hoc(ucmdb_client, active_probe_name):
+    query_body = {
+        "nodes": [
+            {
+                "type": "ntcmd",
+                "queryIdentifier": "ntcmd",
+                "visible": True,
+                "includeSubtypes": True,
+                "layout": ["display_label", "application_ip", "last_discovered_by_probe", "credentials_id"],  # noqa: E501
+                "attributesConditions": [ 
+                    {
+                        "attributeName": "last_discovered_by_probe",
+                        "operator": "equals", 
+                        "value": active_probe_name
+                    }
+                ]
+            }
+        ],
+        "relations": []
+    }
+
+    response = ucmdb_client.topology.queryCIs(query_body)
+    all_cis = response.json().get("cis", [])
+    
+    matching_cis = [
+        ci for ci in all_cis 
+        if ci.get("properties", {}).get("last_discovered_by_probe") == active_probe_name
+    ]
+
+    assert len(matching_cis) > 0, (
+        f"Filtered out all {len(all_cis)} CIs because none matched probe: {active_probe_name}"
+    )
+
+    target_ci = matching_cis[0]
+    props = target_ci.get("properties", {})
+    
+    cred_id = props.get("credentials_id")
+    ip_addr = props.get("application_ip")
+    probe_name = props.get("last_discovered_by_probe")
+
+    print(f"Found {len(matching_cis)} matches. Testing Credential: {cred_id} on {ip_addr}")
+
+    result = ucmdb_client.data_flow.checkCredential(cred_id, probe_name, ip_addr)
+    
+    assert result.status_code == 200
+    print(f"Successfully validated credential for {ip_addr} via {probe_name}")
+
+def test_getAllProtocols(ucmdb_client):
+    result = ucmdb_client.data_flow.getAllProtocols()
+    assert result.status_code == 200
+
+def test_getCredentialProfiles(ucmdb_client):
+    result = ucmdb_client.data_flow.getCredentialProfiles()
+    assert result.status_code == 200
+
+def test_probeStatus(ucmdb_client):
+    result = ucmdb_client.data_flow.probeStatus()
+    assert result.status_code == 200
+
+def test_queryIPs(ucmdb_client):
+    result = ucmdb_client.data_flow.queryIPs('10.1.1.')
+    assert result.status_code == 200
+
+def test_queryProbe(ucmdb_client):
+    result = ucmdb_client.data_flow.queryProbe()
+    assert result.status_code == 200

ucmdb_rest-2.0.1/tests/test_datamodel.py

@@ -0,0 +1,67 @@
+import pytest #noqa
+
+myCI = {
+           "cis": [
+                {
+                   "ucmdbId": "1",
+                   "type": "node",
+                   "properties": {"name":"Test6",
+                                  "os_family":"windows"}
+                }
+            ],
+            "relations": []
+        }
+
+ci_list = []
+node_global_id = None
+
+def test_addCIs(ucmdb_client):
+    global ci_list, node_global_id
+    result = ucmdb_client.data_model.addCIs(myCI, returnIdsMap=True)
+    
+    assert result.status_code == 200
+    data = result.json()
+    print(data)
+    
+    if "idsMap" in data:
+        ci_list = list(data["idsMap"].values())
+        node_global_id = data["idsMap"].get("1")
+    else:
+        ci_list = data.get("addedCis", []) + data.get("ignoredCis", [])
+        if ci_list:
+            node_global_id = ci_list[0]
+
+    assert len(ci_list) > 0
+    assert node_global_id is not None
+
+def test_updateCI(ucmdb_client):
+    global node_global_id
+    updatedCI = {"ucmdbId":node_global_id,
+                 "type":"node",
+                 "properties" : {"data_note":"Updated by REST"}}
+    response = ucmdb_client.data_model.updateCI(node_global_id, updatedCI)
+    
+    assert response.status_code == 200
+    data = response.json()
+    assert node_global_id in data.get("updatedCis", []) or node_global_id in data.get("ignoredCis", [])  # noqa: E501
+
+def test_deleteCIs(ucmdb_client):
+    global ci_list
+    for ci_id in ci_list:
+        response = ucmdb_client.data_model.deleteCIs(ci_id, isGlobalId=True)
+        assert response.status_code == 200
+
+def test_getClass(ucmdb_client):
+    response = ucmdb_client.data_model.getClass("node")
+    assert response.status_code == 200
+
+def test_retrieveIdentificationRule(ucmdb_client):
+    response = ucmdb_client.data_model.retrieveIdentificationRule("node")
+    assert response.status_code == 200
+
+def test_convertFromBase64_logic(ucmdb_client):
+    sample_input = "SGVsbG8gVUNNREI="
+    expected_output = "Hello UCMDB"
+
+    result = ucmdb_client.data_model.convertFromBase64(sample_input)
+    assert result == expected_output

ucmdb_rest-2.0.1/tests/test_discovery.py

@@ -0,0 +1,80 @@
+import pytest
+
+
+# 1. Metadata Tests
+def test_get_module_tree(ucmdb_client):
+    response = ucmdb_client.discovery.getModuleTree()
+    assert response.status_code == 200
+    assert "children" in response.json()
+
+def test_get_use_cases(ucmdb_client):
+    response = ucmdb_client.discovery.getDiscoveryUseCases()
+    assert response.status_code == 200
+    data = response.json()
+    assert isinstance(data, dict)
+    assert "children" in data
+
+def test_get_job_metadata(ucmdb_client):
+    response = ucmdb_client.discovery.getJobMetaData()
+    assert response.status_code == 200
+    assert "items" in response.json()
+
+# 2. IP Range Tests
+def test_get_ip_ranges(ucmdb_client):
+    response = ucmdb_client.discovery.getIPRange()
+    assert response.status_code == 200
+    assert "items" in response.json()
+
+def test_get_ip_range_for_specific_ip(ucmdb_client):
+    # Testing with a common loopback or local IP
+    response = ucmdb_client.discovery.getIPRangeForIP("127.0.0.1")
+    assert response.status_code == 200
+
+# 3. Job Group & Parameter Tests
+def test_get_job_group_with_fields(ucmdb_client):
+    # This specifically tests the fix you just made
+    response = ucmdb_client.discovery.getJobGroup(fields="name,id")
+    assert response.status_code == 200
+    data = response.json()
+    if data.get("items"):
+        assert "name" in data["items"][0]
+        assert "id" in data["items"][0]
+
+def test_get_questions(ucmdb_client):
+    job_name = "Host Connection by Shell"
+    response = ucmdb_client.discovery.getQuestions(job_name)
+    assert response.status_code == 200
+
+def test_get_schedules(ucmdb_client):
+    response = ucmdb_client.discovery.getSchedules()
+    assert response.status_code == 200
+
+# 4. Lifecycle Test
+def test_job_group_lifecycle(ucmdb_client):
+    name = "Pytest_Discovery_Test"
+    payload = {
+        "name": name,
+        "type": "CMS",
+        "description": "Test Group",
+        # discoveryType often defaults to null on the server
+        "discoveryType": None, 
+        "jobs": [
+            {
+                "jobName": "Call Home Processing",
+                "jobDisplayName": "Call Home Processing",
+                "adapterName": "CallHomeProcessing",
+                "inputCI": "callhome_event",
+                "jobType": "DynamicService",
+                "protocols": [],
+                "jobParameters": {},
+                "triggerQueries": [],
+                "jobInvokeOnNewTrigger": True
+            }
+        ]
+    }
+    # Create
+    assert ucmdb_client.discovery.createJobGroup(payload).status_code in [200, 201]
+    # Get Specific
+    assert ucmdb_client.discovery.getSpecificJobGroup(name).status_code == 200
+    # Delete
+    assert ucmdb_client.discovery.deleteSpecificJobGroup(name).status_code == 200