Azure / Azure/azure-cli

Customer feedback | az cognitiveservices | List Deployed OpenAI models

Open
#29,883 1 comment 0 reactions 0 assignees View on GitHub
act-codegen-extensibility-squad Auto-Assign bug Cognitive Services Service Attention
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

### Describe the bug

This GitHub issue is being moved from MicrosoftDocs/azure-docs-cli [GitHub issue 4600](https://github.com/MicrosoftDocs/azure-docs-cli/issues/4600) so the engineering team can respond.

### Request:
Please provide more description information on the [az cognitiveservices account list-models](https://learn.microsoft.com/en-us/cli/azure/cognitiveservices/account#az-cognitiveservices-account-list-models) command. Currently the long-summary reads "This article lists the Azure CLI commands for Azure Cognitive Services account and subscription management only..." This is a bit confusing as the long-summary is supposed to provide helpful information on the Azure CLI __reference command__. What __article__ is this statement refering to?

The customer is expressing confusion between `available` and `deployed` models yet these words are not present in the short or long summary.
![image](https://github.com/user-attachments/assets/64b4928d-d6d5-4ed1-8cd5-b58e8d1c49a5)

The link for `https://docs.microsoft.com/azure/cognitive-services/` takes the customer to the Azure Cognitive Service landing page ...
![image](https://github.com/user-attachments/assets/fb95f176-f259-477d-8f19-bfea31dd8c49)

...I personally wish that every Azure CLI reference command provided a link to the Azure service, but as of 2024-09-11, I'm not finding a conceptual article that uses this reference command in a code block. How should the customer find more information on listing models for an accont from the service landing page?

************************************************

### Type of issue

Missing or misleading content

### Feedback

I find the information for the command a bit misleading, since the command:

`az cognitiveservices account list-models -n NAME -g RG` lists the AVAILABLE open ai models, and not the deployed models for the specific resource as it would be expected.

It would be far more useful if this command would also have a flag for deployed models only, and would work on subcription level - i.e. I want to see all OpenAI endpoints and their respective deployed models in subscription 99999999999999999.

Is this on the roadmap?

### Page URL

https://learn.microsoft.com/en-us/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-list

### Content source URL

https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/cognitiveservices/account.yml

### Related command

az cognitiveservices account list-models

### Errors

n/a

### Issue script & Debug output

n/a

### Expected behavior

n/a

### Environment Summary

Azure CLI 2.64.0

### Additional context

_No response_

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.