`extract` reports extraction errors / exits with code 1 for APIs using `set-body template="liquid"` with `{{ }}` expressions
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Accessibilité débutants
- 58/100
- Type d'issue
- Bug
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- azure, typescript
Piste de recherche
Commencez par exécuter la commande apiops extract signalée sur une stratégie d’API contenant set-body template="liquid" avec des expressions {{ }}, en utilisant la journalisation de débogage pour suivre les recherches de named values. Suivez le chemin d’extraction qui analyse les expressions de stratégie et vérifiez que les expressions Liquid ne sont pas traitées comme des named values. C’est terminé lorsque l’extraction signale zéro erreur et se termine avec le code 0 lorsque les ressources d’API référencées sont valides.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Command that triggered the bug
apiops extract --log-level debug --resource-group --service-name --output ./artifacts --filter ./configuration.extractor.yaml --subscription-id --remove-stale
Expected behavior
Extraction completes with exit code 0 for an API whose policy uses set-body template="liquid" to build or transform a request/response body, as long as the API and its real named values/backends actually exist and are reachable.
Actual behavior
The extraction otherwise finishes fine. All APIs, operations, and real named values get written to the output directory. But the run still reports errors and exits with code 1:
[INFO] Extraction complete: 19 resources extracted, 4 errors
With --log-level debug on, I can see the CLI issuing GET .../namedValues/<value> requests where <value> isn't a named value at all. It looks like it was pulled straight out of a {{ ... }} expression inside one of our set-body template="liquid"> blocks:
[DEBUG] HTTP GET https://management.azure.com/.../namedValues/context.Request.MatchedParameters%5B%22id%22%5D?api-version=2025-09-01-preview
[DEBUG] HTTP GET https://management.azure.com/.../namedValues/body.envelope.body.Test_Result.test?api-version=2025-09-01-preview
[DEBUG] HTTP GET https://management.azure.com/.../namedValues/body.envelope.body.fault.faultcode?api-version=2025-09-01-preview
[DEBUG] HTTP GET https://management.azure.com/.../namedValues/body.envelope.body.fault.faultstring?api-version=2025-09-01-preview
None of those are named values in our APIM instance. They're Liquid interpolation expressions from a set-body template="liquid" policy we use to build a SOAP request and reshape the SOAP response into JSON. Each lookup 404s, and each 404 seems to get counted toward the "errors" total. That matches up exactly: 4 Liquid expressions, 4 reported errors. The nonzero exit code then fails our CI pipeline step even though nothing is actually broken or missing.
To work around this we rewrote the affected set-body template="liquid"> blocks as plain C# expressions (<set-body>@{ ... return ...; }</set-body>) instead of Liquid templates. That removed the {{ }} syntax from the policy entirely, and the same extraction now completes with 0 errors and exit code 0. But with the Liquid template the policy would be easier to read and understand.
apiops CLI version
1.0.1
Environment details
- Azure DevOps pipeline, Ubuntu 24.04 hosted agent
- Node.js 24.x
apiops extractinvoked vianpx, with--filterpointing at a YAML filter config- The affected API's policy has three
<set-body template="liquid">blocks: one building a SOAP request body (interpolating a template parameter), and two transforming the SOAP response into JSON (interpolating values pulled out of the parsed SOAP envelope)
CI/CD environment
Azure DevOps
Is this bug blocking you?
No
- Langage dominant
- TypeScript
- Étoiles
- 29
- Forks
- 10
- Merge moyen
- 1 j 14 h
- PR mergées (30 j)
- 22
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de Azure/apiops-cli
-
type:question
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
Azure/apiops-cli#277 ·
-
type:documentation
Difficulté 1/5 Moins d'une heure Accessibilité débutants 94/100
Azure/apiops-cli#250 ·
-
Documentation P2
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
Azure/apiops-cli#24 · 1 commentaire ·
-
type:bug
Difficulté 4/5 3-5 jours Accessibilité débutants 55/100
Azure/apiops-cli#291 ·
-
type:feature
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 30/100
Azure/apiops-cli#275 · 2 commentaires · 2 réactions ·
Toutes les issues de Azure/apiops-cli
Issues similaires
-
S: triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
-
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
-
fix(errors): EHOSTUNREACH from a happy-eyeballs connect is reported as a resolver error (STAMP-80) Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 90/100
snapshot-labs/stamp#666 ·
-
fix(api): prevent leaderboard SSE heartbeat from starting after disconnect during initial load Ouvertebug
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
GauravKarakoti/SecureFlow#1070 · 1 commentaire ·
-
feature:Languages/Translations good first issue ready Web
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
digitalfabrik/integreat-app#4394 ·