Skip to content

Commit 2af9cce

Browse files
authored
Merge pull request #268689 from MicrosoftDocs/main
3/11/2024 PM Publish
2 parents 81cf81c + df4072e commit 2af9cce

File tree

94 files changed

+775
-733
lines changed

Some content is hidden

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

94 files changed

+775
-733
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10940,6 +10940,11 @@
1094010940
"redirect_url": "/azure/azure-health-insights/overview",
1094110941
"redirect_document_id": false
1094210942
},
10943+
{
10944+
"source_path_from_root": "/articles/azure-functions/functions-monitor-log-analytics.md",
10945+
"redirect_url": "/azure/azure-functions/monitor-functions",
10946+
"redirect_document_id": false
10947+
},
1094310948
{
1094410949
"source_path_from_root": "/articles/cloud-services-php-create-web-role.md",
1094510950
"redirect_url": "/azure/cloud-services/cloud-services-php-create-web-role",

articles/ai-services/computer-vision/how-to/identity-access-token.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,25 +9,25 @@ manager: nitinme
99
ms.service: azure-ai-vision
1010
ms.subservice: azure-ai-face
1111
ms.topic: how-to
12-
ms.date: 05/11/2023
12+
ms.date: 03/07/2024
1313
ms.author: pafarley
1414
---
1515

1616
# Use limited access tokens for Face
1717

18-
Independent software vendors (ISVs) can manage the Face API usage of their clients by issuing access tokens that grant access to Face features which are normally gated. This allows client companies to use the Face API without having to go through the formal approval process.
18+
Independent software vendors (ISVs) can manage the Face API usage of their clients by issuing access tokens that grant access to Face features which are normally gated. This allows their client companies to use the Face API without having to go through the formal approval process.
1919

2020
This guide shows you how to generate the access tokens, if you're an approved ISV, and how to use the tokens if you're a client.
2121

22-
The LimitedAccessToken feature is a part of the existing [Azure AI services token service](https://westus.dev.cognitive.microsoft.com/docs/services/57346a70b4769d2694911369/operations/issueScopedToken). We have added a new operation for the purpose of bypassing the Limited Access gate for approved scenarios. Only ISVs that pass the gating requirements will be given access to this feature.
22+
The limited access token feature is a part of the existing [Azure AI services token service](https://westus.dev.cognitive.microsoft.com/docs/services/57346a70b4769d2694911369/operations/issueScopedToken). We have added a new operation for the purpose of bypassing the Limited Access gate for approved scenarios. Only ISVs that pass the gating requirements will be given access to this feature.
2323

2424
## Example use case
2525

26-
A company sells software that uses the Azure AI Face service to operate door access security systems. Their clients, individual manufacturers of door devices, subscribe to the software and run it on their devices. These client companies want to make Face API calls from their devices to perform Limited Access operations like face identification. By relying on access tokens from the ISV, they can bypass the formal approval process for face identification. The ISV, which has already been approved, can grant the client just-in-time access tokens.
26+
An example company sells software that uses the Azure AI Face service to operate door access security systems. Their clients, individual manufacturers of door devices, subscribe to the software and run it on their devices. These client companies want to make Face API calls from their devices to perform Limited Access operations like face identification. By relying on access tokens from the ISV, they can bypass the formal approval process for face identification. The ISV, which has already been approved, can grant the client just-in-time access tokens.
2727

2828
## Expectation of responsibility
2929

30-
The issuing ISV is responsible for ensuring that the tokens are used only for the approved purpose.
30+
The token-issuing ISV is responsible for ensuring that the tokens are used only for the approved purpose.
3131

3232
If the ISV learns that a client is using the LimitedAccessToken for non-approved purposes, the ISV should stop generating tokens for that customer. Microsoft can track the issuance and usage of LimitedAccessTokens, and we reserve the right to revoke an ISV's access to the **issueLimitedAccessToken** API if abuse is not addressed.
3333

@@ -80,7 +80,7 @@ The API should return a `200` response with the token in the form of a JSON web
8080

8181
## Step 3: Client application uses the token
8282

83-
The ISV's application can then pass the LimitedAccessToken as an HTTP request header for future Face API requests on behalf of the client. This works independently of other authentication mechanisms, so no personal information of the client's is ever leaked to the ISV.
83+
The ISV's application can then pass the limited access token as an HTTP request header for future Face API requests on behalf of the client. This works independently of other authentication mechanisms, so no personal information of the client's is ever leaked to the ISV.
8484

8585
> [!CAUTION]
8686
> The client doesn't need to be aware of the token value, as it can be passed in the background. If the client were to use a web monitoring tool to intercept the traffic, they'd be able to view the LimitedAccessToken header. However, because the token expires after a short period of time, they are limited in what they can do with it. This risk is known and considered acceptable.

articles/ai-services/content-safety/concepts/response-codes.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: azure-ai-content-safety
99
ms.custom: build-2023
1010
ms.topic: conceptual
11-
ms.date: 05/09/2023
11+
ms.date: 03/07/2024
1212
ms.author: pafarley
1313
---
1414

@@ -18,9 +18,9 @@ The content APIs may return the following error codes:
1818

1919
| Error Code | Possible reasons | Suggestions |
2020
| ---------- | ------- | -------------------- |
21-
| InvalidRequestBody | One or more fields in the request body do not match the API definition. | 1. Check the API version you specified in the API call. <br/>2. Check the corresponding API definition for the API version you selected. |
22-
| InvalidResourceName | The resource name you specified in the URL does not meet the requirements, like the blocklist name, blocklist term ID, etc. | 1. Check the API version you specified in the API call. <br/>2. Check whether the given name has invalid characters according to the API definition. |
23-
| ResourceNotFound | The resource you specified in the URL may not exist, like the blocklist name. | 1. Check the API version you specified in the API call. <br/> 2. Double check the existence of the resource specified in the URL. |
24-
| InternalError | Some unexpected situations on the server side have been triggered. | 1. You may want to retry a few times after a small period and see it the issue happens again. <br/> 2. Contact Azure Support if this issue persists. |
25-
| ServerBusy | The server side cannot process the request temporarily. | 1. You may want to retry a few times after a small period and see it the issue happens again. <br/>2.Contact Azure Support if this issue persists. |
26-
| TooManyRequests | The current RPS has exceeded the quota for your current SKU. | 1. Check the pricing table to understand the RPS quota. <br/>2.Contact Azure Support if you need more QPS. |
21+
| InvalidRequestBody | One or more fields in the request body do not match the API definition. | Check the API version you specified in the API call. <br/>Check the corresponding API definition for the API version you selected. |
22+
| InvalidResourceName | The resource name you specified in the URL does not meet the requirements, like the blocklist name, blocklist term ID, etc. | Check the API version you specified in the API call. <br/>Check whether the given name has invalid characters according to the API definition. |
23+
| ResourceNotFound | The resource you specified in the URL may not exist, like the blocklist name. | Check the API version you specified in the API call. <br/>Double check the existence of the resource specified in the URL. |
24+
| InternalError | Some unexpected situations on the server side have been triggered. | You may want to retry a few times after a small period and see it the issue happens again. <br/> Contact Azure Support if this issue persists. |
25+
| ServerBusy | The server side cannot process the request temporarily. | You may want to retry a few times after a small period and see it the issue happens again. <br/>Contact Azure Support if this issue persists. |
26+
| TooManyRequests | The current RPS has exceeded the quota for your current SKU. | Check the pricing table to understand the RPS quota. <br/>Contact Azure Support if you need more QPS. |

articles/ai-services/content-safety/how-to/use-blocklist.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The default AI classifiers are sufficient for most content moderation needs. How
2323
## Prerequisites
2424

2525
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
26-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, and select a resource group, supported region, and supported pricing tier. Then select **Create**.
26+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2727
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2828
* One of the following installed:
2929
* [cURL](https://curl.haxx.se/) for REST API calls.

articles/ai-services/content-safety/includes/quickstarts/csharp-quickstart-image.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ manager: nitinme
77
ms.service: azure-ai-content-safety
88
ms.custom:
99
ms.topic: include
10-
ms.date: 07/04/2023
10+
ms.date: 03/07/2024
1111
ms.author: pafarley
1212
---
1313

@@ -18,7 +18,7 @@ ms.author: pafarley
1818
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
1919
* The [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) with workload .NET desktop development enabled. Or if you don't plan on using Visual Studio IDE, you need the current version of [.NET Core](https://dotnet.microsoft.com/download/dotnet-core).
2020
* [.NET Runtime](https://dotnet.microsoft.com/download/dotnet/) installed.
21-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, select a resource group, supported region, and supported pricing tier. Then select **Create**.
21+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2222
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2323

2424
## Set up application

articles/ai-services/content-safety/includes/quickstarts/csharp-quickstart-text.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.author: pafarley
1717

1818
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
1919
* The [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) with workload .NET desktop development enabled. Or if you don't plan on using Visual Studio IDE, you need the current version of [.NET Core](https://dotnet.microsoft.com/download/dotnet-core).
20-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, select a resource group, supported region, and supported pricing tier. Then select **Create**.
20+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2121
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2222

2323
## Set up application

articles/ai-services/content-safety/includes/quickstarts/java-quickstart-image.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ manager: nitinme
77
ms.service: azure-ai-content-safety
88
ms.custom:
99
ms.topic: include
10-
ms.date: 10/10/2023
10+
ms.date: 03/07/2024
1111
ms.author: pafarley
1212
---
1313

@@ -19,7 +19,7 @@ ms.author: pafarley
1919
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
2020
* The current version of the [Java Development Kit (JDK)](https://www.microsoft.com/openjdk)
2121
* The [Gradle build tool](https://gradle.org/install/), or another dependency manager.
22-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, select a resource group, supported region, and supported pricing tier. Then select **Create**.
22+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2323
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2424

2525
## Set up application

articles/ai-services/content-safety/includes/quickstarts/java-quickstart-text.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ ms.author: pafarley
2020
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
2121
* The current version of the [Java Development Kit (JDK)](https://www.microsoft.com/openjdk)
2222
* The [Gradle build tool](https://gradle.org/install/), or another dependency manager.
23-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, select a resource group, supported region, and supported pricing tier. Then select **Create**.
23+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2424
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2525

2626
## Set up application

articles/ai-services/content-safety/includes/quickstarts/javascript-quickstart-image.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ manager: nitinme
77
ms.service: azure-ai-content-safety
88
ms.custom:
99
ms.topic: include
10-
ms.date: 10/10/2023
10+
ms.date: 03/07/2024
1111
ms.author: pafarley
1212
---
1313

@@ -18,7 +18,7 @@ ms.author: pafarley
1818

1919
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
2020
* The current version of [Node.js](https://nodejs.org/)
21-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, select a resource group, supported region, and supported pricing tier. Then select **Create**.
21+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2222
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2323

2424
## Set up application

articles/ai-services/content-safety/includes/quickstarts/javascript-quickstart-text.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.author: pafarley
1818

1919
* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/)
2020
* The current version of [Node.js](https://nodejs.org/)
21-
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select the subscription you entered on the application form, select a resource group, supported region, and supported pricing tier. Then select **Create**.
21+
* Once you have your Azure subscription, <a href="https://aka.ms/acs-create" title="Create a Content Safety resource" target="_blank">create a Content Safety resource </a> in the Azure portal to get your key and endpoint. Enter a unique name for your resource, select your subscription, and select a resource group, supported region (East US or West Europe), and supported pricing tier. Then select **Create**.
2222
* The resource takes a few minutes to deploy. After it finishes, Select **go to resource**. In the left pane, under **Resource Management**, select **Subscription Key and Endpoint**. The endpoint and either of the keys are used to call APIs.
2323

2424
## Set up application

0 commit comments

Comments
 (0)