> verifyFaceToFaceWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.verifyFaceToFaceWithResponseAsync(body, requestOptions);
+ }
+
+ /**
+ * Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and
+ * attributes.<br /> * No image will be stored. Only the extracted face feature will be stored on server. The
+ * faceId is an identifier of the face feature and will be used in [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). The stored face feature(s) will expire
+ * and be deleted at the time specified by faceIdTimeToLive after the original detection call. * Optional parameters
+ * include faceId, landmarks, and attributes. Attributes include age, gender, headPose, smile, facialHair, glasses,
+ * emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, mask, and qualityForRecognition. Some of
+ * the results returned for specific attributes may not be highly accurate. * JPEG, PNG, GIF (the first frame), and
+ * BMP format are supported. The allowed image file size is from 1KB to 6MB. * Up to 100 faces can be returned for
+ * an image. Faces are ranked by face rectangle size from large to small. * For optimal results when querying [Face
+ * - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) ('returnFaceId' is true), please use faces
+ * that are: frontal, clear, and with a minimum size of 200x200 pixels (100 pixels between eyes). * 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * * Different 'recognitionModel' values are provided. If follow-up operations like Verify, Identify, Find
+ * Similar are needed, please specify the recognition model with 'recognitionModel' parameter. The default value for
+ * 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in
+ * this parameter. Once specified, the detected faceIds will be associated with the specified recognition model.
+ * More details, please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ *
Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnFaceId | String | No | A value indicating whether the operation should return faceIds of detected faces. |
+ * | returnFaceLandmarks | String | No | A value indicating whether the operation should return landmarks of the detected faces. |
+ * | returnFaceAttributes | String | No | Analyze and return the one or more specified face attributes in the comma-separated string like "returnFaceAttributes=age,gender". The available attributes depends on the 'detectionModel' specified. 'detection_01' supports age, gender, headPose, smile, facialHair, glasses, emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, and qualityForRecognition. While 'detection_02' does not support any attributes and 'detection_03' only supports mask and qualityForRecognition. Additionally, qualityForRecognition is only supported when the 'recognitionModel' is specified as 'recognition_03' or 'recognition_04'. Note that each face attribute analysis has additional computational and time cost. In the form of "," separated string. |
+ * | recognitionModel | String | No | Name of recognition model. Recognition model is used when the face features are extracted and associated with detected faceIds, (Large)FaceList or (Large)PersonGroup. A recognition model name can be provided when performing Face - Detect or (Large)FaceList - Create or (Large)PersonGroup - Create. The default value is 'recognition_01', if latest model needed, please explicitly specify the model you need. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ * | detectionModel | String | No | 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. |
+ * | faceIdTimeToLive | String | No | The number of seconds for the faceId being cached. Supported range from 60 seconds up to 86400 seconds. The default value is 86400 (24 hours). |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * faceRectangle: {
+ * width: int
+ * height: int
+ * left: int
+ * top: int
+ * }
+ * faceLandmarks: {
+ * pupilLeft: {
+ * x: float
+ * y: float
+ * }
+ * pupilRight: (recursive schema, see pupilRight above)
+ * noseTip: (recursive schema, see noseTip above)
+ * mouthLeft: (recursive schema, see mouthLeft above)
+ * mouthRight: (recursive schema, see mouthRight above)
+ * eyebrowLeftOuter: (recursive schema, see eyebrowLeftOuter above)
+ * eyebrowLeftInner: (recursive schema, see eyebrowLeftInner above)
+ * eyeLeftOuter: (recursive schema, see eyeLeftOuter above)
+ * eyeLeftTop: (recursive schema, see eyeLeftTop above)
+ * eyeLeftBottom: (recursive schema, see eyeLeftBottom above)
+ * eyeLeftInner: (recursive schema, see eyeLeftInner above)
+ * eyebrowRightInner: (recursive schema, see eyebrowRightInner above)
+ * eyebrowRightOuter: (recursive schema, see eyebrowRightOuter above)
+ * eyeRightInner: (recursive schema, see eyeRightInner above)
+ * eyeRightTop: (recursive schema, see eyeRightTop above)
+ * eyeRightBottom: (recursive schema, see eyeRightBottom above)
+ * eyeRightOuter: (recursive schema, see eyeRightOuter above)
+ * noseRootLeft: (recursive schema, see noseRootLeft above)
+ * noseRootRight: (recursive schema, see noseRootRight above)
+ * noseLeftAlarTop: (recursive schema, see noseLeftAlarTop above)
+ * noseRightAlarTop: (recursive schema, see noseRightAlarTop above)
+ * noseLeftAlarOutTip: (recursive schema, see noseLeftAlarOutTip above)
+ * noseRightAlarOutTip: (recursive schema, see noseRightAlarOutTip above)
+ * upperLipTop: (recursive schema, see upperLipTop above)
+ * upperLipBottom: (recursive schema, see upperLipBottom above)
+ * underLipTop: (recursive schema, see underLipTop above)
+ * underLipBottom: (recursive schema, see underLipBottom above)
+ * }
+ * faceAttributes: {
+ * age: Float
+ * gender: String(male/female)
+ * smile: Float
+ * facialHair: {
+ * moustache: Float
+ * beard: Float
+ * sideburns: Float
+ * }
+ * glasses: String(noGlasses/readingGlasses/sunglasses/swimmingGoggles)
+ * headPose: {
+ * roll: Float
+ * yaw: Float
+ * pitch: Float
+ * }
+ * emotion: {
+ * anger: Float
+ * contempt: Float
+ * disgust: Float
+ * fear: Float
+ * happiness: Float
+ * neutral: Float
+ * sadness: Float
+ * surprise: Float
+ * }
+ * hair: {
+ * bald: Float
+ * invisible: Boolean
+ * hairColor: [
+ * {
+ * color: String(unknown/white/gray/blond/brown/red/black/other)
+ * confidence: Float
+ * }
+ * ]
+ * }
+ * makeup: {
+ * eyeMakeup: Boolean
+ * lipMakeup: Boolean
+ * }
+ * occlusion: {
+ * foreheadOccluded: Boolean
+ * eyeOccluded: Boolean
+ * mouthOccluded: Boolean
+ * }
+ * accessories: [
+ * {
+ * type: String(headWear/glasses/mask)
+ * confidence: Float
+ * }
+ * ]
+ * blur: {
+ * blurLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * exposure: {
+ * exposureLevel: String(UnderExposure/GoodExposure/OverExposure)
+ * value: Float
+ * }
+ * noise: {
+ * noiseLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * mask: {
+ * type: String(noMask/faceMask/otherMaskOrOcclusion/uncertain)
+ * noseAndMouthCovered: Boolean
+ * }
+ * qualityForRecognition: String(Low/Medium/High)
+ * }
+ * }
+ * ]
+ * }
+ *
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of DetectedFace along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> detectWithUrlWithResponse(BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.serviceClient.detectWithUrlWithResponseAsync(imageUrl, requestOptions);
+ }
+
+ /**
+ * Verify whether two faces belong to a same person. Compares a face Id with a Person Id.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId: String
+ * personGroupId: String
+ * largePersonGroupId: String
+ * personId: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * isIdentical: boolean
+ * confidence: float
+ * }
+ * }
+ *
+ * @param body Request body for face to person verification.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return result of the verify operation along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> verifyFaceToPersonWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.verifyFaceToPersonWithResponseAsync(body, requestOptions);
+ }
+
+ /**
+ * Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and
+ * attributes.<br /> * No image will be stored. Only the extracted face feature will be stored on server. The
+ * faceId is an identifier of the face feature and will be used in [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). The stored face feature(s) will expire
+ * and be deleted at the time specified by faceIdTimeToLive after the original detection call. * Optional parameters
+ * include faceId, landmarks, and attributes. Attributes include age, gender, headPose, smile, facialHair, glasses,
+ * emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, mask, and qualityForRecognition. Some of
+ * the results returned for specific attributes may not be highly accurate. * JPEG, PNG, GIF (the first frame), and
+ * BMP format are supported. The allowed image file size is from 1KB to 6MB. * Up to 100 faces can be returned for
+ * an image. Faces are ranked by face rectangle size from large to small. * For optimal results when querying [Face
+ * - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) ('returnFaceId' is true), please use faces
+ * that are: frontal, clear, and with a minimum size of 200x200 pixels (100 pixels between eyes). * 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model) *
+ * Different 'recognitionModel' values are provided. If follow-up operations like Verify, Identify, Find Similar are
+ * needed, please specify the recognition model with 'recognitionModel' parameter. The default value for
+ * 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in
+ * this parameter. Once specified, the detected faceIds will be associated with the specified recognition model.
+ * More details, please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnFaceId | String | No | A value indicating whether the operation should return faceIds of detected faces. |
+ * | returnFaceLandmarks | String | No | A value indicating whether the operation should return landmarks of the detected faces. |
+ * | returnFaceAttributes | String | No | Analyze and return the one or more specified face attributes in the comma-separated string like "returnFaceAttributes=age,gender". The available attributes depends on the 'detectionModel' specified. 'detection_01' supports age, gender, headPose, smile, facialHair, glasses, emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, and qualityForRecognition. While 'detection_02' does not support any attributes and 'detection_03' only supports mask and qualityForRecognition. Additionally, qualityForRecognition is only supported when the 'recognitionModel' is specified as 'recognition_03' or 'recognition_04'. Note that each face attribute analysis has additional computational and time cost. In the form of "," separated string. |
+ * | recognitionModel | String | No | Name of recognition model. Recognition model is used when the face features are extracted and associated with detected faceIds, (Large)FaceList or (Large)PersonGroup. A recognition model name can be provided when performing Face - Detect or (Large)FaceList - Create or (Large)PersonGroup - Create. The default value is 'recognition_01', if latest model needed, please explicitly specify the model you need. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ * | detectionModel | String | No | 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. |
+ * | faceIdTimeToLive | String | No | The number of seconds for the faceId being cached. Supported range from 60 seconds up to 86400 seconds. The default value is 86400 (24 hours). |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * faceRectangle: {
+ * width: int
+ * height: int
+ * left: int
+ * top: int
+ * }
+ * faceLandmarks: {
+ * pupilLeft: {
+ * x: float
+ * y: float
+ * }
+ * pupilRight: (recursive schema, see pupilRight above)
+ * noseTip: (recursive schema, see noseTip above)
+ * mouthLeft: (recursive schema, see mouthLeft above)
+ * mouthRight: (recursive schema, see mouthRight above)
+ * eyebrowLeftOuter: (recursive schema, see eyebrowLeftOuter above)
+ * eyebrowLeftInner: (recursive schema, see eyebrowLeftInner above)
+ * eyeLeftOuter: (recursive schema, see eyeLeftOuter above)
+ * eyeLeftTop: (recursive schema, see eyeLeftTop above)
+ * eyeLeftBottom: (recursive schema, see eyeLeftBottom above)
+ * eyeLeftInner: (recursive schema, see eyeLeftInner above)
+ * eyebrowRightInner: (recursive schema, see eyebrowRightInner above)
+ * eyebrowRightOuter: (recursive schema, see eyebrowRightOuter above)
+ * eyeRightInner: (recursive schema, see eyeRightInner above)
+ * eyeRightTop: (recursive schema, see eyeRightTop above)
+ * eyeRightBottom: (recursive schema, see eyeRightBottom above)
+ * eyeRightOuter: (recursive schema, see eyeRightOuter above)
+ * noseRootLeft: (recursive schema, see noseRootLeft above)
+ * noseRootRight: (recursive schema, see noseRootRight above)
+ * noseLeftAlarTop: (recursive schema, see noseLeftAlarTop above)
+ * noseRightAlarTop: (recursive schema, see noseRightAlarTop above)
+ * noseLeftAlarOutTip: (recursive schema, see noseLeftAlarOutTip above)
+ * noseRightAlarOutTip: (recursive schema, see noseRightAlarOutTip above)
+ * upperLipTop: (recursive schema, see upperLipTop above)
+ * upperLipBottom: (recursive schema, see upperLipBottom above)
+ * underLipTop: (recursive schema, see underLipTop above)
+ * underLipBottom: (recursive schema, see underLipBottom above)
+ * }
+ * faceAttributes: {
+ * age: Float
+ * gender: String(male/female)
+ * smile: Float
+ * facialHair: {
+ * moustache: Float
+ * beard: Float
+ * sideburns: Float
+ * }
+ * glasses: String(noGlasses/readingGlasses/sunglasses/swimmingGoggles)
+ * headPose: {
+ * roll: Float
+ * yaw: Float
+ * pitch: Float
+ * }
+ * emotion: {
+ * anger: Float
+ * contempt: Float
+ * disgust: Float
+ * fear: Float
+ * happiness: Float
+ * neutral: Float
+ * sadness: Float
+ * surprise: Float
+ * }
+ * hair: {
+ * bald: Float
+ * invisible: Boolean
+ * hairColor: [
+ * {
+ * color: String(unknown/white/gray/blond/brown/red/black/other)
+ * confidence: Float
+ * }
+ * ]
+ * }
+ * makeup: {
+ * eyeMakeup: Boolean
+ * lipMakeup: Boolean
+ * }
+ * occlusion: {
+ * foreheadOccluded: Boolean
+ * eyeOccluded: Boolean
+ * mouthOccluded: Boolean
+ * }
+ * accessories: [
+ * {
+ * type: String(headWear/glasses/mask)
+ * confidence: Float
+ * }
+ * ]
+ * blur: {
+ * blurLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * exposure: {
+ * exposureLevel: String(UnderExposure/GoodExposure/OverExposure)
+ * value: Float
+ * }
+ * noise: {
+ * noiseLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * mask: {
+ * type: String(noMask/faceMask/otherMaskOrOcclusion/uncertain)
+ * noseAndMouthCovered: Boolean
+ * }
+ * qualityForRecognition: String(Low/Medium/High)
+ * }
+ * }
+ * ]
+ * }
+ *
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of DetectedFace along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> detectWithStreamWithResponse(BinaryData image, RequestOptions requestOptions) {
+ return this.serviceClient.detectWithStreamWithResponseAsync(image, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceClient.java
new file mode 100644
index 000000000000..96ebbac00a00
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceClient.java
@@ -0,0 +1,656 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = FaceClientBuilder.class)
+public final class FaceClient {
+ @Generated private final FaceAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of FaceClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ FaceClient(FaceAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * 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 With
+ * Url](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl) or [Face - Detect With
+ * Stream](https://docs.microsoft.com/rest/api/faceapi/face/detectwithstream), which will expire at the time
+ * specified by faceIdTimeToLive after creation. A "faceListId" is created by [FaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/facelist/create) containing persistedFaceIds that will not
+ * expire. And a "largeFaceListId" is created by [LargeFaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/largefacelist/create) 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.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId: String
+ * faceListId: String
+ * largeFaceListId: String
+ * faceIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * mode: String(matchPerson/matchFace)
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * persistedFaceId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for Find Similar.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of SimilarFace along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response findSimilarWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.findSimilarWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * Divide candidate faces into groups based on face similarity.<br /> * The output is one or more disjointed
+ * face groups and a messyGroup. A face group contains faces that have similar looking, often of the same person.
+ * Face groups are ranked by group size, i.e. number of faces. Notice that faces belonging to a same person might be
+ * split into several groups in the result. * MessyGroup is a special face group containing faces that cannot find
+ * any similar counterpart face from original faces. The messyGroup will not appear in the result if all faces found
+ * their counterparts. * Group API needs at least 2 candidate faces and 1000 at most. We suggest to try [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface) when you only have 2 candidate faces.
+ * * The 'recognitionModel' associated with the query faces' faceIds should be the same.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * groups: [
+ * [
+ * String
+ * ]
+ * ]
+ * messyGroup: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param body Request body for grouping.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face groups based on face similarity along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response groupWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.groupWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * 1-to-many identification to find the closest matches of the specific query person face from a person group, large
+ * person group, person directory dynamic person group or person directory personIds array. <br/> For each
+ * face in the faceIds array, Face Identify will compute similarities between the query face and all the faces in
+ * the person group (given by personGroupId) or large person group (given by largePersonGroupId), and return
+ * candidate person(s) for that face ranked by similarity confidence. The person group/large person group should be
+ * trained to make it ready for identification. See more in [PersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/persongroup/train) and [LargePersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/train). <br/>
+ *
+ * Remarks:<br /> * The algorithm allows more than one face to be identified independently at the same
+ * request, but no more than 10 faces. * Each person in the person group/large person group could have more than one
+ * face, but no more than 248 faces. * Higher face image quality means better identification precision. Please
+ * consider high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger.
+ * * Number of candidates returned is restricted by maxNumOfCandidatesReturned and confidenceThreshold. If no person
+ * is identified, the returned candidates will be an empty array. * Try [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) when you need to find similar faces from a
+ * face list/large face list instead of a person group/large person group. * The 'recognitionModel' associated with
+ * the query faces' faceIds should be the same as the 'recognitionModel' used by the target person group or large
+ * person group.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * personGroupId: String
+ * largePersonGroupId: String
+ * dynamicPersonGroupId: String
+ * personIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * confidenceThreshold: Float
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * candidates: [
+ * {
+ * personId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for identify operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of IdentifyResult along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response identifyWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.identifyWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * Verify whether two faces belong to a same person or whether one face belongs to a person. <br/>
+ * Remarks:<br /> * Higher face image quality means better identification precision. Please consider
+ * high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger. * For
+ * the scenarios that are sensitive to accuracy please make your own judgment. * The 'recognitionModel' associated
+ * with the query faces' faceIds should be the same as the 'recognitionModel' used by the target face, person group
+ * or large person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId1: String
+ * faceId2: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * isIdentical: boolean
+ * confidence: float
+ * }
+ * }
+ *
+ * @param body Request body for face to face verification.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return result of the verify operation along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response verifyFaceToFaceWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.verifyFaceToFaceWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and
+ * attributes.<br /> * No image will be stored. Only the extracted face feature will be stored on server. The
+ * faceId is an identifier of the face feature and will be used in [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). The stored face feature(s) will expire
+ * and be deleted at the time specified by faceIdTimeToLive after the original detection call. * Optional parameters
+ * include faceId, landmarks, and attributes. Attributes include age, gender, headPose, smile, facialHair, glasses,
+ * emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, mask, and qualityForRecognition. Some of
+ * the results returned for specific attributes may not be highly accurate. * JPEG, PNG, GIF (the first frame), and
+ * BMP format are supported. The allowed image file size is from 1KB to 6MB. * Up to 100 faces can be returned for
+ * an image. Faces are ranked by face rectangle size from large to small. * For optimal results when querying [Face
+ * - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) ('returnFaceId' is true), please use faces
+ * that are: frontal, clear, and with a minimum size of 200x200 pixels (100 pixels between eyes). * 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * * Different 'recognitionModel' values are provided. If follow-up operations like Verify, Identify, Find
+ * Similar are needed, please specify the recognition model with 'recognitionModel' parameter. The default value for
+ * 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in
+ * this parameter. Once specified, the detected faceIds will be associated with the specified recognition model.
+ * More details, please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ *
Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnFaceId | String | No | A value indicating whether the operation should return faceIds of detected faces. |
+ * | returnFaceLandmarks | String | No | A value indicating whether the operation should return landmarks of the detected faces. |
+ * | returnFaceAttributes | String | No | Analyze and return the one or more specified face attributes in the comma-separated string like "returnFaceAttributes=age,gender". The available attributes depends on the 'detectionModel' specified. 'detection_01' supports age, gender, headPose, smile, facialHair, glasses, emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, and qualityForRecognition. While 'detection_02' does not support any attributes and 'detection_03' only supports mask and qualityForRecognition. Additionally, qualityForRecognition is only supported when the 'recognitionModel' is specified as 'recognition_03' or 'recognition_04'. Note that each face attribute analysis has additional computational and time cost. In the form of "," separated string. |
+ * | recognitionModel | String | No | Name of recognition model. Recognition model is used when the face features are extracted and associated with detected faceIds, (Large)FaceList or (Large)PersonGroup. A recognition model name can be provided when performing Face - Detect or (Large)FaceList - Create or (Large)PersonGroup - Create. The default value is 'recognition_01', if latest model needed, please explicitly specify the model you need. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ * | detectionModel | String | No | 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. |
+ * | faceIdTimeToLive | String | No | The number of seconds for the faceId being cached. Supported range from 60 seconds up to 86400 seconds. The default value is 86400 (24 hours). |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * faceRectangle: {
+ * width: int
+ * height: int
+ * left: int
+ * top: int
+ * }
+ * faceLandmarks: {
+ * pupilLeft: {
+ * x: float
+ * y: float
+ * }
+ * pupilRight: (recursive schema, see pupilRight above)
+ * noseTip: (recursive schema, see noseTip above)
+ * mouthLeft: (recursive schema, see mouthLeft above)
+ * mouthRight: (recursive schema, see mouthRight above)
+ * eyebrowLeftOuter: (recursive schema, see eyebrowLeftOuter above)
+ * eyebrowLeftInner: (recursive schema, see eyebrowLeftInner above)
+ * eyeLeftOuter: (recursive schema, see eyeLeftOuter above)
+ * eyeLeftTop: (recursive schema, see eyeLeftTop above)
+ * eyeLeftBottom: (recursive schema, see eyeLeftBottom above)
+ * eyeLeftInner: (recursive schema, see eyeLeftInner above)
+ * eyebrowRightInner: (recursive schema, see eyebrowRightInner above)
+ * eyebrowRightOuter: (recursive schema, see eyebrowRightOuter above)
+ * eyeRightInner: (recursive schema, see eyeRightInner above)
+ * eyeRightTop: (recursive schema, see eyeRightTop above)
+ * eyeRightBottom: (recursive schema, see eyeRightBottom above)
+ * eyeRightOuter: (recursive schema, see eyeRightOuter above)
+ * noseRootLeft: (recursive schema, see noseRootLeft above)
+ * noseRootRight: (recursive schema, see noseRootRight above)
+ * noseLeftAlarTop: (recursive schema, see noseLeftAlarTop above)
+ * noseRightAlarTop: (recursive schema, see noseRightAlarTop above)
+ * noseLeftAlarOutTip: (recursive schema, see noseLeftAlarOutTip above)
+ * noseRightAlarOutTip: (recursive schema, see noseRightAlarOutTip above)
+ * upperLipTop: (recursive schema, see upperLipTop above)
+ * upperLipBottom: (recursive schema, see upperLipBottom above)
+ * underLipTop: (recursive schema, see underLipTop above)
+ * underLipBottom: (recursive schema, see underLipBottom above)
+ * }
+ * faceAttributes: {
+ * age: Float
+ * gender: String(male/female)
+ * smile: Float
+ * facialHair: {
+ * moustache: Float
+ * beard: Float
+ * sideburns: Float
+ * }
+ * glasses: String(noGlasses/readingGlasses/sunglasses/swimmingGoggles)
+ * headPose: {
+ * roll: Float
+ * yaw: Float
+ * pitch: Float
+ * }
+ * emotion: {
+ * anger: Float
+ * contempt: Float
+ * disgust: Float
+ * fear: Float
+ * happiness: Float
+ * neutral: Float
+ * sadness: Float
+ * surprise: Float
+ * }
+ * hair: {
+ * bald: Float
+ * invisible: Boolean
+ * hairColor: [
+ * {
+ * color: String(unknown/white/gray/blond/brown/red/black/other)
+ * confidence: Float
+ * }
+ * ]
+ * }
+ * makeup: {
+ * eyeMakeup: Boolean
+ * lipMakeup: Boolean
+ * }
+ * occlusion: {
+ * foreheadOccluded: Boolean
+ * eyeOccluded: Boolean
+ * mouthOccluded: Boolean
+ * }
+ * accessories: [
+ * {
+ * type: String(headWear/glasses/mask)
+ * confidence: Float
+ * }
+ * ]
+ * blur: {
+ * blurLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * exposure: {
+ * exposureLevel: String(UnderExposure/GoodExposure/OverExposure)
+ * value: Float
+ * }
+ * noise: {
+ * noiseLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * mask: {
+ * type: String(noMask/faceMask/otherMaskOrOcclusion/uncertain)
+ * noseAndMouthCovered: Boolean
+ * }
+ * qualityForRecognition: String(Low/Medium/High)
+ * }
+ * }
+ * ]
+ * }
+ *
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of DetectedFace along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response detectWithUrlWithResponse(BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.asyncClient.detectWithUrlWithResponse(imageUrl, requestOptions).block();
+ }
+
+ /**
+ * Verify whether two faces belong to a same person. Compares a face Id with a Person Id.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId: String
+ * personGroupId: String
+ * largePersonGroupId: String
+ * personId: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * isIdentical: boolean
+ * confidence: float
+ * }
+ * }
+ *
+ * @param body Request body for face to person verification.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return result of the verify operation along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response verifyFaceToPersonWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.verifyFaceToPersonWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and
+ * attributes.<br /> * No image will be stored. Only the extracted face feature will be stored on server. The
+ * faceId is an identifier of the face feature and will be used in [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). The stored face feature(s) will expire
+ * and be deleted at the time specified by faceIdTimeToLive after the original detection call. * Optional parameters
+ * include faceId, landmarks, and attributes. Attributes include age, gender, headPose, smile, facialHair, glasses,
+ * emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, mask, and qualityForRecognition. Some of
+ * the results returned for specific attributes may not be highly accurate. * JPEG, PNG, GIF (the first frame), and
+ * BMP format are supported. The allowed image file size is from 1KB to 6MB. * Up to 100 faces can be returned for
+ * an image. Faces are ranked by face rectangle size from large to small. * For optimal results when querying [Face
+ * - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) ('returnFaceId' is true), please use faces
+ * that are: frontal, clear, and with a minimum size of 200x200 pixels (100 pixels between eyes). * 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model) *
+ * Different 'recognitionModel' values are provided. If follow-up operations like Verify, Identify, Find Similar are
+ * needed, please specify the recognition model with 'recognitionModel' parameter. The default value for
+ * 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in
+ * this parameter. Once specified, the detected faceIds will be associated with the specified recognition model.
+ * More details, please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnFaceId | String | No | A value indicating whether the operation should return faceIds of detected faces. |
+ * | returnFaceLandmarks | String | No | A value indicating whether the operation should return landmarks of the detected faces. |
+ * | returnFaceAttributes | String | No | Analyze and return the one or more specified face attributes in the comma-separated string like "returnFaceAttributes=age,gender". The available attributes depends on the 'detectionModel' specified. 'detection_01' supports age, gender, headPose, smile, facialHair, glasses, emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, and qualityForRecognition. While 'detection_02' does not support any attributes and 'detection_03' only supports mask and qualityForRecognition. Additionally, qualityForRecognition is only supported when the 'recognitionModel' is specified as 'recognition_03' or 'recognition_04'. Note that each face attribute analysis has additional computational and time cost. In the form of "," separated string. |
+ * | recognitionModel | String | No | Name of recognition model. Recognition model is used when the face features are extracted and associated with detected faceIds, (Large)FaceList or (Large)PersonGroup. A recognition model name can be provided when performing Face - Detect or (Large)FaceList - Create or (Large)PersonGroup - Create. The default value is 'recognition_01', if latest model needed, please explicitly specify the model you need. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ * | detectionModel | String | No | 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. |
+ * | faceIdTimeToLive | String | No | The number of seconds for the faceId being cached. Supported range from 60 seconds up to 86400 seconds. The default value is 86400 (24 hours). |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * faceRectangle: {
+ * width: int
+ * height: int
+ * left: int
+ * top: int
+ * }
+ * faceLandmarks: {
+ * pupilLeft: {
+ * x: float
+ * y: float
+ * }
+ * pupilRight: (recursive schema, see pupilRight above)
+ * noseTip: (recursive schema, see noseTip above)
+ * mouthLeft: (recursive schema, see mouthLeft above)
+ * mouthRight: (recursive schema, see mouthRight above)
+ * eyebrowLeftOuter: (recursive schema, see eyebrowLeftOuter above)
+ * eyebrowLeftInner: (recursive schema, see eyebrowLeftInner above)
+ * eyeLeftOuter: (recursive schema, see eyeLeftOuter above)
+ * eyeLeftTop: (recursive schema, see eyeLeftTop above)
+ * eyeLeftBottom: (recursive schema, see eyeLeftBottom above)
+ * eyeLeftInner: (recursive schema, see eyeLeftInner above)
+ * eyebrowRightInner: (recursive schema, see eyebrowRightInner above)
+ * eyebrowRightOuter: (recursive schema, see eyebrowRightOuter above)
+ * eyeRightInner: (recursive schema, see eyeRightInner above)
+ * eyeRightTop: (recursive schema, see eyeRightTop above)
+ * eyeRightBottom: (recursive schema, see eyeRightBottom above)
+ * eyeRightOuter: (recursive schema, see eyeRightOuter above)
+ * noseRootLeft: (recursive schema, see noseRootLeft above)
+ * noseRootRight: (recursive schema, see noseRootRight above)
+ * noseLeftAlarTop: (recursive schema, see noseLeftAlarTop above)
+ * noseRightAlarTop: (recursive schema, see noseRightAlarTop above)
+ * noseLeftAlarOutTip: (recursive schema, see noseLeftAlarOutTip above)
+ * noseRightAlarOutTip: (recursive schema, see noseRightAlarOutTip above)
+ * upperLipTop: (recursive schema, see upperLipTop above)
+ * upperLipBottom: (recursive schema, see upperLipBottom above)
+ * underLipTop: (recursive schema, see underLipTop above)
+ * underLipBottom: (recursive schema, see underLipBottom above)
+ * }
+ * faceAttributes: {
+ * age: Float
+ * gender: String(male/female)
+ * smile: Float
+ * facialHair: {
+ * moustache: Float
+ * beard: Float
+ * sideburns: Float
+ * }
+ * glasses: String(noGlasses/readingGlasses/sunglasses/swimmingGoggles)
+ * headPose: {
+ * roll: Float
+ * yaw: Float
+ * pitch: Float
+ * }
+ * emotion: {
+ * anger: Float
+ * contempt: Float
+ * disgust: Float
+ * fear: Float
+ * happiness: Float
+ * neutral: Float
+ * sadness: Float
+ * surprise: Float
+ * }
+ * hair: {
+ * bald: Float
+ * invisible: Boolean
+ * hairColor: [
+ * {
+ * color: String(unknown/white/gray/blond/brown/red/black/other)
+ * confidence: Float
+ * }
+ * ]
+ * }
+ * makeup: {
+ * eyeMakeup: Boolean
+ * lipMakeup: Boolean
+ * }
+ * occlusion: {
+ * foreheadOccluded: Boolean
+ * eyeOccluded: Boolean
+ * mouthOccluded: Boolean
+ * }
+ * accessories: [
+ * {
+ * type: String(headWear/glasses/mask)
+ * confidence: Float
+ * }
+ * ]
+ * blur: {
+ * blurLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * exposure: {
+ * exposureLevel: String(UnderExposure/GoodExposure/OverExposure)
+ * value: Float
+ * }
+ * noise: {
+ * noiseLevel: String(Low/Medium/High)
+ * value: Float
+ * }
+ * mask: {
+ * type: String(noMask/faceMask/otherMaskOrOcclusion/uncertain)
+ * noseAndMouthCovered: Boolean
+ * }
+ * qualityForRecognition: String(Low/Medium/High)
+ * }
+ * }
+ * ]
+ * }
+ *
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of DetectedFace along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response detectWithStreamWithResponse(BinaryData image, RequestOptions requestOptions) {
+ return this.asyncClient.detectWithStreamWithResponse(image, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceClientBuilder.java
new file mode 100644
index 000000000000..bcce339301e7
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the FaceClient type. */
+@ServiceClientBuilder(serviceClients = {FaceClient.class, FaceAsyncClient.class})
+public final class FaceClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the FaceClientBuilder. */
+ @Generated
+ public FaceClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the FaceClientBuilder.
+ */
+ @Generated
+ public FaceClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of FaceAsyncClient class.
+ *
+ * @return an instance of FaceAsyncClient.
+ */
+ @Generated
+ public FaceAsyncClient buildAsyncClient() {
+ return new FaceAsyncClient(buildInnerClient().getFaces());
+ }
+
+ /**
+ * Builds an instance of FaceClient class.
+ *
+ * @return an instance of FaceClient.
+ */
+ @Generated
+ public FaceClient buildClient() {
+ return new FaceClient(new FaceAsyncClient(buildInnerClient().getFaces()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListAsyncClient.java
new file mode 100644
index 000000000000..537e917d6ee4
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListAsyncClient.java
@@ -0,0 +1,367 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceListsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = FaceListClientBuilder.class, isAsync = true)
+public final class FaceListAsyncClient {
+ @Generated private final FaceListsImpl serviceClient;
+
+ /**
+ * Initializes an instance of FaceListAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ FaceListAsyncClient(FaceListsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Create an empty face list with user-specified faceListId, name, an optional userData and recognitionModel. Up to
+ * 64 face lists are allowed in one subscription. <br /> Face list is a list of faces, up to 1,000 faces, and
+ * used by [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After
+ * creation, user should use [FaceList - Add
+ * Face](https://docs.microsoft.com/rest/api/faceapi/facelist/addfacefromurl) to import the faces. No image will be
+ * stored. Only the extracted face features are stored on server until [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Find Similar is used
+ * for scenario like finding celebrity-like faces, similar face filtering, or as a light way face identification.
+ * But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> Please consider
+ * [LargeFaceList](https://docs.microsoft.com/rest/api/faceapi/largefacelist) when the face number is large. It can
+ * support up to 1,000,000 faces. <br />'recognitionModel' should be specified to associate with this face
+ * list. 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 face list will use the
+ * recognition model that's already associated with the collection. Existing face features in a face list can't be
+ * updated to features extracted by another version of recognition model. Please Refer to [Specify a face
+ * recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for creating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponse(String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createWithResponseAsync(faceListId, body, requestOptions);
+ }
+
+ /**
+ * Retrieve a face list’s faceListId, name, userData, recognitionModel and faces in the face list.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return face list object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(String faceListId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(faceListId, requestOptions);
+ }
+
+ /**
+ * Update information of a face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for updating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(faceListId, body, requestOptions);
+ }
+
+ /**
+ * Delete a specified face list.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(String faceListId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(faceListId, requestOptions);
+ }
+
+ /**
+ * List face lists’ faceListId, name, userData and recognitionModel. <br /> To get face information inside
+ * faceList use [FaceList - Get](https://docs.microsoft.com/rest/api/faceapi/facelist/get).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face list results, with fields of faceListId, name and userData along with {@link Response}
+ * on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * Delete a face from a face list by specified faceListId and persistedFaceId. <br /> Adding/deleting faces
+ * to/from a same face list are processed sequentially and to/from different face lists are in parallel.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteFaceWithResponse(
+ String faceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteFaceWithResponseAsync(faceListId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromUrlWithResponse(
+ String faceListId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromUrlWithResponseAsync(faceListId, imageUrl, requestOptions);
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromStreamWithResponse(
+ String faceListId, BinaryData image, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromStreamWithResponseAsync(faceListId, image, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListClient.java
new file mode 100644
index 000000000000..50f33b4fc9cb
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListClient.java
@@ -0,0 +1,364 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = FaceListClientBuilder.class)
+public final class FaceListClient {
+ @Generated private final FaceListAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of FaceListClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ FaceListClient(FaceListAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Create an empty face list with user-specified faceListId, name, an optional userData and recognitionModel. Up to
+ * 64 face lists are allowed in one subscription. <br /> Face list is a list of faces, up to 1,000 faces, and
+ * used by [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After
+ * creation, user should use [FaceList - Add
+ * Face](https://docs.microsoft.com/rest/api/faceapi/facelist/addfacefromurl) to import the faces. No image will be
+ * stored. Only the extracted face features are stored on server until [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Find Similar is used
+ * for scenario like finding celebrity-like faces, similar face filtering, or as a light way face identification.
+ * But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> Please consider
+ * [LargeFaceList](https://docs.microsoft.com/rest/api/faceapi/largefacelist) when the face number is large. It can
+ * support up to 1,000,000 faces. <br />'recognitionModel' should be specified to associate with this face
+ * list. 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 face list will use the
+ * recognition model that's already associated with the collection. Existing face features in a face list can't be
+ * updated to features extracted by another version of recognition model. Please Refer to [Specify a face
+ * recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for creating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createWithResponse(faceListId, body, requestOptions).block();
+ }
+
+ /**
+ * Retrieve a face list’s faceListId, name, userData, recognitionModel and faces in the face list.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return face list object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String faceListId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(faceListId, requestOptions).block();
+ }
+
+ /**
+ * Update information of a face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for updating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(faceListId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete a specified face list.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String faceListId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(faceListId, requestOptions).block();
+ }
+
+ /**
+ * List face lists’ faceListId, name, userData and recognitionModel. <br /> To get face information inside
+ * faceList use [FaceList - Get](https://docs.microsoft.com/rest/api/faceapi/facelist/get).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face list results, with fields of faceListId, name and userData along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(requestOptions).block();
+ }
+
+ /**
+ * Delete a face from a face list by specified faceListId and persistedFaceId. <br /> Adding/deleting faces
+ * to/from a same face list are processed sequentially and to/from different face lists are in parallel.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteFaceWithResponse(
+ String faceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteFaceWithResponse(faceListId, persistedFaceId, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromUrlWithResponse(
+ String faceListId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.asyncClient.addFaceFromUrlWithResponse(faceListId, imageUrl, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromStreamWithResponse(
+ String faceListId, BinaryData image, RequestOptions requestOptions) {
+ return this.asyncClient.addFaceFromStreamWithResponse(faceListId, image, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListClientBuilder.java
new file mode 100644
index 000000000000..bc890c30f893
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceListClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the FaceListClient type. */
+@ServiceClientBuilder(serviceClients = {FaceListClient.class, FaceListAsyncClient.class})
+public final class FaceListClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the FaceListClientBuilder. */
+ @Generated
+ public FaceListClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the FaceListClientBuilder.
+ */
+ @Generated
+ public FaceListClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of FaceListAsyncClient class.
+ *
+ * @return an instance of FaceListAsyncClient.
+ */
+ @Generated
+ public FaceListAsyncClient buildAsyncClient() {
+ return new FaceListAsyncClient(buildInnerClient().getFaceLists());
+ }
+
+ /**
+ * Builds an instance of FaceListClient class.
+ *
+ * @return an instance of FaceListClient.
+ */
+ @Generated
+ public FaceListClient buildClient() {
+ return new FaceListClient(new FaceListAsyncClient(buildInnerClient().getFaceLists()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceServiceVersion.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceServiceVersion.java
new file mode 100644
index 000000000000..4b08740edb3a
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/FaceServiceVersion.java
@@ -0,0 +1,33 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.util.ServiceVersion;
+
+/** Service version of FaceClient. */
+public enum FaceServiceVersion implements ServiceVersion {
+ /** Enum value 1.0-preview. */
+ V1_0_PREVIEW("1.0-preview");
+
+ private final String version;
+
+ FaceServiceVersion(String version) {
+ this.version = version;
+ }
+
+ @Override
+ public String getVersion() {
+ return this.version;
+ }
+
+ /**
+ * Gets the latest service version supported by this client library.
+ *
+ * @return The latest {@link FaceServiceVersion}.
+ */
+ public static FaceServiceVersion getLatest() {
+ return V1_0_PREVIEW;
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListAsyncClient.java
new file mode 100644
index 000000000000..a7b57f69e9b8
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListAsyncClient.java
@@ -0,0 +1,518 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.LargeFaceListsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = LargeFaceListClientBuilder.class, isAsync = true)
+public final class LargeFaceListAsyncClient {
+ @Generated private final LargeFaceListsImpl serviceClient;
+
+ /**
+ * Initializes an instance of LargeFaceListAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ LargeFaceListAsyncClient(LargeFaceListsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Create an empty large face list with user-specified largeFaceListId, name, an optional userData and
+ * recognitionModel. <br /> Large face list is a list of faces, up to 1,000,000 faces, and used by [Face -
+ * Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After creation, user
+ * should use [LargeFaceList Face - Add](https://docs.microsoft.com/rest/api/faceapi/largefacelist/addfacefromurl)
+ * to import the faces and [LargeFaceList - Train](https://docs.microsoft.com/rest/api/faceapi/largefacelist/train)
+ * to make it ready for [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). No
+ * image will be stored. Only the extracted face features are stored on server until [LargeFaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/delete) is called. <br /> Find Similar is
+ * used for scenario like finding celebrity-like faces, similar face filtering, or as a light way face
+ * identification. But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br/>'recognitionModel' should be
+ * specified to associate with this large face list. 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 face list will use the recognition model that's already associated with the
+ * collection. Existing face features in a large face list can't be updated to features extracted by another version
+ * of recognition model. Please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Large face list quota: * Free-tier subscription quota: 64 large face lists. * S0-tier subscription quota:
+ * 1,000,000 large face lists.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param body Request body for creating a large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponse(
+ String largeFaceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createWithResponseAsync(largeFaceListId, body, requestOptions);
+ }
+
+ /**
+ * Retrieve a large face list’s largeFaceListId, name, userData and recognitionModel.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * largeFaceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return large face list object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(largeFaceListId, requestOptions);
+ }
+
+ /**
+ * Update information of a large face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param body Request body for updating a large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(
+ String largeFaceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(largeFaceListId, body, requestOptions);
+ }
+
+ /**
+ * Delete a specified large face list.
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(largeFaceListId, requestOptions);
+ }
+
+ /**
+ * Retrieve the training status of a large face list (completed or ongoing).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(nonstarted/running/succeeded/failed)
+ * created: String
+ * lastAction: String
+ * lastSuccessfulTraining: String
+ * message: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return training status object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getTrainingStatusWithResponse(
+ String largeFaceListId, RequestOptions requestOptions) {
+ return this.serviceClient.getTrainingStatusWithResponseAsync(largeFaceListId, requestOptions);
+ }
+
+ /**
+ * List large face lists’ information of largeFaceListId, name, userData and recognitionModel. <br /> To get
+ * face information inside largeFaceList use [LargeFaceList Face -
+ * Get](https://docs.microsoft.com/rest/api/faceapi/largefacelist/getface)<br /> * Large face lists are stored
+ * in alphabetical order of largeFaceListId. * "start" parameter (string, optional) is a user-provided
+ * largeFaceListId value that returned entries have larger ids by string comparison. "start" set to empty to
+ * indicate return from the first item. * "top" parameter (int, optional) specifies the number of entries to return.
+ * A maximal of 1000 entries can be returned in one call. To fetch more, you can specify "start" with the last
+ * returned entry’s Id of the current call. <br /> For example, total 5 large person lists: "list1", ...,
+ * "list5". <br /> "start=&top=" will return all 5 lists. <br /> "start=&top=2" will return
+ * "list1", "list2". <br /> "start=list2&top=3" will return "list3", "list4", "list5".
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ * | start | String | No | Starting large face list id to return (used to list a range of large face lists). |
+ * | top | String | No | Number of large face lists to return starting with the large face list id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * largeFaceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of large face list results, with fields of largeFaceListId, name and userData along with {@link
+ * Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * Queue a large face list training task, the training task may not be started immediately.
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> trainWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.serviceClient.trainWithResponseAsync(largeFaceListId, requestOptions);
+ }
+
+ /**
+ * Delete a face from a large face list by specified largeFaceListId and persistedFaceId. <br />
+ * Adding/deleting faces to/from a same large face list are processed sequentially and to/from different large face
+ * lists are in parallel.
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteFaceWithResponse(
+ String largeFaceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteFaceWithResponseAsync(largeFaceListId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Retrieve information about a persisted face (specified by persistedFaceId and its belonging largeFaceListId).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getFaceWithResponse(
+ String largeFaceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.getFaceWithResponseAsync(largeFaceListId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Update a persisted face's userData field.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param body Request body for updating persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateFaceWithResponse(
+ String largeFaceListId, String persistedFaceId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateFaceWithResponseAsync(largeFaceListId, persistedFaceId, body, requestOptions);
+ }
+
+ /**
+ * Add a face to a specified large face list, up to 1,000,000 faces. <br /> 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 [LargeFaceList Face - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/deleteface) or
+ * [LargeFaceList - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/delete) is called. <br
+ * /> Note persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+ *
+ * Quota: * Free-tier subscription quota: 1,000 faces per large face list. * S0-tier subscription quota:
+ * 1,000,000 faces per large face list.
+ *
+ *
Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromUrlWithResponse(
+ String largeFaceListId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromUrlWithResponseAsync(largeFaceListId, imageUrl, requestOptions);
+ }
+
+ /**
+ * List all faces in a large face list, and retrieve face information (including userData and persistedFaceIds of
+ * registered faces of the face).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | Starting face id to return (used to list a range of faces). |
+ * | top | String | No | Number of faces to return starting with the face id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of persisted faces within the face list or large face list along with {@link Response} on
+ * successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listFacesWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.serviceClient.listFacesWithResponseAsync(largeFaceListId, requestOptions);
+ }
+
+ /**
+ * Add a face to a specified large face list, up to 1,000,000 faces. <br /> 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 [LargeFaceList Face - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/deleteface) or
+ * [LargeFaceList - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/delete) is called. <br
+ * /> Note persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Quota: * Free-tier subscription quota: 1,000 faces per large face list. * S0-tier subscription quota:
+ * 1,000,000 faces per large face list.
+ *
+ *
Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromStreamWithResponse(
+ String largeFaceListId, BinaryData image, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromStreamWithResponseAsync(largeFaceListId, image, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListClient.java
new file mode 100644
index 000000000000..6f02a57873c5
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListClient.java
@@ -0,0 +1,512 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = LargeFaceListClientBuilder.class)
+public final class LargeFaceListClient {
+ @Generated private final LargeFaceListAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of LargeFaceListClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ LargeFaceListClient(LargeFaceListAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Create an empty large face list with user-specified largeFaceListId, name, an optional userData and
+ * recognitionModel. <br /> Large face list is a list of faces, up to 1,000,000 faces, and used by [Face -
+ * Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After creation, user
+ * should use [LargeFaceList Face - Add](https://docs.microsoft.com/rest/api/faceapi/largefacelist/addfacefromurl)
+ * to import the faces and [LargeFaceList - Train](https://docs.microsoft.com/rest/api/faceapi/largefacelist/train)
+ * to make it ready for [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). No
+ * image will be stored. Only the extracted face features are stored on server until [LargeFaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/delete) is called. <br /> Find Similar is
+ * used for scenario like finding celebrity-like faces, similar face filtering, or as a light way face
+ * identification. But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br/>'recognitionModel' should be
+ * specified to associate with this large face list. 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 face list will use the recognition model that's already associated with the
+ * collection. Existing face features in a large face list can't be updated to features extracted by another version
+ * of recognition model. Please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Large face list quota: * Free-tier subscription quota: 64 large face lists. * S0-tier subscription quota:
+ * 1,000,000 large face lists.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param body Request body for creating a large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(String largeFaceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createWithResponse(largeFaceListId, body, requestOptions).block();
+ }
+
+ /**
+ * Retrieve a large face list’s largeFaceListId, name, userData and recognitionModel.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * largeFaceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return large face list object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(largeFaceListId, requestOptions).block();
+ }
+
+ /**
+ * Update information of a large face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param body Request body for updating a large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(String largeFaceListId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(largeFaceListId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete a specified large face list.
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(largeFaceListId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve the training status of a large face list (completed or ongoing).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(nonstarted/running/succeeded/failed)
+ * created: String
+ * lastAction: String
+ * lastSuccessfulTraining: String
+ * message: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return training status object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getTrainingStatusWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.asyncClient.getTrainingStatusWithResponse(largeFaceListId, requestOptions).block();
+ }
+
+ /**
+ * List large face lists’ information of largeFaceListId, name, userData and recognitionModel. <br /> To get
+ * face information inside largeFaceList use [LargeFaceList Face -
+ * Get](https://docs.microsoft.com/rest/api/faceapi/largefacelist/getface)<br /> * Large face lists are stored
+ * in alphabetical order of largeFaceListId. * "start" parameter (string, optional) is a user-provided
+ * largeFaceListId value that returned entries have larger ids by string comparison. "start" set to empty to
+ * indicate return from the first item. * "top" parameter (int, optional) specifies the number of entries to return.
+ * A maximal of 1000 entries can be returned in one call. To fetch more, you can specify "start" with the last
+ * returned entry’s Id of the current call. <br /> For example, total 5 large person lists: "list1", ...,
+ * "list5". <br /> "start=&top=" will return all 5 lists. <br /> "start=&top=2" will return
+ * "list1", "list2". <br /> "start=list2&top=3" will return "list3", "list4", "list5".
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ * | start | String | No | Starting large face list id to return (used to list a range of large face lists). |
+ * | top | String | No | Number of large face lists to return starting with the large face list id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * largeFaceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of large face list results, with fields of largeFaceListId, name and userData along with {@link
+ * Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(requestOptions).block();
+ }
+
+ /**
+ * Queue a large face list training task, the training task may not be started immediately.
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response trainWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.asyncClient.trainWithResponse(largeFaceListId, requestOptions).block();
+ }
+
+ /**
+ * Delete a face from a large face list by specified largeFaceListId and persistedFaceId. <br />
+ * Adding/deleting faces to/from a same large face list are processed sequentially and to/from different large face
+ * lists are in parallel.
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteFaceWithResponse(
+ String largeFaceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteFaceWithResponse(largeFaceListId, persistedFaceId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve information about a persisted face (specified by persistedFaceId and its belonging largeFaceListId).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getFaceWithResponse(
+ String largeFaceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient.getFaceWithResponse(largeFaceListId, persistedFaceId, requestOptions).block();
+ }
+
+ /**
+ * Update a persisted face's userData field.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param body Request body for updating persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateFaceWithResponse(
+ String largeFaceListId, String persistedFaceId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateFaceWithResponse(largeFaceListId, persistedFaceId, body, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a specified large face list, up to 1,000,000 faces. <br /> 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 [LargeFaceList Face - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/deleteface) or
+ * [LargeFaceList - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/delete) is called. <br
+ * /> Note persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+ *
+ * Quota: * Free-tier subscription quota: 1,000 faces per large face list. * S0-tier subscription quota:
+ * 1,000,000 faces per large face list.
+ *
+ *
Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromUrlWithResponse(
+ String largeFaceListId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.asyncClient.addFaceFromUrlWithResponse(largeFaceListId, imageUrl, requestOptions).block();
+ }
+
+ /**
+ * List all faces in a large face list, and retrieve face information (including userData and persistedFaceIds of
+ * registered faces of the face).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | Starting face id to return (used to list a range of faces). |
+ * | top | String | No | Number of faces to return starting with the face id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of persisted faces within the face list or large face list along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listFacesWithResponse(String largeFaceListId, RequestOptions requestOptions) {
+ return this.asyncClient.listFacesWithResponse(largeFaceListId, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a specified large face list, up to 1,000,000 faces. <br /> 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 [LargeFaceList Face - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/deleteface) or
+ * [LargeFaceList - Delete](https://docs.microsoft.com/rest/api/faceapi/largefacelist/delete) is called. <br
+ * /> Note persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Quota: * Free-tier subscription quota: 1,000 faces per large face list. * S0-tier subscription quota:
+ * 1,000,000 faces per large face list.
+ *
+ *
Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largeFaceListId Id referencing a particular large face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromStreamWithResponse(
+ String largeFaceListId, BinaryData image, RequestOptions requestOptions) {
+ return this.asyncClient.addFaceFromStreamWithResponse(largeFaceListId, image, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListClientBuilder.java
new file mode 100644
index 000000000000..5fd644780e49
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargeFaceListClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the LargeFaceListClient type. */
+@ServiceClientBuilder(serviceClients = {LargeFaceListClient.class, LargeFaceListAsyncClient.class})
+public final class LargeFaceListClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the LargeFaceListClientBuilder. */
+ @Generated
+ public LargeFaceListClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the LargeFaceListClientBuilder.
+ */
+ @Generated
+ public LargeFaceListClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of LargeFaceListAsyncClient class.
+ *
+ * @return an instance of LargeFaceListAsyncClient.
+ */
+ @Generated
+ public LargeFaceListAsyncClient buildAsyncClient() {
+ return new LargeFaceListAsyncClient(buildInnerClient().getLargeFaceLists());
+ }
+
+ /**
+ * Builds an instance of LargeFaceListClient class.
+ *
+ * @return an instance of LargeFaceListClient.
+ */
+ @Generated
+ public LargeFaceListClient buildClient() {
+ return new LargeFaceListClient(new LargeFaceListAsyncClient(buildInnerClient().getLargeFaceLists()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupAsyncClient.java
new file mode 100644
index 000000000000..957e11f61ef3
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupAsyncClient.java
@@ -0,0 +1,261 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.LargePersonGroupsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = LargePersonGroupClientBuilder.class, isAsync = true)
+public final class LargePersonGroupAsyncClient {
+ @Generated private final LargePersonGroupsImpl serviceClient;
+
+ /**
+ * Initializes an instance of LargePersonGroupAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ LargePersonGroupAsyncClient(LargePersonGroupsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * 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
+ * recognition feature, and up to 1,000,000 people. <br /> After creation, use [LargePersonGroup Person -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/create) to add person into the group,
+ * and call [LargePersonGroup - Train](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/train) to get
+ * this group ready for [Face - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br />
+ * No image will be stored. Only the person's extracted face features and userData will be stored on server until
+ * [LargePersonGroup Person - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/delete) or
+ * [LargePersonGroup - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/delete) is called.
+ * <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. Please refer to [Specify a face recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Large person group quota: * Free-tier subscription quota: 1,000 large person groups. * S0-tier subscription
+ * quota: 1,000,000 large person groups.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param body Request body for creating new large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponse(
+ String largePersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createWithResponseAsync(largePersonGroupId, body, requestOptions);
+ }
+
+ /**
+ * Delete an existing large person group. Persisted face features of all people in the large person group will also
+ * be deleted.
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(largePersonGroupId, requestOptions);
+ }
+
+ /**
+ * Retrieve the information of a large person group, including its name, userData and recognitionModel. This API
+ * returns large person group information only, use [LargePersonGroup Person -
+ * List](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/list) instead to retrieve person
+ * information under the large person group.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * largePersonGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return large person group object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(largePersonGroupId, requestOptions);
+ }
+
+ /**
+ * Update an existing large person group's display name and userData. The properties which does not appear in
+ * request body will not be updated.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param body Request body for updating large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(
+ String largePersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(largePersonGroupId, body, requestOptions);
+ }
+
+ /**
+ * Retrieve the training status of a large person group (completed or ongoing).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(nonstarted/running/succeeded/failed)
+ * created: String
+ * lastAction: String
+ * lastSuccessfulTraining: String
+ * message: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return training status object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getTrainingStatusWithResponse(
+ String largePersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.getTrainingStatusWithResponseAsync(largePersonGroupId, requestOptions);
+ }
+
+ /**
+ * List all existing large person groups’ largePersonGroupId, name, userData and recognitionModel.<br /> *
+ * Large person groups are stored in alphabetical order of largePersonGroupId. * "start" parameter (string,
+ * optional) is a user-provided largePersonGroupId value that returned entries have larger ids by string comparison.
+ * "start" set to empty to indicate return from the first item. * "top" parameter (int, optional) specifies the
+ * number of entries to return. A maximal of 1000 entries can be returned in one call. To fetch more, you can
+ * specify "start" with the last returned entry’s Id of the current call. <br /> For example, total 5 large
+ * person groups: "group1", ..., "group5". <br /> "start=&top=" will return all 5 groups. <br />
+ * "start=&top=2" will return "group1", "group2". <br /> "start=group2&top=3" will return "group3",
+ * "group4", "group5".
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List large person groups from the least largePersonGroupId greater than the "start". |
+ * | top | String | No | The number of large person groups to list. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * largePersonGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of large person groups along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * Queue a large person group training task, the training task may not be started immediately.
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> trainWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.trainWithResponseAsync(largePersonGroupId, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupClient.java
new file mode 100644
index 000000000000..6ed1940a16fd
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupClient.java
@@ -0,0 +1,259 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = LargePersonGroupClientBuilder.class)
+public final class LargePersonGroupClient {
+ @Generated private final LargePersonGroupAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of LargePersonGroupClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ LargePersonGroupClient(LargePersonGroupAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * 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
+ * recognition feature, and up to 1,000,000 people. <br /> After creation, use [LargePersonGroup Person -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/create) to add person into the group,
+ * and call [LargePersonGroup - Train](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/train) to get
+ * this group ready for [Face - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br />
+ * No image will be stored. Only the person's extracted face features and userData will be stored on server until
+ * [LargePersonGroup Person - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/delete) or
+ * [LargePersonGroup - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/delete) is called.
+ * <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. Please refer to [Specify a face recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Large person group quota: * Free-tier subscription quota: 1,000 large person groups. * S0-tier subscription
+ * quota: 1,000,000 large person groups.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param body Request body for creating new large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(
+ String largePersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createWithResponse(largePersonGroupId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing large person group. Persisted face features of all people in the large person group will also
+ * be deleted.
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(largePersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve the information of a large person group, including its name, userData and recognitionModel. This API
+ * returns large person group information only, use [LargePersonGroup Person -
+ * List](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/list) instead to retrieve person
+ * information under the large person group.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * largePersonGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return large person group object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(largePersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * Update an existing large person group's display name and userData. The properties which does not appear in
+ * request body will not be updated.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param body Request body for updating large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(
+ String largePersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(largePersonGroupId, body, requestOptions).block();
+ }
+
+ /**
+ * Retrieve the training status of a large person group (completed or ongoing).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(nonstarted/running/succeeded/failed)
+ * created: String
+ * lastAction: String
+ * lastSuccessfulTraining: String
+ * message: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return training status object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getTrainingStatusWithResponse(
+ String largePersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.getTrainingStatusWithResponse(largePersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * List all existing large person groups’ largePersonGroupId, name, userData and recognitionModel.<br /> *
+ * Large person groups are stored in alphabetical order of largePersonGroupId. * "start" parameter (string,
+ * optional) is a user-provided largePersonGroupId value that returned entries have larger ids by string comparison.
+ * "start" set to empty to indicate return from the first item. * "top" parameter (int, optional) specifies the
+ * number of entries to return. A maximal of 1000 entries can be returned in one call. To fetch more, you can
+ * specify "start" with the last returned entry’s Id of the current call. <br /> For example, total 5 large
+ * person groups: "group1", ..., "group5". <br /> "start=&top=" will return all 5 groups. <br />
+ * "start=&top=2" will return "group1", "group2". <br /> "start=group2&top=3" will return "group3",
+ * "group4", "group5".
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List large person groups from the least largePersonGroupId greater than the "start". |
+ * | top | String | No | The number of large person groups to list. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * largePersonGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of large person groups along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(requestOptions).block();
+ }
+
+ /**
+ * Queue a large person group training task, the training task may not be started immediately.
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response trainWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.trainWithResponse(largePersonGroupId, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupClientBuilder.java
new file mode 100644
index 000000000000..5389f611ca27
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the LargePersonGroupClient type. */
+@ServiceClientBuilder(serviceClients = {LargePersonGroupClient.class, LargePersonGroupAsyncClient.class})
+public final class LargePersonGroupClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the LargePersonGroupClientBuilder. */
+ @Generated
+ public LargePersonGroupClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the LargePersonGroupClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of LargePersonGroupAsyncClient class.
+ *
+ * @return an instance of LargePersonGroupAsyncClient.
+ */
+ @Generated
+ public LargePersonGroupAsyncClient buildAsyncClient() {
+ return new LargePersonGroupAsyncClient(buildInnerClient().getLargePersonGroups());
+ }
+
+ /**
+ * Builds an instance of LargePersonGroupClient class.
+ *
+ * @return an instance of LargePersonGroupClient.
+ */
+ @Generated
+ public LargePersonGroupClient buildClient() {
+ return new LargePersonGroupClient(new LargePersonGroupAsyncClient(buildInnerClient().getLargePersonGroups()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonAsyncClient.java
new file mode 100644
index 000000000000..b4098c835d59
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonAsyncClient.java
@@ -0,0 +1,429 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.LargePersonGroupPersonsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = LargePersonGroupPersonClientBuilder.class, isAsync = true)
+public final class LargePersonGroupPersonAsyncClient {
+ @Generated private final LargePersonGroupPersonsImpl serviceClient;
+
+ /**
+ * Initializes an instance of LargePersonGroupPersonAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ LargePersonGroupPersonAsyncClient(LargePersonGroupPersonsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Create a new person in a specified large person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param body Request body for creating new person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponse(
+ String largePersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createWithResponseAsync(largePersonGroupId, body, requestOptions);
+ }
+
+ /**
+ * List all persons in a large person group, and retrieve person information (including personId, name, userData and
+ * persistedFaceIds of registered faces of the person).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | Starting person id to return (used to list a range of persons). |
+ * | top | String | No | Number of persons to return starting with the person id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of Persons along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(largePersonGroupId, requestOptions);
+ }
+
+ /**
+ * 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 largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(
+ String largePersonGroupId, String personId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(largePersonGroupId, personId, requestOptions);
+ }
+
+ /**
+ * Retrieve a person's name and userData, and the persisted faceIds representing the registered person face feature.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(
+ String largePersonGroupId, String personId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(largePersonGroupId, personId, requestOptions);
+ }
+
+ /**
+ * Update name or userData of a person.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param body Request body for person update operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(
+ String largePersonGroupId, String personId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(largePersonGroupId, personId, body, requestOptions);
+ }
+
+ /**
+ * 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 largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteFaceWithResponse(
+ String largePersonGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteFaceWithResponseAsync(
+ largePersonGroupId, personId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Retrieve information about a persisted face (specified by persistedFaceId, personId and its belonging
+ * largePersonGroupId).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getFaceWithResponse(
+ String largePersonGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.getFaceWithResponseAsync(
+ largePersonGroupId, personId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Update a person persisted face's userData field.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param body Request body for updating persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateFaceWithResponse(
+ String largePersonGroupId,
+ String personId,
+ String persistedFaceId,
+ BinaryData body,
+ RequestOptions requestOptions) {
+ return this.serviceClient.updateFaceWithResponseAsync(
+ largePersonGroupId, personId, persistedFaceId, body, requestOptions);
+ }
+
+ /**
+ * 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](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/deleteface), [LargePersonGroup Person
+ * - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/delete) or [LargePersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromUrlWithResponse(
+ String largePersonGroupId, String personId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromUrlWithResponseAsync(
+ largePersonGroupId, personId, imageUrl, requestOptions);
+ }
+
+ /**
+ * 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](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/deleteface), [LargePersonGroup Person
+ * - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/delete) or [LargePersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromStreamWithResponse(
+ String largePersonGroupId, String personId, BinaryData image, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromStreamWithResponseAsync(
+ largePersonGroupId, personId, image, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonClient.java
new file mode 100644
index 000000000000..35034f1401f2
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonClient.java
@@ -0,0 +1,432 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = LargePersonGroupPersonClientBuilder.class)
+public final class LargePersonGroupPersonClient {
+ @Generated private final LargePersonGroupPersonAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of LargePersonGroupPersonClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ LargePersonGroupPersonClient(LargePersonGroupPersonAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Create a new person in a specified large person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param body Request body for creating new person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(
+ String largePersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createWithResponse(largePersonGroupId, body, requestOptions).block();
+ }
+
+ /**
+ * List all persons in a large person group, and retrieve person information (including personId, name, userData and
+ * persistedFaceIds of registered faces of the person).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | Starting person id to return (used to list a range of persons). |
+ * | top | String | No | Number of persons to return starting with the person id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of Persons along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(String largePersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(largePersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * 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 largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(
+ String largePersonGroupId, String personId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(largePersonGroupId, personId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve a person's name and userData, and the persisted faceIds representing the registered person face feature.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(
+ String largePersonGroupId, String personId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(largePersonGroupId, personId, requestOptions).block();
+ }
+
+ /**
+ * Update name or userData of a person.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param body Request body for person update operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(
+ String largePersonGroupId, String personId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(largePersonGroupId, personId, body, requestOptions).block();
+ }
+
+ /**
+ * 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 largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteFaceWithResponse(
+ String largePersonGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient
+ .deleteFaceWithResponse(largePersonGroupId, personId, persistedFaceId, requestOptions)
+ .block();
+ }
+
+ /**
+ * Retrieve information about a persisted face (specified by persistedFaceId, personId and its belonging
+ * largePersonGroupId).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getFaceWithResponse(
+ String largePersonGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient
+ .getFaceWithResponse(largePersonGroupId, personId, persistedFaceId, requestOptions)
+ .block();
+ }
+
+ /**
+ * Update a person persisted face's userData field.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param body Request body for updating persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateFaceWithResponse(
+ String largePersonGroupId,
+ String personId,
+ String persistedFaceId,
+ BinaryData body,
+ RequestOptions requestOptions) {
+ return this.asyncClient
+ .updateFaceWithResponse(largePersonGroupId, personId, persistedFaceId, body, requestOptions)
+ .block();
+ }
+
+ /**
+ * 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](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/deleteface), [LargePersonGroup Person
+ * - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/delete) or [LargePersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromUrlWithResponse(
+ String largePersonGroupId, String personId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.asyncClient
+ .addFaceFromUrlWithResponse(largePersonGroupId, personId, imageUrl, requestOptions)
+ .block();
+ }
+
+ /**
+ * 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](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/deleteface), [LargePersonGroup Person
+ * - Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroupperson/delete) or [LargePersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param largePersonGroupId Id referencing a particular large person group.
+ * @param personId Id referencing a particular person.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromStreamWithResponse(
+ String largePersonGroupId, String personId, BinaryData image, RequestOptions requestOptions) {
+ return this.asyncClient
+ .addFaceFromStreamWithResponse(largePersonGroupId, personId, image, requestOptions)
+ .block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonClientBuilder.java
new file mode 100644
index 000000000000..0579d2bd26cd
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/LargePersonGroupPersonClientBuilder.java
@@ -0,0 +1,265 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the LargePersonGroupPersonClient type. */
+@ServiceClientBuilder(serviceClients = {LargePersonGroupPersonClient.class, LargePersonGroupPersonAsyncClient.class})
+public final class LargePersonGroupPersonClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the LargePersonGroupPersonClientBuilder. */
+ @Generated
+ public LargePersonGroupPersonClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the LargePersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public LargePersonGroupPersonClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of LargePersonGroupPersonAsyncClient class.
+ *
+ * @return an instance of LargePersonGroupPersonAsyncClient.
+ */
+ @Generated
+ public LargePersonGroupPersonAsyncClient buildAsyncClient() {
+ return new LargePersonGroupPersonAsyncClient(buildInnerClient().getLargePersonGroupPersons());
+ }
+
+ /**
+ * Builds an instance of LargePersonGroupPersonClient class.
+ *
+ * @return an instance of LargePersonGroupPersonClient.
+ */
+ @Generated
+ public LargePersonGroupPersonClient buildClient() {
+ return new LargePersonGroupPersonClient(
+ new LargePersonGroupPersonAsyncClient(buildInnerClient().getLargePersonGroupPersons()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryAsyncClient.java
new file mode 100644
index 000000000000..72f53c3126bf
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryAsyncClient.java
@@ -0,0 +1,625 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.PersonDirectoriesImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = PersonDirectoryClientBuilder.class, isAsync = true)
+public final class PersonDirectoryAsyncClient {
+ @Generated private final PersonDirectoriesImpl serviceClient;
+
+ /**
+ * Initializes an instance of PersonDirectoryAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ PersonDirectoryAsyncClient(PersonDirectoriesImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Retrieve list of person information in person directory.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | The start parameter |
+ * | top | String | No | The top parameter |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * personId: String
+ * name: String
+ * userData: String
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of EnrollmentResponse along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getPersonsWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.getPersonsWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * Creates a new person in person directory.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * }
+ * }
+ *
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createPersonWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createPersonWithResponseAsync(body, requestOptions);
+ }
+
+ /**
+ * Update name or userData of a person.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId The personId parameter.
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updatePersonWithResponse(
+ String personId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updatePersonWithResponseAsync(personId, body, requestOptions);
+ }
+
+ /**
+ * Delete an existing person from person directory. The persistedFaceId, userData, person name and face feature(s)
+ * in the person entry will all be deleted.
+ *
+ * @param personId The personId parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deletePersonWithResponse(String personId, RequestOptions requestOptions) {
+ return this.serviceClient.deletePersonWithResponseAsync(personId, requestOptions);
+ }
+
+ /**
+ * Retrieve a person's name and userData, and the persisted faceIds representing the registered person face
+ * feature(s).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Person id.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getPersonWithResponse(String personId, RequestOptions requestOptions) {
+ return this.serviceClient.getPersonWithResponseAsync(personId, requestOptions);
+ }
+
+ /**
+ * Add a new face to person.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | detectionModel | String | No | Detection model string. |
+ * | userData | String | No | User data of person face. |
+ * | targetFace | String | No | Target face. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * recognitionModel: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Person id.
+ * @param recognitionModel Recognition model string.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addPersonFaceWithResponse(
+ String personId, String recognitionModel, RequestOptions requestOptions) {
+ return this.serviceClient.addPersonFaceWithResponseAsync(personId, recognitionModel, requestOptions);
+ }
+
+ /**
+ * Retrieve person face information. The persisted person face is specified by its personId and persistedFaceId.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Target person to get persistedFaceIds from.
+ * @param recognitionModel The 'recognitionModel' associated with this persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getPersonFacesWithResponse(
+ String personId, String recognitionModel, RequestOptions requestOptions) {
+ return this.serviceClient.getPersonFacesWithResponseAsync(personId, recognitionModel, requestOptions);
+ }
+
+ /**
+ * Delete an existing person face from person directory. The persistedFaceId, userData, and face feature in the
+ * person entry will all be deleted.
+ *
+ * @param personId Person id.
+ * @param recognitionModel Recognition model string.
+ * @param persistedFaceId Persisted face id to delete.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deletePersonFaceWithResponse(
+ String personId, String recognitionModel, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.deletePersonFaceWithResponseAsync(
+ personId, recognitionModel, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Retrieve person face information. The persisted person face is specified by its personId and persistedFaceId.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Target person to get face from.
+ * @param recognitionModel The 'recognitionModel' associated with this persisted face.
+ * @param persistedFaceId Target person face id to get.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getPersonFaceWithResponse(
+ String personId, String recognitionModel, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.getPersonFaceWithResponseAsync(
+ personId, recognitionModel, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Update the data of a person face.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * detectionModel: String(detection_01/detection_02/detection_03/detection_preview_1904/ir_detection_01/expression_01)
+ * faceFeature: byte[]
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Target person to update face from.
+ * @param recognitionModel The 'recognitionModel' associated with this persisted face.
+ * @param persistedFaceId PersistedFaceId created from Person Face Create.
+ * @param body Target person face id to update.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updatePersonFaceWithResponse(
+ String personId,
+ String recognitionModel,
+ String persistedFaceId,
+ BinaryData body,
+ RequestOptions requestOptions) {
+ return this.serviceClient.updatePersonFaceWithResponseAsync(
+ personId, recognitionModel, persistedFaceId, body, requestOptions);
+ }
+
+ /**
+ * Creates a new dynamic person group with specified dynamicPersonGroupId, name, and user-provided userData. A
+ * dynamic person group is a container that references persons. After creation, use "DynamicPersonGroup - Update" to
+ * add/remove persons into the search space. DynamicPersonGroup and UserData will be stored on server until
+ * DynamicPersonGroup Delete is called.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * addPersonIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group Id. Valid format should be a string composed by
+ * numbers, English letters in lower case, '-', '_', and no longer than 64 characters.
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createDynamicPersonGroupWithResponseAsync(dynamicPersonGroupId, body, requestOptions);
+ }
+
+ /**
+ * Updates an existing dynamic person group with specified dynamicPersonGroupId, name, and user-provided userData.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * removePersonIds: [
+ * String
+ * ]
+ * name: String
+ * userData: String
+ * addPersonIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group Id.
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateDynamicPersonGroupWithResponseAsync(dynamicPersonGroupId, body, requestOptions);
+ }
+
+ /**
+ * Get metadata on a dynamic person group.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * dynamicPersonGroupId: String
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group id.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return metadata on a dynamic person group along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.getDynamicPersonGroupWithResponseAsync(dynamicPersonGroupId, requestOptions);
+ }
+
+ /**
+ * Delete an existing dynamic person group. Note that Persons are not deleted with this operation. To delete person
+ * call Person Delete.
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group Id.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteDynamicPersonGroupWithResponseAsync(dynamicPersonGroupId, requestOptions);
+ }
+
+ /**
+ * Retrieve list of persons referenced in a given DynamicPersonGroup person directory.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List persons from the least personId greater than the "start". It contains no more than 64 characters. Default is empty. |
+ * | top | String | No | The number of persons to list, ranging in [1, 1000]. Default is 1000. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId Dynamic person group Id to list persons from.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listDynamicPersonGroupPersonsWithResponse(
+ String dynamicPersonGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.listDynamicPersonGroupPersonsWithResponseAsync(dynamicPersonGroupId, requestOptions);
+ }
+
+ /**
+ * Retrieve list of dynamic person groups in person directory.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List dynamicPersonGroupId from the least dynamicPersonGroupId greater than the "start". It contains no more than 64 characters. Default is empty. |
+ * | top | String | No | The number of dynamicPersonGroups to list, ranging in [1, 1000]. Default is 1000. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * dynamicPersonGroupId: String
+ * name: String
+ * userData: String
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of DynamicPersonGroupGetResponse along with {@link Response} on successful completion of {@link
+ * Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listDynamicPersonGroupsWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.listDynamicPersonGroupsWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * List the dynamic person groups that a person has been referenced in.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List dynamic person group id from the least dynamicPersonGroupId greater than the "start". It contains no more than 64 characters. Default is empty. |
+ * | top | String | No | The number of dynamicPersonGroupId to list, ranging in [1, 1000]. Default is 1000. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * dynamicPersonGroupIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param personId Valid PersonId created from Person Create.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listDynamicPersonGroupPersonReferencesWithResponse(
+ String personId, RequestOptions requestOptions) {
+ return this.serviceClient.listDynamicPersonGroupPersonReferencesWithResponseAsync(personId, requestOptions);
+ }
+
+ /**
+ * Add a new face to person.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | detectionModel | String | No | Detection model string. |
+ * | userData | String | No | User data of person face. |
+ * | targetFace | String | No | Target face. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * recognitionModel: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Person id.
+ * @param recognitionModel Recognition model string.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addPersonFaceFromStreamWithResponse(
+ String personId, String recognitionModel, BinaryData image, RequestOptions requestOptions) {
+ return this.serviceClient.addPersonFaceFromStreamWithResponseAsync(
+ personId, recognitionModel, image, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryClient.java
new file mode 100644
index 000000000000..57091ce1eb05
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryClient.java
@@ -0,0 +1,629 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = PersonDirectoryClientBuilder.class)
+public final class PersonDirectoryClient {
+ @Generated private final PersonDirectoryAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of PersonDirectoryClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ PersonDirectoryClient(PersonDirectoryAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Retrieve list of person information in person directory.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | The start parameter |
+ * | top | String | No | The top parameter |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * personId: String
+ * name: String
+ * userData: String
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of EnrollmentResponse along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getPersonsWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.getPersonsWithResponse(requestOptions).block();
+ }
+
+ /**
+ * Creates a new person in person directory.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * }
+ * }
+ *
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createPersonWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createPersonWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * Update name or userData of a person.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId The personId parameter.
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updatePersonWithResponse(String personId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updatePersonWithResponse(personId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing person from person directory. The persistedFaceId, userData, person name and face feature(s)
+ * in the person entry will all be deleted.
+ *
+ * @param personId The personId parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deletePersonWithResponse(String personId, RequestOptions requestOptions) {
+ return this.asyncClient.deletePersonWithResponse(personId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve a person's name and userData, and the persisted faceIds representing the registered person face
+ * feature(s).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Person id.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getPersonWithResponse(String personId, RequestOptions requestOptions) {
+ return this.asyncClient.getPersonWithResponse(personId, requestOptions).block();
+ }
+
+ /**
+ * Add a new face to person.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | detectionModel | String | No | Detection model string. |
+ * | userData | String | No | User data of person face. |
+ * | targetFace | String | No | Target face. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * recognitionModel: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Person id.
+ * @param recognitionModel Recognition model string.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addPersonFaceWithResponse(
+ String personId, String recognitionModel, RequestOptions requestOptions) {
+ return this.asyncClient.addPersonFaceWithResponse(personId, recognitionModel, requestOptions).block();
+ }
+
+ /**
+ * Retrieve person face information. The persisted person face is specified by its personId and persistedFaceId.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Target person to get persistedFaceIds from.
+ * @param recognitionModel The 'recognitionModel' associated with this persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getPersonFacesWithResponse(
+ String personId, String recognitionModel, RequestOptions requestOptions) {
+ return this.asyncClient.getPersonFacesWithResponse(personId, recognitionModel, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing person face from person directory. The persistedFaceId, userData, and face feature in the
+ * person entry will all be deleted.
+ *
+ * @param personId Person id.
+ * @param recognitionModel Recognition model string.
+ * @param persistedFaceId Persisted face id to delete.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deletePersonFaceWithResponse(
+ String personId, String recognitionModel, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient
+ .deletePersonFaceWithResponse(personId, recognitionModel, persistedFaceId, requestOptions)
+ .block();
+ }
+
+ /**
+ * Retrieve person face information. The persisted person face is specified by its personId and persistedFaceId.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Target person to get face from.
+ * @param recognitionModel The 'recognitionModel' associated with this persisted face.
+ * @param persistedFaceId Target person face id to get.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getPersonFaceWithResponse(
+ String personId, String recognitionModel, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient
+ .getPersonFaceWithResponse(personId, recognitionModel, persistedFaceId, requestOptions)
+ .block();
+ }
+
+ /**
+ * Update the data of a person face.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * detectionModel: String(detection_01/detection_02/detection_03/detection_preview_1904/ir_detection_01/expression_01)
+ * faceFeature: byte[]
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Target person to update face from.
+ * @param recognitionModel The 'recognitionModel' associated with this persisted face.
+ * @param persistedFaceId PersistedFaceId created from Person Face Create.
+ * @param body Target person face id to update.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updatePersonFaceWithResponse(
+ String personId,
+ String recognitionModel,
+ String persistedFaceId,
+ BinaryData body,
+ RequestOptions requestOptions) {
+ return this.asyncClient
+ .updatePersonFaceWithResponse(personId, recognitionModel, persistedFaceId, body, requestOptions)
+ .block();
+ }
+
+ /**
+ * Creates a new dynamic person group with specified dynamicPersonGroupId, name, and user-provided userData. A
+ * dynamic person group is a container that references persons. After creation, use "DynamicPersonGroup - Update" to
+ * add/remove persons into the search space. DynamicPersonGroup and UserData will be stored on server until
+ * DynamicPersonGroup Delete is called.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * addPersonIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group Id. Valid format should be a string composed by
+ * numbers, English letters in lower case, '-', '_', and no longer than 64 characters.
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient
+ .createDynamicPersonGroupWithResponse(dynamicPersonGroupId, body, requestOptions)
+ .block();
+ }
+
+ /**
+ * Updates an existing dynamic person group with specified dynamicPersonGroupId, name, and user-provided userData.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * removePersonIds: [
+ * String
+ * ]
+ * name: String
+ * userData: String
+ * addPersonIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group Id.
+ * @param body The body parameter.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient
+ .updateDynamicPersonGroupWithResponse(dynamicPersonGroupId, body, requestOptions)
+ .block();
+ }
+
+ /**
+ * Get metadata on a dynamic person group.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * dynamicPersonGroupId: String
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group id.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return metadata on a dynamic person group along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.getDynamicPersonGroupWithResponse(dynamicPersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing dynamic person group. Note that Persons are not deleted with this operation. To delete person
+ * call Person Delete.
+ *
+ * @param dynamicPersonGroupId User provided dynamic person group Id.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteDynamicPersonGroupWithResponse(
+ String dynamicPersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteDynamicPersonGroupWithResponse(dynamicPersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve list of persons referenced in a given DynamicPersonGroup person directory.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List persons from the least personId greater than the "start". It contains no more than 64 characters. Default is empty. |
+ * | top | String | No | The number of persons to list, ranging in [1, 1000]. Default is 1000. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param dynamicPersonGroupId Dynamic person group Id to list persons from.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listDynamicPersonGroupPersonsWithResponse(
+ String dynamicPersonGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.listDynamicPersonGroupPersonsWithResponse(dynamicPersonGroupId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve list of dynamic person groups in person directory.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List dynamicPersonGroupId from the least dynamicPersonGroupId greater than the "start". It contains no more than 64 characters. Default is empty. |
+ * | top | String | No | The number of dynamicPersonGroups to list, ranging in [1, 1000]. Default is 1000. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * dynamicPersonGroupId: String
+ * name: String
+ * userData: String
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of DynamicPersonGroupGetResponse along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listDynamicPersonGroupsWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.listDynamicPersonGroupsWithResponse(requestOptions).block();
+ }
+
+ /**
+ * List the dynamic person groups that a person has been referenced in.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List dynamic person group id from the least dynamicPersonGroupId greater than the "start". It contains no more than 64 characters. Default is empty. |
+ * | top | String | No | The number of dynamicPersonGroupId to list, ranging in [1, 1000]. Default is 1000. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personId: String
+ * dynamicPersonGroupIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param personId Valid PersonId created from Person Create.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listDynamicPersonGroupPersonReferencesWithResponse(
+ String personId, RequestOptions requestOptions) {
+ return this.asyncClient.listDynamicPersonGroupPersonReferencesWithResponse(personId, requestOptions).block();
+ }
+
+ /**
+ * Add a new face to person.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | detectionModel | String | No | Detection model string. |
+ * | userData | String | No | User data of person face. |
+ * | targetFace | String | No | Target face. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * recognitionModel: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personId Person id.
+ * @param recognitionModel Recognition model string.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the response body along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addPersonFaceFromStreamWithResponse(
+ String personId, String recognitionModel, BinaryData image, RequestOptions requestOptions) {
+ return this.asyncClient
+ .addPersonFaceFromStreamWithResponse(personId, recognitionModel, image, requestOptions)
+ .block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryClientBuilder.java
new file mode 100644
index 000000000000..33816eddb770
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonDirectoryClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the PersonDirectoryClient type. */
+@ServiceClientBuilder(serviceClients = {PersonDirectoryClient.class, PersonDirectoryAsyncClient.class})
+public final class PersonDirectoryClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the PersonDirectoryClientBuilder. */
+ @Generated
+ public PersonDirectoryClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the PersonDirectoryClientBuilder.
+ */
+ @Generated
+ public PersonDirectoryClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of PersonDirectoryAsyncClient class.
+ *
+ * @return an instance of PersonDirectoryAsyncClient.
+ */
+ @Generated
+ public PersonDirectoryAsyncClient buildAsyncClient() {
+ return new PersonDirectoryAsyncClient(buildInnerClient().getPersonDirectories());
+ }
+
+ /**
+ * Builds an instance of PersonDirectoryClient class.
+ *
+ * @return an instance of PersonDirectoryClient.
+ */
+ @Generated
+ public PersonDirectoryClient buildClient() {
+ return new PersonDirectoryClient(new PersonDirectoryAsyncClient(buildInnerClient().getPersonDirectories()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupAsyncClient.java
new file mode 100644
index 000000000000..c1ccd9dcd2dc
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupAsyncClient.java
@@ -0,0 +1,258 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.PersonGroupsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = PersonGroupClientBuilder.class, isAsync = true)
+public final class PersonGroupAsyncClient {
+ @Generated private final PersonGroupsImpl serviceClient;
+
+ /**
+ * Initializes an instance of PersonGroupAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ PersonGroupAsyncClient(PersonGroupsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Create a new person group with specified personGroupId, name, user-provided userData and recognitionModel. <br
+ * /> A person group is the container of the uploaded person data, including face recognition features. <br
+ * /> After creation, use [PersonGroup Person -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/create) to add persons into the group, and
+ * then call [PersonGroup - Train](https://docs.microsoft.com/rest/api/faceapi/persongroup/train) to get this group
+ * ready for [Face - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> No image
+ * will be stored. Only the person's extracted face features and userData will be stored on server until
+ * [PersonGroup Person - Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or
+ * [PersonGroup - Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called.
+ * <br/>'recognitionModel' should be specified to associate with this 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 person group will use the recognition model that's
+ * already associated with the collection. Existing face features in a person group can't be updated to features
+ * extracted by another version of recognition model.
+ *
+ * Person group quota: * Free-tier subscription quota: 1,000 person groups. Each holds up to 1,000 persons. *
+ * S0-tier subscription quota: 1,000,000 person groups. Each holds up to 10,000 persons. * to handle larger scale
+ * face identification problem, please consider using
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup).
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param body Request body for creating new person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponse(
+ String personGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createWithResponseAsync(personGroupId, body, requestOptions);
+ }
+
+ /**
+ * Delete an existing person group. Persisted face features of all people in the person group will also be deleted.
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(personGroupId, requestOptions);
+ }
+
+ /**
+ * Retrieve person group name, userData and recognitionModel. To get person information under this personGroup, use
+ * [PersonGroup Person - List](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/list).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person group object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(personGroupId, requestOptions);
+ }
+
+ /**
+ * Update an existing person group's display name and userData. The properties which does not appear in request body
+ * will not be updated.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param body Request body for updating person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(
+ String personGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(personGroupId, body, requestOptions);
+ }
+
+ /**
+ * Retrieve the training status of a person group (completed or ongoing).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(nonstarted/running/succeeded/failed)
+ * created: String
+ * lastAction: String
+ * lastSuccessfulTraining: String
+ * message: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return training status object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getTrainingStatusWithResponse(
+ String personGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.getTrainingStatusWithResponseAsync(personGroupId, requestOptions);
+ }
+
+ /**
+ * List person groups’ personGroupId, name, userData and recognitionModel.<br /> * Person groups are stored in
+ * alphabetical order of personGroupId. * "start" parameter (string, optional) is a user-provided personGroupId
+ * value that returned entries have larger ids by string comparison. "start" set to empty to indicate return from
+ * the first item. * "top" parameter (int, optional) specifies the number of entries to return. A maximal of 1000
+ * entries can be returned in one call. To fetch more, you can specify "start" with the last returned entry’s Id of
+ * the current call. <br /> For example, total 5 person groups: "group1", ..., "group5". <br />
+ * "start=&top=" will return all 5 groups. <br /> "start=&top=2" will return "group1", "group2".
+ * <br /> "start=group2&top=3" will return "group3", "group4", "group5".
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List person groups from the least personGroupId greater than the "start". |
+ * | top | String | No | The number of person groups to list. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * personGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of person groups along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * Queue a person group training task, the training task may not be started immediately.
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> trainWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.trainWithResponseAsync(personGroupId, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupClient.java
new file mode 100644
index 000000000000..a74c91f584ec
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupClient.java
@@ -0,0 +1,253 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = PersonGroupClientBuilder.class)
+public final class PersonGroupClient {
+ @Generated private final PersonGroupAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of PersonGroupClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ PersonGroupClient(PersonGroupAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Create a new person group with specified personGroupId, name, user-provided userData and recognitionModel. <br
+ * /> A person group is the container of the uploaded person data, including face recognition features. <br
+ * /> After creation, use [PersonGroup Person -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/create) to add persons into the group, and
+ * then call [PersonGroup - Train](https://docs.microsoft.com/rest/api/faceapi/persongroup/train) to get this group
+ * ready for [Face - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> No image
+ * will be stored. Only the person's extracted face features and userData will be stored on server until
+ * [PersonGroup Person - Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or
+ * [PersonGroup - Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called.
+ * <br/>'recognitionModel' should be specified to associate with this 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 person group will use the recognition model that's
+ * already associated with the collection. Existing face features in a person group can't be updated to features
+ * extracted by another version of recognition model.
+ *
+ * Person group quota: * Free-tier subscription quota: 1,000 person groups. Each holds up to 1,000 persons. *
+ * S0-tier subscription quota: 1,000,000 person groups. Each holds up to 10,000 persons. * to handle larger scale
+ * face identification problem, please consider using
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup).
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param body Request body for creating new person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(String personGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createWithResponse(personGroupId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing person group. Persisted face features of all people in the person group will also be deleted.
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(personGroupId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve person group name, userData and recognitionModel. To get person information under this personGroup, use
+ * [PersonGroup Person - List](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/list).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * personGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person group object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(personGroupId, requestOptions).block();
+ }
+
+ /**
+ * Update an existing person group's display name and userData. The properties which does not appear in request body
+ * will not be updated.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param body Request body for updating person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(String personGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(personGroupId, body, requestOptions).block();
+ }
+
+ /**
+ * Retrieve the training status of a person group (completed or ongoing).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(nonstarted/running/succeeded/failed)
+ * created: String
+ * lastAction: String
+ * lastSuccessfulTraining: String
+ * message: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return training status object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getTrainingStatusWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.getTrainingStatusWithResponse(personGroupId, requestOptions).block();
+ }
+
+ /**
+ * List person groups’ personGroupId, name, userData and recognitionModel.<br /> * Person groups are stored in
+ * alphabetical order of personGroupId. * "start" parameter (string, optional) is a user-provided personGroupId
+ * value that returned entries have larger ids by string comparison. "start" set to empty to indicate return from
+ * the first item. * "top" parameter (int, optional) specifies the number of entries to return. A maximal of 1000
+ * entries can be returned in one call. To fetch more, you can specify "start" with the last returned entry’s Id of
+ * the current call. <br /> For example, total 5 person groups: "group1", ..., "group5". <br />
+ * "start=&top=" will return all 5 groups. <br /> "start=&top=2" will return "group1", "group2".
+ * <br /> "start=group2&top=3" will return "group3", "group4", "group5".
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | List person groups from the least personGroupId greater than the "start". |
+ * | top | String | No | The number of person groups to list. |
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * personGroupId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of person groups along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(requestOptions).block();
+ }
+
+ /**
+ * Queue a person group training task, the training task may not be started immediately.
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response trainWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.trainWithResponse(personGroupId, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupClientBuilder.java
new file mode 100644
index 000000000000..094239ad31fc
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the PersonGroupClient type. */
+@ServiceClientBuilder(serviceClients = {PersonGroupClient.class, PersonGroupAsyncClient.class})
+public final class PersonGroupClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the PersonGroupClientBuilder. */
+ @Generated
+ public PersonGroupClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the PersonGroupClientBuilder.
+ */
+ @Generated
+ public PersonGroupClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of PersonGroupAsyncClient class.
+ *
+ * @return an instance of PersonGroupAsyncClient.
+ */
+ @Generated
+ public PersonGroupAsyncClient buildAsyncClient() {
+ return new PersonGroupAsyncClient(buildInnerClient().getPersonGroups());
+ }
+
+ /**
+ * Builds an instance of PersonGroupClient class.
+ *
+ * @return an instance of PersonGroupClient.
+ */
+ @Generated
+ public PersonGroupClient buildClient() {
+ return new PersonGroupClient(new PersonGroupAsyncClient(buildInnerClient().getPersonGroups()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonAsyncClient.java
new file mode 100644
index 000000000000..dbab5cc1c053
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonAsyncClient.java
@@ -0,0 +1,441 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.PersonGroupPersonsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = PersonGroupPersonClientBuilder.class, isAsync = true)
+public final class PersonGroupPersonAsyncClient {
+ @Generated private final PersonGroupPersonsImpl serviceClient;
+
+ /**
+ * Initializes an instance of PersonGroupPersonAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ PersonGroupPersonAsyncClient(PersonGroupPersonsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Create a new person in a specified person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param body Request body for creating new person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponse(
+ String personGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.createWithResponseAsync(personGroupId, body, requestOptions);
+ }
+
+ /**
+ * List all persons in a person group, and retrieve person information (including personId, name, userData and
+ * persistedFaceIds of registered faces of the person).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | Starting person id to return (used to list a range of persons). |
+ * | top | String | No | Number of persons to return starting with the person id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of Persons along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(personGroupId, requestOptions);
+ }
+
+ /**
+ * Delete an existing person from a person group. The persistedFaceId, userData, person name and face feature in the
+ * person entry will all be deleted.
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(
+ String personGroupId, String personId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(personGroupId, personId, requestOptions);
+ }
+
+ /**
+ * Retrieve a person's information, including registered persisted faces, name and userData.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(
+ String personGroupId, String personId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(personGroupId, personId, requestOptions);
+ }
+
+ /**
+ * Update name or userData of a person.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param body Request body for person update operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(
+ String personGroupId, String personId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(personGroupId, personId, body, requestOptions);
+ }
+
+ /**
+ * Delete a face from a person in a person group by specified personGroupId, 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 personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteFaceWithResponse(
+ String personGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteFaceWithResponseAsync(personGroupId, personId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Retrieve information about a persisted face (specified by persistedFaceId, personId and its belonging
+ * personGroupId).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getFaceWithResponse(
+ String personGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.serviceClient.getFaceWithResponseAsync(personGroupId, personId, persistedFaceId, requestOptions);
+ }
+
+ /**
+ * Add a face to a person into a 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 [PersonGroup PersonFace -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/deleteface), [PersonGroup Person -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or [PersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param body Request body for updating persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateFaceWithResponse(
+ String personGroupId,
+ String personId,
+ String persistedFaceId,
+ BinaryData body,
+ RequestOptions requestOptions) {
+ return this.serviceClient.updateFaceWithResponseAsync(
+ personGroupId, personId, persistedFaceId, body, requestOptions);
+ }
+
+ /**
+ * Add a face to a person into a 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 [PersonGroup PersonFace -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/deleteface), [PersonGroup Person -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or [PersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromUrlWithResponse(
+ String personGroupId, String personId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromUrlWithResponseAsync(personGroupId, personId, imageUrl, requestOptions);
+ }
+
+ /**
+ * Add a face to a person into a 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 [PersonGroup PersonFace -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/deleteface), [PersonGroup Person -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or [PersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromStreamWithResponse(
+ String personGroupId, String personId, BinaryData image, RequestOptions requestOptions) {
+ return this.serviceClient.addFaceFromStreamWithResponseAsync(personGroupId, personId, image, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonClient.java
new file mode 100644
index 000000000000..aaad2b17e3d3
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonClient.java
@@ -0,0 +1,440 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = PersonGroupPersonClientBuilder.class)
+public final class PersonGroupPersonClient {
+ @Generated private final PersonGroupPersonAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of PersonGroupPersonClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ PersonGroupPersonClient(PersonGroupPersonAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Create a new person in a specified person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param body Request body for creating new person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(
+ String personGroupId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.createWithResponse(personGroupId, body, requestOptions).block();
+ }
+
+ /**
+ * List all persons in a person group, and retrieve person information (including personId, name, userData and
+ * persistedFaceIds of registered faces of the person).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | start | String | No | Starting person id to return (used to list a range of persons). |
+ * | top | String | No | Number of persons to return starting with the person id indicated by the 'start' parameter. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of Persons along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(String personGroupId, RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(personGroupId, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing person from a person group. The persistedFaceId, userData, person name and face feature in the
+ * person entry will all be deleted.
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String personGroupId, String personId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(personGroupId, personId, requestOptions).block();
+ }
+
+ /**
+ * Retrieve a person's information, including registered persisted faces, name and userData.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * personId: String
+ * persistedFaceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return person object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String personGroupId, String personId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(personGroupId, personId, requestOptions).block();
+ }
+
+ /**
+ * Update name or userData of a person.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param body Request body for person update operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(
+ String personGroupId, String personId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(personGroupId, personId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete a face from a person in a person group by specified personGroupId, 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 personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteFaceWithResponse(
+ String personGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient
+ .deleteFaceWithResponse(personGroupId, personId, persistedFaceId, requestOptions)
+ .block();
+ }
+
+ /**
+ * Retrieve information about a persisted face (specified by persistedFaceId, personId and its belonging
+ * personGroupId).
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getFaceWithResponse(
+ String personGroupId, String personId, String persistedFaceId, RequestOptions requestOptions) {
+ return this.asyncClient.getFaceWithResponse(personGroupId, personId, persistedFaceId, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a person into a 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 [PersonGroup PersonFace -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/deleteface), [PersonGroup Person -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or [PersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param body Request body for updating persisted face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateFaceWithResponse(
+ String personGroupId,
+ String personId,
+ String persistedFaceId,
+ BinaryData body,
+ RequestOptions requestOptions) {
+ return this.asyncClient
+ .updateFaceWithResponse(personGroupId, personId, persistedFaceId, body, requestOptions)
+ .block();
+ }
+
+ /**
+ * Add a face to a person into a 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 [PersonGroup PersonFace -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/deleteface), [PersonGroup Person -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or [PersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromUrlWithResponse(
+ String personGroupId, String personId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return this.asyncClient.addFaceFromUrlWithResponse(personGroupId, personId, imageUrl, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a person into a 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 [PersonGroup PersonFace -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/deleteface), [PersonGroup Person -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroupperson/delete) or [PersonGroup -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/persongroup/delete) is called. <br /> Note
+ * persistedFaceId is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param personGroupId Id referencing a particular person group.
+ * @param personId Id referencing a particular person.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromStreamWithResponse(
+ String personGroupId, String personId, BinaryData image, RequestOptions requestOptions) {
+ return this.asyncClient.addFaceFromStreamWithResponse(personGroupId, personId, image, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonClientBuilder.java
new file mode 100644
index 000000000000..60c688359b0f
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/PersonGroupPersonClientBuilder.java
@@ -0,0 +1,265 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the PersonGroupPersonClient type. */
+@ServiceClientBuilder(serviceClients = {PersonGroupPersonClient.class, PersonGroupPersonAsyncClient.class})
+public final class PersonGroupPersonClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the PersonGroupPersonClientBuilder. */
+ @Generated
+ public PersonGroupPersonClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the PersonGroupPersonClientBuilder.
+ */
+ @Generated
+ public PersonGroupPersonClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of PersonGroupPersonAsyncClient class.
+ *
+ * @return an instance of PersonGroupPersonAsyncClient.
+ */
+ @Generated
+ public PersonGroupPersonAsyncClient buildAsyncClient() {
+ return new PersonGroupPersonAsyncClient(buildInnerClient().getPersonGroupPersons());
+ }
+
+ /**
+ * Builds an instance of PersonGroupPersonClient class.
+ *
+ * @return an instance of PersonGroupPersonClient.
+ */
+ @Generated
+ public PersonGroupPersonClient buildClient() {
+ return new PersonGroupPersonClient(
+ new PersonGroupPersonAsyncClient(buildInnerClient().getPersonGroupPersons()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotAsyncClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotAsyncClient.java
new file mode 100644
index 000000000000..3a7c8125b2db
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotAsyncClient.java
@@ -0,0 +1,291 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.SnapshotsImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+import reactor.core.publisher.Mono;
+
+/** Initializes a new instance of the asynchronous FaceClient type. */
+@ServiceClient(builder = SnapshotClientBuilder.class, isAsync = true)
+public final class SnapshotAsyncClient {
+ @Generated private final SnapshotsImpl serviceClient;
+
+ /**
+ * Initializes an instance of SnapshotAsyncClient class.
+ *
+ * @param serviceClient the service client implementation.
+ */
+ @Generated
+ SnapshotAsyncClient(SnapshotsImpl serviceClient) {
+ this.serviceClient = serviceClient;
+ }
+
+ /**
+ * Submit an operation to take a snapshot of face list, large face list, person group or large person group, with
+ * user-specified snapshot type, source object id, apply scope and an optional user data.<br /> The snapshot
+ * interfaces are for users to backup and restore their face data from one face subscription to another, inside same
+ * region or across regions. The workflow contains two phases, user first calls Snapshot - Take to create a copy of
+ * the source object and store it as a snapshot, then calls Snapshot - Apply to paste the snapshot to target
+ * subscription. The snapshots are stored in a centralized location (per Azure instance), so that they can be
+ * applied cross accounts and regions.<br /> Taking snapshot is an asynchronous operation. An operation id can
+ * be obtained from the "Operation-Location" field in response header, to be used in OperationStatus - Get for
+ * tracking the progress of creating the snapshot. The snapshot id will be included in the "resourceLocation" field
+ * in OperationStatus - Get response when the operation status is "succeeded".<br /> Snapshot taking time
+ * depends on the number of person and face entries in the source object. It could be in seconds, or up to several
+ * hours for 1,000,000 persons with multiple faces.<br /> Snapshots will be automatically expired and cleaned
+ * in 48 hours after it is created by Snapshot - Take. User can delete the snapshot using Snapshot - Delete by
+ * themselves any time before expiration.<br /> Taking snapshot for a certain object will not block any other
+ * operations against the object. All read-only operations (Get/List and Identify/FindSimilar/Verify) can be
+ * conducted as usual. For all writable operations, including Add/Update/Delete the source object or its
+ * persons/faces and Train, they are not blocked but not recommended because writable updates may not be reflected
+ * on the snapshot during its taking. After snapshot taking is completed, all readable and writable operations can
+ * work as normal. Snapshot will also include the training results of the source object, which means target
+ * subscription the snapshot applied to does not need re-train the target object before calling
+ * Identify/FindSimilar.<br /> * Free-tier subscription quota: 100 take operations per month. * S0-tier
+ * subscription quota: 100 take operations per day.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * type: String(FaceList/LargeFaceList/LargePersonGroup/PersonGroup)
+ * objectId: String
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * }
+ * }
+ *
+ * @param body Request body for taking a snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> takeWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.takeWithResponseAsync(body, requestOptions);
+ }
+
+ /**
+ * List all accessible snapshots with related information, including snapshots that were taken by the user, or
+ * snapshots to be applied to the user (subscription id was included in the applyScope in Snapshot - Take).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | type | String | No | User specified object type as a search filter. |
+ * | applyScope | String | No | User specified snapshot apply scopes as a search filter. ApplyScope is an array of the target Azure subscription ids for the snapshot, specified by the user who created the snapshot by Snapshot - Take. In the form of "," separated string. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * id: String
+ * account: String
+ * type: String(FaceList/LargeFaceList/LargePersonGroup/PersonGroup)
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * createdTime: String
+ * lastUpdateTime: String
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of snapshots along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponse(RequestOptions requestOptions) {
+ return this.serviceClient.listWithResponseAsync(requestOptions);
+ }
+
+ /**
+ * Retrieve information about a snapshot. Snapshot is only accessible to the source subscription who took it, and
+ * target subscriptions included in the applyScope in Snapshot - Take.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * id: String
+ * account: String
+ * type: String(FaceList/LargeFaceList/LargePersonGroup/PersonGroup)
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * createdTime: String
+ * lastUpdateTime: String
+ * }
+ * }
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return snapshot object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponse(String snapshotId, RequestOptions requestOptions) {
+ return this.serviceClient.getWithResponseAsync(snapshotId, requestOptions);
+ }
+
+ /**
+ * Update the information of a snapshot. Only the source subscription who took the snapshot can update the snapshot.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * }
+ * }
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param body Request body for updating a snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponse(String snapshotId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.updateWithResponseAsync(snapshotId, body, requestOptions);
+ }
+
+ /**
+ * Delete an existing snapshot according to the snapshotId. All object data and information in the snapshot will
+ * also be deleted. Only the source subscription who took the snapshot can delete the snapshot. If the user does not
+ * delete a snapshot with this API, the snapshot will still be automatically deleted in 48 hours after creation.
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponse(String snapshotId, RequestOptions requestOptions) {
+ return this.serviceClient.deleteWithResponseAsync(snapshotId, requestOptions);
+ }
+
+ /**
+ * Submit an operation to apply a snapshot to current subscription. For each snapshot, only subscriptions included
+ * in the applyScope of Snapshot - Take can apply it.<br /> The snapshot interfaces are for users to backup
+ * and restore their face data from one face subscription to another, inside same region or across regions. The
+ * workflow contains two phases, user first calls Snapshot - Take to create a copy of the source object and store it
+ * as a snapshot, then calls Snapshot - Apply to paste the snapshot to target subscription. The snapshots are stored
+ * in a centralized location (per Azure instance), so that they can be applied cross accounts and regions.<br
+ * /> Applying snapshot is an asynchronous operation. An operation id can be obtained from the
+ * "Operation-Location" field in response header, to be used in OperationStatus - Get for tracking the progress of
+ * applying the snapshot. The target object id will be included in the "resourceLocation" field in OperationStatus -
+ * Get response when the operation status is "succeeded".<br /> Snapshot applying time depends on the number
+ * of person and face entries in the snapshot object. It could be in seconds, or up to 1 hour for 1,000,000 persons
+ * with multiple faces.<br /> Snapshots will be automatically expired and cleaned in 48 hours after it is
+ * created by Snapshot - Take. So the target subscription is required to apply the snapshot in 48 hours since its
+ * creation.<br /> Applying a snapshot will not block any other operations against the target object, however
+ * it is not recommended because the correctness cannot be guaranteed during snapshot applying. After snapshot
+ * applying is completed, all operations towards the target object can work as normal. Snapshot also includes the
+ * training results of the source object, which means target subscription the snapshot applied to does not need
+ * re-train the target object before calling Identify/FindSimilar.<br /> One snapshot can be applied multiple
+ * times in parallel, while currently only CreateNew apply mode is supported, which means the apply operation will
+ * fail if target subscription already contains an object of same type and using the same objectId. Users can
+ * specify the "objectId" in request body to avoid such conflicts.<br /> * Free-tier subscription quota: 100
+ * apply operations per month. * S0-tier subscription quota: 100 apply operations per day.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * objectId: String
+ * mode: String
+ * }
+ * }
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param body Request body for applying a snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> applyWithResponse(String snapshotId, BinaryData body, RequestOptions requestOptions) {
+ return this.serviceClient.applyWithResponseAsync(snapshotId, body, requestOptions);
+ }
+
+ /**
+ * Get status of a long running operation.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(notStarted/running/succeeded/failed)
+ * createdTime: String
+ * lastActionTime: String
+ * finishedTime: String
+ * resourceLocation: String
+ * message: String
+ * }
+ * }
+ *
+ * @param operationId Id referencing a particular take/apply snapshot operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return status of a long running operation along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getOperationStatusWithResponse(
+ String operationId, RequestOptions requestOptions) {
+ return this.serviceClient.getOperationStatusWithResponseAsync(operationId, requestOptions);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotClient.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotClient.java
new file mode 100644
index 000000000000..311867c574a6
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotClient.java
@@ -0,0 +1,288 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceClient;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.util.BinaryData;
+
+/** Initializes a new instance of the synchronous FaceClient type. */
+@ServiceClient(builder = SnapshotClientBuilder.class)
+public final class SnapshotClient {
+ @Generated private final SnapshotAsyncClient asyncClient;
+
+ /**
+ * Initializes an instance of SnapshotClient class.
+ *
+ * @param asyncClient the async client.
+ */
+ @Generated
+ SnapshotClient(SnapshotAsyncClient asyncClient) {
+ this.asyncClient = asyncClient;
+ }
+
+ /**
+ * Submit an operation to take a snapshot of face list, large face list, person group or large person group, with
+ * user-specified snapshot type, source object id, apply scope and an optional user data.<br /> The snapshot
+ * interfaces are for users to backup and restore their face data from one face subscription to another, inside same
+ * region or across regions. The workflow contains two phases, user first calls Snapshot - Take to create a copy of
+ * the source object and store it as a snapshot, then calls Snapshot - Apply to paste the snapshot to target
+ * subscription. The snapshots are stored in a centralized location (per Azure instance), so that they can be
+ * applied cross accounts and regions.<br /> Taking snapshot is an asynchronous operation. An operation id can
+ * be obtained from the "Operation-Location" field in response header, to be used in OperationStatus - Get for
+ * tracking the progress of creating the snapshot. The snapshot id will be included in the "resourceLocation" field
+ * in OperationStatus - Get response when the operation status is "succeeded".<br /> Snapshot taking time
+ * depends on the number of person and face entries in the source object. It could be in seconds, or up to several
+ * hours for 1,000,000 persons with multiple faces.<br /> Snapshots will be automatically expired and cleaned
+ * in 48 hours after it is created by Snapshot - Take. User can delete the snapshot using Snapshot - Delete by
+ * themselves any time before expiration.<br /> Taking snapshot for a certain object will not block any other
+ * operations against the object. All read-only operations (Get/List and Identify/FindSimilar/Verify) can be
+ * conducted as usual. For all writable operations, including Add/Update/Delete the source object or its
+ * persons/faces and Train, they are not blocked but not recommended because writable updates may not be reflected
+ * on the snapshot during its taking. After snapshot taking is completed, all readable and writable operations can
+ * work as normal. Snapshot will also include the training results of the source object, which means target
+ * subscription the snapshot applied to does not need re-train the target object before calling
+ * Identify/FindSimilar.<br /> * Free-tier subscription quota: 100 take operations per month. * S0-tier
+ * subscription quota: 100 take operations per day.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * type: String(FaceList/LargeFaceList/LargePersonGroup/PersonGroup)
+ * objectId: String
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * }
+ * }
+ *
+ * @param body Request body for taking a snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response takeWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.takeWithResponse(body, requestOptions).block();
+ }
+
+ /**
+ * List all accessible snapshots with related information, including snapshots that were taken by the user, or
+ * snapshots to be applied to the user (subscription id was included in the applyScope in Snapshot - Take).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | type | String | No | User specified object type as a search filter. |
+ * | applyScope | String | No | User specified snapshot apply scopes as a search filter. ApplyScope is an array of the target Azure subscription ids for the snapshot, specified by the user who created the snapshot by Snapshot - Take. In the form of "," separated string. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * id: String
+ * account: String
+ * type: String(FaceList/LargeFaceList/LargePersonGroup/PersonGroup)
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * createdTime: String
+ * lastUpdateTime: String
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of snapshots along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(RequestOptions requestOptions) {
+ return this.asyncClient.listWithResponse(requestOptions).block();
+ }
+
+ /**
+ * Retrieve information about a snapshot. Snapshot is only accessible to the source subscription who took it, and
+ * target subscriptions included in the applyScope in Snapshot - Take.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * id: String
+ * account: String
+ * type: String(FaceList/LargeFaceList/LargePersonGroup/PersonGroup)
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * createdTime: String
+ * lastUpdateTime: String
+ * }
+ * }
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return snapshot object along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String snapshotId, RequestOptions requestOptions) {
+ return this.asyncClient.getWithResponse(snapshotId, requestOptions).block();
+ }
+
+ /**
+ * Update the information of a snapshot. Only the source subscription who took the snapshot can update the snapshot.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * applyScope: [
+ * String
+ * ]
+ * userData: String
+ * }
+ * }
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param body Request body for updating a snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(String snapshotId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.updateWithResponse(snapshotId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete an existing snapshot according to the snapshotId. All object data and information in the snapshot will
+ * also be deleted. Only the source subscription who took the snapshot can delete the snapshot. If the user does not
+ * delete a snapshot with this API, the snapshot will still be automatically deleted in 48 hours after creation.
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String snapshotId, RequestOptions requestOptions) {
+ return this.asyncClient.deleteWithResponse(snapshotId, requestOptions).block();
+ }
+
+ /**
+ * Submit an operation to apply a snapshot to current subscription. For each snapshot, only subscriptions included
+ * in the applyScope of Snapshot - Take can apply it.<br /> The snapshot interfaces are for users to backup
+ * and restore their face data from one face subscription to another, inside same region or across regions. The
+ * workflow contains two phases, user first calls Snapshot - Take to create a copy of the source object and store it
+ * as a snapshot, then calls Snapshot - Apply to paste the snapshot to target subscription. The snapshots are stored
+ * in a centralized location (per Azure instance), so that they can be applied cross accounts and regions.<br
+ * /> Applying snapshot is an asynchronous operation. An operation id can be obtained from the
+ * "Operation-Location" field in response header, to be used in OperationStatus - Get for tracking the progress of
+ * applying the snapshot. The target object id will be included in the "resourceLocation" field in OperationStatus -
+ * Get response when the operation status is "succeeded".<br /> Snapshot applying time depends on the number
+ * of person and face entries in the snapshot object. It could be in seconds, or up to 1 hour for 1,000,000 persons
+ * with multiple faces.<br /> Snapshots will be automatically expired and cleaned in 48 hours after it is
+ * created by Snapshot - Take. So the target subscription is required to apply the snapshot in 48 hours since its
+ * creation.<br /> Applying a snapshot will not block any other operations against the target object, however
+ * it is not recommended because the correctness cannot be guaranteed during snapshot applying. After snapshot
+ * applying is completed, all operations towards the target object can work as normal. Snapshot also includes the
+ * training results of the source object, which means target subscription the snapshot applied to does not need
+ * re-train the target object before calling Identify/FindSimilar.<br /> One snapshot can be applied multiple
+ * times in parallel, while currently only CreateNew apply mode is supported, which means the apply operation will
+ * fail if target subscription already contains an object of same type and using the same objectId. Users can
+ * specify the "objectId" in request body to avoid such conflicts.<br /> * Free-tier subscription quota: 100
+ * apply operations per month. * S0-tier subscription quota: 100 apply operations per day.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * objectId: String
+ * mode: String
+ * }
+ * }
+ *
+ * @param snapshotId Id referencing a particular snapshot.
+ * @param body Request body for applying a snapshot.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response applyWithResponse(String snapshotId, BinaryData body, RequestOptions requestOptions) {
+ return this.asyncClient.applyWithResponse(snapshotId, body, requestOptions).block();
+ }
+
+ /**
+ * Get status of a long running operation.
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * status: String(notStarted/running/succeeded/failed)
+ * createdTime: String
+ * lastActionTime: String
+ * finishedTime: String
+ * resourceLocation: String
+ * message: String
+ * }
+ * }
+ *
+ * @param operationId Id referencing a particular take/apply snapshot operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return status of a long running operation along with {@link Response}.
+ */
+ @Generated
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getOperationStatusWithResponse(String operationId, RequestOptions requestOptions) {
+ return this.asyncClient.getOperationStatusWithResponse(operationId, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotClientBuilder.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotClientBuilder.java
new file mode 100644
index 000000000000..871ac11497c2
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/SnapshotClientBuilder.java
@@ -0,0 +1,264 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face;
+
+import com.azure.cognitiveservices.face.implementation.FaceClientImpl;
+import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.ServiceClientBuilder;
+import com.azure.core.http.HttpClient;
+import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.HttpPipelinePosition;
+import com.azure.core.http.policy.AddHeadersPolicy;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.HttpLogOptions;
+import com.azure.core.http.policy.HttpLoggingPolicy;
+import com.azure.core.http.policy.HttpPipelinePolicy;
+import com.azure.core.http.policy.HttpPolicyProviders;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.ClientOptions;
+import com.azure.core.util.Configuration;
+import com.azure.core.util.CoreUtils;
+import com.azure.core.util.serializer.JacksonAdapter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/** A builder for creating a new instance of the SnapshotClient type. */
+@ServiceClientBuilder(serviceClients = {SnapshotClient.class, SnapshotAsyncClient.class})
+public final class SnapshotClientBuilder {
+ @Generated private static final String SDK_NAME = "name";
+
+ @Generated private static final String SDK_VERSION = "version";
+
+ @Generated
+ private final Map properties = CoreUtils.getProperties("azure-cognitiveservices-face.properties");
+
+ /** Create an instance of the SnapshotClientBuilder. */
+ @Generated
+ public SnapshotClientBuilder() {
+ this.pipelinePolicies = new ArrayList<>();
+ }
+
+ /*
+ * Supported Cognitive Services endpoints (protocol and hostname, for
+ * example: https://westus.api.cognitive.microsoft.com).
+ */
+ @Generated private String endpoint;
+
+ /**
+ * Sets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @param endpoint the endpoint value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder endpoint(String endpoint) {
+ this.endpoint = endpoint;
+ return this;
+ }
+
+ /*
+ * The HTTP pipeline to send requests through
+ */
+ @Generated private HttpPipeline pipeline;
+
+ /**
+ * Sets The HTTP pipeline to send requests through.
+ *
+ * @param pipeline the pipeline value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder pipeline(HttpPipeline pipeline) {
+ this.pipeline = pipeline;
+ return this;
+ }
+
+ /*
+ * The HTTP client used to send the request.
+ */
+ @Generated private HttpClient httpClient;
+
+ /**
+ * Sets The HTTP client used to send the request.
+ *
+ * @param httpClient the httpClient value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder httpClient(HttpClient httpClient) {
+ this.httpClient = httpClient;
+ return this;
+ }
+
+ /*
+ * The configuration store that is used during construction of the service
+ * client.
+ */
+ @Generated private Configuration configuration;
+
+ /**
+ * Sets The configuration store that is used during construction of the service client.
+ *
+ * @param configuration the configuration value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder configuration(Configuration configuration) {
+ this.configuration = configuration;
+ return this;
+ }
+
+ /*
+ * The logging configuration for HTTP requests and responses.
+ */
+ @Generated private HttpLogOptions httpLogOptions;
+
+ /**
+ * Sets The logging configuration for HTTP requests and responses.
+ *
+ * @param httpLogOptions the httpLogOptions value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder httpLogOptions(HttpLogOptions httpLogOptions) {
+ this.httpLogOptions = httpLogOptions;
+ return this;
+ }
+
+ /*
+ * The retry policy that will attempt to retry failed requests, if
+ * applicable.
+ */
+ @Generated private RetryPolicy retryPolicy;
+
+ /**
+ * Sets The retry policy that will attempt to retry failed requests, if applicable.
+ *
+ * @param retryPolicy the retryPolicy value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder retryPolicy(RetryPolicy retryPolicy) {
+ this.retryPolicy = retryPolicy;
+ return this;
+ }
+
+ /*
+ * The list of Http pipeline policies to add.
+ */
+ @Generated private final List pipelinePolicies;
+
+ /*
+ * The client options such as application ID and custom headers to set on a
+ * request.
+ */
+ @Generated private ClientOptions clientOptions;
+
+ /**
+ * Sets The client options such as application ID and custom headers to set on a request.
+ *
+ * @param clientOptions the clientOptions value.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder clientOptions(ClientOptions clientOptions) {
+ this.clientOptions = clientOptions;
+ return this;
+ }
+
+ /**
+ * Adds a custom Http pipeline policy.
+ *
+ * @param customPolicy The custom Http pipeline policy to add.
+ * @return the SnapshotClientBuilder.
+ */
+ @Generated
+ public SnapshotClientBuilder addPolicy(HttpPipelinePolicy customPolicy) {
+ pipelinePolicies.add(customPolicy);
+ return this;
+ }
+
+ /**
+ * Builds an instance of FaceClientImpl with the provided parameters.
+ *
+ * @return an instance of FaceClientImpl.
+ */
+ @Generated
+ private FaceClientImpl buildInnerClient() {
+ if (pipeline == null) {
+ this.pipeline = createHttpPipeline();
+ }
+ FaceClientImpl client = new FaceClientImpl(pipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ return client;
+ }
+
+ @Generated
+ private HttpPipeline createHttpPipeline() {
+ Configuration buildConfiguration =
+ (configuration == null) ? Configuration.getGlobalConfiguration() : configuration;
+ if (httpLogOptions == null) {
+ httpLogOptions = new HttpLogOptions();
+ }
+ if (clientOptions == null) {
+ clientOptions = new ClientOptions();
+ }
+ List policies = new ArrayList<>();
+ String clientName = properties.getOrDefault(SDK_NAME, "UnknownName");
+ String clientVersion = properties.getOrDefault(SDK_VERSION, "UnknownVersion");
+ String applicationId = CoreUtils.getApplicationId(clientOptions, httpLogOptions);
+ policies.add(new UserAgentPolicy(applicationId, clientName, clientVersion, buildConfiguration));
+ HttpHeaders headers = new HttpHeaders();
+ clientOptions.getHeaders().forEach(header -> headers.set(header.getName(), header.getValue()));
+ if (headers.getSize() > 0) {
+ policies.add(new AddHeadersPolicy(headers));
+ }
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_CALL)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addBeforeRetryPolicies(policies);
+ policies.add(retryPolicy == null ? new RetryPolicy() : retryPolicy);
+ policies.add(new CookiePolicy());
+ policies.addAll(
+ this.pipelinePolicies.stream()
+ .filter(p -> p.getPipelinePosition() == HttpPipelinePosition.PER_RETRY)
+ .collect(Collectors.toList()));
+ HttpPolicyProviders.addAfterRetryPolicies(policies);
+ policies.add(new HttpLoggingPolicy(httpLogOptions));
+ HttpPipeline httpPipeline =
+ new HttpPipelineBuilder()
+ .policies(policies.toArray(new HttpPipelinePolicy[0]))
+ .httpClient(httpClient)
+ .clientOptions(clientOptions)
+ .build();
+ return httpPipeline;
+ }
+
+ /**
+ * Builds an instance of SnapshotAsyncClient class.
+ *
+ * @return an instance of SnapshotAsyncClient.
+ */
+ @Generated
+ public SnapshotAsyncClient buildAsyncClient() {
+ return new SnapshotAsyncClient(buildInnerClient().getSnapshots());
+ }
+
+ /**
+ * Builds an instance of SnapshotClient class.
+ *
+ * @return an instance of SnapshotClient.
+ */
+ @Generated
+ public SnapshotClient buildClient() {
+ return new SnapshotClient(new SnapshotAsyncClient(buildInnerClient().getSnapshots()));
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FaceClientImpl.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FaceClientImpl.java
new file mode 100644
index 000000000000..183834e06827
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FaceClientImpl.java
@@ -0,0 +1,213 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face.implementation;
+
+import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.HttpPipelineBuilder;
+import com.azure.core.http.policy.CookiePolicy;
+import com.azure.core.http.policy.RetryPolicy;
+import com.azure.core.http.policy.UserAgentPolicy;
+import com.azure.core.util.serializer.JacksonAdapter;
+import com.azure.core.util.serializer.SerializerAdapter;
+
+/** Initializes a new instance of the FaceClient type. */
+public final class FaceClientImpl {
+ /**
+ * Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ */
+ private final String endpoint;
+
+ /**
+ * Gets Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ *
+ * @return the endpoint value.
+ */
+ public String getEndpoint() {
+ return this.endpoint;
+ }
+
+ /** The HTTP pipeline to send requests through. */
+ private final HttpPipeline httpPipeline;
+
+ /**
+ * Gets The HTTP pipeline to send requests through.
+ *
+ * @return the httpPipeline value.
+ */
+ public HttpPipeline getHttpPipeline() {
+ return this.httpPipeline;
+ }
+
+ /** The serializer to serialize an object into a string. */
+ private final SerializerAdapter serializerAdapter;
+
+ /**
+ * Gets The serializer to serialize an object into a string.
+ *
+ * @return the serializerAdapter value.
+ */
+ public SerializerAdapter getSerializerAdapter() {
+ return this.serializerAdapter;
+ }
+
+ /** The FacesImpl object to access its operations. */
+ private final FacesImpl faces;
+
+ /**
+ * Gets the FacesImpl object to access its operations.
+ *
+ * @return the FacesImpl object.
+ */
+ public FacesImpl getFaces() {
+ return this.faces;
+ }
+
+ /** The PersonGroupPersonsImpl object to access its operations. */
+ private final PersonGroupPersonsImpl personGroupPersons;
+
+ /**
+ * Gets the PersonGroupPersonsImpl object to access its operations.
+ *
+ * @return the PersonGroupPersonsImpl object.
+ */
+ public PersonGroupPersonsImpl getPersonGroupPersons() {
+ return this.personGroupPersons;
+ }
+
+ /** The PersonGroupsImpl object to access its operations. */
+ private final PersonGroupsImpl personGroups;
+
+ /**
+ * Gets the PersonGroupsImpl object to access its operations.
+ *
+ * @return the PersonGroupsImpl object.
+ */
+ public PersonGroupsImpl getPersonGroups() {
+ return this.personGroups;
+ }
+
+ /** The FaceListsImpl object to access its operations. */
+ private final FaceListsImpl faceLists;
+
+ /**
+ * Gets the FaceListsImpl object to access its operations.
+ *
+ * @return the FaceListsImpl object.
+ */
+ public FaceListsImpl getFaceLists() {
+ return this.faceLists;
+ }
+
+ /** The LargePersonGroupPersonsImpl object to access its operations. */
+ private final LargePersonGroupPersonsImpl largePersonGroupPersons;
+
+ /**
+ * Gets the LargePersonGroupPersonsImpl object to access its operations.
+ *
+ * @return the LargePersonGroupPersonsImpl object.
+ */
+ public LargePersonGroupPersonsImpl getLargePersonGroupPersons() {
+ return this.largePersonGroupPersons;
+ }
+
+ /** The LargePersonGroupsImpl object to access its operations. */
+ private final LargePersonGroupsImpl largePersonGroups;
+
+ /**
+ * Gets the LargePersonGroupsImpl object to access its operations.
+ *
+ * @return the LargePersonGroupsImpl object.
+ */
+ public LargePersonGroupsImpl getLargePersonGroups() {
+ return this.largePersonGroups;
+ }
+
+ /** The LargeFaceListsImpl object to access its operations. */
+ private final LargeFaceListsImpl largeFaceLists;
+
+ /**
+ * Gets the LargeFaceListsImpl object to access its operations.
+ *
+ * @return the LargeFaceListsImpl object.
+ */
+ public LargeFaceListsImpl getLargeFaceLists() {
+ return this.largeFaceLists;
+ }
+
+ /** The SnapshotsImpl object to access its operations. */
+ private final SnapshotsImpl snapshots;
+
+ /**
+ * Gets the SnapshotsImpl object to access its operations.
+ *
+ * @return the SnapshotsImpl object.
+ */
+ public SnapshotsImpl getSnapshots() {
+ return this.snapshots;
+ }
+
+ /** The PersonDirectoriesImpl object to access its operations. */
+ private final PersonDirectoriesImpl personDirectories;
+
+ /**
+ * Gets the PersonDirectoriesImpl object to access its operations.
+ *
+ * @return the PersonDirectoriesImpl object.
+ */
+ public PersonDirectoriesImpl getPersonDirectories() {
+ return this.personDirectories;
+ }
+
+ /**
+ * Initializes an instance of FaceClient client.
+ *
+ * @param endpoint Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ */
+ public FaceClientImpl(String endpoint) {
+ this(
+ new HttpPipelineBuilder()
+ .policies(new UserAgentPolicy(), new RetryPolicy(), new CookiePolicy())
+ .build(),
+ JacksonAdapter.createDefaultSerializerAdapter(),
+ endpoint);
+ }
+
+ /**
+ * Initializes an instance of FaceClient client.
+ *
+ * @param httpPipeline The HTTP pipeline to send requests through.
+ * @param endpoint Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ */
+ public FaceClientImpl(HttpPipeline httpPipeline, String endpoint) {
+ this(httpPipeline, JacksonAdapter.createDefaultSerializerAdapter(), endpoint);
+ }
+
+ /**
+ * Initializes an instance of FaceClient client.
+ *
+ * @param httpPipeline The HTTP pipeline to send requests through.
+ * @param serializerAdapter The serializer to serialize an object into a string.
+ * @param endpoint Supported Cognitive Services endpoints (protocol and hostname, for example:
+ * https://westus.api.cognitive.microsoft.com).
+ */
+ public FaceClientImpl(HttpPipeline httpPipeline, SerializerAdapter serializerAdapter, String endpoint) {
+ this.httpPipeline = httpPipeline;
+ this.serializerAdapter = serializerAdapter;
+ this.endpoint = endpoint;
+ this.faces = new FacesImpl(this);
+ this.personGroupPersons = new PersonGroupPersonsImpl(this);
+ this.personGroups = new PersonGroupsImpl(this);
+ this.faceLists = new FaceListsImpl(this);
+ this.largePersonGroupPersons = new LargePersonGroupPersonsImpl(this);
+ this.largePersonGroups = new LargePersonGroupsImpl(this);
+ this.largeFaceLists = new LargeFaceListsImpl(this);
+ this.snapshots = new SnapshotsImpl(this);
+ this.personDirectories = new PersonDirectoriesImpl(this);
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FaceListsImpl.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FaceListsImpl.java
new file mode 100644
index 000000000000..7af8f0da3c64
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FaceListsImpl.java
@@ -0,0 +1,1203 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face.implementation;
+
+import com.azure.core.annotation.BodyParam;
+import com.azure.core.annotation.Delete;
+import com.azure.core.annotation.ExpectedResponses;
+import com.azure.core.annotation.Get;
+import com.azure.core.annotation.Host;
+import com.azure.core.annotation.HostParam;
+import com.azure.core.annotation.Patch;
+import com.azure.core.annotation.PathParam;
+import com.azure.core.annotation.Post;
+import com.azure.core.annotation.Put;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceInterface;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.annotation.UnexpectedResponseExceptionType;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.http.rest.RestProxy;
+import com.azure.core.util.BinaryData;
+import com.azure.core.util.Context;
+import com.azure.core.util.FluxUtil;
+import reactor.core.publisher.Mono;
+
+/** An instance of this class provides access to all the operations defined in FaceLists. */
+public final class FaceListsImpl {
+ /** The proxy service used to perform REST calls. */
+ private final FaceListsService service;
+
+ /** The service client containing this operation class. */
+ private final FaceClientImpl client;
+
+ /**
+ * Initializes an instance of FaceListsImpl.
+ *
+ * @param client the instance of the service client containing this operation class.
+ */
+ FaceListsImpl(FaceClientImpl client) {
+ this.service =
+ RestProxy.create(FaceListsService.class, client.getHttpPipeline(), client.getSerializerAdapter());
+ this.client = client;
+ }
+
+ /**
+ * The interface defining all the services for FaceClientFaceLists to be used by the proxy service to perform REST
+ * calls.
+ */
+ @Host("{Endpoint}/face/v1.0-preview")
+ @ServiceInterface(name = "FaceClientFaceLists")
+ private interface FaceListsService {
+ @Put("/facelists/{faceListId}")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> create(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Get("/facelists/{faceListId}")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> get(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Patch("/facelists/{faceListId}")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> update(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Delete("/facelists/{faceListId}")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> delete(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Get("/facelists")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> list(
+ @HostParam("Endpoint") String endpoint, RequestOptions requestOptions, Context context);
+
+ @Delete("/facelists/{faceListId}/persistedfaces/{persistedFaceId}")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> deleteFace(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ @PathParam("persistedFaceId") String persistedFaceId,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/facelists/{faceListId}/persistedfaces")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> addFaceFromUrl(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ @BodyParam("application/json") BinaryData imageUrl,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/facelists/{faceListId}/persistedfaces")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> addFaceFromStream(
+ @HostParam("Endpoint") String endpoint,
+ @PathParam("faceListId") String faceListId,
+ @BodyParam("application/octet-stream") BinaryData image,
+ RequestOptions requestOptions,
+ Context context);
+ }
+
+ /**
+ * Create an empty face list with user-specified faceListId, name, an optional userData and recognitionModel. Up to
+ * 64 face lists are allowed in one subscription. <br /> Face list is a list of faces, up to 1,000 faces, and
+ * used by [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After
+ * creation, user should use [FaceList - Add
+ * Face](https://docs.microsoft.com/rest/api/faceapi/facelist/addfacefromurl) to import the faces. No image will be
+ * stored. Only the extracted face features are stored on server until [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Find Similar is used
+ * for scenario like finding celebrity-like faces, similar face filtering, or as a light way face identification.
+ * But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> Please consider
+ * [LargeFaceList](https://docs.microsoft.com/rest/api/faceapi/largefacelist) when the face number is large. It can
+ * support up to 1,000,000 faces. <br />'recognitionModel' should be specified to associate with this face
+ * list. 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 face list will use the
+ * recognition model that's already associated with the collection. Existing face features in a face list can't be
+ * updated to features extracted by another version of recognition model. Please Refer to [Specify a face
+ * recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for creating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponseAsync(
+ String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.create(this.client.getEndpoint(), faceListId, body, requestOptions, context));
+ }
+
+ /**
+ * Create an empty face list with user-specified faceListId, name, an optional userData and recognitionModel. Up to
+ * 64 face lists are allowed in one subscription. <br /> Face list is a list of faces, up to 1,000 faces, and
+ * used by [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After
+ * creation, user should use [FaceList - Add
+ * Face](https://docs.microsoft.com/rest/api/faceapi/facelist/addfacefromurl) to import the faces. No image will be
+ * stored. Only the extracted face features are stored on server until [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Find Similar is used
+ * for scenario like finding celebrity-like faces, similar face filtering, or as a light way face identification.
+ * But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> Please consider
+ * [LargeFaceList](https://docs.microsoft.com/rest/api/faceapi/largefacelist) when the face number is large. It can
+ * support up to 1,000,000 faces. <br />'recognitionModel' should be specified to associate with this face
+ * list. 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 face list will use the
+ * recognition model that's already associated with the collection. Existing face features in a face list can't be
+ * updated to features extracted by another version of recognition model. Please Refer to [Specify a face
+ * recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for creating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> createWithResponseAsync(
+ String faceListId, BinaryData body, RequestOptions requestOptions, Context context) {
+ return service.create(this.client.getEndpoint(), faceListId, body, requestOptions, context);
+ }
+
+ /**
+ * Create an empty face list with user-specified faceListId, name, an optional userData and recognitionModel. Up to
+ * 64 face lists are allowed in one subscription. <br /> Face list is a list of faces, up to 1,000 faces, and
+ * used by [Face - Find Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). <br /> After
+ * creation, user should use [FaceList - Add
+ * Face](https://docs.microsoft.com/rest/api/faceapi/facelist/addfacefromurl) to import the faces. No image will be
+ * stored. Only the extracted face features are stored on server until [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Find Similar is used
+ * for scenario like finding celebrity-like faces, similar face filtering, or as a light way face identification.
+ * But if the actual use is to identify person, please use
+ * [PersonGroup](https://docs.microsoft.com/rest/api/faceapi/persongroup) /
+ * [LargePersonGroup](https://docs.microsoft.com/rest/api/faceapi/largepersongroup) and [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify). <br /> Please consider
+ * [LargeFaceList](https://docs.microsoft.com/rest/api/faceapi/largefacelist) when the face number is large. It can
+ * support up to 1,000,000 faces. <br />'recognitionModel' should be specified to associate with this face
+ * list. 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 face list will use the
+ * recognition model that's already associated with the collection. Existing face features in a face list can't be
+ * updated to features extracted by another version of recognition model. Please Refer to [Specify a face
+ * recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for creating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response createWithResponse(String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return createWithResponseAsync(faceListId, body, requestOptions).block();
+ }
+
+ /**
+ * Retrieve a face list’s faceListId, name, userData, recognitionModel and faces in the face list.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return face list object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponseAsync(String faceListId, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.get(this.client.getEndpoint(), faceListId, requestOptions, context));
+ }
+
+ /**
+ * Retrieve a face list’s faceListId, name, userData, recognitionModel and faces in the face list.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return face list object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> getWithResponseAsync(
+ String faceListId, RequestOptions requestOptions, Context context) {
+ return service.get(this.client.getEndpoint(), faceListId, requestOptions, context);
+ }
+
+ /**
+ * Retrieve a face list’s faceListId, name, userData, recognitionModel and faces in the face list.
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return face list object along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response getWithResponse(String faceListId, RequestOptions requestOptions) {
+ return getWithResponseAsync(faceListId, requestOptions).block();
+ }
+
+ /**
+ * Update information of a face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for updating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponseAsync(
+ String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.update(this.client.getEndpoint(), faceListId, body, requestOptions, context));
+ }
+
+ /**
+ * Update information of a face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for updating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> updateWithResponseAsync(
+ String faceListId, BinaryData body, RequestOptions requestOptions, Context context) {
+ return service.update(this.client.getEndpoint(), faceListId, body, requestOptions, context);
+ }
+
+ /**
+ * Update information of a face list.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * name: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param body Request body for updating a face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response updateWithResponse(String faceListId, BinaryData body, RequestOptions requestOptions) {
+ return updateWithResponseAsync(faceListId, body, requestOptions).block();
+ }
+
+ /**
+ * Delete a specified face list.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponseAsync(String faceListId, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.delete(this.client.getEndpoint(), faceListId, requestOptions, context));
+ }
+
+ /**
+ * Delete a specified face list.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteWithResponseAsync(
+ String faceListId, RequestOptions requestOptions, Context context) {
+ return service.delete(this.client.getEndpoint(), faceListId, requestOptions, context);
+ }
+
+ /**
+ * Delete a specified face list.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteWithResponse(String faceListId, RequestOptions requestOptions) {
+ return deleteWithResponseAsync(faceListId, requestOptions).block();
+ }
+
+ /**
+ * List face lists’ faceListId, name, userData and recognitionModel. <br /> To get face information inside
+ * faceList use [FaceList - Get](https://docs.microsoft.com/rest/api/faceapi/facelist/get).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face list results, with fields of faceListId, name and userData along with {@link Response}
+ * on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponseAsync(RequestOptions requestOptions) {
+ return FluxUtil.withContext(context -> service.list(this.client.getEndpoint(), requestOptions, context));
+ }
+
+ /**
+ * List face lists’ faceListId, name, userData and recognitionModel. <br /> To get face information inside
+ * faceList use [FaceList - Get](https://docs.microsoft.com/rest/api/faceapi/facelist/get).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face list results, with fields of faceListId, name and userData along with {@link Response}
+ * on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> listWithResponseAsync(RequestOptions requestOptions, Context context) {
+ return service.list(this.client.getEndpoint(), requestOptions, context);
+ }
+
+ /**
+ * List face lists’ faceListId, name, userData and recognitionModel. <br /> To get face information inside
+ * faceList use [FaceList - Get](https://docs.microsoft.com/rest/api/faceapi/facelist/get).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | returnRecognitionModel | String | No | A value indicating whether the operation should return 'recognitionModel' in response. |
+ *
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceListId: String
+ * name: String
+ * userData: String
+ * recognitionModel: String(recognition_01/recognition_02/recognition_03/recognition_04)
+ * persistedFaces: [
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face list results, with fields of faceListId, name and userData along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response listWithResponse(RequestOptions requestOptions) {
+ return listWithResponseAsync(requestOptions).block();
+ }
+
+ /**
+ * Delete a face from a face list by specified faceListId and persistedFaceId. <br /> Adding/deleting faces
+ * to/from a same face list are processed sequentially and to/from different face lists are in parallel.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteFaceWithResponseAsync(
+ String faceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context ->
+ service.deleteFace(
+ this.client.getEndpoint(), faceListId, persistedFaceId, requestOptions, context));
+ }
+
+ /**
+ * Delete a face from a face list by specified faceListId and persistedFaceId. <br /> Adding/deleting faces
+ * to/from a same face list are processed sequentially and to/from different face lists are in parallel.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> deleteFaceWithResponseAsync(
+ String faceListId, String persistedFaceId, RequestOptions requestOptions, Context context) {
+ return service.deleteFace(this.client.getEndpoint(), faceListId, persistedFaceId, requestOptions, context);
+ }
+
+ /**
+ * Delete a face from a face list by specified faceListId and persistedFaceId. <br /> Adding/deleting faces
+ * to/from a same face list are processed sequentially and to/from different face lists are in parallel.
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param persistedFaceId Id referencing a particular persistedFaceId of an existing face.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return the {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response deleteFaceWithResponse(
+ String faceListId, String persistedFaceId, RequestOptions requestOptions) {
+ return deleteFaceWithResponseAsync(faceListId, persistedFaceId, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromUrlWithResponseAsync(
+ String faceListId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context ->
+ service.addFaceFromUrl(
+ this.client.getEndpoint(), faceListId, imageUrl, requestOptions, context));
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromUrlWithResponseAsync(
+ String faceListId, BinaryData imageUrl, RequestOptions requestOptions, Context context) {
+ return service.addFaceFromUrl(this.client.getEndpoint(), faceListId, imageUrl, requestOptions, context);
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * url: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param imageUrl A JSON document with a URL pointing to the image that is to be analyzed.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromUrlWithResponse(
+ String faceListId, BinaryData imageUrl, RequestOptions requestOptions) {
+ return addFaceFromUrlWithResponseAsync(faceListId, imageUrl, requestOptions).block();
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromStreamWithResponseAsync(
+ String faceListId, BinaryData image, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context ->
+ service.addFaceFromStream(
+ this.client.getEndpoint(), faceListId, image, requestOptions, context));
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> addFaceFromStreamWithResponseAsync(
+ String faceListId, BinaryData image, RequestOptions requestOptions, Context context) {
+ return service.addFaceFromStream(this.client.getEndpoint(), faceListId, image, requestOptions, context);
+ }
+
+ /**
+ * Add a face to a specified face list, up to 1,000 faces. <br /> 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 [FaceList - Delete Face](https://docs.microsoft.com/rest/api/faceapi/facelist/deleteface) or [FaceList -
+ * Delete](https://docs.microsoft.com/rest/api/faceapi/facelist/delete) is called. <br /> Note persistedFaceId
+ * is different from faceId generated by [Face -
+ * Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl). * Higher face image quality means better
+ * detection and recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200
+ * pixels (100 pixels between eyes) or bigger. * 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](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl), 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 face list are processed sequentially and
+ * to/from different face lists are 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * Query Parameters
+ *
+ *
+ * Query Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | userData | String | No | User-specified data about the face for any purpose. The maximum length is 1KB. |
+ * | targetFace | String | No | A face rectangle to specify the target face to be added to a person in the format of "targetFace=left,top,width,height". E.g. "targetFace=10,10,100,100". If there 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. In the form of "," separated string. |
+ * | detectionModel | String | No | 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. |
+ *
+ *
+ * Header Parameters
+ *
+ *
+ * Header Parameters
+ * | Name | Type | Required | Description |
|---|
+ * | Content-Length | long | Yes | The contentLength parameter |
+ *
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * Flux
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * persistedFaceId: String
+ * userData: String
+ * }
+ * }
+ *
+ * @param faceListId Id referencing a particular face list.
+ * @param image An image stream.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return personFace object along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response addFaceFromStreamWithResponse(
+ String faceListId, BinaryData image, RequestOptions requestOptions) {
+ return addFaceFromStreamWithResponseAsync(faceListId, image, requestOptions).block();
+ }
+}
diff --git a/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FacesImpl.java b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FacesImpl.java
new file mode 100644
index 000000000000..992ed78e195d
--- /dev/null
+++ b/sdk/cognitiveservices/azure-cognitiveservices-face/src/main/java/com/azure/cognitiveservices/face/implementation/FacesImpl.java
@@ -0,0 +1,2053 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.cognitiveservices.face.implementation;
+
+import com.azure.core.annotation.BodyParam;
+import com.azure.core.annotation.ExpectedResponses;
+import com.azure.core.annotation.Host;
+import com.azure.core.annotation.HostParam;
+import com.azure.core.annotation.Post;
+import com.azure.core.annotation.ReturnType;
+import com.azure.core.annotation.ServiceInterface;
+import com.azure.core.annotation.ServiceMethod;
+import com.azure.core.annotation.UnexpectedResponseExceptionType;
+import com.azure.core.exception.ClientAuthenticationException;
+import com.azure.core.exception.HttpResponseException;
+import com.azure.core.exception.ResourceModifiedException;
+import com.azure.core.exception.ResourceNotFoundException;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.http.rest.Response;
+import com.azure.core.http.rest.RestProxy;
+import com.azure.core.util.BinaryData;
+import com.azure.core.util.Context;
+import com.azure.core.util.FluxUtil;
+import reactor.core.publisher.Mono;
+
+/** An instance of this class provides access to all the operations defined in Faces. */
+public final class FacesImpl {
+ /** The proxy service used to perform REST calls. */
+ private final FacesService service;
+
+ /** The service client containing this operation class. */
+ private final FaceClientImpl client;
+
+ /**
+ * Initializes an instance of FacesImpl.
+ *
+ * @param client the instance of the service client containing this operation class.
+ */
+ FacesImpl(FaceClientImpl client) {
+ this.service = RestProxy.create(FacesService.class, client.getHttpPipeline(), client.getSerializerAdapter());
+ this.client = client;
+ }
+
+ /**
+ * The interface defining all the services for FaceClientFaces to be used by the proxy service to perform REST
+ * calls.
+ */
+ @Host("{Endpoint}/face/v1.0-preview")
+ @ServiceInterface(name = "FaceClientFaces")
+ private interface FacesService {
+ @Post("/findsimilars")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> findSimilar(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/group")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> group(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/identify")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> identify(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/verify")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> verifyFaceToFace(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/detect")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> detectWithUrl(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/json") BinaryData imageUrl,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/verify")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> verifyFaceToPerson(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/json") BinaryData body,
+ RequestOptions requestOptions,
+ Context context);
+
+ @Post("/detect")
+ @ExpectedResponses({200})
+ @UnexpectedResponseExceptionType(
+ value = ClientAuthenticationException.class,
+ code = {401})
+ @UnexpectedResponseExceptionType(
+ value = ResourceNotFoundException.class,
+ code = {404})
+ @UnexpectedResponseExceptionType(
+ value = ResourceModifiedException.class,
+ code = {409})
+ @UnexpectedResponseExceptionType(HttpResponseException.class)
+ Mono> detectWithStream(
+ @HostParam("Endpoint") String endpoint,
+ @BodyParam("application/octet-stream") BinaryData image,
+ RequestOptions requestOptions,
+ Context context);
+ }
+
+ /**
+ * 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 With
+ * Url](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl) or [Face - Detect With
+ * Stream](https://docs.microsoft.com/rest/api/faceapi/face/detectwithstream), which will expire at the time
+ * specified by faceIdTimeToLive after creation. A "faceListId" is created by [FaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/facelist/create) containing persistedFaceIds that will not
+ * expire. And a "largeFaceListId" is created by [LargeFaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/largefacelist/create) 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.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId: String
+ * faceListId: String
+ * largeFaceListId: String
+ * faceIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * mode: String(matchPerson/matchFace)
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * persistedFaceId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for Find Similar.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of SimilarFace along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> findSimilarWithResponseAsync(BinaryData body, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.findSimilar(this.client.getEndpoint(), body, requestOptions, context));
+ }
+
+ /**
+ * 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 With
+ * Url](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl) or [Face - Detect With
+ * Stream](https://docs.microsoft.com/rest/api/faceapi/face/detectwithstream), which will expire at the time
+ * specified by faceIdTimeToLive after creation. A "faceListId" is created by [FaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/facelist/create) containing persistedFaceIds that will not
+ * expire. And a "largeFaceListId" is created by [LargeFaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/largefacelist/create) 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.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId: String
+ * faceListId: String
+ * largeFaceListId: String
+ * faceIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * mode: String(matchPerson/matchFace)
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * persistedFaceId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for Find Similar.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of SimilarFace along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> findSimilarWithResponseAsync(
+ BinaryData body, RequestOptions requestOptions, Context context) {
+ return service.findSimilar(this.client.getEndpoint(), body, requestOptions, context);
+ }
+
+ /**
+ * 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 With
+ * Url](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl) or [Face - Detect With
+ * Stream](https://docs.microsoft.com/rest/api/faceapi/face/detectwithstream), which will expire at the time
+ * specified by faceIdTimeToLive after creation. A "faceListId" is created by [FaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/facelist/create) containing persistedFaceIds that will not
+ * expire. And a "largeFaceListId" is created by [LargeFaceList -
+ * Create](https://docs.microsoft.com/rest/api/faceapi/largefacelist/create) 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.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId: String
+ * faceListId: String
+ * largeFaceListId: String
+ * faceIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * mode: String(matchPerson/matchFace)
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * persistedFaceId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for Find Similar.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of SimilarFace along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response findSimilarWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return findSimilarWithResponseAsync(body, requestOptions).block();
+ }
+
+ /**
+ * Divide candidate faces into groups based on face similarity.<br /> * The output is one or more disjointed
+ * face groups and a messyGroup. A face group contains faces that have similar looking, often of the same person.
+ * Face groups are ranked by group size, i.e. number of faces. Notice that faces belonging to a same person might be
+ * split into several groups in the result. * MessyGroup is a special face group containing faces that cannot find
+ * any similar counterpart face from original faces. The messyGroup will not appear in the result if all faces found
+ * their counterparts. * Group API needs at least 2 candidate faces and 1000 at most. We suggest to try [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface) when you only have 2 candidate faces.
+ * * The 'recognitionModel' associated with the query faces' faceIds should be the same.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * groups: [
+ * [
+ * String
+ * ]
+ * ]
+ * messyGroup: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param body Request body for grouping.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face groups based on face similarity along with {@link Response} on successful completion of
+ * {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> groupWithResponseAsync(BinaryData body, RequestOptions requestOptions) {
+ return FluxUtil.withContext(context -> service.group(this.client.getEndpoint(), body, requestOptions, context));
+ }
+
+ /**
+ * Divide candidate faces into groups based on face similarity.<br /> * The output is one or more disjointed
+ * face groups and a messyGroup. A face group contains faces that have similar looking, often of the same person.
+ * Face groups are ranked by group size, i.e. number of faces. Notice that faces belonging to a same person might be
+ * split into several groups in the result. * MessyGroup is a special face group containing faces that cannot find
+ * any similar counterpart face from original faces. The messyGroup will not appear in the result if all faces found
+ * their counterparts. * Group API needs at least 2 candidate faces and 1000 at most. We suggest to try [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface) when you only have 2 candidate faces.
+ * * The 'recognitionModel' associated with the query faces' faceIds should be the same.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * groups: [
+ * [
+ * String
+ * ]
+ * ]
+ * messyGroup: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param body Request body for grouping.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face groups based on face similarity along with {@link Response} on successful completion of
+ * {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> groupWithResponseAsync(
+ BinaryData body, RequestOptions requestOptions, Context context) {
+ return service.group(this.client.getEndpoint(), body, requestOptions, context);
+ }
+
+ /**
+ * Divide candidate faces into groups based on face similarity.<br /> * The output is one or more disjointed
+ * face groups and a messyGroup. A face group contains faces that have similar looking, often of the same person.
+ * Face groups are ranked by group size, i.e. number of faces. Notice that faces belonging to a same person might be
+ * split into several groups in the result. * MessyGroup is a special face group containing faces that cannot find
+ * any similar counterpart face from original faces. The messyGroup will not appear in the result if all faces found
+ * their counterparts. * Group API needs at least 2 candidate faces and 1000 at most. We suggest to try [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface) when you only have 2 candidate faces.
+ * * The 'recognitionModel' associated with the query faces' faceIds should be the same.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * groups: [
+ * [
+ * String
+ * ]
+ * ]
+ * messyGroup: [
+ * String
+ * ]
+ * }
+ * }
+ *
+ * @param body Request body for grouping.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return an array of face groups based on face similarity along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response groupWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return groupWithResponseAsync(body, requestOptions).block();
+ }
+
+ /**
+ * 1-to-many identification to find the closest matches of the specific query person face from a person group, large
+ * person group, person directory dynamic person group or person directory personIds array. <br/> For each
+ * face in the faceIds array, Face Identify will compute similarities between the query face and all the faces in
+ * the person group (given by personGroupId) or large person group (given by largePersonGroupId), and return
+ * candidate person(s) for that face ranked by similarity confidence. The person group/large person group should be
+ * trained to make it ready for identification. See more in [PersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/persongroup/train) and [LargePersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/train). <br/>
+ *
+ * Remarks:<br /> * The algorithm allows more than one face to be identified independently at the same
+ * request, but no more than 10 faces. * Each person in the person group/large person group could have more than one
+ * face, but no more than 248 faces. * Higher face image quality means better identification precision. Please
+ * consider high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger.
+ * * Number of candidates returned is restricted by maxNumOfCandidatesReturned and confidenceThreshold. If no person
+ * is identified, the returned candidates will be an empty array. * Try [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) when you need to find similar faces from a
+ * face list/large face list instead of a person group/large person group. * The 'recognitionModel' associated with
+ * the query faces' faceIds should be the same as the 'recognitionModel' used by the target person group or large
+ * person group.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * personGroupId: String
+ * largePersonGroupId: String
+ * dynamicPersonGroupId: String
+ * personIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * confidenceThreshold: Float
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * candidates: [
+ * {
+ * personId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for identify operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of IdentifyResult along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> identifyWithResponseAsync(BinaryData body, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.identify(this.client.getEndpoint(), body, requestOptions, context));
+ }
+
+ /**
+ * 1-to-many identification to find the closest matches of the specific query person face from a person group, large
+ * person group, person directory dynamic person group or person directory personIds array. <br/> For each
+ * face in the faceIds array, Face Identify will compute similarities between the query face and all the faces in
+ * the person group (given by personGroupId) or large person group (given by largePersonGroupId), and return
+ * candidate person(s) for that face ranked by similarity confidence. The person group/large person group should be
+ * trained to make it ready for identification. See more in [PersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/persongroup/train) and [LargePersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/train). <br/>
+ *
+ * Remarks:<br /> * The algorithm allows more than one face to be identified independently at the same
+ * request, but no more than 10 faces. * Each person in the person group/large person group could have more than one
+ * face, but no more than 248 faces. * Higher face image quality means better identification precision. Please
+ * consider high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger.
+ * * Number of candidates returned is restricted by maxNumOfCandidatesReturned and confidenceThreshold. If no person
+ * is identified, the returned candidates will be an empty array. * Try [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) when you need to find similar faces from a
+ * face list/large face list instead of a person group/large person group. * The 'recognitionModel' associated with
+ * the query faces' faceIds should be the same as the 'recognitionModel' used by the target person group or large
+ * person group.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * personGroupId: String
+ * largePersonGroupId: String
+ * dynamicPersonGroupId: String
+ * personIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * confidenceThreshold: Float
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * candidates: [
+ * {
+ * personId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for identify operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of IdentifyResult along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> identifyWithResponseAsync(
+ BinaryData body, RequestOptions requestOptions, Context context) {
+ return service.identify(this.client.getEndpoint(), body, requestOptions, context);
+ }
+
+ /**
+ * 1-to-many identification to find the closest matches of the specific query person face from a person group, large
+ * person group, person directory dynamic person group or person directory personIds array. <br/> For each
+ * face in the faceIds array, Face Identify will compute similarities between the query face and all the faces in
+ * the person group (given by personGroupId) or large person group (given by largePersonGroupId), and return
+ * candidate person(s) for that face ranked by similarity confidence. The person group/large person group should be
+ * trained to make it ready for identification. See more in [PersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/persongroup/train) and [LargePersonGroup -
+ * Train](https://docs.microsoft.com/rest/api/faceapi/largepersongroup/train). <br/>
+ *
+ * Remarks:<br /> * The algorithm allows more than one face to be identified independently at the same
+ * request, but no more than 10 faces. * Each person in the person group/large person group could have more than one
+ * face, but no more than 248 faces. * Higher face image quality means better identification precision. Please
+ * consider high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger.
+ * * Number of candidates returned is restricted by maxNumOfCandidatesReturned and confidenceThreshold. If no person
+ * is identified, the returned candidates will be an empty array. * Try [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) when you need to find similar faces from a
+ * face list/large face list instead of a person group/large person group. * The 'recognitionModel' associated with
+ * the query faces' faceIds should be the same as the 'recognitionModel' used by the target person group or large
+ * person group.
+ *
+ *
Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceIds: [
+ * String
+ * ]
+ * personGroupId: String
+ * largePersonGroupId: String
+ * dynamicPersonGroupId: String
+ * personIds: [
+ * String
+ * ]
+ * maxNumOfCandidatesReturned: Integer
+ * confidenceThreshold: Float
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * [
+ * {
+ * faceId: String
+ * candidates: [
+ * {
+ * personId: String
+ * confidence: float
+ * }
+ * ]
+ * }
+ * ]
+ * }
+ *
+ * @param body Request body for identify operation.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return array of IdentifyResult along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response identifyWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return identifyWithResponseAsync(body, requestOptions).block();
+ }
+
+ /**
+ * Verify whether two faces belong to a same person or whether one face belongs to a person. <br/>
+ * Remarks:<br /> * Higher face image quality means better identification precision. Please consider
+ * high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger. * For
+ * the scenarios that are sensitive to accuracy please make your own judgment. * The 'recognitionModel' associated
+ * with the query faces' faceIds should be the same as the 'recognitionModel' used by the target face, person group
+ * or large person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId1: String
+ * faceId2: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * isIdentical: boolean
+ * confidence: float
+ * }
+ * }
+ *
+ * @param body Request body for face to face verification.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return result of the verify operation along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> verifyFaceToFaceWithResponseAsync(
+ BinaryData body, RequestOptions requestOptions) {
+ return FluxUtil.withContext(
+ context -> service.verifyFaceToFace(this.client.getEndpoint(), body, requestOptions, context));
+ }
+
+ /**
+ * Verify whether two faces belong to a same person or whether one face belongs to a person. <br/>
+ * Remarks:<br /> * Higher face image quality means better identification precision. Please consider
+ * high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger. * For
+ * the scenarios that are sensitive to accuracy please make your own judgment. * The 'recognitionModel' associated
+ * with the query faces' faceIds should be the same as the 'recognitionModel' used by the target face, person group
+ * or large person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId1: String
+ * faceId2: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * isIdentical: boolean
+ * confidence: float
+ * }
+ * }
+ *
+ * @param body Request body for face to face verification.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @param context The context to associate with this operation.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return result of the verify operation along with {@link Response} on successful completion of {@link Mono}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Mono> verifyFaceToFaceWithResponseAsync(
+ BinaryData body, RequestOptions requestOptions, Context context) {
+ return service.verifyFaceToFace(this.client.getEndpoint(), body, requestOptions, context);
+ }
+
+ /**
+ * Verify whether two faces belong to a same person or whether one face belongs to a person. <br/>
+ * Remarks:<br /> * Higher face image quality means better identification precision. Please consider
+ * high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger. * For
+ * the scenarios that are sensitive to accuracy please make your own judgment. * The 'recognitionModel' associated
+ * with the query faces' faceIds should be the same as the 'recognitionModel' used by the target face, person group
+ * or large person group.
+ *
+ * Request Body Schema
+ *
+ *
{@code
+ * {
+ * faceId1: String
+ * faceId2: String
+ * }
+ * }
+ *
+ * Response Body Schema
+ *
+ *
{@code
+ * {
+ * isIdentical: boolean
+ * confidence: float
+ * }
+ * }
+ *
+ * @param body Request body for face to face verification.
+ * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+ * @throws HttpResponseException thrown if the request is rejected by server.
+ * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+ * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+ * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+ * @return result of the verify operation along with {@link Response}.
+ */
+ @ServiceMethod(returns = ReturnType.SINGLE)
+ public Response verifyFaceToFaceWithResponse(BinaryData body, RequestOptions requestOptions) {
+ return verifyFaceToFaceWithResponseAsync(body, requestOptions).block();
+ }
+
+ /**
+ * Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and
+ * attributes.<br /> * No image will be stored. Only the extracted face feature will be stored on server. The
+ * faceId is an identifier of the face feature and will be used in [Face -
+ * Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar). The stored face feature(s) will expire
+ * and be deleted at the time specified by faceIdTimeToLive after the original detection call. * Optional parameters
+ * include faceId, landmarks, and attributes. Attributes include age, gender, headPose, smile, facialHair, glasses,
+ * emotion, hair, makeup, occlusion, accessories, blur, exposure, noise, mask, and qualityForRecognition. Some of
+ * the results returned for specific attributes may not be highly accurate. * JPEG, PNG, GIF (the first frame), and
+ * BMP format are supported. The allowed image file size is from 1KB to 6MB. * Up to 100 faces can be returned for
+ * an image. Faces are ranked by face rectangle size from large to small. * For optimal results when querying [Face
+ * - Identify](https://docs.microsoft.com/rest/api/faceapi/face/identify), [Face -
+ * Verify](https://docs.microsoft.com/rest/api/faceapi/face/verifyfacetoface), and [Face - Find
+ * Similar](https://docs.microsoft.com/rest/api/faceapi/face/findsimilar) ('returnFaceId' is true), please use faces
+ * that are: frontal, clear, and with a minimum size of 200x200 pixels (100 pixels between eyes). * 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/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model).
+ *
+ * * Different 'recognitionModel' values are provided. If follow-up operations like Verify, Identify, Find
+ * Similar are needed, please specify the recognition model with 'recognitionModel' parameter. The default value for
+ * 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in
+ * this parameter. Once specified, the detected faceIds will be associated with the specified recognition model.
+ * More details, please refer to [Specify a recognition
+ * model](https://docs.microsoft.com/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model).
+ *
+ *
Query Parameters
+ *
+ *