Workload

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

Tools

Tool	Description
`f5xc-api-containerservices-workload-create`	Create Workload.
`f5xc-api-containerservices-workload-get`	Get Workload.
`f5xc-api-containerservices-workload-list`	List Workload.
`f5xc-api-containerservices-workload-update`	Update Workload.
`f5xc-api-containerservices-workload-delete`	Delete Workload.

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:

workload_choice

Option	Description	Recommended
`spec.job`	Job
`spec.service`	Service
`spec.simple_service`	Simple service
`spec.stateful_service`	Stateful service

Example Usage

Ask Claude to help you work with Workload resources:

Create Workload

“Create a workload named ‘example’ in the ‘production’ namespace”

List Workloads

“List all workloads in the ‘production’ namespace”

Get Workload Details

“Get details of the workload named ‘example’ in namespace ‘production‘“

CURL Examples

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

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

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

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