Skip to content

Commit e4c2786

Browse files
committed
updates per feedback from AI Services writers
1 parent 7e107a2 commit e4c2786

File tree

1 file changed

+11
-32
lines changed

1 file changed

+11
-32
lines changed

articles/ai-services/includes/quickstarts/management-azportal.md

Lines changed: 11 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -17,36 +17,23 @@ author: eric-urban
1717

1818
* A valid Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/).
1919

20-
## Create a first resource
20+
## Create a new Azure AI Foundry resource
2121

2222
AI Foundry portal provides a way to create a new Azure resource with basic, defaulted, settings. If your organization requires customized Azure configurations like alternative names, security controls or cost tags, you may have to use Azure Portal or [template options](../../../ai-foundry/how-to/create-resource-template.md) to comply with your organization's Azure Policy compliance.
2323

24-
# [Azure AI Foundry portal](#tab/ai-foundry)
24+
The Azure AI Foundry multi-service resource is listed under **AI Foundry** > **AI Foundry** in the portal. The API kind is **AIServices**. Look for the logo as shown here:
2525

26-
* Access [AI Foundry Portal](https://ai.azure.com) to get started and sign in using your organization account.
26+
:::image type="content" source="../../media/ai-services-resource-portal.png" alt-text="Screenshot of the Azure AI Foundry resource in the Azure portal." lightbox="../../media/ai-services-resource-portal.png":::
2727

28-
Do you see existing projects or Foundry resources listed? Then, you may not have to create a new resource. You may pick an existing project, or create a new project under an existing resource your IT admin may have pre-configured.
28+
> [!IMPORTANT]
29+
> Azure provides more than one resource kinds named Azure AI services. Be sure to select the one that is listed under **AI Foundry** > **AI Foundry** with the logo as shown previously.
2930
30-
* If you are sure you want to create a new resource, there are multiple entry points to create new resources:
31-
32-
1. Home page
33-
1. All resources
34-
1. Management center -> All resources
31+
To create an AI Foundry resource follow these instructions:
3532

36-
Click 'create new' or 'create project' to get started. If this is the first project you create, we automatically create a parent Azure resource for you.
33+
> [!TIP]
34+
> If you need to createn an [!INCLUDE [fdp](../includes/fdp-project-name.md)] resource, you can also use the [Azure Foundry portal](https://ai.azure.com) to create the resource. For more information, see [Create a project for Azure AI Foundry](/azure/ai-foundry/how-to/create-projects?tabs=ai-foundry&pivots=fdp-project).
3735
38-
# [Azure Portal](#tab/azure-portal)
39-
40-
* In Azure Portal or Azure marketplace, search for 'AI Foundry'.
41-
42-
The Azure AI Foundry resource is listed under **AI Foundry** > **AI Foundry** in the portal. The API kind is **AIServices**. Look for the logo as shown here:
43-
44-
:::image type="content" source="../../media/ai-services-resource-portal.png" alt-text="Screenshot of the Azure AI Foundry resource in the Azure portal." lightbox="../../media/ai-services-resource-portal.png":::
45-
46-
> [!IMPORTANT]
47-
> Azure provides more than one resource kinds named Azure AI services. Be sure to select the one that is listed under **AI Foundry** > **AI Foundry** with the logo as shown previously.
48-
49-
* Click `create new` or follow this link to create an **AI Foundry** resource: [https://portal.azure.com/#create/Microsoft.CognitiveServicesAIServices](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIServices)
36+
1. Select this link to create an **AI Foundry** resource: [https://portal.azure.com/#create/Microsoft.CognitiveServicesAIServices](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIServices)
5037

5138
1. On the **Create** page, provide the following information:
5239

@@ -56,19 +43,11 @@ AI Foundry portal provides a way to create a new Azure resource with basic, def
5643
| **Resource group** | The Azure resource group that will contain your Azure AI Foundry resource. You can create a new group or add it to a pre-existing group. |
5744
| **Region** | The location of your Azure AI service instance. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
5845
| **Name** | A descriptive name for your Azure AI Foundry resource. For example, *MyAIServicesResource*. |
59-
| **First project name** | The name for your first 'default' project. Projects are folders to organize your work. The default project has backwards compatibility with developer APIs that previously lived on a resource level for selected AI Services. |
6046

6147
1. Configure other settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
6248

63-
---
64-
65-
## Common issues
66-
67-
* If your subscription doesn't allow you to create an AI Foundry resource, you might need to enable the privilege of that [Azure resource provider](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider) using the [Azure portal](/azure/azure-resource-manager/management/resource-providers-and-types#azure-portal), [PowerShell command](/azure/azure-resource-manager/management/resource-providers-and-types#azure-powershell) or an [Azure CLI command](/azure/azure-resource-manager/management/resource-providers-and-types#azure-cli). If you are not the subscription owner, ask someone with the role of *Owner* or *Admin* to complete the registration for you or ask for the **/register/action** privileges to be granted to your account.
68-
69-
* If you are unable to create resources due to Azure RBAC permissions, you may need to ask someone with the *Owner*, *Contributor* or *Azure AI Administrator* role to create it for you. Alternative, use an existing resource your admin may have pre-configured for you to create a new project. Creating projects requires less Azure permissions.
70-
71-
* Quota limit exceeded. See [resource limits](../../../ai-foundry/model-inference/quotas-limits.md) for possible causes including the maximum number of instances per subscription and region.
49+
> [!TIP]
50+
> If your subscription doesn't allow you to create an AI Foundry resource, you might need to enable the privilege of that [Azure resource provider](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider) using the [Azure portal](/azure/azure-resource-manager/management/resource-providers-and-types#azure-portal), [PowerShell command](/azure/azure-resource-manager/management/resource-providers-and-types#azure-powershell) or an [Azure CLI command](/azure/azure-resource-manager/management/resource-providers-and-types#azure-cli). If you are not the subscription owner, ask someone with the role of *Owner* or *Admin* to complete the registration for you or ask for the **/register/action** privileges to be granted to your account.
7251
7352
## Clean up resources
7453

0 commit comments

Comments
 (0)