Exposing reviewers properties on accessReviewInstance model

Author: shubhamguptacal

specification/authorization/resource-manager/Microsoft.Authorization/preview/2021-07-01-preview/authorization-AccessReviewCalls.json

@@ -376,6 +376,63 @@
             }
           }
         }
+      },
+      "put": {
+        "tags": [
+          "PutAccessReviewInstance"
+        ],
+        "operationId": "AccessReviewInstances_Create",
+        "x-ms-examples": {
+          "GetAccessReviews": {
+            "$ref": "./examples/PutAccessReviewInstance.json"
+          }
+        },
+        "description": "Update access review instance.",
+        "parameters": [
+          {
+            "name": "scheduleDefinitionId",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The id of the access review schedule definition."
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The id of the access review instance."
+          },
+          {
+            "name": "properties",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/AccessReviewInstanceProperties"
+            },
+            "description": "Access review instance properties."
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful update",
+            "schema": {
+              "$ref": "#/definitions/AccessReviewInstance"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/ErrorDefinition"
+            }
+          }
+        }
       }
     },
     "/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/accessReviewScheduleDefinitions/{scheduleDefinitionId}/instances/{id}/stop": {
@@ -1225,6 +1282,34 @@
           "format": "date-time",
           "description": "The DateTime when the review instance is scheduled to end.",
           "x-nullable": false
+        },
+        "reviewers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AccessReviewReviewer"
+          },
+          "description": "This is the collection of reviewers."
+        },
+        "backupReviewers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AccessReviewReviewer"
+          },
+          "description": "This is the collection of backup reviewers."
+        },
+        "reviewersType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "This field specifies the type of reviewers for a review. Usually for a review, reviewers are explicitly assigned. However, in some cases, the reviewers may not be assigned and instead be chosen dynamically. For example managers review or self review.",
+          "enum": [
+            "Assigned",
+            "Self",
+            "Managers"
+          ],
+          "x-ms-enum": {
+            "name": "AccessReviewInstanceReviewersType",
+            "modelAsString": true
+          }
         }
       },
       "description": "Access Review Instance properties."

specification/authorization/resource-manager/Microsoft.Authorization/preview/2021-07-01-preview/examples/PutAccessReviewInstance.json

@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "api-version": "2021-07-01-preview",
+    "subscriptionId": "fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
+    "scheduleDefinitionId": "fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
+    "id": "4135f961-be78-4005-8101-c72a5af307a2",
+    "properties": {},
+    "body": {
+      "properties": {
+        "status": "InProgress",
+        "startDateTime": "2018-08-03T21:02:30.667Z",
+        "endDateTime": "2018-08-03T21:17:30.513Z",
+        "reviewers": [
+          {
+            "principalId": "89ff94f6-029c-429c-9037-6cf4fe2f4a13",
+            "principalType": "group"
+          }
+        ],
+        "backupReviewers": [
+          {
+            "principalId": "fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
+            "principalType": "user"
+          }
+        ],
+        "reviewersType": "Assigned"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d/providers/Microsoft.Authorization/accessReviewScheduleDefinitions/fa73e90b-5bf1-45fd-a182-35ce5fc0674d/instances/4135f961-be78-4005-8101-c72a5af307a2",
+        "type": "Microsoft.Authorization/accessReviewScheduleDefinitions/instances",
+        "name": "4135f961-be78-4005-8101-c72a5af307a2",
+        "properties": {
+          "status": "InProgress",
+          "startDateTime": "2018-08-03T21:02:30.667Z",
+          "endDateTime": "2018-08-03T21:17:30.513Z",
+          "reviewers": [
+            {
+              "principalId": "89ff94f6-029c-429c-9037-6cf4fe2f4a13",
+              "principalType": "group"
+            }
+          ],
+          "backupReviewers": [
+            {
+              "principalId": "fa73e90b-5bf1-45fd-a182-35ce5fc0674d",
+              "principalType": "user"
+            }
+          ],
+          "reviewersType": "Assigned"
+        }
+      }
+    }
+  }
+}