Update docs to include required RBAC permissions (Roles/Actions)

[hrboyceiii]

As Azure services and supporting APIs evolve, it is becoming more difficult to follow and implement the practice granting least-privileged access. Many times, the only option is to grant r/w just so that teams can perform necessary operations (an example would be restarting an Azure Web App, VM, etc.) because it is very difficult to map operations to permissions.

Please consider including in the documentation for all automation libraries and commands the required permissions to perform the associated action. This will greatly simplify the task of evaluating and implementing custom RBAC roles for use in large enterprise organizations.

[markcowl]

@hrboyceiii I really like this idea - it would require documenting the required actions at the API level, so it is a longer-term project, but we might be able to do it shorter term for wel--used cmdlets.

[hrboyceiii]

@markcowl Great, thanks!

I was looking for a github repo for the rest api but it doesn't look like one exists (at least from the docs.microsoft.com site). Is there a place I can cross-post this request for that team? Or is that not necessary at this time?

[markcowl]

https://github.com/azure/azure-rest-api-specs

[hrboyceiii]

@markcowl Thanks.