-
Notifications
You must be signed in to change notification settings - Fork 5k
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
[Communication][Chat] Added new attachment type of "file" #23662
Conversation
…api-specs into jpeng/file-sharing-poc
Hi, @jpeng-ms 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. vscswagger@microsoft.com |
Swagger Validation Report
|
compared swaggers (via Oad v0.10.4)] | new version | base version |
---|---|---|
communicationserviceschat.json | 2023-07-01-preview(8c1f4f4) | 2023-07-01-preview(main) |
Rule | Message |
---|---|
1020 - AddedEnumValue |
The new version is adding enum value(s) 'teamsImage, file' from the old version. New: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1388:9 Old: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1385:9 |
1020 - AddedEnumValue |
The new version is adding enum value(s) 'teamsImage, file' from the old version. New: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1361:5 Old: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1360:5 |
️️✔️
Breaking Change(Cross-Version) succeeded [Detail] [Expand]
There are no breaking changes.
️️✔️
CredScan succeeded [Detail] [Expand]
There is no credential detected.
️⚠️
LintDiff: 0 Warnings warning [Detail]
compared tags (via openapi-validator v2.0.0) | new version | base version |
---|---|---|
package-chat-2023-07-01-preview | package-chat-2023-07-01-preview(8c1f4f4) | package-chat-2023-07-01-preview(main) |
The following errors/warnings exist before current PR submission:
Only 30 items are listed, please refer to log for more details.
Rule | Message |
---|---|
OperationIdNounVerb |
Per the Noun_Verb convention for Operation Ids, the noun 'Chat' should not appear after the underscore. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L781 |
OperationIdNounVerb |
Per the Noun_Verb convention for Operation Ids, the noun 'Chat' should not appear after the underscore. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L858 |
OperationIdNounVerb |
Per the Noun_Verb convention for Operation Ids, the noun 'ChatThread' should not appear after the underscore. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L934 |
OperationIdNounVerb |
Per the Noun_Verb convention for Operation Ids, the noun 'ChatThread' should not appear after the underscore. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1006 |
OperationIdNounVerb |
Per the Noun_Verb convention for Operation Ids, the noun 'Chat' should not appear after the underscore. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1069 |
HostParametersValidation |
The host parameter must be typed 'type 'string', format 'url''. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L1847 |
Path parameter should specify a maximum length (maxLength) and characters allowed (pattern). Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L20 |
|
Operation is missing a default response. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L45 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L52 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L59 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L66 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L73 |
|
Path parameter should specify a maximum length (maxLength) and characters allowed (pattern). Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L104 |
|
Operation is missing a default response. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L124 |
|
All success responses except 202 & 204 should define a response body. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L125 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L128 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L135 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L142 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L149 |
|
Path parameter should specify a maximum length (maxLength) and characters allowed (pattern). Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L178 |
|
Operation is missing a default response. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L198 |
|
Using post for a create operation is discouraged. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L199 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L205 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L212 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L219 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L226 |
|
Path parameter should specify a maximum length (maxLength) and characters allowed (pattern). Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L250 |
|
Operation is missing a default response. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L275 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L282 |
|
Error response should contain a x-ms-error-code header. Location: Chat/preview/2023-07-01-preview/communicationserviceschat.json#L289 |
️️✔️
Avocado succeeded [Detail] [Expand]
Validation passes for Avocado.
️️✔️
ApiReadinessCheck succeeded [Detail] [Expand]
️⚠️
~[Staging] ServiceAPIReadinessTest: 0 Warnings warning [Detail]
API Test is not triggered due to precheck failure. Check pipeline log for details.
️️✔️
SwaggerAPIView succeeded [Detail] [Expand]
️️✔️
CadlAPIView succeeded [Detail] [Expand]
️️✔️
TypeSpecAPIView succeeded [Detail] [Expand]
️️✔️
ModelValidation succeeded [Detail] [Expand]
Validation passes for ModelValidation.
️️✔️
SemanticValidation succeeded [Detail] [Expand]
Validation passes for SemanticValidation.
️️✔️
PoliCheck succeeded [Detail] [Expand]
Validation passed for PoliCheck.
️️✔️
PrettierCheck succeeded [Detail] [Expand]
Validation passes for PrettierCheck.
️️✔️
SpellCheck succeeded [Detail] [Expand]
Validation passes for SpellCheck.
️️✔️
Lint(RPaaS) succeeded [Detail] [Expand]
Validation passes for Lint(RPaaS).
️️✔️
CadlValidation succeeded [Detail] [Expand]
Validation passes for CadlValidation.
️️✔️
TypeSpec Validation succeeded [Detail] [Expand]
Validation passes for TypeSpec Validation.
️️✔️
PR Summary succeeded [Detail] [Expand]
Validation passes for Summary.
Swagger pipeline restarted successfully, please wait for status update in this comment. |
Generated ApiView
|
@JeffreyRichter @DominikMe we are introducing a new enum type to "attachment" with no other changes. So I was wondering if we could review this async without a meeting? Please let me know if you need any more information about this change. Thanks! |
Hi, @jpeng-ms. Your PR has no update for 14 days and it is marked as stale PR. If no further update for over 14 days, the bot will close the PR. If you want to refresh the PR, please remove |
Data Plane API - Pull Request
I have previously discussed this with @DominikMe and he told me we can overwrite the build failures. Also the APIs in 2023-07-01 have not been implemented not deployed, so adding this new enum won't affect any Contoso user.
Only change introduced in this API was to expand
AttachmentType
to include a new enums type offile
andteamsImage
:example payload from chat gateway:
API Info: The Basics
Most of the information about your service should be captured in the issue that serves as your API Spec engagement record.
Is this review for (select one):
Change Scope
adding a new enum type "file"
❔Got questions? Need additional info?? We are here to help!
Contact us!
The Azure API Review Board is dedicated to helping you create amazing APIs. You can read about our mission and learn more about our process on our wiki.
Click here for links to tools, specs, guidelines & other good stuff
Tooling
Guidelines & Specifications
Helpful Links