-
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
Add personalizer v1.1-preview.1 swagger for SDK #14289
Add personalizer v1.1-preview.1 swagger for SDK #14289
Conversation
ormichae
commented
May 6, 2021
- Purpose of the update is to generate an SDK for a new Personalizer API version (v1.1preview.1)
- Will be offered in public preview starting after Build
- We will publish the swagger before the build conference
Hi, @ormichae Thanks for your PR. I am workflow bot for review process. Here are some small tips. Any feedback about review process or workflow bot, pls contact swagger and tools team. vsswagger@microsoft.com |
Swagger Validation Report
|
Rule | Message |
---|---|
OperationId has a noun that conflicts with one of the model names in definitions section. The model name will be disambiguated to 'EvaluationModel'. Consider using the plural form of 'Evaluation' to avoid this. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Personalizer/preview/v1.1-preview.1/Personalizer.json#L184 |
|
'body' parameter lacks 'description' property. Consider adding a 'description' element. Accurate description is essential for maintaining reference documentation. Location: Personalizer/preview/v1.1-preview.1/Personalizer.json#L192 |
The following errors/warnings exist before current PR submission:
Rule | Message |
---|---|
OperationId has a noun that conflicts with one of the model names in definitions section. The model name will be disambiguated to 'ServiceConfigurationModel'. Consider using the plural form of 'ServiceConfiguration' to avoid this. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Personalizer/preview/v1.1-preview.1/Personalizer.json#L21 |
|
OperationId has a noun that conflicts with one of the model names in definitions section. The model name will be disambiguated to 'ServiceConfigurationModel'. Consider using the plural form of 'ServiceConfiguration' to avoid this. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Personalizer/preview/v1.1-preview.1/Personalizer.json#L65 |
️️✔️
Avocado succeeded [Detail] [Expand]
Validation passes for Avocado.
️️✔️
ModelValidation succeeded [Detail] [Expand]
Validation passes for ModelValidation.
️️✔️
SemanticValidation succeeded [Detail] [Expand]
Validation passes for SemanticValidation.
️❌
Cross Version BreakingChange (Base on preview version): 1 Errors, 0 Warnings failed [Detail]
- Compared Swaggers (Based on Oad v0.8.9)
- original: preview/v1.0/Personalizer.json <---> new: preview/v1.1-preview.1/Personalizer.json
Rule | Message |
---|---|
1037 - ConstraintIsWeaker |
The new version has a less constraining 'enum' value than the previous one. New: Personalizer/preview/v1.1-preview.1/Personalizer.json#L954:9 Old: Personalizer/preview/v1.0/Personalizer.json#L163:9 |
️❌
Cross Version BreakingChange (Base on stable version): 2 Errors, 0 Warnings failed [Detail]
- Compared Swaggers (Based on Oad v0.8.9)
- original: stable/v1.0/Personalizer.json <---> new: preview/v1.1-preview.1/Personalizer.json
Rule | Message |
---|---|
1037 - ConstraintIsWeaker |
The new version has a less constraining 'enum' value than the previous one. New: Personalizer/preview/v1.1-preview.1/Personalizer.json#L954:9 Old: Personalizer/stable/v1.0/Personalizer.json#L694:9 |
1037 - ConstraintIsWeaker |
The new version has a less constraining 'enum' value than the previous one. New: Personalizer/preview/v1.1-preview.1/Personalizer.json#L1353:9 Old: Personalizer/stable/v1.0/Personalizer.json#L878:9 |
️️✔️
CredScan succeeded [Detail] [Expand]
There is no credential detected.
️️✔️
[Staging] SDK Track2 Validation succeeded [Detail] [Expand]
Validation passes for SDKTrack2Validation
- The following tags are being changed in this PR
|:speech_balloon: AutorestCore/Exception|"readme":"cognitiveservices/data-plane/Personalizer/readme.md",
"tag":"release_1_1_preview.1",
"details":"> Installing AutoRest extension '@microsoft.azure/openapi-validator' (1.8.0)"|
|:speech_balloon: AutorestCore/Exception|"readme":"cognitiveservices/data-plane/Personalizer/readme.md",
"tag":"release_1_1_preview.1",
"details":"> Installed AutoRest extension '@microsoft.azure/openapi-validator' (1.8.0->1.8.0)"|
|:speech_balloon: AutorestCore/Exception|"readme":"cognitiveservices/data-plane/Personalizer/readme.md",
"tag":"release_1_1_preview.1",
"details":"> Loading AutoRest extension '@autorest/modelerfour' (4.15.456->4.15.456)"|
️️✔️
[Staging] PrettierCheck succeeded [Detail] [Expand]
Validation passes for PrettierCheck.
️️✔️
[Staging] SpellCheck succeeded [Detail] [Expand]
Validation passes for SpellCheck.
[Call for Action] To better understand Azure service dev/test scenario, and support Azure service developer better on Swagger and REST API related tests in early phase, please help to fill in with this survey https://aka.ms/SurveyForEarlyPhase. It will take 5 to 10 minutes. If you already complete survey, please neglect this comment. Thanks. |
Thank you for your contribution ormichae! We will review the pull request and get back to you soon. |
Swagger Generation Artifacts
|
Rule | Message |
---|---|
RestBuild error |
"logUrl":"https://apidrop.visualstudio.com/Content%20CI/_build/results?buildId=214333&view=logs&j=fd490c07-0b22-5182-fac9-6d67fe1e939b", "detail":"Run.ps1 failed with exit code 1 " |
Hi @ormichae, Your PR has some issues. Please fix the CI sequentially by following the order of
|
@PhoenixHe-msft I think the |
@jianyexi to confirm the cross api breaking change result. |
This is allowed in new api version, please ignore it. |
@jianyexi are you saying this isn't a false positive? If so, can you please update the wiki with a description for this case as it's not clear why this specific change was flagged. |
* added swagger and examples for personalizer v1.1 preview * moved folder * added new version to readme * prettier changes * fixed breaking changes * removed custom words * changed endpoint name * prettier * custom word * custom words Co-authored-by: orenmichaely <35842001+orenmichaely@users.noreply.github.com>