def find_similar_with_http_info(face_id, face_list_id:nil, large_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, large_face_list_id:large_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
def find_similar_with_http_info(face_id, face_list_id:nil, large_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, large_face_list_id:large_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, to search the similar-looking faces from a faceId
 array, a face list or a large face list. faceId array contains the faces
 created by [Face -
 Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236),
 which will expire 24 hours after creation. A "faceListId" is created by
 [FaceList -
 Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524b)
 containing persistedFaceIds that will not expire. And a "largeFaceListId" is
 created by [LargeFaceList -
 Create](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc)
 containing persistedFaceIds that will also not expire. Depending on the input
 the returned similar faces list contains faceIds or persistedFaceIds ranked
 by similarity.
 <br/>Find similar has two working modes, "matchPerson" and "matchFace".
 "matchPerson" is the default mode that it tries to find faces of the same
 person as possible by using internal same-person thresholds. It is useful to
 find a known person's other photos. Note that an empty list will be returned
 if no faces pass the internal thresholds. "matchFace" mode ignores
 same-person thresholds and returns ranked similar faces anyway, even the
 similarity is low. It can be used in the cases like searching
 celebrity-looking faces.
 <br/>The 'recognitionModel' associated with the query face's faceId should be
 the same as the 'recognitionModel' used by the target faceId array, face list
 or large face list.


 @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, largeFaceListId and faceIds should not be provided at the same
 time.
 @param large_face_list_id [String] An existing user-specified unique
 candidate large face list, created in LargeFaceList - Create. Large face list
 contains a set of persistedFaceIds which are persisted and will never expire.
 Parameter faceListId, largeFaceListId 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.
 The number of faceIds is limited to 1000. Parameter faceListId,
 largeFaceListId and faceIds should not be provided at the same time.
 @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.