Azure / Azure/apiops-cli

Docs example says products are auto-included transitively, but they aren't extracted with `products: []`

Aperta Adatta ai principianti
#277 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
type:question
Lingua principale
TypeScript
Stelle
26
Fork
9
Merge medio
1g 3h
PR unite (30g)
20

Descrizione

### Question

The[filtering guide](https://github.com/Azure/apiops-cli/blob/b327e6382385f530784f93f646f9b550eba6fe25/docs/guides/filtering-resources.md) has this example under "Transitive Dependency Behavior":

```yaml
apis:
- petstore-api
```

> And petstore-api is assigned to:
> - Product starter → auto-included
> - Tag production → auto-included
>
> The extract output includes all of these, even though only apiNames was specified in the filter.

I set up a filter based on the "How To: Extract Just One API" section on the same page, which lists only version sets, backends, named values, policy fragments, and tags as auto-included when their keys are set to `[]`, and does not mention products:

```yaml
apis:
- my-api-1
- my-api-2
backends: []
namedValues: []
products: []
tags: []
versionSets: []
loggers: []
diagnostics: []
groups: []
policyFragments: []
gateways: []
schemas: []
subscriptions: []
policies: []
policyRestrictions: []
documentations: []
workspaces: []
```

After running `apiops extract` with this filter, the `products` folder is empty. I confirmed directly against the APIM instance that both APIs are still assigned to their respective products, so the association exists and just isn't showing up in the extract output.

Did I misunderstand something about how the filter or `--filter`/transitive resolution is supposed to work here, or is the "Products containing the API" line in the Transitive Dependency Behavior example not accurate for the current release?

### Context

`@azure-tools/apiops-cli` version `1.0.1`. Filter file only sets `apis:` with two explicit API names and `products: []`, no `--no-transitive` flag passed to `apiops extract`.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Read docs/guides/filtering-resources.md, especially the “Transitive Dependency Behavior” and “How To: Extract Just One API” sections. Reproduce the issue with apiops extract, version 1.0.1, and the filter shown; done means the documentation accurately describes whether products are included when products: [] is set.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
azure
Ambito
cli, documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Attiva
Chiarezza
Abbastanza chiara
Idoneità per principianti
76/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.