mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node operation, Project List Servers, interacts with the mittwald mStudio API to retrieve a list of servers associated with a specific project or customer. It is useful for scenarios where you need to programmatically fetch server details for management, monitoring, or reporting purposes within a project context.

For example, a user might want to:

  • Retrieve all servers under their organization to display in a dashboard.
  • Filter servers by search terms such as ID or description to find specific resources.
  • Paginate through large sets of servers when dealing with many entries.

Properties

Name Meaning
Customer Id ID of the Organization to list PlacementGroups for. If not provided, defaults to the executing User's ID.
Limit Maximum number of server records to return (default: 10000).
Page The page number of results to retrieve (default: 1).
Skip Number of records to skip before starting to collect the result set (default: 0).
Search Term Text to filter servers by searchable fields: id, shortId, and description.

Output

The node outputs JSON data containing the list of servers matching the query parameters. Each item in the output array represents a server with its associated properties as returned by the mittwald mStudio API.

If the API supports binary data related to servers (e.g., configuration files or logs), it would be included in the binary output field; however, this operation primarily returns JSON data about servers.

Dependencies

  • Requires an API key credential for authentication with the mittwald mStudio API.
  • The base URL for API requests is https://api.mittwald.de.
  • The node uses standard HTTP headers for JSON content negotiation (Accept and Content-Type set to application/json).

Troubleshooting

  • Authentication errors: Ensure that the API key credential is correctly configured and has sufficient permissions.
  • Empty results: Verify that the Customer Id is correct or try omitting it to use the executing user's ID. Also, check if the Search Term filters out all results unintentionally.
  • Pagination issues: Adjust Limit, Page, and Skip values carefully to navigate through large datasets without missing or duplicating entries.
  • API rate limits or connectivity problems: Check network connectivity and API usage quotas.

Links and References

Discussion