Portainer icon

Portainer

Interact with Portainer via API

Actions190

Kubernetes → Get Kubernetes Ingress

AI-generated

Overview

This node operation retrieves details of a specific Kubernetes Ingress resource within a given namespace. It is useful for scenarios where you need to fetch the configuration or status of an Ingress object in your Kubernetes cluster, such as when monitoring traffic routing rules or debugging access issues.

Practical examples include:

  • Fetching the current state of an Ingress to verify its rules and backend services.
  • Integrating with automation workflows that react to changes or conditions in Ingress resources.
  • Auditing or reporting on Ingress configurations across namespaces.

Properties

Name Meaning
Id Environment identifier (a numeric ID representing the Kubernetes environment or cluster).
Namespace The Kubernetes namespace where the target Ingress resource resides.
Ingress The name of the specific Ingress resource to retrieve.

Output

The node outputs JSON data representing the full details of the requested Kubernetes Ingress resource. This typically includes metadata, specification, and status fields describing the Ingress configuration, such as host rules, paths, backend services, TLS settings, and current operational status.

No binary data output is indicated.

Dependencies

  • Requires connection to a Kubernetes cluster environment identified by the provided environment ID.
  • Proper authentication and permissions to access the Kubernetes API for reading Ingress resources.
  • The node expects relevant credentials and API endpoint configuration to be set up in n8n to communicate with the Kubernetes cluster.

Troubleshooting

  • Common Issues:

    • Incorrect or missing environment ID may cause failure to connect to the Kubernetes cluster.
    • Specifying a non-existent namespace or ingress name will result in errors indicating the resource was not found.
    • Insufficient permissions or invalid credentials can lead to authorization errors.
  • Error Messages:

    • "Resource not found" or similar indicates the specified Ingress or namespace does not exist.
    • "Unauthorized" or "Forbidden" suggests credential or permission problems; verify API keys and RBAC settings.
    • Network or connection timeouts imply connectivity issues with the Kubernetes API server.

Resolving these usually involves verifying input parameters, ensuring correct cluster access credentials, and confirming the existence of the targeted namespace and Ingress resource.

Links and References

Discussion