K8S Cluster Role

K8S Cluster Role provides tools for creating, listing, retrieving, updating, and deleting resources in F5 Distributed Cloud.

Tools

Tool	Description
`f5xc-api-managedkubernetes-k8s-cluster-role-create`	Create Configuration Specification.
`f5xc-api-managedkubernetes-k8s-cluster-role-get`	Get Configuration Specification.
`f5xc-api-managedkubernetes-k8s-cluster-role-list`	List K8s Cluster Role.
`f5xc-api-managedkubernetes-k8s-cluster-role-update`	Update Configuration Specification.
`f5xc-api-managedkubernetes-k8s-cluster-role-delete`	Delete K8s Cluster Role.

Parameters

Path Parameters

Parameter	Description	Example
`namespace`	Namespace This defines the workspace within which each the configuration object is to be created.	`system`
`name`	Name The name of the configuration object to be fetched.	`example-resource`

Query Parameters

Parameter	Description	Example
`response_format`	The format in which the configuration object is to be fetched. This could be for example - in GetSpec form for the contents of object…	`GET_RSP_FORMAT_DEFAULT`
`label_filter`	A LabelSelectorType expression that every item in list response will satisfy.	`-`
`report_fields`	The report_fields parameter…	`-`
`report_status_fields`	The report_status_fields parameter…	`-`

Configuration Choices

This resource includes mutually exclusive configuration options:

rule_choice

Option	Description	Recommended
`spec.k8s_cluster_role_selector`	K8s cluster role selector
`spec.policy_rule_list`	Policy rule list
`spec.yaml`	Yaml

Example Usage

Ask Claude to help you work with K8S Cluster Role resources:

Create K8S Cluster Role

“Create a k8s-cluster-role named ‘example’ in the ‘production’ namespace”

List K8S Cluster Roles

“List all k8s-cluster-roles in the ‘production’ namespace”

Get K8S Cluster Role Details

“Get details of the k8s-cluster-role named ‘example’ in namespace ‘production‘“

CURL Examples

# List resources
curl -X GET "https://${TENANT}.console.ves.volterra.io/api/config/namespaces/$${PARAM}/k8s_cluster_roles" \
  -H "Authorization: APIToken ${F5XC_API_TOKEN}"

# Get specific resource
curl -X GET "https://${TENANT}.console.ves.volterra.io/api/config/namespaces/$${PARAM}/k8s_cluster_roles/$${PARAM}" \
  -H "Authorization: APIToken ${F5XC_API_TOKEN}"

# Create resource
curl -X POST "https://${TENANT}.console.ves.volterra.io/api/config/namespaces/$${PARAM}/k8s_cluster_roles" \
  -H "Authorization: APIToken ${F5XC_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d @k8s_cluster_role.json

# Delete resource
curl -X DELETE "https://${TENANT}.console.ves.volterra.io/api/config/namespaces/$${PARAM}/k8s_cluster_roles/$${PARAM}" \
  -H "Authorization: APIToken ${F5XC_API_TOKEN}"