K8s Clusters

This is a simple module that supports listing k8s clusters.

Example Syntax


name: List Clusters
ionoscloudsdk.ionoscloud.k8s_cluster_info: null
register: k8s_cluster_list_response

Returned object

{
    "changed": false,
    "clusters": [
        {
            "entities": {
                "nodepools": {
                    "href": "https://api.ionos.com/cloudapi/v6/k8s/75214458-7d67-4c86-9213-df8b4fa6dc2a/nodepools",
                    "id": "75214458-7d67-4c86-9213-df8b4fa6dc2a/nodepools",
                    "items": null,
                    "type": "collection"
                }
            },
            "href": "https://api.ionos.com/cloudapi/v6/k8s/75214458-7d67-4c86-9213-df8b4fa6dc2a",
            "id": "75214458-7d67-4c86-9213-df8b4fa6dc2a",
            "metadata": {
                "created_by": "<USER_EMAIL>",
                "created_by_user_id": "<USER_ID>",
                "created_date": "2023-08-03T13:04:58+00:00",
                "etag": "12ef56686a1f54b5776f6067651a574a",
                "last_modified_by": "<USER_EMAIL>",
                "last_modified_by_user_id": "<USER_ID>",
                "last_modified_date": "2023-08-03T13:04:58+00:00",
                "state": "ACTIVE"
            },
            "properties": {
                "api_subnet_allow_list": null,
                "available_upgrade_versions": [
                    "1.26.6",
                    "1.26.5",
                    "1.26.4"
                ],
                "k8s_version": "1.25.11",
                "maintenance_window": {
                    "day_of_the_week": "Thursday",
                    "time": "22:37:58Z"
                },
                "name": "my-cluster-4",
                "s3_buckets": null,
                "viable_node_pool_versions": [
                    "1.25.11",
                    "1.25.10",
                    "1.25.9",
                    "1.25.6",
                    "1.25.5",
                    "1.24.15",
                    "1.24.14",
                    "1.24.13",
                    "1.24.10",
                    "1.24.9",
                    "1.24.8",
                    "1.24.6"
                ]
            },
            "type": "k8s"
        }
    ],
    "failed": false
}

For more examples please check out the tests here.

Available parameters:

NameRequiredDescription

depth int

False

The depth used when retrieving the items. Default: 1

filters dict

False

Filter that can be used to list only objects which have a certain set of propeties. Filters should be a dict with a key containing keys and value pair in the following format: 'properties.name': 'server_name'

api_url str

False

The Ionos API base URL.

certificate_fingerprint str

False

The Ionos API certificate fingerprint.

username str

False

The Ionos username. Overrides the IONOS_USERNAME environment variable.

password str

False

The Ionos password. Overrides the IONOS_PASSWORD environment variable.

token str

False

The Ionos token. Overrides the IONOS_TOKEN environment variable.

Last updated