Full YAML schema missing

microsoft / azure-container-apps

Roadmap and issues for Azure Container Apps

MIT License

356 stars 27 forks source link

Full YAML schema missing #932

Open letmaik opened 8 months ago

letmaik commented 8 months ago

This issue is a: (mark with an x)

[ ] bug report -> please search issues before submitting
[x] documentation issue or request
[ ] regression (a behavior that used to work and stopped in a new release)

Issue description

https://learn.microsoft.com/en-gb/azure/container-apps/azure-resource-manager-api-spec?tabs=yaml#examples is not enough.

Also, lots of the data types in the tables say "object", which is not helpful.

jason-berk-k1x commented 7 months ago

also, the "job" yaml spec just links to the "app" spec and I don't think they are the same..... job documentation is lacking

hbuckle commented 4 months ago

This makes debugging extremely difficult - especially when the API returns terrible errors such as

Bad Request({"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"$":["The JSON value could not be converted to System.Boolean. Path: $ | LineNumber: 0 | BytePositionInLine: 4."]}})

This was due to properties.configuration.ingress.external being missing but there was no way to tell apart from trial and error.