Deprecate system events from legacy eventgrid package (#45807)

Author: samvaity

eng/versioning/version_client.txt

@@ -142,7 +142,7 @@ com.azure:azure-maps-geolocation;1.0.0-beta.3;1.0.0-beta.4
 com.azure:azure-maps-render;2.0.0-beta.2;2.0.0-beta.3
 com.azure:azure-maps-route;1.0.0-beta.3;1.0.0-beta.4
 com.azure:azure-maps-search;2.0.0-beta.2;2.0.0-beta.3
-com.azure:azure-messaging-eventgrid;4.30.1;4.31.0-beta.1
+com.azure:azure-messaging-eventgrid;4.30.1;4.31.0
 com.azure:azure-messaging-eventgrid-systemevents;1.0.0-beta.2;1.0.0
 com.azure:azure-messaging-eventgrid-namespaces;1.1.4;1.2.0-beta.1
 com.azure:azure-messaging-eventgrid-cloudnative-cloudevents;1.0.0-beta.1;1.0.0-beta.2

sdk/eventgrid/azure-messaging-eventgrid-cloudnative-cloudevents/pom.xml

@@ -92,7 +92,7 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-messaging-eventgrid</artifactId>
-      <version>4.31.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventgrid;current} -->
+      <version>4.31.0</version> <!-- {x-version-update;com.azure:azure-messaging-eventgrid;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>

sdk/eventgrid/azure-messaging-eventgrid-systemevents/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Release History
 
-## 1.0.0 (2025-06-23)
+## 1.0.0 (2025-06-26)
 
 ### Features Added
 - First stable release of the azure-messaging-eventgrid-systemevents client library for Java, providing strongly-typed models for Azure Event Grid system events.

sdk/eventgrid/azure-messaging-eventgrid-systemevents/tsp-location.yaml

@@ -1,4 +1,4 @@
 directory: specification/eventgrid/Azure.Messaging.EventGrid.SystemEvents
-commit: 528afc8e7ace5f030a03fce5f361ded2bdf3438f
+commit: 793fd0656f99dc4d69cc4a24f0c64551442cd6c7
 repo: Azure/azure-rest-api-specs
 additionalDirectories:

sdk/eventgrid/azure-messaging-eventgrid/CHANGELOG.md

@@ -1,14 +1,9 @@
 # Release History
 
-## 4.31.0-beta.1 (Unreleased)
-
-### Features Added
+## 4.31.0 (2025-06-26)
 
 ### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
+- Deprecated system events from `azure-messaging-eventgrid` package. Users should migrate to the new `azure-messaging-eventgrid-systemevents` package for system events.
 
 ## 4.30.1 (2025-06-19)
 

sdk/eventgrid/azure-messaging-eventgrid/pom.xml

@@ -12,7 +12,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-messaging-eventgrid</artifactId>
-  <version>4.31.0-beta.1</version> <!-- {x-version-update;com.azure:azure-messaging-eventgrid;current} -->
+  <version>4.31.0</version> <!-- {x-version-update;com.azure:azure-messaging-eventgrid;current} -->
 
   <packaging>jar</packaging>
   <name>Microsoft Azure SDK for eventgrid</name>

sdk/eventgrid/azure-messaging-eventgrid/src/main/java/com/azure/messaging/eventgrid/systemevents/AcsCallEndReasonProperties.java

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) AutoRest Code Generator.
-
 package com.azure.messaging.eventgrid.systemevents;
 
 import com.azure.core.annotation.Fluent;
@@ -14,9 +13,14 @@
 
 /**
  * Schema of calling event reason properties.
+ * 
+ * @deprecated This class is deprecated and may be removed in future releases. System events are now available in the
+ * azure-messaging-eventgrid-systemevents package.
  */
 @Fluent
+@Deprecated
 public final class AcsCallEndReasonProperties implements JsonSerializable<AcsCallEndReasonProperties> {
+
     /*
      * Reason code for ending the call.
      */
@@ -44,7 +48,7 @@ public AcsCallEndReasonProperties() {
 
     /**
      * Get the code property: Reason code for ending the call.
-     * 
+     *
      * @return the code value.
      */
     @Generated
@@ -54,7 +58,7 @@ public Integer getCode() {
 
     /**
      * Set the code property: Reason code for ending the call.
-     * 
+     *
      * @param code the code value to set.
      * @return the AcsCallEndReasonProperties object itself.
      */
@@ -66,7 +70,7 @@ public AcsCallEndReasonProperties setCode(Integer code) {
 
     /**
      * Get the subCode property: Reason subcode for ending the call.
-     * 
+     *
      * @return the subCode value.
      */
     @Generated
@@ -76,7 +80,7 @@ public Integer getSubCode() {
 
     /**
      * Set the subCode property: Reason subcode for ending the call.
-     * 
+     *
      * @param subCode the subCode value to set.
      * @return the AcsCallEndReasonProperties object itself.
      */
@@ -88,7 +92,7 @@ public AcsCallEndReasonProperties setSubCode(Integer subCode) {
 
     /**
      * Get the phrase property: Reason for ending the call.
-     * 
+     *
      * @return the phrase value.
      */
     @Generated
@@ -98,7 +102,7 @@ public String getPhrase() {
 
     /**
      * Set the phrase property: Reason for ending the call.
-     * 
+     *
      * @param phrase the phrase value to set.
      * @return the AcsCallEndReasonProperties object itself.
      */
@@ -123,7 +127,7 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
 
     /**
      * Reads an instance of AcsCallEndReasonProperties from the JsonReader.
-     * 
+     *
      * @param jsonReader The JsonReader being read.
      * @return An instance of AcsCallEndReasonProperties if the JsonReader was pointing to an instance of it, or null if
      * it was pointing to JSON null.
@@ -136,7 +140,6 @@ public static AcsCallEndReasonProperties fromJson(JsonReader jsonReader) throws
             while (reader.nextToken() != JsonToken.END_OBJECT) {
                 String fieldName = reader.getFieldName();
                 reader.nextToken();
-
                 if ("code".equals(fieldName)) {
                     deserializedAcsCallEndReasonProperties.code = reader.getNullable(JsonReader::getInt);
                 } else if ("subCode".equals(fieldName)) {
@@ -147,7 +150,6 @@ public static AcsCallEndReasonProperties fromJson(JsonReader jsonReader) throws
                     reader.skipChildren();
                 }
             }
-
             return deserializedAcsCallEndReasonProperties;
         });
     }

sdk/eventgrid/azure-messaging-eventgrid/src/main/java/com/azure/messaging/eventgrid/systemevents/AcsCallEndedByKind.java

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) AutoRest Code Generator.
-
 package com.azure.messaging.eventgrid.systemevents;
 
 import com.azure.core.annotation.Generated;
@@ -10,8 +9,13 @@
 
 /**
  * The type of the call ended by.
+ * 
+ * @deprecated This class is deprecated and may be removed in future releases. System events are now available in the
+ * azure-messaging-eventgrid-systemevents package.
  */
+@Deprecated
 public final class AcsCallEndedByKind extends ExpandableStringEnum<AcsCallEndedByKind> {
+
     /**
      * Call end initiator is a participant.
      */
@@ -26,7 +30,7 @@ public final class AcsCallEndedByKind extends ExpandableStringEnum<AcsCallEndedB
 
     /**
      * Creates a new instance of AcsCallEndedByKind value.
-     * 
+     *
      * @deprecated Use the {@link #fromString(String)} factory method.
      */
     @Generated
@@ -36,7 +40,7 @@ public AcsCallEndedByKind() {
 
     /**
      * Creates or finds a AcsCallEndedByKind from its string representation.
-     * 
+     *
      * @param name a name to look for.
      * @return the corresponding AcsCallEndedByKind.
      */
@@ -47,7 +51,7 @@ public static AcsCallEndedByKind fromString(String name) {
 
     /**
      * Gets known AcsCallEndedByKind values.
-     * 
+     *
      * @return known AcsCallEndedByKind values.
      */
     @Generated

sdk/eventgrid/azure-messaging-eventgrid/src/main/java/com/azure/messaging/eventgrid/systemevents/AcsCallEndedByProperties.java

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) AutoRest Code Generator.
-
 package com.azure.messaging.eventgrid.systemevents;
 
 import com.azure.core.annotation.Fluent;
@@ -14,9 +13,14 @@
 
 /**
  * Schema of calling event endedby properties.
+ * 
+ * @deprecated This class is deprecated and may be removed in future releases. System events are now available in the
+ * azure-messaging-eventgrid-systemevents package.
  */
 @Fluent
+@Deprecated
 public final class AcsCallEndedByProperties implements JsonSerializable<AcsCallEndedByProperties> {
+
     /*
      * The communication identifier of the call ended by
      */
@@ -44,7 +48,7 @@ public AcsCallEndedByProperties() {
 
     /**
      * Get the communicationIdentifier property: The communication identifier of the call ended by.
-     * 
+     *
      * @return the communicationIdentifier value.
      */
     @Generated
@@ -54,7 +58,7 @@ public CommunicationIdentifierModel getCommunicationIdentifier() {
 
     /**
      * Set the communicationIdentifier property: The communication identifier of the call ended by.
-     * 
+     *
      * @param communicationIdentifier the communicationIdentifier value to set.
      * @return the AcsCallEndedByProperties object itself.
      */
@@ -66,7 +70,7 @@ public AcsCallEndedByProperties setCommunicationIdentifier(CommunicationIdentifi
 
     /**
      * Get the kind property: The type of the call ended by.
-     * 
+     *
      * @return the kind value.
      */
     @Generated
@@ -76,7 +80,7 @@ public AcsCallEndedByKind getKind() {
 
     /**
      * Set the kind property: The type of the call ended by.
-     * 
+     *
      * @param kind the kind value to set.
      * @return the AcsCallEndedByProperties object itself.
      */
@@ -88,7 +92,7 @@ public AcsCallEndedByProperties setKind(AcsCallEndedByKind kind) {
 
     /**
      * Get the name property: The name of the call ended by.
-     * 
+     *
      * @return the name value.
      */
     @Generated
@@ -98,7 +102,7 @@ public String getName() {
 
     /**
      * Set the name property: The name of the call ended by.
-     * 
+     *
      * @param name the name value to set.
      * @return the AcsCallEndedByProperties object itself.
      */
@@ -123,7 +127,7 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
 
     /**
      * Reads an instance of AcsCallEndedByProperties from the JsonReader.
-     * 
+     *
      * @param jsonReader The JsonReader being read.
      * @return An instance of AcsCallEndedByProperties if the JsonReader was pointing to an instance of it, or null if
      * it was pointing to JSON null.
@@ -136,7 +140,6 @@ public static AcsCallEndedByProperties fromJson(JsonReader jsonReader) throws IO
             while (reader.nextToken() != JsonToken.END_OBJECT) {
                 String fieldName = reader.getFieldName();
                 reader.nextToken();
-
                 if ("communicationIdentifier".equals(fieldName)) {
                     deserializedAcsCallEndedByProperties.communicationIdentifier
                         = CommunicationIdentifierModel.fromJson(reader);
@@ -148,7 +151,6 @@ public static AcsCallEndedByProperties fromJson(JsonReader jsonReader) throws IO
                     reader.skipChildren();
                 }
             }
-
             return deserializedAcsCallEndedByProperties;
         });
     }

sdk/eventgrid/azure-messaging-eventgrid/src/main/java/com/azure/messaging/eventgrid/systemevents/AcsCallEndedEventData.java

@@ -13,8 +13,12 @@
 
 /**
  * Schema of the Data property of an EventGridEvent for a Microsoft.Communication.CallEnded event.
+ * 
+ * @deprecated This class is deprecated and may be removed in future releases. System events are now available in the
+ * azure-messaging-eventgrid-systemevents package.
  */
 @Fluent
+@Deprecated
 public final class AcsCallEndedEventData extends AcsCallingEventProperties {
 
     /*