search

Azure / azure-sdk-for-net

This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
MIT License
5.25k stars 4.58k forks source link

[QUERY] Get API Operation - what is 'tags' parameter? #45258

Closed oleg-shatin-ptech closed 1 week ago

oleg-shatin-ptech commented 1 month ago

Library name and version

Azure.ResourceManager.ApiManagement 1.2.0 (any version actually)

Query/Question

Hello! We are currently using HTTP API for management for APIMs. We fetch the list of apis and operations of these apis. Currently we specify the apiVersion=2019-01-01. Currently we use HTTP operation operationsByTags (not sure whether it exists in current docs) and using. Our issue is that this current response schema lacks the "parameters" field and it looks like migration to use endpoint /api/{api-id}/operations will get us these params.

The issue is that it's not clear what is tags query param for the HTTP API and for the library as well. I see that the default response doesn't return tags, and tags param in the docs says it can be used to "Include tags in the response", and that's what we actually need. The unclear part is: how to use this param? I thought it's a bool, but I got an empty response. Didn't found a word about it in more detail. Is it a filter? Could you guys pls provide some example on it?

Thank you.

Environment

No response

github-actions[bot] commented 1 month ago

Thank you for your feedback. Tagging and routing to the team member best able to assist.

welovej commented 2 weeks ago

could you provide some screen shots to illustrate your issues? I am little confused. @oleg-shatin-ptech

welovej commented 2 weeks ago
PixPin_2024-08-22_17-55-36 PixPin_2024-08-22_17-56-29

well I can not repro what you said, please check these two pics above. @oleg-shatin-ptech

oleg-shatin-ptech commented 2 weeks ago

@welovej I'm not reporting a behavioral issue, but rather asking for clarification, what is the purpose and usage example of the tags URI parameter for /operations/ endpoint from the docs. image

in our particular scenario, we need to get for each operation the list of tags AND the list of template parameters and I'm looking for the best way to do it.

welovej commented 1 week ago

@oleg-shatin-ptech
I knew your concerns and tried in many ways. It did have some problems with tags query parameter in this service endpoint whether I did as like 'tags= xxxtag' or 'tags=true'.

Thank you for reaching out to us about the Azure SDK for .NET. Unfortunately,This issue is related to the service side and not the SDK side, so we are not able to help you with it. Therefore, we are closing this issue for now. If you need more assistance, please open an Azure support request or open a rest-api-sepc issue. We apologize for any inconvenience this may cause you. We value your feedback and we want to make sure that your problem is solved. If you think that we have misunderstood your issue or closed it incorrectly, please feel free to comment on this thread and reopen the issue. We will be happy to assist you further. Thank you for your understanding and cooperation.