Skip to content

including all json files and examples for system topics introduced by ARN#25848

Merged
lmazuel merged 35 commits intoAzure:mainfrom
Supriya-R-Dixit:sdixit/azureResourceNotifications
Sep 29, 2023
Merged

including all json files and examples for system topics introduced by ARN#25848
lmazuel merged 35 commits intoAzure:mainfrom
Supriya-R-Dixit:sdixit/azureResourceNotifications

Conversation

@Supriya-R-Dixit
Copy link
Copy Markdown
Member

@Supriya-R-Dixit Supriya-R-Dixit commented Sep 18, 2023

Data Plane API - Pull Request

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.

  • Link to API Spec engagement record issue:

Is this review for (select one):

  • a private preview
  • a public preview
  • GA release

Change Scope

This section will help us focus on the specific parts of your API that are new or have been modified.
Please share a link to the design document for the new APIs, a link to the previous API Spec document (if applicable), and the root paths that have been updated.

  • Design Document:
  • Previous API Spec Doc:
  • Updated paths:

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.

❔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

@openapi-pipeline-app
Copy link
Copy Markdown

openapi-pipeline-app bot commented Sep 18, 2023

Next Steps to Merge

Next steps that must be taken to merge this PR:
  • ❌ Your PR requires an API stewardship board review. See the PR description for help.
  • ❌ The required check named Automated merging requirements met has failed. This is the final check that must pass. Refer to the check in the PR's 'Checks' tab for details on how to fix it. In addition, refer to step 4 in the PR workflow diagram (even if your PR is for data plane, not ARM).

@openapi-pipeline-app
Copy link
Copy Markdown

openapi-pipeline-app bot commented Sep 18, 2023

Swagger Validation Report

️️✔️BreakingChange succeeded [Detail] [Expand]
There are no breaking changes.
️️✔️Breaking Change(Cross-Version) succeeded [Detail] [Expand]
There are no breaking changes.
️️✔️CredScan succeeded [Detail] [Expand]
There is no credential detected.
️⚠️LintDiff: 1 Warnings warning [Detail]
compared tags (via openapi-validator v2.1.5) new version base version
package-2023-06-01-preview package-2023-06-01-preview(d253b82) package-2023-06-01-preview(main)

[must fix]The following errors/warnings are introduced by current PR:

Rule Message Related RPC [For API reviewers]
⚠️ PropertyType Property should have a defined type.
Location: Microsoft.ResourceNotifications/stable/2018-01-01/common.json#L37
️️✔️Avocado succeeded [Detail] [Expand]
Validation passes for Avocado.
️❌SwaggerAPIView: 0 Errors, 0 Warnings failed [Detail]
️️✔️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).
️️✔️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?

@openapi-pipeline-app
Copy link
Copy Markdown

openapi-pipeline-app bot commented Sep 18, 2023

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

️️✔️ azure-sdk-for-net-track2 succeeded [Detail] [Expand]
  • ️✔️Succeeded [Logs]Release - Generate from 05ba8f2. SDK Automation 14.0.0
    command	pwsh ./eng/scripts/Automation-Sdk-Init.ps1 ../azure-sdk-for-net_tmp/initInput.json ../azure-sdk-for-net_tmp/initOutput.json
    command	pwsh ./eng/scripts/Invoke-GenerateAndBuildV2.ps1 ../azure-sdk-for-net_tmp/generateInput.json ../azure-sdk-for-net_tmp/generateOutput.json
  • ️✔️Azure.Messaging.EventGrid [View full logs]  [Release SDK Changes]
    info	[Changelog]
Posted by Swagger Pipeline | How to fix these errors?

@openapi-pipeline-app
Copy link
Copy Markdown

openapi-pipeline-app bot commented Sep 18, 2023

Generated ApiView

Language Package Name ApiView Link
.Net Azure.Messaging.EventGrid https://apiview.dev/Assemblies/Review/aeccab324ae74dd98751e2df7f53c2db

@openapi-workflow-bot
Copy link
Copy Markdown

Hi @Supriya-R-Dixit! 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.

- $(this-folder)/Microsoft.ResourceNotifications/stable/2018-01-01/Resources.json
- $(this-folder)/Microsoft.ResourceNotifications/stable/2018-01-01/HealthResources.json
- $(this-folder)/Microsoft.ResourceNotifications/stable/2018-01-01/MaintenanceResources.json

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: remove extra line breaks

"swagger": "2.0",
"info": {
"version": "2018-01-01",
"title": "Schema of Azure Resource Management events published to Azure Event Grid via Azure Resource Notifications",
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be pointing to health resources.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same for description.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Copy link
Copy Markdown
Member

@JoshLove-msft JoshLove-msft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! Thanks @Supriya-R-Dixit!

@lmazuel lmazuel merged commit 05ba8f2 into Azure:main Sep 29, 2023
@openapi-pipeline-app
Copy link
Copy Markdown

Swagger pipeline restarted successfully, please wait for status update in this comment.

@Supriya-R-Dixit Supriya-R-Dixit deleted the sdixit/azureResourceNotifications branch September 29, 2023 18:04
jnlycklama pushed a commit that referenced this pull request Nov 8, 2023
… ARN (#25848)

* including all json and examples for system topics introduced by ARN

* amended the readme file to include the json files for topic types

* including all json files

* included references to example json files

* corrected the examles folder name

* made changes to resources.json

* included common.json for common properties across all ARN event types

* testing $ref

* testing $ref

* changed $ref and braces around apiVersion

* changed "DateTime" to "dateTime"

* fixed dateTime

* dateTime need a pattern with string

* included format property for resourceeventtime

* created a common properties event for deleted events

* corrected the extra comma

* fixed prettier formatting

* corrected additionalproperties

* added cloud event schema samples

* renamed cloud events schema folder

* changes to cloud event schema folder

* included example for availability status changed under cloud events
schema folder

* ensured the eventdata has a verb in it

* removed "azure" from the common events naming

* changed names of the base event defintions

* removed the type filed under additional properties

* updated base event type names as suggested by reviewer

* removed files related to resources and maintenance resources as they
are not going public preview by 9/30

* removed references to maintenance and resources jsons

* modified the base event structure according to feedback

* fixed formatting issues.

* edited description an description and removed few  base events which are
not currently needed

* changed naming of the base event type as per feedback from Josh Love
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants