Merge pull request #2353 from microsoftgraph/WeeklyApiRefresh/2023101…

…01212

[v2] Weekly OpenApiDocs Refresh

config/ModuleMetadata.json

@@ -27,15 +27,15 @@
   "versions": {
     "authentication": {
       "prerelease": "",
-      "version": "2.7.0"
+      "version": "2.8.0"
     },
     "beta": {
       "prerelease": "",
-      "version": "2.7.0"
+      "version": "2.8.0"
     },
     "v1.0": {
       "prerelease": "",
-      "version": "2.7.0"
+      "version": "2.8.0"
     }
   }
 }

openApiDocs/beta/ChangeNotifications.yml

@@ -11,7 +11,7 @@ paths:
       tags:
         - subscriptions.subscription
       summary: List subscriptions
-      description: 'Retrieve a list of webhook subscriptions.  The content of the response depends on the context in which the app is calling; for details, see the scenarios in the Permissions section.'
+      description: 'Retrieve a list of webhook subscriptions. The content of the response depends on the context in which the app is calling; for details, see the scenarios in the Permissions section. This API is available in the following national cloud deployments.'
       externalDocs:
         description: Find more info here
         url: https://learn.microsoft.com/graph/api/subscription-list?view=graph-rest-1.0
@@ -58,7 +58,7 @@ paths:
       tags:
         - subscriptions.subscription
       summary: Create subscription
-      description: 'Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph. To identify the resources for which you can create subscriptions and the limitations on subscriptions, see Set up notifications for changes in resource data: Supported resources. Some resources support rich notifications, that is, notifications that include resource data. For more information about these resources, see Set up change notifications that include resource data: Supported resources.'
+      description: 'Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph. To identify the resources for which you can create subscriptions and the limitations on subscriptions, see Set up notifications for changes in resource data: Supported resources. Some resources support rich notifications, that is, notifications that include resource data. For more information about these resources, see Set up change notifications that include resource data: Supported resources. This API is available in the following national cloud deployments.'
       externalDocs:
         description: Find more info here
         url: https://learn.microsoft.com/graph/api/subscription-post-subscriptions?view=graph-rest-1.0
@@ -85,7 +85,7 @@ paths:
       tags:
         - subscriptions.subscription
       summary: Get subscription
-      description: Retrieve the properties and relationships of a subscription. See the table in the Permissions section for the list of resources that support subscribing to change notifications.
+      description: Retrieve the properties and relationships of a subscription. See the table in the Permissions section for the list of resources that support subscribing to change notifications. This API is available in the following national cloud deployments.
       externalDocs:
         description: Find more info here
         url: https://learn.microsoft.com/graph/api/subscription-get?view=graph-rest-1.0
@@ -140,7 +140,7 @@ paths:
       tags:
         - subscriptions.subscription
       summary: Update subscription
-      description: 'Renew a subscription by extending its expiry time. The table in the Permissions section lists the resources that support subscribing to change notifications. Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See subscription for maximum length of a subscription for each resource type.'
+      description: 'Renew a subscription by extending its expiry time. The table in the Permissions section lists the resources that support subscribing to change notifications. Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See subscription for maximum length of a subscription for each resource type. This API is available in the following national cloud deployments.'
       externalDocs:
         description: Find more info here
         url: https://learn.microsoft.com/graph/api/subscription-update?view=graph-rest-1.0
@@ -175,7 +175,7 @@ paths:
       tags:
         - subscriptions.subscription
       summary: Delete subscription
-      description: 'Delete a subscription. For the list of resources that support subscribing to change notifications, see the table in the Permissions section.'
+      description: 'Delete a subscription. For the list of resources that support subscribing to change notifications, see the table in the Permissions section. This API is available in the following national cloud deployments.'
       externalDocs:
         description: Find more info here
         url: https://learn.microsoft.com/graph/api/subscription-delete?view=graph-rest-1.0
@@ -206,7 +206,7 @@ paths:
       tags:
         - subscriptions.Actions
       summary: Invoke action reauthorize
-      description: Reauthorize a subscription when you receive a reauthorizationRequired challenge.
+      description: Reauthorize a subscription when you receive a reauthorizationRequired challenge. This API is available in the following national cloud deployments.
       externalDocs:
         description: Find more info here
         url: https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
@@ -243,7 +243,7 @@ components:
               description: 'Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: created, updated, deleted. Multiple values can be combined using a comma-separated list. Note:  Drive root item and list change notifications support only the updated changeType. User and group change notifications support updated and deleted changeType. Use updated to receive notifications when user or group is created, updated or soft deleted.  Use deleted to receive notifications when user or group is permanently deleted.'
             clientState:
               type: string
-              description: Required. Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification.
+              description: Optional. Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification.
               nullable: true
             creatorId:
               type: string