Skip to content
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] Promote file attachment type from Beta -> GA #27395

Merged
merged 7 commits into from
Feb 20, 2024

Conversation

emlynmac
Copy link
Member

@emlynmac emlynmac commented Jan 16, 2024

Data Plane API - Pull Request

Previous PR with beta version:
#23662

API Info: The Basics

GA release of the beta API, previously reviewed and approved. No additional changes.

  • Link to API Spec engagement record issue:

Is this review for (select one):

  • a private preview
  • a public preview
  • GA release

Change Scope

FileAttachmentType gains type "file" to GA.

Viewing API changes

For convenient view of the API changes made by this PR, refer to the URLs provided in the table
in the Generated ApiView comment added to this PR. You can use ApiView to show API versions diff.

Suppressing failures

If one or multiple validation error/warning suppression(s) is detected in your PR, please follow the
Swagger-Suppression-Process
to get approval.

Helpful Links

Checks stuck in `queued` state? If the PR CI checks appear to be stuck in `queued` state, please add a comment with contents `/azp run`. This should result in a new comment denoting a `PR validation pipeline` has started and the checks should be updated after few minutes.

@emlynmac emlynmac requested a review from a team as a code owner January 16, 2024 19:23
@emlynmac emlynmac requested review from DominikMe and mikekistler and removed request for a team January 16, 2024 19:23
Copy link

openapi-pipeline-app bot commented Jan 16, 2024

Next Steps to Merge

✅ All automated merging requirements have been met! Refer to step 4 in the PR workflow diagram (even if your PR is for data plane, not ARM).

Copy link

openapi-pipeline-app bot commented Jan 16, 2024

Swagger Validation Report

️️✔️BreakingChange succeeded [Detail] [Expand]
There are no breaking changes.
️⚠️Breaking Change(Cross-Version): 5 Warnings warning [Detail]
compared swaggers (via Oad v0.10.4)] new version base version
communicationserviceschat.json 2024-03-07(45984f1) 2023-11-07(main)
communicationserviceschat.json 2024-03-07(45984f1) 2023-11-15-preview(main)

The following breaking changes are detected by comparison with the latest preview version:

Rule Message
⚠️ 1003 - RequestBodyFormatNoLongerSupported The new version does not support 'application/merge-patch+json' as a request body format.
New: Chat/stable/2024-03-07/communicationserviceschat.json#L1132:9
Old: Chat/preview/2023-11-15-preview/communicationserviceschat.json#L1132:9
⚠️ 1033 - RemovedProperty The new version is missing a property found in the old version. Was 'metadata' renamed or removed?
New: Chat/stable/2024-03-07/communicationserviceschat.json#L1342:7
Old: Chat/preview/2023-11-15-preview/communicationserviceschat.json#L1344:7
⚠️ 1033 - RemovedProperty The new version is missing a property found in the old version. Was 'metadata' renamed or removed?
New: Chat/stable/2024-03-07/communicationserviceschat.json#L1600:7
Old: Chat/preview/2023-11-15-preview/communicationserviceschat.json#L1609:7
⚠️ 1033 - RemovedProperty The new version is missing a property found in the old version. Was 'metadata' renamed or removed?
New: Chat/stable/2024-03-07/communicationserviceschat.json#L1624:7
Old: Chat/preview/2023-11-15-preview/communicationserviceschat.json#L1640:7
⚠️ 1033 - RemovedProperty The new version is missing a property found in the old version. Was 'metadata' renamed or removed?
New: Chat/stable/2024-03-07/communicationserviceschat.json#L1726:7
Old: Chat/preview/2023-11-15-preview/communicationserviceschat.json#L1749:7
️️✔️CredScan succeeded [Detail] [Expand]
There is no credential detected.
️⚠️LintDiff: 0 Warnings warning [Detail]
compared tags (via openapi-validator v2.1.6) new version base version
package-chat-2024-03-07 package-chat-2024-03-07(45984f1) default(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/stable/2024-03-07/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/stable/2024-03-07/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/stable/2024-03-07/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/stable/2024-03-07/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/stable/2024-03-07/communicationserviceschat.json#L1069
HostParametersValidation The host parameter must be typed 'type 'string', format 'url''.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L1782
⚠️ PathParameterSchema Path parameter should specify a maximum length (maxLength) and characters allowed (pattern).
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L20
⚠️ DefaultResponse Operation is missing a default response.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L45
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L52
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L59
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L66
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L73
⚠️ PathParameterSchema Path parameter should specify a maximum length (maxLength) and characters allowed (pattern).
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L104
⚠️ DefaultResponse Operation is missing a default response.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L124
⚠️ SuccessResponseBody All success responses except 202 & 204 should define a response body.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L125
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L128
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L135
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L142
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L149
⚠️ PathParameterSchema Path parameter should specify a maximum length (maxLength) and characters allowed (pattern).
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L178
⚠️ DefaultResponse Operation is missing a default response.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L198
⚠️ Post201Response Using post for a create operation is discouraged.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L199
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L205
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L212
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L219
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L226
⚠️ PathParameterSchema Path parameter should specify a maximum length (maxLength) and characters allowed (pattern).
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L250
⚠️ DefaultResponse Operation is missing a default response.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L275
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L282
⚠️ ErrorResponse Error response should contain a x-ms-error-code header.
Location: Chat/stable/2024-03-07/communicationserviceschat.json#L289
️️✔️Avocado succeeded [Detail] [Expand]
Validation passes for Avocado.
️️✔️SwaggerAPIView 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.
️️✔️SpellCheck succeeded [Detail] [Expand]
Validation passes for SpellCheck.
️️✔️Lint(RPaaS) succeeded [Detail] [Expand]
Validation passes for Lint(RPaaS).
️️✔️PR Summary succeeded [Detail] [Expand]
Validation passes for Summary.
️️✔️Automated merging requirements met succeeded [Detail] [Expand]
Posted by Swagger Pipeline | How to fix these errors?

Copy link

openapi-pipeline-app bot commented Jan 16, 2024

Swagger Generation Artifacts

️️✔️ApiDocPreview succeeded [Detail] [Expand]
 Please click here to preview with your @microsoft account. 
️️✔️SDK Breaking Change Tracking succeeded [Detail] [Expand]

Breaking Changes Tracking

Posted by Swagger Pipeline | How to fix these errors?

Copy link

openapi-pipeline-app bot commented Jan 16, 2024

Generated ApiView

Language Package Name ApiView Link
Swagger Chat https://apiview.dev/Assemblies/Review/7de49151a2ee45d29d87eee0aa5da23b?revisionId=1b295f8a300347c08b956daa232c6ed7

@JeffreyRichter JeffreyRichter added the APIStewardshipBoard-SignedOff The Azure API Stewardship team has reviewed and approved the changes. label Jan 24, 2024
Copy link

Hi @emlynmac! For review efficiency consideration, when creating a new API version, it is required to place API specs of the base version in the first commit, and push new version updates into successive commits. You can use OpenAPIHub to initialize the PR for adding a new version.
For more details refer to the wiki.

@microsoft-github-policy-service microsoft-github-policy-service bot added no-recent-activity There has been no recent activity on this issue. and removed no-recent-activity There has been no recent activity on this issue. labels Feb 19, 2024
@jhendrixMSFT jhendrixMSFT merged commit e35023d into main Feb 20, 2024
31 checks passed
@jhendrixMSFT jhendrixMSFT deleted the jpeng-ms-communication-Chat-2024-03-07 branch February 20, 2024 17:43
vxfield pushed a commit that referenced this pull request Mar 28, 2024
…27395)

* Adds base for updating Chat from version stable/2023-11-07 to version 2024-03-07

* Updates readme

* Updates API version in new specs and examples

* Update communicationserviceschat.json

* Update readme.md

* Update readme.md

* made tag names consistent

---------

Co-authored-by: John <109105353+jpeng-ms@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
APIStewardshipBoard-SignedOff The Azure API Stewardship team has reviewed and approved the changes. CI-MissingBaseCommit data-plane new-api-version
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants