Ajax icon

Ajax

Consume Ajax API (v.0.1.2)

Actions242

Overview

This node, named "Ajax," is designed to interact with an Ajax API to perform various operations on different resources. Specifically, for the Network resource and the Enable/disable Device Ethernet Network Channel operation, it allows users to enable or disable the Ethernet network channel of a specified device within a hub and user context.

Common scenarios where this node is beneficial include:

  • Managing network connectivity settings of devices remotely.
  • Automating network configuration changes in response to system events.
  • Integrating network device management into broader automation workflows.

For example, a user can automate disabling the Ethernet channel of a device when it detects suspicious activity or enable it during maintenance windows.

Properties

Name Meaning
User Id Identifier of the user owning or managing the device.
Hub Id Identifier of the hub where the device is located.
Device Id Identifier of the specific device whose Ethernet network channel state is to be changed.
State Desired state of the Ethernet network channel; options are: ON (enable) or OFF (disable).

Output

The node outputs JSON data representing the result of the operation performed on the device's Ethernet network channel. This typically includes confirmation of the new state or any relevant status information returned by the Ajax API.

If the node supports binary data output, it would relate to any raw responses or files returned by the API, but based on the provided code and operation, the primary output is structured JSON reflecting the operation's success or failure.

Dependencies

  • Requires an API key credential for authenticating with the Ajax API service.
  • Depends on the external Ajax API endpoint to perform network-related operations.
  • The node uses internal helper classes for HTTP communication, state management, and operation resolution, bundled within the node's package.

Troubleshooting

  • Authentication errors: Ensure that the API key credential is correctly configured and has sufficient permissions.
  • Invalid identifiers: Verify that the User Id, Hub Id, and Device Id are correct and correspond to existing entities in the Ajax system.
  • State value issues: The State property must be either ON or OFF; other values will cause errors.
  • API connectivity problems: Check network connectivity and API endpoint availability.
  • Unexpected API responses: Review the API documentation for possible changes or additional required parameters.

Links and References

Discussion