APIc Toolkit needs to document the support for version specific product:list requests

The documentation for the APIc Toolkit products:list command suggests this syntax be used:

./apic-slim products:list --scope catalog --server api.ef29-9c0b91ad.us-east.apiconnect.cloud.ibm.com -o appdev-iam-apic-role-testing -c patmc cfapi-version-list-test

cfapi-version-list-test:1.0.1 [state: published] https://api.ef29-9c0b91ad.us-east.apiconnect.cloud.ibm.com/api/catalogs/d6f9d822-4eb1-4bee-a874-e4d9435b76e3/996475b0-1f42-4484-990e-0a0701933413/products/e4b9bd6a-9596-4b02-bc48-ea728c951f4a

cfapi-version-list-test:1.0.0 [state: published] https://api.ef29-9c0b91ad.us-east.apiconnect.cloud.ibm.com/api/catalogs/d6f9d822-4eb1-4bee-a874-e4d9435b76e3/996475b0-1f42-4484-990e-0a0701933413/products/40b71c9a-d1a7-487f-a774-7bce6d436e80

The ability to understand what the state of a specific product version is a requirement for the creation of robust CI/CD scripts for Product/API management. The products:get command accepts a product:version parameter, but that command does not provide state information (e.g. published).

An "undocumented feature" in the APIc Toolkit allows for the use of a parameter that includes both product name and version [as product/version], with the desired results in the response:

./apic-slim products:list --scope catalog --server api.ef29-9c0b91ad.us-east.apiconnect.cloud.ibm.com -o appdev-iam-apic-role-testing -c patmc cfapi-version-list-test/1.0.1 --output - --fields title,version,state

title: cfapi-version-list-test

version: 1.0.1

state: published

This "undocumented feature" should be documented. As part of that, adding the ability to use the same syntax seen elsewhere in the APIc Toolkit, to the products:list command (e.g. product:version), should be considered.

NET: Good CI/CD scripts require this function; clients would like to know this capability is supported by having it described in the APIc Toolkit documentation.

Note: This RFE was opened as part of an IBM Cloud support conversation with a client team that uses APIc and manages their environment using smart CI/CD scripts. Created here as this RFE needs to be visible to that client, and possibly others, so that they may vote for it.