Portainer icon

Portainer

Interact with Portainer via API

Actions190

Kubernetes → Update Kubernetes Namespace

AI-generated

Overview

This node operation updates a Kubernetes namespace by sending new details to the Kubernetes API. It is useful when you need to modify metadata or configuration of an existing namespace in your Kubernetes cluster, such as changing labels, annotations, or resource quotas.

Practical examples include:

  • Updating namespace labels to organize resources better.
  • Changing annotations for integration with monitoring or logging tools.
  • Adjusting resource quotas or limits defined in the namespace specification.

Properties

Name Meaning
Id Environment identifier (a numeric ID representing the target Kubernetes environment).
Namespace The name of the Kubernetes namespace to update.
Body JSON string containing the updated namespace details (e.g., metadata, labels, spec).

Output

The node outputs JSON data representing the response from the Kubernetes API after updating the namespace. This typically includes the updated namespace object with its current state and metadata.

If the operation succeeds, the output JSON will reflect the new namespace configuration. If it fails, error information may be included in the output.

No binary data output is expected from this operation.

Dependencies

  • Requires access to a Kubernetes cluster API endpoint.
  • Needs proper authentication credentials configured in n8n to authorize API requests.
  • The node uses HTTP requests with JSON payloads to communicate with the Kubernetes API.

Troubleshooting

  • Common issues:

    • Invalid or missing namespace name can cause the update to fail.
    • Incorrect or malformed JSON in the "Body" property will result in request errors.
    • Insufficient permissions or incorrect credentials will lead to authorization errors.
    • Network connectivity problems to the Kubernetes API endpoint.
  • Error messages and resolutions:

    • 404 Not Found: The specified namespace does not exist. Verify the namespace name.
    • 400 Bad Request: The body JSON is invalid or contains unsupported fields. Validate the JSON structure.
    • 401 Unauthorized or 403 Forbidden: Authentication failed or insufficient permissions. Check credentials and RBAC settings.
    • Network errors: Ensure the Kubernetes API URL is reachable and correct.

Links and References

Discussion