Overview
This node integrates with the Vast.ai API to manage cloud computing resources and related services. It allows users to perform various operations such as listing volumes, managing instances, searching offers, handling billing information, and more. Specifically, for the Volumes resource with the Volumes operation, it supports listing volumes available in the Vast.ai environment.
Common scenarios where this node is beneficial include automating infrastructure management tasks, querying available storage volumes, managing compute instances, or integrating Vast.ai data into workflows for monitoring or provisioning.
For example, a user can list all storage volumes associated with their Vast.ai account to monitor usage or automate volume attachment/detachment processes.
Properties
| Name | Meaning |
|---|---|
| API Group Name or ID | Select the specific API endpoint or action to perform within the Volumes resource. For Volumes, the option is "List Volumes". You can choose from a dropdown or specify an ID via expression. |
| Body | The request body parameters sent with the API call (if applicable). For GET methods like listing volumes, this is typically blank. When used, it consists of multiple key-value pairs representing parameter names and their values. |
Output
The node outputs JSON data corresponding to the response from the Vast.ai API for the selected API call. For the Volumes operation "List Volumes", the output JSON contains an array or object describing the volumes available, including details such as volume IDs, sizes, and other metadata provided by the API.
No binary data output is produced by this node.
Example output structure (simplified):
{
"volumes": [
{
"id": "volume1",
"size_gb": 100,
"status": "available",
...
},
{
"id": "volume2",
"size_gb": 250,
"status": "in-use",
...
}
]
}
Dependencies
- Requires an API key credential for Vast.ai to authenticate requests.
- The node uses the official Vast.ai API base URL:
https://console.vast.ai/api/v0. - No additional external dependencies are required beyond the configured API key credential.
- The node expects proper configuration of credentials in n8n to authorize API calls.
Troubleshooting
Missing Required Path Parameter Errors:
Some API calls require mandatory path parameters (e.g., volume ID). If these are missing, the node throws errors indicating which parameter is absent. Ensure all required parameters are set correctly.Authentication Failures:
If the API key is invalid or missing, requests will fail. Verify that the Vast.ai API key credential is correctly configured and has necessary permissions.Invalid API Group or Operation:
Selecting an unsupported API group or operation may result in no data or errors. Confirm that the chosen API group and operation exist and are supported.Empty or Incorrect Request Body:
For non-GET requests, ensure the request body parameters are properly defined. Missing or malformed parameters can cause API errors.Network or API Availability Issues:
Temporary network failures or Vast.ai API downtime can cause request failures. Retry after some time or check Vast.ai service status.