乐享 icon

乐享

与乐享平台API交互

Actions2

Overview

This node integrates with the Lexiang platform API to retrieve configuration item (CI) data. Specifically, the "Get CI List" operation fetches a paginated list of CIs filtered by various criteria such as domains, type codes, and CI IDs. This is useful in IT asset management, CMDB synchronization, or infrastructure monitoring scenarios where users need to query and process detailed asset information from Lexiang.

Practical examples:

  • Retrieve all physical servers on page 2 with 50 results per page.
  • Filter CIs by specific domain categories like "Database" or "Network Device".
  • Query a custom set of CI IDs for targeted asset updates.

Properties

Name Meaning
Page Size Number of results to return per page. Minimum value is 1.
Page Index The page number to retrieve. Minimum value is 1.
Additional Fields Optional filters including:
• Domains: Select one or multiple domain codes to filter assets.
• Type Codes: Comma-separated template codes to filter assets.
• CI IDs: Comma-separated list of specific CI IDs to filter assets.

Domains options include:

  • App Middleware
  • Base Protocol
  • Business System
  • Cloud Platform
  • Data Center
  • Database
  • Load Balance
  • Manage Assets
  • Message Middleware
  • Network Device
  • Operating System
  • Physical Server
  • Security Device
  • Storage Device
  • Terminal
  • Virtualization
  • Web Middleware
  • Wireless

Output

The node outputs an array of JSON objects representing the retrieved CIs matching the specified filters and pagination. Each object contains the CI's attributes as returned by the Lexiang API.

If binary data were involved, it would be summarized here, but this operation only returns JSON data related to CI properties.

Dependencies

  • Requires an active connection to the Lexiang platform API.
  • Needs an API authentication credential configured in n8n to authorize requests.
  • Pagination parameters must be correctly set to avoid large data loads or empty responses.

Troubleshooting

  • Common issues:
    • Incorrect or missing API credentials will cause authentication failures.
    • Requesting a page index beyond available pages may return empty results.
    • Providing invalid domain codes or malformed comma-separated lists can lead to no matches or errors.
  • Error messages:
    • "The operation "getCiList" is not supported for resource "ci". indicates a misconfiguration or unsupported operation call.
    • Generic error messages from the API will be passed through; ensure network connectivity and valid parameters.
  • To resolve errors, verify credentials, check parameter formats, and confirm that the Lexiang API endpoint is reachable.

Links and References

Discussion