feat(product_catalog): add filter by API ID in the catalog API (#5459)

Co-authored-by: Yacine Fodil <105779815+yfodil@users.noreply.github.com>

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-product-catalog-product-list-usage.golden

@@ -12,6 +12,7 @@ ARGS:
   [zone]                    Filter products by zone.
   [datacenter]              Filter products by datacenter.
   [status.{index}]          The lists of filtered product status, if empty only products with status public_beta, general_availability, preview, end_of_new_features, end_of_growth, end_of_deployment, end_of_support, end_of_sale, end_of_life or retired will be returned. (unknown_status | public_beta | preview | general_availability | end_of_new_features | end_of_growth | end_of_deployment | end_of_support | end_of_sale | end_of_life | retired)
+  [api-ids.{index}]         Filter products by API IDs. Each ID is matched against product-specific identifiers: `dedibox.offer_id` (converted to string), `elastic_metal.offer_id`, `apple_silicon.server_type`, `instance.offer_id`, and `load_balancer.node.offer_id`. Products that do not support API ID filtering are excluded from the results. If empty, no filtering is applied.
 
 FLAGS:
   -h, --help                help for list

docs/commands/product-catalog.md

@@ -34,6 +34,7 @@ scw product-catalog product list [arg=value ...]
 | zone |  | Filter products by zone. |
 | datacenter |  | Filter products by datacenter. |
 | status.{index} | One of: `unknown_status`, `public_beta`, `preview`, `general_availability`, `end_of_new_features`, `end_of_growth`, `end_of_deployment`, `end_of_support`, `end_of_sale`, `end_of_life`, `retired` | The lists of filtered product status, if empty only products with status public_beta, general_availability, preview, end_of_new_features, end_of_growth, end_of_deployment, end_of_support, end_of_sale, end_of_life or retired will be returned. |
+| api-ids.{index} |  | Filter products by API IDs. Each ID is matched against product-specific identifiers: `dedibox.offer_id` (converted to string), `elastic_metal.offer_id`, `apple_silicon.server_type`, `instance.offer_id`, and `load_balancer.node.offer_id`. Products that do not support API ID filtering are excluded from the results. If empty, no filtering is applied. |
 
 
 

go.mod

@@ -25,7 +25,7 @@ require (
 	github.com/moby/buildkit v0.29.0
 	github.com/moby/go-archive v0.2.0
 	github.com/opencontainers/go-digest v1.0.0
-	github.com/scaleway/scaleway-sdk-go v1.0.0-beta.36.0.20260407090446-d29e7ae732bb
+	github.com/scaleway/scaleway-sdk-go v1.0.0-beta.36.0.20260407155337-c7324437042d
 	github.com/skratchdot/open-golang v0.0.0-20200116055534-eef842397966
 	github.com/spf13/cobra v1.10.2
 	github.com/spf13/pflag v1.0.10

go.sum

@@ -476,8 +476,8 @@ github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06 h1:OkMGxebDjyw0ULyrTYWeN0UNCCkmCWfjPnIA2W6oviI=
 github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06/go.mod h1:+ePHsJ1keEjQtpvf9HHw0f4ZeJ0TLRsxhunSI2hYJSs=
-github.com/scaleway/scaleway-sdk-go v1.0.0-beta.36.0.20260407090446-d29e7ae732bb h1:9XAQvVL7DigZy2SdWlW1FCA0BCo8vFtW6xaHiPTKL4g=
-github.com/scaleway/scaleway-sdk-go v1.0.0-beta.36.0.20260407090446-d29e7ae732bb/go.mod h1:SKcIU6lqwljcpjOlTnSfMFfURd/XT+08spQyqN9OTWA=
+github.com/scaleway/scaleway-sdk-go v1.0.0-beta.36.0.20260407155337-c7324437042d h1:9sT/BfLItlKOO2JpfrIjjV4I9+f1byWEBPob9CFYNDQ=
+github.com/scaleway/scaleway-sdk-go v1.0.0-beta.36.0.20260407155337-c7324437042d/go.mod h1:SKcIU6lqwljcpjOlTnSfMFfURd/XT+08spQyqN9OTWA=
 github.com/sclevine/spec v1.4.0 h1:z/Q9idDcay5m5irkZ28M7PtQM4aOISzOpj4bUPkDee8=
 github.com/sclevine/spec v1.4.0/go.mod h1:LvpgJaFyvQzRvc1kaDs0bulYwzC70PbiYjC4QnFHkOM=
 github.com/secure-systems-lab/go-securesystemslib v0.10.0 h1:l+H5ErcW0PAehBNrBxoGv1jjNpGYdZ9RcheFkB2WI14=

internal/namespaces/product_catalog/v2alpha1/product_catalog_cli.go

@@ -129,6 +129,13 @@ func productCatalogProductList() *core.Command {
 					"retired",
 				},
 			},
+			{
+				Name:       "api-ids.{index}",
+				Short:      `Filter products by API IDs. Each ID is matched against product-specific identifiers: ` + "`" + `dedibox.offer_id` + "`" + ` (converted to string), ` + "`" + `elastic_metal.offer_id` + "`" + `, ` + "`" + `apple_silicon.server_type` + "`" + `, ` + "`" + `instance.offer_id` + "`" + `, and ` + "`" + `load_balancer.node.offer_id` + "`" + `. Products that do not support API ID filtering are excluded from the results. If empty, no filtering is applied.`,
+				Required:   false,
+				Deprecated: false,
+				Positional: false,
+			},
 		},
 		Run: func(ctx context.Context, args any) (i any, e error) {
 			request := args.(*product_catalog.PublicCatalogAPIListPublicCatalogProductsRequest)