This message was deleted.
# azure
s
This message was deleted.
f
I don't know if this will fix your specific issue but I've found myself having to use the "preview" APIs to get latest MS API alignment. There will be differences here not aligned with the published API docs on pulumi.com.
👍 1
m
Yes, it’s probably due to Pulumi’s default Azure API version being too old. In this case, it’s 2020-12-01. AppServiceEnvironment in the latest stable API version seems to be v3. We’re aware that API versions are not documented right now in the azure native provider and we’re working on it.
👍 2
e
Is there a way for me to specify which MS API is used? Forgive me for being the newbie. I am coming over from Terraform. There are many things I like better in Pulumi but this is one that I am struggling with. Should my mindset be to use classic for while dabbling in native understanding that it is less developed? I thought the point of native is to get the latest. I think it my confusion or issue and there is something to learn here.
f
What platform/lang are you using?
e
TS
f
Prob something like
import * as foo from "@pulumi/azure-native/foo/v20220301";
at the top of your file.
👆 1
where
foo
is whatever service
(That's just a guess, I haven't tried it)
m
Native is stable and fully supported. The only issue is that these API version imports are not very discoverable right now.
e
Understood. I will play with that and thank you!
f
Yeah I totally found them by accident recently 🙂 (Doing azure stuff, have been traditionally AWS).
I needed to do same to set up
standard
tier front door cdn.
e
My issue did not end up being the API version after all. I just needed to specify kind: "ASEV3". Otherwise, it was creating a ASEV1 by default. This is another thing that I am struggling with. The 'possible' values of properties are not well documented, so we have to go search them out.
I hope to continue learning my way around, so I can contribute more and complain less. 🤣
i
I find myself 'by default' using the latest version of the api's. Some versions only support parts of the api surface though, so then I downgrade. As for documentation, I usually refer to the Microsoft ARM template documentation, only using the pulumi docs to get started with something.
If you stick with the 'default' namespaced versions, you'll get warnings from Microsoft that they will be depricated soon AND a not all the functionality is available.
m
We’ve let the default versions get a bit too old. We’re working on bumping them all up currently, although that’ll be a breaking change for users relying on the current default versions, so it’ll be a major version bump.
👍 1
e
@melodic-tomato-39005 Regarding Pulumi documentation, have you considered having an API version toggle like MS has for their dev documentation? That would be a great feature request I guess. With that, you would essentially document whatever default API version Pulumi is using in the current version but on toggle to a different version, provide documentation for how to utilize that version and any changes or additions in properties across different API versions.
m
Yep, for sure. Unfortunately, the size of the Azure docs makes it a bit harder than just adding a toggle, but it’s pretty high up in our plans.