Skip to content

Commit a473b05

Browse files
committed
Fix merge conflicts between main and migration temp branch
2 parents 46a3bdd + df8f035 commit a473b05

File tree

806 files changed

+28226
-36075
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

806 files changed

+28226
-36075
lines changed

.openpublishing.redirection.api-management.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/api-management/api-management-in-workspace.md",
5+
"redirect_url": "/azure/api-management/how-to-create-workspace",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path": "articles/api-management/set-graphql-resolver-policy.md",
510
"redirect_url": "/previous-versions/azure/api-management/set-graphql-resolver-policy",
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"redirections": [
3+
{
4+
"source_path_from_root": "/articles/azure-functions/durable/durable-functions-configure-durable-functions-with-credentials.md",
5+
"redirect_url": "/azure/azure-functions/durable/durable-functions-configure-managed-identity",
6+
"redirect_document_id": false
7+
}
8+
]
9+
}
Lines changed: 167 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,167 @@
1+
---
2+
title: "Face Java client library quickstart"
3+
description: Use the Face client library for Java to detect faces and identify faces (facial recognition search).
4+
#services: cognitive-services
5+
author: PatrickFarley
6+
manager: nitinme
7+
ms.service: azure-ai-vision
8+
ms.subservice: azure-ai-face
9+
ms.custom:
10+
- ignite-2023
11+
ms.topic: include
12+
ms.date: 08/08/2024
13+
ms.author: pafarley
14+
---
15+
16+
Get started with facial recognition using the Face client library for Java. Follow these steps to install the package and try out the example code for basic tasks. The Face service provides you with access to advanced algorithms for detecting and recognizing human faces in images. Follow these steps to install the package and try out the example code for basic face identification using remote images.
17+
18+
[Reference documentation](https://aka.ms/azsdk-java-face-ref) | [Library source code](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/face/azure-ai-vision-face) | [Package (Maven)](https://central.sonatype.com/artifact/com.azure/azure-ai-vision-face) | [Samples](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/face/azure-ai-vision-face/src/samples)
19+
20+
## Prerequisites
21+
22+
* Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
23+
* The current version of the [Java Development Kit (JDK)](https://www.microsoft.com/openjdk)
24+
* [Apache Maven](https://maven.apache.org/download.cgi) installed. On Linux, install from the distribution repositories if available.
25+
* Once you have your Azure subscription, <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesFace" title="Create a Face resource" target="_blank">create a Face resource</a> in the Azure portal to get your key and endpoint. After it deploys, select **Go to resource**.
26+
* You'll need the key and endpoint from the resource you create to connect your application to the Face API.
27+
* You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
28+
29+
30+
## Create environment variables
31+
32+
[!INCLUDE [create environment variables](../face-environment-variables.md)]
33+
34+
## Identify and verify faces
35+
36+
1. Install the client library
37+
38+
Open a console window and create a new folder for your quickstart application. Copy the following content to a new file. Save the file as `pom.xml` in your project directory:
39+
40+
<!-- [!INCLUDE][](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-quickstart-code/master/java/Face/pom.xml)] -->
41+
```xml
42+
<project xmlns="http://maven.apache.org/POM/4.0.0"
43+
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
44+
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
45+
<modelVersion>4.0.0</modelVersion>
46+
<groupId>com.example</groupId>
47+
<artifactId>my-application-name</artifactId>
48+
<version>1.0.0</version>
49+
<dependencies>
50+
<!-- https://mvnrepository.com/artifact/com.azure/azure-ai-vision-face -->
51+
<dependency>
52+
<groupId>com.azure</groupId>
53+
<artifactId>azure-ai-vision-face</artifactId>
54+
<version>1.0.0-beta.1</version>
55+
</dependency>
56+
<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient -->
57+
<dependency>
58+
<groupId>org.apache.httpcomponents</groupId>
59+
<artifactId>httpclient</artifactId>
60+
<version>4.5.13</version>
61+
</dependency>
62+
<!-- https://mvnrepository.com/artifact/com.google.code.gson/gson -->
63+
<dependency>
64+
<groupId>com.google.code.gson</groupId>
65+
<artifactId>gson</artifactId>
66+
<version>2.11.0</version>
67+
</dependency>
68+
</dependencies>
69+
</project>
70+
```
71+
72+
Install the SDK and dependencies by running the following in the project directory:
73+
74+
```console
75+
mvn clean dependency:copy-dependencies
76+
```
77+
78+
1. Create a new Java application
79+
80+
Create a file named `Quickstart.java`, open it in a text editor, and paste in the following code:
81+
82+
> [!NOTE]
83+
> If you haven't received access to the Face service using the [intake form](https://aka.ms/facerecognition), some of these functions won't work.
84+
85+
[!code-java[](~/cognitive-services-quickstart-code/java/Face/Quickstart.java?name=snippet_single)]
86+
87+
88+
1. Run your face recognition app from the application directory with the `javac` and `java` commands.
89+
90+
#### [Windows](#tab/windows)
91+
92+
```console
93+
javac -cp target\dependency\* Quickstart.java
94+
java -cp .;target\dependency\* Quickstart
95+
```
96+
97+
#### [Linux](#tab/linux)
98+
99+
```console
100+
javac -cp target/dependency/* Quickstart.java
101+
java -cp .:target/dependency/* Quickstart
102+
```
103+
104+
---
105+
106+
107+
108+
## Output
109+
110+
```console
111+
========IDENTIFY FACES========
112+
113+
Create a person group (3761e61a-16b2-4503-ad29-ed34c58ba676).
114+
Create a person group person 'Family1-Dad'.
115+
Check whether image is of sufficient quality for recognition
116+
Add face to the person group person(Family1-Dad) from image `Family1-Dad1.jpg`
117+
Check whether image is of sufficient quality for recognition
118+
Add face to the person group person(Family1-Dad) from image `Family1-Dad2.jpg`
119+
Create a person group person 'Family1-Mom'.
120+
Check whether image is of sufficient quality for recognition
121+
Add face to the person group person(Family1-Mom) from image `Family1-Mom1.jpg`
122+
Check whether image is of sufficient quality for recognition
123+
Add face to the person group person(Family1-Mom) from image `Family1-Mom2.jpg`
124+
Create a person group person 'Family1-Son'.
125+
Check whether image is of sufficient quality for recognition
126+
Add face to the person group person(Family1-Son) from image `Family1-Son1.jpg`
127+
Check whether image is of sufficient quality for recognition
128+
Add face to the person group person(Family1-Son) from image `Family1-Son2.jpg`
129+
130+
Train person group 3761e61a-16b2-4503-ad29-ed34c58ba676.
131+
Training status: succeeded.
132+
133+
Pausing for 60 seconds to avoid triggering rate limit on free account...
134+
4 face(s) with 4 having sufficient quality for recognition.
135+
Person 'Family1-Dad' is identified for the face in: identification1.jpg - d7995b34-1b72-47fe-82b6-e9877ed2578d, confidence: 0.96807.
136+
Verification result: is a match? true. confidence: 0.96807
137+
Person 'Family1-Mom' is identified for the face in: identification1.jpg - 844da0ed-4890-4bbf-a531-e638797f96fc, confidence: 0.96902.
138+
Verification result: is a match? true. confidence: 0.96902
139+
No person is identified for the face in: identification1.jpg - c543159a-57f3-4872-83ce-2d4a733d71c9.
140+
Person 'Family1-Son' is identified for the face in: identification1.jpg - 414fac6c-7381-4dba-9c8b-fd26d52e879b, confidence: 0.9281.
141+
Verification result: is a match? true. confidence: 0.9281
142+
143+
========DELETE PERSON GROUP========
144+
145+
Deleted the person group 3761e61a-16b2-4503-ad29-ed34c58ba676.
146+
147+
End of quickstart.
148+
```
149+
150+
151+
152+
## Clean up resources
153+
154+
If you want to clean up and remove an Azure AI services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
155+
156+
* [Azure portal](../../../multi-service-resource.md?pivots=azportal#clean-up-resources)
157+
* [Azure CLI](../../../multi-service-resource.md?pivots=azcli#clean-up-resources)
158+
159+
## Next steps
160+
161+
In this quickstart, you learned how to use the Face client library for Java to do basic face identification. Next, learn about the different face detection models and how to specify the right model for your use case.
162+
163+
> [!div class="nextstepaction"]
164+
> [Specify a face detection model version](../../how-to/specify-detection-model.md)
165+
166+
* [What is the Face service?](../../overview-identity.md)
167+
* More extensive sample code can be found on [GitHub](https://aka.ms/FaceSamples).

articles/ai-services/computer-vision/quickstarts-sdk/identity-client-library.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,11 @@ keywords: face search by image, facial recognition search, facial recognition, f
3535

3636
::: zone-end
3737

38+
::: zone pivot="programming-language-java"
39+
40+
[!INCLUDE [Java quickstart](../includes/quickstarts-sdk/identity-java-sdk.md)]
41+
42+
::: zone-end
3843

3944
::: zone pivot="programming-language-javascript"
4045

articles/ai-services/content-safety/how-to/encrypt-data-at-rest.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,14 +20,10 @@ Azure AI Content Safety automatically encrypts your data when it's persisted to
2020

2121
Azure AI Content Safety is part of Azure AI services. Azure AI services data is encrypted and decrypted using [FIPS 140-2](https://en.wikipedia.org/wiki/FIPS_140-2) compliant [256-bit AES](https://en.wikipedia.org/wiki/Advanced_Encryption_Standard) encryption. Encryption and decryption are transparent, meaning encryption and access are managed for you. Your data is secure by default and you don't need to modify your code or applications to take advantage of encryption.
2222

23-
2423
## About encryption key management
2524

2625
By default, your subscription uses Microsoft-managed encryption keys. There's also the option to manage your subscription with your own keys called customer-managed keys (CMK). CMK offers greater flexibility to create, rotate, disable, and revoke access controls. You can also audit the encryption keys used to protect your data.
2726

28-
> [!IMPORTANT]
29-
> For blocklist names, only MMK encryption is applied by default. Using CMK or not will not change this behavior. All the other data will use either MMK or CMK depending on what you've selected.
30-
3127
## Customer-managed keys with Azure Key Vault
3228

3329
Customer-managed keys (CMK), also known as Bring your own key (BYOK), offer greater flexibility to create, rotate, disable, and revoke access controls. You can also audit the encryption keys used to protect your data.

articles/ai-services/document-intelligence/choose-model-feature.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,8 @@ description: Choose the best Document Intelligence model for your applications a
55
author: laujan
66
manager: nitinme
77
ms.service: azure-ai-document-intelligence
8-
ms.custom:
9-
- ignite-2023
108
ms.topic: overview
11-
ms.date: 02/29/2024
9+
ms.date: 08/07/2024
1210
ms.author: lajanuar
1311
---
1412

@@ -50,12 +48,12 @@ The following decision charts highlight the features of each **Document Intellig
5048

5149
| Document type | Data to extract | Your best solution |
5250
| -----------------|--------------|-------------------|
53-
|**US W-2 tax form**|You want to extract key information such as salary, wages, and taxes withheld.|[**US tax W-2 model**](concept-tax-document.md)|
54-
|**US Tax 1098 form**|You want to extract mortgage interest details such as principal, points, and tax.|[**US tax 1098 model**](concept-tax-document.md)|
55-
|**US Tax 1098-E form**|You want to extract student loan interest details such as lender and interest amount.|[**US tax 1098-E model**](concept-tax-document.md)|
56-
|**US Tax 1098T form**|You want to extract qualified tuition details such as scholarship adjustments, student status, and lender information.|[**US tax 1098-T model**](concept-tax-document.md)|
57-
|**US Tax 1099(Variations) form**|You want to extract information from `1099` forms and its variations (A, B, C, CAP, DIV, G, H, INT, K, LS, LTC, MISC, NEC, OID, PATR, Q, QA, R, S, SA, SB).|[**US tax 1099 model**](concept-tax-document.md)|
58-
|**US Tax 1040(Variations) form**|You want to extract information from `1040` forms and its variations (Schedule 1, Schedule 2, Schedule 3, Schedule 8812, Schedule A, Schedule B, Schedule C, Schedule D, Schedule E, Schedule EIC, Schedule F, Schedule H, Schedule J, Schedule R, Schedule SE, Schedule Senior).|[**US tax 1040 model**](concept-tax-document.md)|
51+
|**US Tax W-2 tax**|You want to extract key information such as salary, wages, and taxes withheld.|[**US tax W-2 model**](concept-tax-document.md)|
52+
|**US Tax 1098**|You want to extract mortgage interest details such as principal, points, and tax.|[**US tax 1098 model**](concept-tax-document.md)|
53+
|**US Tax 1098-E**|You want to extract student loan interest details such as lender and interest amount.|[**US tax 1098-E model**](concept-tax-document.md)|
54+
|**US Tax 1098T**|You want to extract qualified tuition details such as scholarship adjustments, student status, and lender information.|[**US tax 1098-T model**](concept-tax-document.md)|
55+
|**US Tax 1099(Variations)**|You want to extract information from `1099` forms and its variations (A, B, C, CAP, DIV, G, H, INT, K, LS, LTC, MISC, NEC, OID, PATR, Q, QA, R, S, SA, SB).|[**US tax 1099 model**](concept-tax-document.md)|
56+
|**US Tax 1040(Variations)**|You want to extract information from `1040` forms and its variations (Schedule 1, Schedule 2, Schedule 3, Schedule 8812, Schedule A, Schedule B, Schedule C, Schedule D, Schedule E, Schedule `EIC`, Schedule F, Schedule H, Schedule J, Schedule R, Schedule `SE`, Schedule Senior).|[**US tax 1040 model**](concept-tax-document.md)|
5957
|**Contract** (legal agreement between parties).|You want to extract contract agreement details such as parties, dates, and intervals.|[**Contract model**](concept-contract.md)|
6058
|**Health insurance card** or health insurance ID.| You want to extract key information such as insurer, member ID, prescription coverage, and group number.|[**Health insurance card model**](./concept-health-insurance-card.md)|
6159
|**Credit/Debit card** . |You want to extract key information bank cards such as card number and bank name. | [**Credit/Debit card model**](concept-credit-card.md)|
@@ -78,7 +76,8 @@ The following decision charts highlight the features of each **Document Intellig
7876
| Training set | Example documents | Your best solution |
7977
| -----------------|--------------|-------------------|
8078
|**Structured, consistent, documents with a static layout**. |Structured forms such as questionnaires or applications. | [**Custom template model**](./concept-custom-template.md)|
81-
|**Structured, semi-structured, and unstructured documents**.|&#9679; Structured &rightarrow; surveys</br>&#9679; Semi-structured &rightarrow; invoices</br>&#9679; Unstructured &rightarrow; letters| [**Custom neural model**](concept-custom-neural.md)|
79+
|**Structured and semi-structured**.|&#9679; Structured &rightarrow; surveys</br>&#9679; Semi-structured &rightarrow; invoices | [**Custom neural model**](concept-custom-neural.md)|
80+
|**Unstructured documents, documents with varying templates**.|&#9679; Unstructured documents like contracts or letters</br> &#9679; Varying document templates like loan statements from different mortgage companies| [**Custom generative model**](concept-custom-generative.md)|
8281
|**A collection of several models each trained on similar-type documents.** |&#9679; Supply purchase orders</br>&#9679; Equipment purchase orders</br>&#9679; Furniture purchase orders</br> **All composed into a single model**.| [**Composed custom model**](concept-composed-models.md)|
8382

8483
## Custom classification model

0 commit comments

Comments
 (0)