azure_cognitiveservices_face 0.16.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6648bdf2512575046c982df50d07e0127e54b459
+  data.tar.gz: ec848ceb96afb3fde854043a9651e0b36051f91c
+SHA512:
+  metadata.gz: 1013d4549baea2255821fb82845e491ec86750de8f1ec35ba312f8db91e9461bc11861fe821d7f0044e9ea637fa4d41ef13135ec102d4f12fb04541457ec3e38
+  data.tar.gz: b6fd153ddf17767e212dc5f14bf9aca2d01efed4dd87994264f66d51a60de51594276bebad42cdb8f064daba3f31c2c582bc7ef7a58626788e256a2a59ba44eb

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/lib/1.0/generated/azure_cognitiveservices_face.rb

@@ -0,0 +1,78 @@
+# encoding: utf-8
+# Code generated by Microsoft (R) AutoRest Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is
+# regenerated.
+
+require 'uri'
+require 'cgi'
+require 'date'
+require 'json'
+require 'base64'
+require 'erb'
+require 'securerandom'
+require 'time'
+require 'timeliness'
+require 'faraday'
+require 'faraday-cookie_jar'
+require 'concurrent'
+require 'ms_rest'
+require '1.0/generated/azure_cognitiveservices_face/module_definition'
+require 'ms_rest_azure'
+
+module Azure::CognitiveServices::Face::V1_0
+  autoload :Face,                                               '1.0/generated/azure_cognitiveservices_face/face.rb'
+  autoload :PersonGroupPerson,                                  '1.0/generated/azure_cognitiveservices_face/person_group_person.rb'
+  autoload :PersonGroupOperations,                              '1.0/generated/azure_cognitiveservices_face/person_group_operations.rb'
+  autoload :FaceListOperations,                                 '1.0/generated/azure_cognitiveservices_face/face_list_operations.rb'
+  autoload :FaceClient,                                         '1.0/generated/azure_cognitiveservices_face/face_client.rb'
+
+  module Models
+    autoload :FindSimilarRequest,                                 '1.0/generated/azure_cognitiveservices_face/models/find_similar_request.rb'
+    autoload :Error,                                              '1.0/generated/azure_cognitiveservices_face/models/error.rb'
+    autoload :SimilarFace,                                        '1.0/generated/azure_cognitiveservices_face/models/similar_face.rb'
+    autoload :FaceRectangle,                                      '1.0/generated/azure_cognitiveservices_face/models/face_rectangle.rb'
+    autoload :GroupRequest,                                       '1.0/generated/azure_cognitiveservices_face/models/group_request.rb'
+    autoload :FaceLandmarks,                                      '1.0/generated/azure_cognitiveservices_face/models/face_landmarks.rb'
+    autoload :GroupResult,                                        '1.0/generated/azure_cognitiveservices_face/models/group_result.rb'
+    autoload :HeadPose,                                           '1.0/generated/azure_cognitiveservices_face/models/head_pose.rb'
+    autoload :IdentifyRequest,                                    '1.0/generated/azure_cognitiveservices_face/models/identify_request.rb'
+    autoload :HairColor,                                          '1.0/generated/azure_cognitiveservices_face/models/hair_color.rb'
+    autoload :IdentifyCandidate,                                  '1.0/generated/azure_cognitiveservices_face/models/identify_candidate.rb'
+    autoload :Makeup,                                             '1.0/generated/azure_cognitiveservices_face/models/makeup.rb'
+    autoload :IdentifyResult,                                     '1.0/generated/azure_cognitiveservices_face/models/identify_result.rb'
+    autoload :Accessory,                                          '1.0/generated/azure_cognitiveservices_face/models/accessory.rb'
+    autoload :VerifyFaceToPersonRequest,                          '1.0/generated/azure_cognitiveservices_face/models/verify_face_to_person_request.rb'
+    autoload :Exposure,                                           '1.0/generated/azure_cognitiveservices_face/models/exposure.rb'
+    autoload :VerifyFaceToFaceRequest,                            '1.0/generated/azure_cognitiveservices_face/models/verify_face_to_face_request.rb'
+    autoload :FaceAttributes,                                     '1.0/generated/azure_cognitiveservices_face/models/face_attributes.rb'
+    autoload :VerifyResult,                                       '1.0/generated/azure_cognitiveservices_face/models/verify_result.rb'
+    autoload :APIError,                                           '1.0/generated/azure_cognitiveservices_face/models/apierror.rb'
+    autoload :PersistedFace,                                      '1.0/generated/azure_cognitiveservices_face/models/persisted_face.rb'
+    autoload :FacialHair,                                         '1.0/generated/azure_cognitiveservices_face/models/facial_hair.rb'
+    autoload :Coordinate,                                         '1.0/generated/azure_cognitiveservices_face/models/coordinate.rb'
+    autoload :Emotion,                                            '1.0/generated/azure_cognitiveservices_face/models/emotion.rb'
+    autoload :Occlusion,                                          '1.0/generated/azure_cognitiveservices_face/models/occlusion.rb'
+    autoload :Noise,                                              '1.0/generated/azure_cognitiveservices_face/models/noise.rb'
+    autoload :ImageUrl,                                           '1.0/generated/azure_cognitiveservices_face/models/image_url.rb'
+    autoload :Hair,                                               '1.0/generated/azure_cognitiveservices_face/models/hair.rb'
+    autoload :NameAndUserDataContract,                            '1.0/generated/azure_cognitiveservices_face/models/name_and_user_data_contract.rb'
+    autoload :DetectedFace,                                       '1.0/generated/azure_cognitiveservices_face/models/detected_face.rb'
+    autoload :UpdatePersonFaceRequest,                            '1.0/generated/azure_cognitiveservices_face/models/update_person_face_request.rb'
+    autoload :Blur,                                               '1.0/generated/azure_cognitiveservices_face/models/blur.rb'
+    autoload :TrainingStatus,                                     '1.0/generated/azure_cognitiveservices_face/models/training_status.rb'
+    autoload :FaceList,                                           '1.0/generated/azure_cognitiveservices_face/models/face_list.rb'
+    autoload :PersonGroup,                                        '1.0/generated/azure_cognitiveservices_face/models/person_group.rb'
+    autoload :Person,                                             '1.0/generated/azure_cognitiveservices_face/models/person.rb'
+    autoload :Gender,                                             '1.0/generated/azure_cognitiveservices_face/models/gender.rb'
+    autoload :GlassesType,                                        '1.0/generated/azure_cognitiveservices_face/models/glasses_type.rb'
+    autoload :HairColorType,                                      '1.0/generated/azure_cognitiveservices_face/models/hair_color_type.rb'
+    autoload :AccessoryType,                                      '1.0/generated/azure_cognitiveservices_face/models/accessory_type.rb'
+    autoload :BlurLevel,                                          '1.0/generated/azure_cognitiveservices_face/models/blur_level.rb'
+    autoload :ExposureLevel,                                      '1.0/generated/azure_cognitiveservices_face/models/exposure_level.rb'
+    autoload :NoiseLevel,                                         '1.0/generated/azure_cognitiveservices_face/models/noise_level.rb'
+    autoload :FindSimilarMatchMode,                               '1.0/generated/azure_cognitiveservices_face/models/find_similar_match_mode.rb'
+    autoload :TrainingStatusType,                                 '1.0/generated/azure_cognitiveservices_face/models/training_status_type.rb'
+    autoload :FaceAttributeType,                                  '1.0/generated/azure_cognitiveservices_face/models/face_attribute_type.rb'
+    autoload :AzureRegions,                                       '1.0/generated/azure_cognitiveservices_face/models/azure_regions.rb'
+  end
+end

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

@@ -0,0 +1,955 @@
+# encoding: utf-8
+# Code generated by Microsoft (R) AutoRest Code Generator.
+# Changes may cause incorrect behavior and will be lost if the code is
+# regenerated.
+
+module Azure::CognitiveServices::Face::V1_0
+  #
+  # An API for face detection, verification, and identification.
+  #
+  class Face
+    include MsRestAzure
+
+    #
+    # Creates and initializes a new instance of the Face class.
+    # @param client service class for accessing basic functionality.
+    #
+    def initialize(client)
+      @client = client
+    end
+
+    # @return [FaceClient] reference to the FaceClient
+    attr_reader :client
+
+    #
+    # Given query face's faceId, find the similar-looking faces from a faceId array
+    # or a faceListId.
+    #
+    # @param face_id FaceId of the query face. User needs to call Face - Detect
+    # first to get a valid faceId. Note that this faceId is not persisted and will
+    # expire 24 hours after the detection call
+    # @param face_list_id [String] An existing user-specified unique candidate face
+    # list, created in Face List - Create a Face List. Face list contains a set of
+    # persistedFaceIds which are persisted and will never expire. Parameter
+    # faceListId and faceIds should not be provided at the same time
+    # @param face_ids An array of candidate faceIds. All of them are created by
+    # Face - Detect and the faceIds will expire 24 hours after the detection call.
+    # @param max_num_of_candidates_returned [Integer] The number of top similar
+    # faces returned. The valid range is [1, 1000].
+    # @param mode [FindSimilarMatchMode] Similar face searching mode. It can be
+    # "matchPerson" or "matchFace". Possible values include: 'matchPerson',
+    # 'matchFace'
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [Array] operation results.
+    #
+    def find_similar(face_id, face_list_id:nil, face_ids:nil, max_num_of_candidates_returned:20, mode:nil, custom_headers:nil)
+      response = find_similar_async(face_id, face_list_id:face_list_id, face_ids:face_ids, max_num_of_candidates_returned:max_num_of_candidates_returned, mode:mode, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Given query face's faceId, find the similar-looking faces from a faceId array
+    # or a faceListId.
+    #
+    # @param face_id FaceId of the query face. User needs to call Face - Detect
+    # first to get a valid faceId. Note that this faceId is not persisted and will
+    # expire 24 hours after the detection call
+    # @param face_list_id [String] An existing user-specified unique candidate face
+    # list, created in Face List - Create a Face List. Face list contains a set of
+    # persistedFaceIds which are persisted and will never expire. Parameter
+    # faceListId and faceIds should not be provided at the same time
+    # @param face_ids An array of candidate faceIds. All of them are created by
+    # Face - Detect and the faceIds will expire 24 hours after the detection call.
+    # @param max_num_of_candidates_returned [Integer] The number of top similar
+    # faces returned. The valid range is [1, 1000].
+    # @param mode [FindSimilarMatchMode] Similar face searching mode. It can be
+    # "matchPerson" or "matchFace". Possible values include: 'matchPerson',
+    # 'matchFace'
+    # @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 find_similar_with_http_info(face_id, face_list_id:nil, face_ids:nil, max_num_of_candidates_returned:20, mode:nil, custom_headers:nil)
+      find_similar_async(face_id, face_list_id:face_list_id, face_ids:face_ids, max_num_of_candidates_returned:max_num_of_candidates_returned, mode:mode, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Given query face's faceId, find the similar-looking faces from a faceId array
+    # or a faceListId.
+    #
+    # @param face_id FaceId of the query face. User needs to call Face - Detect
+    # first to get a valid faceId. Note that this faceId is not persisted and will
+    # expire 24 hours after the detection call
+    # @param face_list_id [String] An existing user-specified unique candidate face
+    # list, created in Face List - Create a Face List. Face list contains a set of
+    # persistedFaceIds which are persisted and will never expire. Parameter
+    # faceListId and faceIds should not be provided at the same time
+    # @param face_ids An array of candidate faceIds. All of them are created by
+    # Face - Detect and the faceIds will expire 24 hours after the detection call.
+    # @param max_num_of_candidates_returned [Integer] The number of top similar
+    # faces returned. The valid range is [1, 1000].
+    # @param mode [FindSimilarMatchMode] Similar face searching mode. It can be
+    # "matchPerson" or "matchFace". Possible values include: 'matchPerson',
+    # 'matchFace'
+    # @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 find_similar_async(face_id, face_list_id:nil, face_ids:nil, max_num_of_candidates_returned:20, mode:nil, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'face_id is nil' if face_id.nil?
+      fail ArgumentError, "'face_list_id' should satisfy the constraint - 'MaxLength': '64'" if !face_list_id.nil? && face_list_id.length > 64
+      fail ArgumentError, "'face_list_id' should satisfy the constraint - 'Pattern': '^[a-z0-9-_]+$'" if !face_list_id.nil? && face_list_id.match(Regexp.new('^^[a-z0-9-_]+$$')).nil?
+      fail ArgumentError, "'face_ids' should satisfy the constraint - 'MaxItems': '1000'" if !face_ids.nil? && face_ids.length > 1000
+      fail ArgumentError, "'max_num_of_candidates_returned' should satisfy the constraint - 'InclusiveMaximum': '1000'" if !max_num_of_candidates_returned.nil? && max_num_of_candidates_returned > 1000
+      fail ArgumentError, "'max_num_of_candidates_returned' should satisfy the constraint - 'InclusiveMinimum': '1'" if !max_num_of_candidates_returned.nil? && max_num_of_candidates_returned < 1
+
+      body = FindSimilarRequest.new
+      unless face_id.nil? && face_list_id.nil? && face_ids.nil? && max_num_of_candidates_returned.nil? && mode.nil?
+        body.face_id = face_id
+        body.face_list_id = face_list_id
+        body.face_ids = face_ids
+        body.max_num_of_candidates_returned = max_num_of_candidates_returned
+        body.mode = mode
+      end
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/json; charset=utf-8'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = Azure::CognitiveServices::Face::V1_0::Models::FindSimilarRequest.mapper()
+      request_content = @client.serialize(request_mapper,  body)
+      request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
+
+      path_template = 'findsimilars'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = {
+              client_side_validation: true,
+              required: false,
+              serialized_name: 'parsed_response',
+              type: {
+                name: 'Sequence',
+                element: {
+                    client_side_validation: true,
+                    required: false,
+                    serialized_name: 'SimilarFaceElementType',
+                    type: {
+                      name: 'Composite',
+                      class_name: 'SimilarFace'
+                    }
+                }
+              }
+            }
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+    #
+    # Divide candidate faces into groups based on face similarity.
+    #
+    # @param face_ids Array of candidate faceId created by Face - Detect. The
+    # maximum is 1000 faces
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [GroupResult] operation results.
+    #
+    def group(face_ids, custom_headers:nil)
+      response = group_async(face_ids, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Divide candidate faces into groups based on face similarity.
+    #
+    # @param face_ids Array of candidate faceId created by Face - Detect. The
+    # maximum is 1000 faces
+    # @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 group_with_http_info(face_ids, custom_headers:nil)
+      group_async(face_ids, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Divide candidate faces into groups based on face similarity.
+    #
+    # @param face_ids Array of candidate faceId created by Face - Detect. The
+    # maximum is 1000 faces
+    # @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 group_async(face_ids, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'face_ids is nil' if face_ids.nil?
+      fail ArgumentError, "'face_ids' should satisfy the constraint - 'MaxItems': '1000'" if !face_ids.nil? && face_ids.length > 1000
+
+      body = GroupRequest.new
+      unless face_ids.nil?
+        body.face_ids = face_ids
+      end
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/json; charset=utf-8'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = Azure::CognitiveServices::Face::V1_0::Models::GroupRequest.mapper()
+      request_content = @client.serialize(request_mapper,  body)
+      request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
+
+      path_template = 'group'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = Azure::CognitiveServices::Face::V1_0::Models::GroupResult.mapper()
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+    #
+    # Identify unknown faces from a person group.
+    #
+    # @param person_group_id [String] PersonGroupId of the target person group,
+    # created by PersonGroups.Create
+    # @param face_ids Array of query faces faceIds, created by the Face - Detect.
+    # Each of the faces are identified independently. The valid number of faceIds
+    # is between [1, 10].
+    # @param max_num_of_candidates_returned [Integer] The range of
+    # maxNumOfCandidatesReturned is between 1 and 5 (default is 1).
+    # @param confidence_threshold [Float] Confidence threshold of identification,
+    # used to judge whether one face belong to one person. The range of
+    # confidenceThreshold is [0, 1] (default specified by algorithm).
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [Array] operation results.
+    #
+    def identify(person_group_id, face_ids, max_num_of_candidates_returned:1, confidence_threshold:nil, custom_headers:nil)
+      response = identify_async(person_group_id, face_ids, max_num_of_candidates_returned:max_num_of_candidates_returned, confidence_threshold:confidence_threshold, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Identify unknown faces from a person group.
+    #
+    # @param person_group_id [String] PersonGroupId of the target person group,
+    # created by PersonGroups.Create
+    # @param face_ids Array of query faces faceIds, created by the Face - Detect.
+    # Each of the faces are identified independently. The valid number of faceIds
+    # is between [1, 10].
+    # @param max_num_of_candidates_returned [Integer] The range of
+    # maxNumOfCandidatesReturned is between 1 and 5 (default is 1).
+    # @param confidence_threshold [Float] Confidence threshold of identification,
+    # used to judge whether one face belong to one person. The range of
+    # confidenceThreshold is [0, 1] (default specified by algorithm).
+    # @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 identify_with_http_info(person_group_id, face_ids, max_num_of_candidates_returned:1, confidence_threshold:nil, custom_headers:nil)
+      identify_async(person_group_id, face_ids, max_num_of_candidates_returned:max_num_of_candidates_returned, confidence_threshold:confidence_threshold, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Identify unknown faces from a person group.
+    #
+    # @param person_group_id [String] PersonGroupId of the target person group,
+    # created by PersonGroups.Create
+    # @param face_ids Array of query faces faceIds, created by the Face - Detect.
+    # Each of the faces are identified independently. The valid number of faceIds
+    # is between [1, 10].
+    # @param max_num_of_candidates_returned [Integer] The range of
+    # maxNumOfCandidatesReturned is between 1 and 5 (default is 1).
+    # @param confidence_threshold [Float] Confidence threshold of identification,
+    # used to judge whether one face belong to one person. The range of
+    # confidenceThreshold is [0, 1] (default specified by algorithm).
+    # @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 identify_async(person_group_id, face_ids, max_num_of_candidates_returned:1, confidence_threshold:nil, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'person_group_id is nil' if person_group_id.nil?
+      fail ArgumentError, "'person_group_id' should satisfy the constraint - 'MaxLength': '64'" if !person_group_id.nil? && person_group_id.length > 64
+      fail ArgumentError, "'person_group_id' should satisfy the constraint - 'Pattern': '^[a-z0-9-_]+$'" if !person_group_id.nil? && person_group_id.match(Regexp.new('^^[a-z0-9-_]+$$')).nil?
+      fail ArgumentError, 'face_ids is nil' if face_ids.nil?
+      fail ArgumentError, "'face_ids' should satisfy the constraint - 'MaxItems': '10'" if !face_ids.nil? && face_ids.length > 10
+      fail ArgumentError, "'max_num_of_candidates_returned' should satisfy the constraint - 'InclusiveMaximum': '5'" if !max_num_of_candidates_returned.nil? && max_num_of_candidates_returned > 5
+      fail ArgumentError, "'max_num_of_candidates_returned' should satisfy the constraint - 'InclusiveMinimum': '1'" if !max_num_of_candidates_returned.nil? && max_num_of_candidates_returned < 1
+
+      body = IdentifyRequest.new
+      unless person_group_id.nil? && face_ids.nil? && max_num_of_candidates_returned.nil? && confidence_threshold.nil?
+        body.person_group_id = person_group_id
+        body.face_ids = face_ids
+        body.max_num_of_candidates_returned = max_num_of_candidates_returned
+        body.confidence_threshold = confidence_threshold
+      end
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/json; charset=utf-8'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = Azure::CognitiveServices::Face::V1_0::Models::IdentifyRequest.mapper()
+      request_content = @client.serialize(request_mapper,  body)
+      request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
+
+      path_template = 'identify'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = {
+              client_side_validation: true,
+              required: false,
+              serialized_name: 'parsed_response',
+              type: {
+                name: 'Sequence',
+                element: {
+                    client_side_validation: true,
+                    required: false,
+                    serialized_name: 'IdentifyResultElementType',
+                    type: {
+                      name: 'Composite',
+                      class_name: 'IdentifyResult'
+                    }
+                }
+              }
+            }
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+    #
+    # Verify whether two faces belong to a same person or whether one face belongs
+    # to a person.
+    #
+    # @param face_id1 FaceId of the first face, comes from Face - Detect
+    # @param face_id2 FaceId of the second face, comes from Face - Detect
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [VerifyResult] operation results.
+    #
+    def verify_face_to_face(face_id1, face_id2, custom_headers:nil)
+      response = verify_face_to_face_async(face_id1, face_id2, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Verify whether two faces belong to a same person or whether one face belongs
+    # to a person.
+    #
+    # @param face_id1 FaceId of the first face, comes from Face - Detect
+    # @param face_id2 FaceId of the second face, comes from Face - Detect
+    # @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 verify_face_to_face_with_http_info(face_id1, face_id2, custom_headers:nil)
+      verify_face_to_face_async(face_id1, face_id2, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Verify whether two faces belong to a same person or whether one face belongs
+    # to a person.
+    #
+    # @param face_id1 FaceId of the first face, comes from Face - Detect
+    # @param face_id2 FaceId of the second face, comes from Face - Detect
+    # @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 verify_face_to_face_async(face_id1, face_id2, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'face_id1 is nil' if face_id1.nil?
+      fail ArgumentError, 'face_id2 is nil' if face_id2.nil?
+
+      body = VerifyFaceToFaceRequest.new
+      unless face_id1.nil? && face_id2.nil?
+        body.face_id1 = face_id1
+        body.face_id2 = face_id2
+      end
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/json; charset=utf-8'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = Azure::CognitiveServices::Face::V1_0::Models::VerifyFaceToFaceRequest.mapper()
+      request_content = @client.serialize(request_mapper,  body)
+      request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
+
+      path_template = 'verify'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = Azure::CognitiveServices::Face::V1_0::Models::VerifyResult.mapper()
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+    #
+    # Detect human faces in an image and returns face locations, and optionally
+    # with faceIds, landmarks, and attributes.
+    #
+    # @param url [String]
+    # @param return_face_id [Boolean] A value indicating whether the operation
+    # should return faceIds of detected faces.
+    # @param return_face_landmarks [Boolean] A value indicating whether the
+    # operation should return landmarks of the detected faces.
+    # @param return_face_attributes [Array<FaceAttributeType>] Analyze and return
+    # the one or more specified face attributes in the comma-separated string like
+    # "returnFaceAttributes=age,gender". Supported face attributes include age,
+    # gender, headPose, smile, facialHair, glasses and emotion. Note that each face
+    # attribute analysis has additional computational and time cost.
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [Array] operation results.
+    #
+    def detect_with_url(url, return_face_id:true, return_face_landmarks:false, return_face_attributes:nil, custom_headers:nil)
+      response = detect_with_url_async(url, return_face_id:return_face_id, return_face_landmarks:return_face_landmarks, return_face_attributes:return_face_attributes, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Detect human faces in an image and returns face locations, and optionally
+    # with faceIds, landmarks, and attributes.
+    #
+    # @param url [String]
+    # @param return_face_id [Boolean] A value indicating whether the operation
+    # should return faceIds of detected faces.
+    # @param return_face_landmarks [Boolean] A value indicating whether the
+    # operation should return landmarks of the detected faces.
+    # @param return_face_attributes [Array<FaceAttributeType>] Analyze and return
+    # the one or more specified face attributes in the comma-separated string like
+    # "returnFaceAttributes=age,gender". Supported face attributes include age,
+    # gender, headPose, smile, facialHair, glasses and emotion. Note that each face
+    # attribute analysis has additional computational and time cost.
+    # @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 detect_with_url_with_http_info(url, return_face_id:true, return_face_landmarks:false, return_face_attributes:nil, custom_headers:nil)
+      detect_with_url_async(url, return_face_id:return_face_id, return_face_landmarks:return_face_landmarks, return_face_attributes:return_face_attributes, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Detect human faces in an image and returns face locations, and optionally
+    # with faceIds, landmarks, and attributes.
+    #
+    # @param url [String]
+    # @param return_face_id [Boolean] A value indicating whether the operation
+    # should return faceIds of detected faces.
+    # @param return_face_landmarks [Boolean] A value indicating whether the
+    # operation should return landmarks of the detected faces.
+    # @param return_face_attributes [Array<FaceAttributeType>] Analyze and return
+    # the one or more specified face attributes in the comma-separated string like
+    # "returnFaceAttributes=age,gender". Supported face attributes include age,
+    # gender, headPose, smile, facialHair, glasses and emotion. Note that each face
+    # attribute analysis has additional computational and time cost.
+    # @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 detect_with_url_async(url, return_face_id:true, return_face_landmarks:false, return_face_attributes:nil, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'url is nil' if url.nil?
+
+      image_url = ImageUrl.new
+      unless url.nil?
+        image_url.url = url
+      end
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/json; charset=utf-8'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = Azure::CognitiveServices::Face::V1_0::Models::ImageUrl.mapper()
+      request_content = @client.serialize(request_mapper,  image_url)
+      request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
+
+      path_template = 'detect'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          query_params: {'returnFaceId' => return_face_id,'returnFaceLandmarks' => return_face_landmarks,'returnFaceAttributes' => return_face_attributes.nil? ? nil : return_face_attributes.join(',')},
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = {
+              client_side_validation: true,
+              required: false,
+              serialized_name: 'parsed_response',
+              type: {
+                name: 'Sequence',
+                element: {
+                    client_side_validation: true,
+                    required: false,
+                    serialized_name: 'DetectedFaceElementType',
+                    type: {
+                      name: 'Composite',
+                      class_name: 'DetectedFace'
+                    }
+                }
+              }
+            }
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+    #
+    # Verify whether two faces belong to a same person. Compares a face Id with a
+    # Person Id
+    #
+    # @param face_id FaceId the face, comes from Face - Detect
+    # @param person_group_id [String] Using existing personGroupId and personId for
+    # fast loading a specified person. personGroupId is created in Person
+    # Groups.Create.
+    # @param person_id Specify a certain person in a person group. personId is
+    # created in Persons.Create.
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [VerifyResult] operation results.
+    #
+    def verify_face_to_person(face_id, person_group_id, person_id, custom_headers:nil)
+      response = verify_face_to_person_async(face_id, person_group_id, person_id, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Verify whether two faces belong to a same person. Compares a face Id with a
+    # Person Id
+    #
+    # @param face_id FaceId the face, comes from Face - Detect
+    # @param person_group_id [String] Using existing personGroupId and personId for
+    # fast loading a specified person. personGroupId is created in Person
+    # Groups.Create.
+    # @param person_id Specify a certain person in a person group. personId is
+    # created in Persons.Create.
+    # @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 verify_face_to_person_with_http_info(face_id, person_group_id, person_id, custom_headers:nil)
+      verify_face_to_person_async(face_id, person_group_id, person_id, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Verify whether two faces belong to a same person. Compares a face Id with a
+    # Person Id
+    #
+    # @param face_id FaceId the face, comes from Face - Detect
+    # @param person_group_id [String] Using existing personGroupId and personId for
+    # fast loading a specified person. personGroupId is created in Person
+    # Groups.Create.
+    # @param person_id Specify a certain person in a person group. personId is
+    # created in Persons.Create.
+    # @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 verify_face_to_person_async(face_id, person_group_id, person_id, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'face_id is nil' if face_id.nil?
+      fail ArgumentError, 'person_group_id is nil' if person_group_id.nil?
+      fail ArgumentError, "'person_group_id' should satisfy the constraint - 'MaxLength': '64'" if !person_group_id.nil? && person_group_id.length > 64
+      fail ArgumentError, "'person_group_id' should satisfy the constraint - 'Pattern': '^[a-z0-9-_]+$'" if !person_group_id.nil? && person_group_id.match(Regexp.new('^^[a-z0-9-_]+$$')).nil?
+      fail ArgumentError, 'person_id is nil' if person_id.nil?
+
+      body = VerifyFaceToPersonRequest.new
+      unless face_id.nil? && person_group_id.nil? && person_id.nil?
+        body.face_id = face_id
+        body.person_group_id = person_group_id
+        body.person_id = person_id
+      end
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/json; charset=utf-8'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = Azure::CognitiveServices::Face::V1_0::Models::VerifyFaceToPersonRequest.mapper()
+      request_content = @client.serialize(request_mapper,  body)
+      request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
+
+      path_template = 'verify'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = Azure::CognitiveServices::Face::V1_0::Models::VerifyResult.mapper()
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+    #
+    # Detect human faces in an image and returns face locations, and optionally
+    # with faceIds, landmarks, and attributes.
+    #
+    # @param image An image stream.
+    # @param return_face_id [Boolean] A value indicating whether the operation
+    # should return faceIds of detected faces.
+    # @param return_face_landmarks [Boolean] A value indicating whether the
+    # operation should return landmarks of the detected faces.
+    # @param return_face_attributes [Array<FaceAttributeType>] Analyze and return
+    # the one or more specified face attributes in the comma-separated string like
+    # "returnFaceAttributes=age,gender". Supported face attributes include age,
+    # gender, headPose, smile, facialHair, glasses and emotion. Note that each face
+    # attribute analysis has additional computational and time cost.
+    # @param custom_headers [Hash{String => String}] A hash of custom headers that
+    # will be added to the HTTP request.
+    #
+    # @return [Array] operation results.
+    #
+    def detect_with_stream(image, return_face_id:true, return_face_landmarks:false, return_face_attributes:nil, custom_headers:nil)
+      response = detect_with_stream_async(image, return_face_id:return_face_id, return_face_landmarks:return_face_landmarks, return_face_attributes:return_face_attributes, custom_headers:custom_headers).value!
+      response.body unless response.nil?
+    end
+
+    #
+    # Detect human faces in an image and returns face locations, and optionally
+    # with faceIds, landmarks, and attributes.
+    #
+    # @param image An image stream.
+    # @param return_face_id [Boolean] A value indicating whether the operation
+    # should return faceIds of detected faces.
+    # @param return_face_landmarks [Boolean] A value indicating whether the
+    # operation should return landmarks of the detected faces.
+    # @param return_face_attributes [Array<FaceAttributeType>] Analyze and return
+    # the one or more specified face attributes in the comma-separated string like
+    # "returnFaceAttributes=age,gender". Supported face attributes include age,
+    # gender, headPose, smile, facialHair, glasses and emotion. Note that each face
+    # attribute analysis has additional computational and time cost.
+    # @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 detect_with_stream_with_http_info(image, return_face_id:true, return_face_landmarks:false, return_face_attributes:nil, custom_headers:nil)
+      detect_with_stream_async(image, return_face_id:return_face_id, return_face_landmarks:return_face_landmarks, return_face_attributes:return_face_attributes, custom_headers:custom_headers).value!
+    end
+
+    #
+    # Detect human faces in an image and returns face locations, and optionally
+    # with faceIds, landmarks, and attributes.
+    #
+    # @param image An image stream.
+    # @param return_face_id [Boolean] A value indicating whether the operation
+    # should return faceIds of detected faces.
+    # @param return_face_landmarks [Boolean] A value indicating whether the
+    # operation should return landmarks of the detected faces.
+    # @param return_face_attributes [Array<FaceAttributeType>] Analyze and return
+    # the one or more specified face attributes in the comma-separated string like
+    # "returnFaceAttributes=age,gender". Supported face attributes include age,
+    # gender, headPose, smile, facialHair, glasses and emotion. Note that each face
+    # attribute analysis has additional computational and time cost.
+    # @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 detect_with_stream_async(image, return_face_id:true, return_face_landmarks:false, return_face_attributes:nil, custom_headers:nil)
+      fail ArgumentError, '@client.azure_region is nil' if @client.azure_region.nil?
+      fail ArgumentError, 'image is nil' if image.nil?
+
+
+      request_headers = {}
+      request_headers['Content-Type'] = 'application/octet-stream'
+
+      # Set Headers
+      request_headers['x-ms-client-request-id'] = SecureRandom.uuid
+      request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
+
+      # Serialize Request
+      request_mapper = {
+        client_side_validation: true,
+        required: true,
+        serialized_name: 'Image',
+        type: {
+          name: 'Stream'
+        }
+      }
+      request_content = @client.serialize(request_mapper,  image)
+
+      path_template = 'detect'
+
+      request_url = @base_url || @client.base_url
+    request_url = request_url.gsub('{AzureRegion}', @client.azure_region)
+
+      options = {
+          middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
+          query_params: {'returnFaceId' => return_face_id,'returnFaceLandmarks' => return_face_landmarks,'returnFaceAttributes' => return_face_attributes.nil? ? nil : return_face_attributes.join(',')},
+          body: request_content,
+          headers: request_headers.merge(custom_headers || {}),
+          base_url: request_url
+      }
+      promise = @client.make_request_async(:post, path_template, options)
+
+      promise = promise.then do |result|
+        http_response = result.response
+        status_code = http_response.status
+        response_content = http_response.body
+        unless status_code == 200
+          error_model = JSON.load(response_content)
+          fail MsRest::HttpOperationError.new(result.request, http_response, error_model)
+        end
+
+        result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        # Deserialize Response
+        if status_code == 200
+          begin
+            parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
+            result_mapper = {
+              client_side_validation: true,
+              required: false,
+              serialized_name: 'parsed_response',
+              type: {
+                name: 'Sequence',
+                element: {
+                    client_side_validation: true,
+                    required: false,
+                    serialized_name: 'DetectedFaceElementType',
+                    type: {
+                      name: 'Composite',
+                      class_name: 'DetectedFace'
+                    }
+                }
+              }
+            }
+            result.body = @client.deserialize(result_mapper, parsed_response)
+          rescue Exception => e
+            fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
+          end
+        end
+
+        result
+      end
+
+      promise.execute
+    end
+
+  end
+end