-
Notifications
You must be signed in to change notification settings - Fork 5.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Adding a new GET api in Microsoft.Network for ServiceTags, with pagination #11075
Conversation
[Staging] Swagger Validation Report
️✔️ |
Rule | Message |
---|---|
OBJECT_ADDITIONAL_PROPERTIES |
Additional properties not allowed: networkFeatures Url: Microsoft.Network/stable/2020-07-01/serviceTags.json#L180 |
OBJECT_ADDITIONAL_PROPERTIES |
Additional properties not allowed: state Url: Microsoft.Network/stable/2020-07-01/serviceTags.json#L180 |
️️✔️
SemanticValidation [Detail]
️✔️
Validation passes for SemanticValidation.
No pipelines are associated with this pull request. |
This is a draft PR for confirming the changes for adding a new service for getting ServiceTag details from NRP. This new api would support pagination, as per ARM-RP contract. |
@@ -73,6 +73,49 @@ | |||
} | |||
} | |||
} | |||
}, | |||
"/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/serviceTags/paged": { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure you should added new API for the paged version of serviceTags. Please look at other examples in NRP to evolve the existing API to support paging.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@chiragg4u So, as I discussed with you during office hours, https://stackoverflow.microsoft.com/questions/225823 , the current ServiceTag definition returned by api is a single object of structure:
public class ServiceTag {
public string Name { get; set; }
public string Id { get; set; }
public string Type { get; set; }
public string ChangeNumber { get; set; }
public string Cloud { get; set; }
public List<ServiceTagInformation> Values { get; set; }
}
And, the requirement is to paginate over the Values list , and not ServiceTag.
Hence, I plan to add a new definition ServiceTagsDetail, as per the PR.
If I change the definition returned by old api, it would break the existing workflow.
What do you suggest?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO adding a query parameter to get the optimal response would be better
/azp run |
Azure Pipelines successfully started running 3 pipeline(s). |
azure-sdk-for-go
|
azure-sdk-for-net
|
azure-sdk-for-js
|
Azure CLI Extension Generation
No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured
|
azure-sdk-for-python-track2
- Breaking Change detected in SDK
|
azure-sdk-for-java
|
Trenton Generation
No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured
|
No pipelines are associated with this pull request. |
/azp run |
Azure Pipelines successfully started running 3 pipeline(s). |
Hi, @guptas14. The PR has be closed for a long time and it's related branch still exist. If no further used for over 14 days, I will delete this related branch. Please tell me if you still need this branch. |
Hi, @guptas14. The PR has be closed for a long time and it's related branch still exist. Please tell me if you still need this branch or i will delete it in 14 days. |
2 similar comments
Hi, @guptas14. The PR has be closed for a long time and it's related branch still exist. Please tell me if you still need this branch or i will delete it in 14 days. |
Hi, @guptas14. The PR has be closed for a long time and it's related branch still exist. Please tell me if you still need this branch or i will delete it in 14 days. |
MSFT employees can try out our new experience at OpenAPI Hub - one location for using our validation tools and finding your workflow.
Contribution checklist:
If any further question about AME onboarding or validation tools, please view the FAQ.
ARM API Review Checklist
[ Y] Ensure to check this box if one of the following scenarios meet updates in the PR, so that label “WaitForARMFeedback” will be added automatically to involve ARM API Review. Failure to comply may result in delays for manifest application. Note this does not apply to data plane APIs, all “removals” and “adding a new property” no more require ARM API review.
If you are blocked on ARM review and want to get the PR merged with urgency, please get the ARM oncall for reviews (RP Manifest Approvers team under Azure Resource Manager service) from IcM and reach out to them.
Breaking Change Review Checklist
If there are following updates in the PR, ensure to request an approval from API Review Board as defined in the Breaking Change Policy.
Please follow the link to find more details on PR review process.