Actions54
- Namespace Actions
- Deployment Actions
- Service Actions
- Pod Actions
- StatefulSet Actions
- ConfigMap Actions
- Secret Actions
- Job Actions
- CronJob Actions
- Node Actions
- Workload Actions
Overview
This node enables interaction with Rancher and Kubernetes APIs, specifically for managing Kubernetes resources. For the StatefulSet resource with the Get operation, it retrieves one or more StatefulSets from a specified Kubernetes cluster environment. This is useful for monitoring, auditing, or integrating Kubernetes StatefulSets into automated workflows.
Typical use cases include:
- Fetching details of StatefulSets running in a particular namespace to monitor their status.
- Filtering StatefulSets by creation date, creator ID, name, or UUID to find specific deployments.
- Sorting and limiting results to manage large sets of StatefulSets efficiently.
Example: You might use this node to get all StatefulSets in a namespace filtered by a certain label or creation time, then trigger alerts or further automation based on their state.
Properties
Name | Meaning |
---|---|
Cluster Name or ID | Select the Kubernetes cluster to query. Choose from a list or specify an ID via expression. |
Project Name or ID | (Optional) Select the project within the cluster. Choose from a list or specify an ID via expression. |
Namespace Name or ID | (Optional) Select the namespace within the project. Choose from a list or specify an ID via expression. |
Additional Fields | Collection of optional parameters to refine the query: |
- Filters | Filter StatefulSets by: • Created (timestamp) • Creator ID • Name • UUID |
- Sort | Sort results by: • Field: Created or Name • Order: Ascending or Descending |
- Limit | Maximum number of StatefulSets to return (-1 means no limit, i.e., all results) |
Output
The node outputs an array of JSON objects representing the retrieved StatefulSets. Each object contains the full data structure returned by the Rancher/Kubernetes API for a StatefulSet, including metadata, spec, and status fields.
If multiple StatefulSets match the query, the output will be an array of such objects.
No binary data output is produced by this operation.
Dependencies
- Requires connection to a Rancher or Kubernetes API endpoint.
- Needs an API authentication token or API key credential configured in n8n to authorize requests.
- The node depends on dynamic loading methods to populate options for clusters, projects, namespaces, and StatefulSets.
Troubleshooting
- Empty results: Ensure the correct cluster, project, and namespace are selected. Verify filters do not exclude all StatefulSets.
- Authentication errors: Confirm that the API key or token credential is valid and has sufficient permissions to read StatefulSets.
- Invalid IDs: When specifying IDs manually, ensure they are accurate and exist in the target cluster.
- API rate limits or connectivity issues: Check network access to the Rancher/Kubernetes API and any rate limiting policies.
- Sorting or filtering not working as expected: Validate filter values and sort field names against the API documentation.