* Getting Started on DevCentral
* Community Guidelines
* Community Terms of Use / EULA
* Community Ranking Explained
* Community Resources
* Contact the DevCentral Team
* Update MFA on account.f5.com

* Podcasts
* Social Channels
* Video Streaming

 

 

 

 

 

ABOUT DEVCENTRAL

DevCentral News Technical Forum Technical Articles Technical CrowdSRC Community Guidelines DevCentral EULA Get a Developer Lab License Become a DevCentral MVP

RESOURCES

Product Documentation White Papers Glossary Customer Stories Webinars Free Online Courses F5 Certification LearnF5 Training

SUPPORT

Manage Subscriptions Professional Services Professional Services Create a Service Request Software Downloads Support Portal

PARTNERS

Find a Reseller Partner Technology Alliances Become an F5 Partner Login to Partner Central

---

©2024 F5, Inc. All rights reserved.

Hi. In these docs we can find the endpoints and options for the REST API.

https://clouddocs.f5.com/api/icontrol-rest/

We don't find the models/specifications that these endpoints return. 

Eg. we can query for the list of pools. The answer contains the property 'loadBalancingMode'.

https://clouddocs.f5.com/api/icontrol-rest/APIRef_tm_ltm_pool.html

But where can we find the documented, complete list of values that this property can contain?

From the GUI we can assume the values would be similar to Round Robin, Ratio (member), Least Connections (member), ... 

But where are all possible values of all properties of all the models defined and documented?

Hi. In these docs we can find the endpoints and options for the REST API.

https://clouddocs.f5.com/api/icontrol-rest/

We don't find the models/specifications that these endpoints return. 

Eg. we can query for the list of pools. The answer contains the property 'loadBalancingMode'.

https://clouddocs.f5.com/api/icontrol-rest/APIRef_tm_ltm_pool.html

But where can we find the documented, complete list of values that this property can contain?

From the GUI we can assume the values would be similar to Round Robin, Ratio (member), Least Connections (member), ... 

But where are all possible values of all properties of all the models defined and documented?

Also, we might have found some inconsistencies. In the tmsh help for ltm pool members we find the following definition for 'state': 'up', 'down'.

However, from the API calls we get also values like 'user-down', 'user-up' and 'unchecked'. 

So, how can we get a complete list? The iControl REST API does not seem to simply be a tmsh wrapper. 

Thank you for clarifications. 

Also, we might have found some inconsistencies. In the tmsh help for ltm pool members we find the following definition for 'state': 'up', 'down'.

However, from the API calls we get also values like 'user-down', 'user-up' and 'unchecked'. 

So, how can we get a complete list? The iControl REST API does not seem to simply be a tmsh wrapper. 

Thank you for clarifications. 

ah...yes. That's true. It is a wrapper, but not a perfect one unfortunately, and the list you are looking for doesn't exist. We had a python project (https://github.com/F5Networks/f5-common-python/tree/development/f5/bigip) that is no longer actively maintained that attempted to smooth out these inconsistencies and you'll find the ones we managed in there. You'll also find some objects do things like this:

enabled: true and disabled: true

instead of:

enabled: true|false

So you'll need to pop attributes sometimes before resubmitting them for an update.

ah...yes. That's true. It is a wrapper, but not a perfect one unfortunately, and the list you are looking for doesn't exist. We had a python project (https://github.com/F5Networks/f5-common-python/tree/development/f5/bigip) that is no longer actively maintained that attempted to smooth out these inconsistencies and you'll find the ones we managed in there. You'll also find some objects do things like this:

enabled: true and disabled: true

instead of:

enabled: true|false

So you'll need to pop attributes sometimes before resubmitting them for an update.

Hi JRahm

Many thanks for this hint. In this way we can look up all possible values of some other properties as well. Cool!

However, we can't find the possible values of something like the node address: from testing the API we receive expected values like IPv4 addresses, but also '::0.0.0.0' and even 'any6'. Here, tmsh help doesn't seem to help. Where can we find a complete list of possible values?

, is there also a specification of the models themselves, eg. as an openapi specification or within a postman collection? 

Hi JRahm

Many thanks for this hint. In this way we can look up all possible values of some other properties as well. Cool!

However, we can't find the possible values of something like the node address: from testing the API we receive expected values like IPv4 addresses, but also '::0.0.0.0' and even 'any6'. Here, tmsh help doesn't seem to help. Where can we find a complete list of possible values?

, is there also a specification of the models themselves, eg. as an openapi specification or within a postman collection? 

Hi traphix , unfortunately the iControl REST online documentation is a little shy on those details, but if you look at the tmsh man pages (tmsh help ltm pool at the BIG-IP command line) you'll get this list:

load-balancing-mode [dynamic-ratio-member | dynamic-ratio-node |\n                              fastest-app-response | fastest-node |\n                              least-connections-members |\n                              least-connections-node |\n                              least-sessions |\n                              observed-member | observed-node |\n                              predictive-member | predictive-node |\n                              ratio-least-connections-member |\n                              ratio-least-connections-node |\n                              ratio-member | ratio-node | ratio-session |\n                              round-robin | weighted-least-connections-member |\n                              weighted-least-connections-node]

It's also in the AS3 schema for the Pool service (AS3 is just a declarative wrapper for tmsh, as iControl REST is an imperative wrapper for tmsh)

Hi , unfortunately the iControl REST online documentation is a little shy on those details, but if you look at the tmsh man pages (tmsh help ltm pool at the BIG-IP command line) you'll get this list:

It's also in the AS3 schema for the Pool service (AS3 is just a declarative wrapper for tmsh, as iControl REST is an imperative wrapper for tmsh)