private Amazon.Rekognition.Model.SearchFacesByImageResponse CallAWSServiceOperation(IAmazonRekognition client, Amazon.Rekognition.Model.SearchFacesByImageRequest request)
{
Utils.Common.WriteVerboseEndpointMessage(this, client.Config, "Amazon Rekognition", "SearchFacesByImage");
try
{
#if DESKTOP
return(client.SearchFacesByImage(request));
#elif CORECLR
return(client.SearchFacesByImageAsync(request).GetAwaiter().GetResult());
#else
#error "Unknown build edition"
#endif
}
catch (AmazonServiceException exc)
{
var webException = exc.InnerException as System.Net.WebException;
if (webException != null)
{
throw new Exception(Utils.Common.FormatNameResolutionFailureMessage(client.Config, webException.Message), webException);
}
throw;
}
}
public object Execute(ExecutorContext context)
{
System.IO.MemoryStream _ImageContentStream = null;
try
{
var cmdletContext = context as CmdletContext;
// create request
var request = new Amazon.Rekognition.Model.SearchFacesByImageRequest();
if (cmdletContext.CollectionId != null)
{
request.CollectionId = cmdletContext.CollectionId;
}
if (cmdletContext.FaceMatchThreshold != null)
{
request.FaceMatchThreshold = cmdletContext.FaceMatchThreshold.Value;
}
// populate Image
var requestImageIsNull = true;
request.Image = new Amazon.Rekognition.Model.Image();
System.IO.MemoryStream requestImage_imageContent = null;
if (cmdletContext.ImageContent != null)
{
_ImageContentStream = new System.IO.MemoryStream(cmdletContext.ImageContent);
requestImage_imageContent = _ImageContentStream;
}
if (requestImage_imageContent != null)
{
request.Image.Bytes = requestImage_imageContent;
requestImageIsNull = false;
}
Amazon.Rekognition.Model.S3Object requestImage_image_S3Object = null;
// populate S3Object
var requestImage_image_S3ObjectIsNull = true;
requestImage_image_S3Object = new Amazon.Rekognition.Model.S3Object();
System.String requestImage_image_S3Object_imageBucket = null;
if (cmdletContext.ImageBucket != null)
{
requestImage_image_S3Object_imageBucket = cmdletContext.ImageBucket;
}
if (requestImage_image_S3Object_imageBucket != null)
{
requestImage_image_S3Object.Bucket = requestImage_image_S3Object_imageBucket;
requestImage_image_S3ObjectIsNull = false;
}
System.String requestImage_image_S3Object_imageName = null;
if (cmdletContext.ImageName != null)
{
requestImage_image_S3Object_imageName = cmdletContext.ImageName;
}
if (requestImage_image_S3Object_imageName != null)
{
requestImage_image_S3Object.Name = requestImage_image_S3Object_imageName;
requestImage_image_S3ObjectIsNull = false;
}
System.String requestImage_image_S3Object_imageVersion = null;
if (cmdletContext.ImageVersion != null)
{
requestImage_image_S3Object_imageVersion = cmdletContext.ImageVersion;
}
if (requestImage_image_S3Object_imageVersion != null)
{
requestImage_image_S3Object.Version = requestImage_image_S3Object_imageVersion;
requestImage_image_S3ObjectIsNull = false;
}
// determine if requestImage_image_S3Object should be set to null
if (requestImage_image_S3ObjectIsNull)
{
requestImage_image_S3Object = null;
}
if (requestImage_image_S3Object != null)
{
request.Image.S3Object = requestImage_image_S3Object;
requestImageIsNull = false;
}
// determine if request.Image should be set to null
if (requestImageIsNull)
{
request.Image = null;
}
if (cmdletContext.MaxFace != null)
{
request.MaxFaces = cmdletContext.MaxFace.Value;
}
if (cmdletContext.QualityFilter != null)
{
request.QualityFilter = cmdletContext.QualityFilter;
}
CmdletOutput output;
// issue call
var client = Client ?? CreateClient(_CurrentCredentials, _RegionEndpoint);
try
{
var response = CallAWSServiceOperation(client, request);
object pipelineOutput = null;
pipelineOutput = cmdletContext.Select(response, this);
output = new CmdletOutput
{
PipelineOutput = pipelineOutput,
ServiceResponse = response
};
}
catch (Exception e)
{
output = new CmdletOutput {
ErrorResponse = e
};
}
return(output);
}
finally
{
if (_ImageContentStream != null)
{
_ImageContentStream.Dispose();
}
}
}
/// <summary>
/// For a given input image, first detects the largest face in the image, and then searches
/// the specified collection for matching faces. The operation compares the features of
/// the input face with faces in the specified collection.
///
/// <note>
/// <para>
/// To search for all faces in an input image, you might first call the API, and then
/// use the face IDs returned in subsequent calls to the API.
/// </para>
///
/// <para>
/// You can also call the <code>DetectFaces</code> API and use the bounding boxes in
/// the response to make face crops, which then you can pass in to the <code>SearchFacesByImage</code>
/// API.
/// </para>
/// </note>
/// <para>
/// The response returns an array of faces that match, ordered by similarity score with
/// the highest similarity first. More specifically, it is an array of metadata for each
/// face match found. Along with the metadata, the response also includes a <code>similarity</code>
/// indicating how similar the face is to the input face. In the response, the API also
/// returns the bounding box (and a confidence level that the bounding box contains a
/// face) of the face that Rekognition used for the input image.
/// </para>
///
/// <para>
/// For an example, see <a>example3</a>.
/// </para>
///
/// <para>
/// This operation requires permissions to perform the <code>rekognition:SearchFacesByImage</code>
/// action.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the SearchFacesByImage service method.</param>
///
/// <returns>The response from the SearchFacesByImage service method, as returned by Rekognition.</returns>
/// <exception cref="Amazon.Rekognition.Model.AccessDeniedException">
/// You are not authorized to perform the action.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.ImageTooLargeException">
/// The input image size exceeds the allowed limit. For more information, see <a>limits</a>.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.InternalServerErrorException">
/// Amazon Rekognition experienced a service issue. Try your call again.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.InvalidImageFormatException">
/// The provided image format is not supported.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.InvalidParameterException">
/// Input parameter violated a constraint. Validate your parameter before calling the
/// API again.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.InvalidS3ObjectException">
/// Amazon Rekognition is unable to access the S3 object specified in the request.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.ProvisionedThroughputExceededException">
/// The number of requests exceeded your throughput limit. If you want to increase this
/// limit, contact Amazon Rekognition.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.ResourceNotFoundException">
/// Collection specified in the request is not found.
/// </exception>
/// <exception cref="Amazon.Rekognition.Model.ThrottlingException">
/// Amazon Rekognition is temporarily unable to process the request. Try your call again.
/// </exception>
public SearchFacesByImageResponse SearchFacesByImage(SearchFacesByImageRequest request)
{
var marshaller = new SearchFacesByImageRequestMarshaller();
var unmarshaller = SearchFacesByImageResponseUnmarshaller.Instance;
return Invoke<SearchFacesByImageRequest,SearchFacesByImageResponse>(request, marshaller, unmarshaller);
}
/// <summary>
/// Initiates the asynchronous execution of the SearchFacesByImage operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the SearchFacesByImage operation on AmazonRekognitionClient.</param>
/// <param name="callback">An AsyncCallback delegate that is invoked when the operation completes.</param>
/// <param name="state">A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.</param>
///
/// <returns>An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndSearchFacesByImage
/// operation.</returns>
public IAsyncResult BeginSearchFacesByImage(SearchFacesByImageRequest request, AsyncCallback callback, object state)
{
var marshaller = new SearchFacesByImageRequestMarshaller();
var unmarshaller = SearchFacesByImageResponseUnmarshaller.Instance;
return BeginInvoke<SearchFacesByImageRequest>(request, marshaller, unmarshaller,
callback, state);
}
/// <summary>
/// Initiates the asynchronous execution of the SearchFacesByImage operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the SearchFacesByImage operation.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
/// <returns>The task object representing the asynchronous operation.</returns>
public Task<SearchFacesByImageResponse> SearchFacesByImageAsync(SearchFacesByImageRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new SearchFacesByImageRequestMarshaller();
var unmarshaller = SearchFacesByImageResponseUnmarshaller.Instance;
return InvokeAsync<SearchFacesByImageRequest,SearchFacesByImageResponse>(request, marshaller,
unmarshaller, cancellationToken);
}