Azure / Azure/azure-devops-cli-extension

[Feature Request] Missing documentation for `az devops invoke`

Open
#1,452 0 comments 3 reactions 0 assignees View on GitHub
Feature
Dominant language
Python
Stars
682
Forks
278
Avg merge
3d 23h
Merged PRs (30d)
3

Description

**Is your feature request related to a problem? Please describe.**
It's impossible to figure out the name of a resource for `az devops invoke`, there's no documentation and no way how to figure out the name from the rest api documentation.

**Describe the solution you'd like**
There should be a way how to figure out the correct `area` and `resource` for each REST api call.

**Additional context**

I wanted to use the `az devops invoke` command to get a list of leases for a build: https://learn.microsoft.com/en-us/rest/api/azure/devops/build/builds/get-retention-leases-for-build?view=azure-devops-rest-7.1

I tried to use `--resource leases`, but that failed. The correct resource is `buildleases`, I haven't found this documented anywhere, I had to modify the invoke.py source code to find the full list of all resource location.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.