azure_cognitiveservices_face 0.18.0 → 0.19.0

data/lib/1.0/generated/azure_cognitiveservices_face/large_person_group_operations.rb

@@ -25,7 +25,7 @@ module Azure::CognitiveServices::Face::V1_0
     # Create a new large person group with user-specified largePersonGroupId, name,
     # an optional userData and recognitionModel.
     # <br /> A large person group is the container of the uploaded person data,
-    # including face images and face recognition feature, and up to 1,000,000
+    # including face recognition feature, and up to 1,000,000
     # people.
     # <br /> After creation, use [LargePersonGroup Person -
     # Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40)
@@ -33,24 +33,30 @@ module Azure::CognitiveServices::Face::V1_0
     # Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4)
     # to get this group ready for [Face -
     # Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239).
-    # <br /> The person face, image, and userData will be stored on server until
-    # [LargePersonGroup Person -
+    # <br /> No image will be stored. Only the person's extracted face features and
+    # userData will be stored on server until [LargePersonGroup Person -
     # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
     # or [LargePersonGroup -
     # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
     # is called.
-    # <br />
-    # * Free-tier subscription quota: 1,000 large person groups.
-    # * S0-tier subscription quota: 1,000,000 large person groups.
-    # <br />
-    # 'recognitionModel' should be specified to associate with this large person
-    # group. The default value for 'recognitionModel' is 'recognition_01', if the
-    # latest model needed, please explicitly specify the model you need in this
-    # parameter. New faces that are added to an existing large person group will
-    # use the recognition model that's already associated with the collection.
+    # <br/>'recognitionModel' should be specified to associate with this large
+    # person group. The default value for 'recognitionModel' is 'recognition_01',
+    # if the latest model needed, please explicitly specify the model you need in
+    # this parameter. New faces that are added to an existing large person group
+    # will use the recognition model that's already associated with the collection.
     # Existing face features in a large person group can't be updated to features
     # extracted by another version of recognition model.
-    #
+    # * 'recognition_01': The default recognition model for [LargePersonGroup -
+    # Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d).
+    # All those large person groups created before 2019 March are bonded with this
+    # recognition model.
+    # * 'recognition_02': Recognition model released in 2019 March.
+    # 'recognition_02' is recommended since its overall accuracy is improved
+    # compared with 'recognition_01'.
+    #
+    # Large person group quota:
+    # * Free-tier subscription quota: 1,000 large person groups.
+    # * S0-tier subscription quota: 1,000,000 large person groups.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -71,7 +77,7 @@ module Azure::CognitiveServices::Face::V1_0
     # Create a new large person group with user-specified largePersonGroupId, name,
     # an optional userData and recognitionModel.
     # <br /> A large person group is the container of the uploaded person data,
-    # including face images and face recognition feature, and up to 1,000,000
+    # including face recognition feature, and up to 1,000,000
     # people.
     # <br /> After creation, use [LargePersonGroup Person -
     # Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40)
@@ -79,24 +85,30 @@ module Azure::CognitiveServices::Face::V1_0
     # Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4)
     # to get this group ready for [Face -
     # Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239).
-    # <br /> The person face, image, and userData will be stored on server until
-    # [LargePersonGroup Person -
+    # <br /> No image will be stored. Only the person's extracted face features and
+    # userData will be stored on server until [LargePersonGroup Person -
     # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
     # or [LargePersonGroup -
     # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
     # is called.
-    # <br />
-    # * Free-tier subscription quota: 1,000 large person groups.
-    # * S0-tier subscription quota: 1,000,000 large person groups.
-    # <br />
-    # 'recognitionModel' should be specified to associate with this large person
-    # group. The default value for 'recognitionModel' is 'recognition_01', if the
-    # latest model needed, please explicitly specify the model you need in this
-    # parameter. New faces that are added to an existing large person group will
-    # use the recognition model that's already associated with the collection.
+    # <br/>'recognitionModel' should be specified to associate with this large
+    # person group. The default value for 'recognitionModel' is 'recognition_01',
+    # if the latest model needed, please explicitly specify the model you need in
+    # this parameter. New faces that are added to an existing large person group
+    # will use the recognition model that's already associated with the collection.
     # Existing face features in a large person group can't be updated to features
     # extracted by another version of recognition model.
-    #
+    # * 'recognition_01': The default recognition model for [LargePersonGroup -
+    # Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d).
+    # All those large person groups created before 2019 March are bonded with this
+    # recognition model.
+    # * 'recognition_02': Recognition model released in 2019 March.
+    # 'recognition_02' is recommended since its overall accuracy is improved
+    # compared with 'recognition_01'.
+    #
+    # Large person group quota:
+    # * Free-tier subscription quota: 1,000 large person groups.
+    # * S0-tier subscription quota: 1,000,000 large person groups.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -117,7 +129,7 @@ module Azure::CognitiveServices::Face::V1_0
     # Create a new large person group with user-specified largePersonGroupId, name,
     # an optional userData and recognitionModel.
     # <br /> A large person group is the container of the uploaded person data,
-    # including face images and face recognition feature, and up to 1,000,000
+    # including face recognition feature, and up to 1,000,000
     # people.
     # <br /> After creation, use [LargePersonGroup Person -
     # Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40)
@@ -125,24 +137,30 @@ module Azure::CognitiveServices::Face::V1_0
     # Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4)
     # to get this group ready for [Face -
     # Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239).
-    # <br /> The person face, image, and userData will be stored on server until
-    # [LargePersonGroup Person -
+    # <br /> No image will be stored. Only the person's extracted face features and
+    # userData will be stored on server until [LargePersonGroup Person -
     # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
     # or [LargePersonGroup -
     # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
     # is called.
-    # <br />
-    # * Free-tier subscription quota: 1,000 large person groups.
-    # * S0-tier subscription quota: 1,000,000 large person groups.
-    # <br />
-    # 'recognitionModel' should be specified to associate with this large person
-    # group. The default value for 'recognitionModel' is 'recognition_01', if the
-    # latest model needed, please explicitly specify the model you need in this
-    # parameter. New faces that are added to an existing large person group will
-    # use the recognition model that's already associated with the collection.
+    # <br/>'recognitionModel' should be specified to associate with this large
+    # person group. The default value for 'recognitionModel' is 'recognition_01',
+    # if the latest model needed, please explicitly specify the model you need in
+    # this parameter. New faces that are added to an existing large person group
+    # will use the recognition model that's already associated with the collection.
     # Existing face features in a large person group can't be updated to features
     # extracted by another version of recognition model.
-    #
+    # * 'recognition_01': The default recognition model for [LargePersonGroup -
+    # Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d).
+    # All those large person groups created before 2019 March are bonded with this
+    # recognition model.
+    # * 'recognition_02': Recognition model released in 2019 March.
+    # 'recognition_02' is recommended since its overall accuracy is improved
+    # compared with 'recognition_01'.
+    #
+    # Large person group quota:
+    # * Free-tier subscription quota: 1,000 large person groups.
+    # * S0-tier subscription quota: 1,000,000 large person groups.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -206,6 +224,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -290,6 +310,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -394,6 +416,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -508,6 +532,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -590,6 +616,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -733,6 +761,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -843,6 +873,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end

data/lib/1.0/generated/azure_cognitiveservices_face/large_person_group_person.rb

@@ -116,6 +116,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -229,6 +231,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -263,8 +267,9 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete an existing person from a large person group. All stored person data,
-    # and face features in the person entry will be deleted.
+    # Delete an existing person from a large person group. The persistedFaceId,
+    # userData, person name and face feature in the person entry will all be
+    # deleted.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -279,8 +284,9 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete an existing person from a large person group. All stored person data,
-    # and face features in the person entry will be deleted.
+    # Delete an existing person from a large person group. The persistedFaceId,
+    # userData, person name and face feature in the person entry will all be
+    # deleted.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -295,8 +301,9 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete an existing person from a large person group. All stored person data,
-    # and face features in the person entry will be deleted.
+    # Delete an existing person from a large person group. The persistedFaceId,
+    # userData, person name and face feature in the person entry will all be
+    # deleted.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -343,6 +350,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -351,8 +360,8 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Retrieve a person's information, including registered persisted faces, name
-    # and userData.
+    # Retrieve a person's name and userData, and the persisted faceIds representing
+    # the registered person face feature.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -368,8 +377,8 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Retrieve a person's information, including registered persisted faces, name
-    # and userData.
+    # Retrieve a person's name and userData, and the persisted faceIds representing
+    # the registered person face feature.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -384,8 +393,8 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Retrieve a person's information, including registered persisted faces, name
-    # and userData.
+    # Retrieve a person's name and userData, and the persisted faceIds representing
+    # the registered person face feature.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -432,6 +441,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -547,6 +558,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -555,8 +568,11 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete a face from a person. Relative feature for the persisted face will
-    # also be deleted.
+    # Delete a face from a person in a large person group by specified
+    # largePersonGroupId, personId and persistedFaceId.
+    # <br /> Adding/deleting faces to/from a same person will be processed
+    # sequentially. Adding/deleting faces to/from different persons are processed
+    # in parallel.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -573,8 +589,11 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete a face from a person. Relative feature for the persisted face will
-    # also be deleted.
+    # Delete a face from a person in a large person group by specified
+    # largePersonGroupId, personId and persistedFaceId.
+    # <br /> Adding/deleting faces to/from a same person will be processed
+    # sequentially. Adding/deleting faces to/from different persons are processed
+    # in parallel.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -591,8 +610,11 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete a face from a person. Relative feature for the persisted face will
-    # also be deleted.
+    # Delete a face from a person in a large person group by specified
+    # largePersonGroupId, personId and persistedFaceId.
+    # <br /> Adding/deleting faces to/from a same person will be processed
+    # sequentially. Adding/deleting faces to/from different persons are processed
+    # in parallel.
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -642,6 +664,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -738,6 +762,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -858,6 +884,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -866,8 +894,51 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Add a representative face to a person for identification. The input face is
-    # specified as an image with a targetFace rectangle.
+    # Add a face to a person into a large person group for face identification or
+    # verification. To deal with an image contains multiple faces, input face can
+    # be specified as an image with a targetFace rectangle. It returns a
+    # persistedFaceId representing the added face. No image will be stored. Only
+    # the extracted face feature will be stored on server until [LargePersonGroup
+    # PersonFace -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3),
+    # [LargePersonGroup Person -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
+    # or [LargePersonGroup -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
+    # is called.
+    # <br /> Note persistedFaceId is different from faceId generated by [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236).
+    # * Higher face image quality means better recognition precision. Please
+    # consider high-quality faces: frontal, clear, and face size is 200x200 pixels
+    # (100 pixels between eyes) or bigger.
+    # * Each person entry can hold up to 248 faces.
+    # * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed
+    # image file size is from 1KB to 6MB.
+    # * "targetFace" rectangle should contain one face. Zero or multiple faces will
+    # be regarded as an error. If the provided "targetFace" rectangle is not
+    # returned from [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
+    # there’s no guarantee to detect and add the face successfully.
+    # * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or
+    # large occlusions will cause failures.
+    # * Adding/deleting faces to/from a same person will be processed sequentially.
+    # Adding/deleting faces to/from different persons are processed in parallel.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargePersonGroup Person
+    # - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/599adf2a3a7b9412a4d53f42).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -881,19 +952,68 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [PersistedFace] operation results.
     #
-    def add_face_from_url(large_person_group_id, person_id, url, user_data:nil, target_face:nil, custom_headers:nil)
-      response = add_face_from_url_async(large_person_group_id, person_id, url, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_url(large_person_group_id, person_id, url, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      response = add_face_from_url_async(large_person_group_id, person_id, url, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
     #
-    # Add a representative face to a person for identification. The input face is
-    # specified as an image with a targetFace rectangle.
+    # Add a face to a person into a large person group for face identification or
+    # verification. To deal with an image contains multiple faces, input face can
+    # be specified as an image with a targetFace rectangle. It returns a
+    # persistedFaceId representing the added face. No image will be stored. Only
+    # the extracted face feature will be stored on server until [LargePersonGroup
+    # PersonFace -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3),
+    # [LargePersonGroup Person -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
+    # or [LargePersonGroup -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
+    # is called.
+    # <br /> Note persistedFaceId is different from faceId generated by [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236).
+    # * Higher face image quality means better recognition precision. Please
+    # consider high-quality faces: frontal, clear, and face size is 200x200 pixels
+    # (100 pixels between eyes) or bigger.
+    # * Each person entry can hold up to 248 faces.
+    # * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed
+    # image file size is from 1KB to 6MB.
+    # * "targetFace" rectangle should contain one face. Zero or multiple faces will
+    # be regarded as an error. If the provided "targetFace" rectangle is not
+    # returned from [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
+    # there’s no guarantee to detect and add the face successfully.
+    # * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or
+    # large occlusions will cause failures.
+    # * Adding/deleting faces to/from a same person will be processed sequentially.
+    # Adding/deleting faces to/from different persons are processed in parallel.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargePersonGroup Person
+    # - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/599adf2a3a7b9412a4d53f42).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -907,18 +1027,67 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def add_face_from_url_with_http_info(large_person_group_id, person_id, url, user_data:nil, target_face:nil, custom_headers:nil)
-      add_face_from_url_async(large_person_group_id, person_id, url, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_url_with_http_info(large_person_group_id, person_id, url, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      add_face_from_url_async(large_person_group_id, person_id, url, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
     end
 
     #
-    # Add a representative face to a person for identification. The input face is
-    # specified as an image with a targetFace rectangle.
+    # Add a face to a person into a large person group for face identification or
+    # verification. To deal with an image contains multiple faces, input face can
+    # be specified as an image with a targetFace rectangle. It returns a
+    # persistedFaceId representing the added face. No image will be stored. Only
+    # the extracted face feature will be stored on server until [LargePersonGroup
+    # PersonFace -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3),
+    # [LargePersonGroup Person -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
+    # or [LargePersonGroup -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
+    # is called.
+    # <br /> Note persistedFaceId is different from faceId generated by [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236).
+    # * Higher face image quality means better recognition precision. Please
+    # consider high-quality faces: frontal, clear, and face size is 200x200 pixels
+    # (100 pixels between eyes) or bigger.
+    # * Each person entry can hold up to 248 faces.
+    # * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed
+    # image file size is from 1KB to 6MB.
+    # * "targetFace" rectangle should contain one face. Zero or multiple faces will
+    # be regarded as an error. If the provided "targetFace" rectangle is not
+    # returned from [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
+    # there’s no guarantee to detect and add the face successfully.
+    # * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or
+    # large occlusions will cause failures.
+    # * Adding/deleting faces to/from a same person will be processed sequentially.
+    # Adding/deleting faces to/from different persons are processed in parallel.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargePersonGroup Person
+    # - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/599adf2a3a7b9412a4d53f42).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -932,12 +1101,18 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param [Hash{String => String}] A hash of custom headers that will be added
     # to the HTTP request.
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def add_face_from_url_async(large_person_group_id, person_id, url, user_data:nil, target_face:nil, custom_headers:nil)
+    def add_face_from_url_async(large_person_group_id, person_id, url, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
       fail ArgumentError, '@client.endpoint is nil' if @client.endpoint.nil?
       fail ArgumentError, 'large_person_group_id is nil' if large_person_group_id.nil?
       fail ArgumentError, "'large_person_group_id' should satisfy the constraint - 'MaxLength': '64'" if !large_person_group_id.nil? && large_person_group_id.length > 64
@@ -971,7 +1146,7 @@ module Azure::CognitiveServices::Face::V1_0
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
           path_params: {'largePersonGroupId' => large_person_group_id,'personId' => person_id},
-          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(',')},
+          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(','),'detectionModel' => detection_model},
           body: request_content,
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -988,6 +1163,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -1006,8 +1183,51 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Add a representative face to a person for identification. The input face is
-    # specified as an image with a targetFace rectangle.
+    # Add a face to a person into a large person group for face identification or
+    # verification. To deal with an image contains multiple faces, input face can
+    # be specified as an image with a targetFace rectangle. It returns a
+    # persistedFaceId representing the added face. No image will be stored. Only
+    # the extracted face feature will be stored on server until [LargePersonGroup
+    # PersonFace -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3),
+    # [LargePersonGroup Person -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
+    # or [LargePersonGroup -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
+    # is called.
+    # <br /> Note persistedFaceId is different from faceId generated by [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236).
+    # * Higher face image quality means better recognition precision. Please
+    # consider high-quality faces: frontal, clear, and face size is 200x200 pixels
+    # (100 pixels between eyes) or bigger.
+    # * Each person entry can hold up to 248 faces.
+    # * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed
+    # image file size is from 1KB to 6MB.
+    # * "targetFace" rectangle should contain one face. Zero or multiple faces will
+    # be regarded as an error. If the provided "targetFace" rectangle is not
+    # returned from [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
+    # there’s no guarantee to detect and add the face successfully.
+    # * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or
+    # large occlusions will cause failures.
+    # * Adding/deleting faces to/from a same person will be processed sequentially.
+    # Adding/deleting faces to/from different persons are processed in parallel.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargePersonGroup Person
+    # - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/599adf2a3a7b9412a4d53f42).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -1021,19 +1241,68 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [PersistedFace] operation results.
     #
-    def add_face_from_stream(large_person_group_id, person_id, image, user_data:nil, target_face:nil, custom_headers:nil)
-      response = add_face_from_stream_async(large_person_group_id, person_id, image, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_stream(large_person_group_id, person_id, image, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      response = add_face_from_stream_async(large_person_group_id, person_id, image, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
     #
-    # Add a representative face to a person for identification. The input face is
-    # specified as an image with a targetFace rectangle.
+    # Add a face to a person into a large person group for face identification or
+    # verification. To deal with an image contains multiple faces, input face can
+    # be specified as an image with a targetFace rectangle. It returns a
+    # persistedFaceId representing the added face. No image will be stored. Only
+    # the extracted face feature will be stored on server until [LargePersonGroup
+    # PersonFace -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3),
+    # [LargePersonGroup Person -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
+    # or [LargePersonGroup -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
+    # is called.
+    # <br /> Note persistedFaceId is different from faceId generated by [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236).
+    # * Higher face image quality means better recognition precision. Please
+    # consider high-quality faces: frontal, clear, and face size is 200x200 pixels
+    # (100 pixels between eyes) or bigger.
+    # * Each person entry can hold up to 248 faces.
+    # * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed
+    # image file size is from 1KB to 6MB.
+    # * "targetFace" rectangle should contain one face. Zero or multiple faces will
+    # be regarded as an error. If the provided "targetFace" rectangle is not
+    # returned from [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
+    # there’s no guarantee to detect and add the face successfully.
+    # * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or
+    # large occlusions will cause failures.
+    # * Adding/deleting faces to/from a same person will be processed sequentially.
+    # Adding/deleting faces to/from different persons are processed in parallel.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargePersonGroup Person
+    # - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/599adf2a3a7b9412a4d53f42).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -1047,18 +1316,67 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def add_face_from_stream_with_http_info(large_person_group_id, person_id, image, user_data:nil, target_face:nil, custom_headers:nil)
-      add_face_from_stream_async(large_person_group_id, person_id, image, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_stream_with_http_info(large_person_group_id, person_id, image, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      add_face_from_stream_async(large_person_group_id, person_id, image, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
     end
 
     #
-    # Add a representative face to a person for identification. The input face is
-    # specified as an image with a targetFace rectangle.
+    # Add a face to a person into a large person group for face identification or
+    # verification. To deal with an image contains multiple faces, input face can
+    # be specified as an image with a targetFace rectangle. It returns a
+    # persistedFaceId representing the added face. No image will be stored. Only
+    # the extracted face feature will be stored on server until [LargePersonGroup
+    # PersonFace -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3),
+    # [LargePersonGroup Person -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2)
+    # or [LargePersonGroup -
+    # Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f)
+    # is called.
+    # <br /> Note persistedFaceId is different from faceId generated by [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236).
+    # * Higher face image quality means better recognition precision. Please
+    # consider high-quality faces: frontal, clear, and face size is 200x200 pixels
+    # (100 pixels between eyes) or bigger.
+    # * Each person entry can hold up to 248 faces.
+    # * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed
+    # image file size is from 1KB to 6MB.
+    # * "targetFace" rectangle should contain one face. Zero or multiple faces will
+    # be regarded as an error. If the provided "targetFace" rectangle is not
+    # returned from [Face -
+    # Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
+    # there’s no guarantee to detect and add the face successfully.
+    # * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or
+    # large occlusions will cause failures.
+    # * Adding/deleting faces to/from a same person will be processed sequentially.
+    # Adding/deleting faces to/from different persons are processed in parallel.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargePersonGroup Person
+    # - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/599adf2a3a7b9412a4d53f42).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
     #
     # @param large_person_group_id [String] Id referencing a particular large
     # person group.
@@ -1072,12 +1390,18 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param [Hash{String => String}] A hash of custom headers that will be added
     # to the HTTP request.
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def add_face_from_stream_async(large_person_group_id, person_id, image, user_data:nil, target_face:nil, custom_headers:nil)
+    def add_face_from_stream_async(large_person_group_id, person_id, image, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
       fail ArgumentError, '@client.endpoint is nil' if @client.endpoint.nil?
       fail ArgumentError, 'large_person_group_id is nil' if large_person_group_id.nil?
       fail ArgumentError, "'large_person_group_id' should satisfy the constraint - 'MaxLength': '64'" if !large_person_group_id.nil? && large_person_group_id.length > 64
@@ -1113,7 +1437,7 @@ module Azure::CognitiveServices::Face::V1_0
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
           path_params: {'largePersonGroupId' => large_person_group_id,'personId' => person_id},
-          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(',')},
+          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(','),'detectionModel' => detection_model},
           body: request_content,
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -1130,6 +1454,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin