View Diff on GitHub
# Highlights
この更新は、Azureサービスポータルおよびコグニティブ検索に関連するドキュメントに複数の修正を加えています。最も注目すべき点は、新しい画像やアイコンの追加、新しいビジュアル要素の削除、そしてメタデータの更新です。
New features
- 認証オプションやAzure AI Searchタイル、リソースグループ作成などに関する新しい画像の追加。
- ポータル通知やリクエスト調整用の新しいアイコンが追加されました。
- 使用状況フィルターアイコンが新規追加され、ユーザビリティを強化しました。
Breaking changes
- 検索サービスやエンドポイント取得に関する画像が削除されました。
- 通知モニタリングや新しいサービスに関連した画像が削除されました。
- 認証オプション設定やスケール設定のアイコンが削除されました。
Other updates
- 文書のトピック分類が「reference」から「concept-article」へと変更されました。
- 目次ファイルで、新しい項目名が追加され、AI Searchに特化した内容として明確化されました。
- 一部の画像ファイルの修正による表示改善が行われました。
Insights
この更新は、Azureサービスポータルのユーザビリティと、コグニティブ検索に関する文書の最新化を目的としています。新しいビジュアル要素の追加により、ユーザー体験がより直感的かつ認識しやすくなり、特にAzureサービスの新機能や設定手順を視覚的に理解しやすくすることを目的としています。
削除された画像やアイコンについては、これまでの機能や操作が廃止されたか、別の選択肢に刷新された可能性が高いです。そのため、ユーザーは新しい手順や方法に適応する必要があります。
その他、文書メタデータの更新により、情報の一貫性が保たれ、これからの利用者が内容の整合性を確認しやすくなります。このような継続的な改善は、Azureポータルの成長と相まって、ユーザーに最新のサービスやガイドラインを提示するための重要な一環であると言えるでしょう。全体的に、このドキュメント更新はユーザー経験の向上に寄与し、操作性を高めるための重要なステップとなっています。
Summary Table
Modified Contents
articles/search/cognitive-search-common-errors-warnings.md
Diff
@@ -9,8 +9,8 @@ ms.author: heidist
ms.service: azure-ai-search
ms.custom:
- ignite-2023
-ms.topic: reference
-ms.date: 09/19/2024
+ms.topic: concept-article
+ms.date: 02/19/2025
---
# Troubleshooting common indexer errors and warnings in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "コグニティブ検索の一般的なエラーと警告に関する記事の更新"
}
Explanation
このコードの差分は、コグニティブ検索に関する一般的なエラーと警告についてのドキュメントを更新したことを示しています。具体的には、以下の2つのフィールドが修正されました。
ms.topic
の値が「reference」から「concept-article」に変更されました。これにより、記事のトピックタイプが変更され、より概念的な内容を反映したものになりました。
ms.date
の値が「09/19/2024」から「02/19/2025」に更新されました。この変更は、記事の最終更新日を最新の情報に合わせることを目的としています。
これらの変更は、ユーザーが指導内容をより理解しやすくするために行われたものであり、文書の整合性と最新性を保つための重要な修正です。
articles/search/media/search-create-service-portal/authentication-options.png
Summary
{
"modification_type": "new feature",
"modification_title": "認証オプションに関する画像の追加"
}
Explanation
このコードの差分は、認証オプションに関する新しい画像ファイルをドキュメントに追加したことを示しています。具体的には、ファイル名はauthentication-options.png
であり、記事の内容を視覚的に補完する目的で追加されました。
この変更に伴う具体的な加算や削除はなく、新たに画像が含まれることで、ユーザーが認証オプションについての理解を深めやすくなる効果があります。この画像は、関連する情報をより明確に伝えるために役立つと考えられます。
articles/search/media/search-create-service-portal/azure-ai-search-tile.png
Summary
{
"modification_type": "new feature",
"modification_title": "Azure AI Search タイルに関する画像の追加"
}
Explanation
このコードの差分は、Azure AI Searchタイルに関する新しい画像ファイルをドキュメントに追加したことを示しています。ファイル名はazure-ai-search-tile.png
であり、この画像はサービスポータルの関連情報を視覚的に補完するために追加されました。
具体的には、画像ファイルの追加に伴う加算や削除はなく、単純に新しいビジュアルコンテンツが情報として注入される形になります。この画像は、ユーザーがAzure AI Searchの機能や使い方を理解する助けとなり、ドキュメントの全体的な質を向上させることを意図しています。
articles/search/media/search-create-service-portal/create-resource-group.png
Summary
{
"modification_type": "new feature",
"modification_title": "リソースグループ作成に関する画像の追加"
}
Explanation
このコードの差分は、リソースグループの作成に関する新しい画像ファイルをドキュメントに追加したことを示しています。ファイル名はcreate-resource-group.png
であり、この画像は、ユーザーがAzureプラットフォーム上でリソースグループを作成する手順を視覚的に示すために用意されました。
特に、この変更には加算や削除は伴っておらず、新規画像の追加のみが行われています。このビジュアルコンテンツは、利用者にとって操作手順を理解しやすくする役割を果たし、最終的にはドキュメント全体の有用性を高めることを目的としています。
articles/search/media/search-create-service-portal/create-resource.png
Summary
{
"modification_type": "new feature",
"modification_title": "リソース作成に関する画像の追加"
}
Explanation
このコードの差分は、リソース作成に関する新しい画像ファイルをドキュメントに追加したことを示しています。ファイル名はcreate-resource.png
であり、この画像はAzureのサービスポータルでリソースを作成する際の手順やインターフェースを視覚的に表現することを目的としています。
変更には加算や削除は伴わず、新たに画像が追加されただけです。このビジュアルコンテンツは、ユーザーがリソース作成のプロセスを理解しやすくするためのものであり、ドキュメントの全体的な使い勝手を向上させる役割を果たします。
articles/search/media/search-create-service-portal/create-search-service.png
Summary
{
"modification_type": "new feature",
"modification_title": "検索サービス作成に関する画像の追加"
}
Explanation
このコードの差分は、検索サービスを作成するプロセスに関する新しい画像ファイルをドキュメントに追加したことを示しています。ファイル名はcreate-search-service.png
であり、この画像はAzureサービスポータルにおける検索サービスの作成手順を視覚的に示すことを目的としています。
変更は、加算や削除がなく、新たに画像が追加されたのみです。このビジュアル資料は、ユーザーが検索サービスの作成を理解しやすくするために役立ち、ドキュメント全体の情報価値を高めることに寄与します。
articles/search/media/search-create-service-portal/find-search3.png
Summary
{
"modification_type": "breaking change",
"modification_title": "検索サービスに関する画像の削除"
}
Explanation
このコードの差分は、検索サービスに関連する画像ファイルfind-search3.png
がドキュメントから削除されたことを示しています。削除された画像は、Azureサービスポータルの使用方法を説明するためのビジュアルコンテンツの一部であった可能性があります。
変更は、加算や削除が行われたことにより、関連する情報が失われるため、ユーザーの理解に影響を与える可能性があります。この削除は、ドキュメントの内容を更新したり、より適切な情報に置き換えたりする過程の一部である可能性がありますが、それによって情報の流れが断絶されることにもつながります。
articles/search/media/search-create-service-portal/get-endpoint.png
Summary
{
"modification_type": "breaking change",
"modification_title": "エンドポイント取得に関する画像の削除"
}
Explanation
このコードの差分は、エンドポイントを取得するプロセスに関連する画像ファイルget-endpoint.png
がドキュメントから削除されたことを示しています。この画像は、Azureサービスポータルでの操作手順を視覚的に説明するために用いられていたと考えられます。
画像の削除は、ユーザーにとっての情報源が減少し、その結果、操作手順の理解が難しくなる可能性があります。この変更は、ドキュメントの整合性や内容の最新性を保つための一環かもしれませんが、削除された情報が重要であった場合、利用者に不便をもたらすかもしれません。
articles/search/media/search-create-service-portal/monitor-notifications.png
Summary
{
"modification_type": "breaking change",
"modification_title": "通知モニタリングに関する画像の削除"
}
Explanation
このコードの差分は、通知をモニタリングするための画像ファイルmonitor-notifications.png
がドキュメントから削除されたことを示しています。この画像は、Azureサービスポータルにおける通知の設定や確認の手順を視覚化するために利用されていたと考えられます。
画像の削除は、該当する機能や操作に関する説明が不十分になる可能性があり、ユーザーの理解や操作を困難にすることがあります。この変更は、ドキュメントの最新化や改善の一環であるかもしれませんが、重要なビジュアルコンテンツの欠如は、利用者にとって不便をもたらすかもしれません。
articles/search/media/search-create-service-portal/new-resource-group.png
Summary
{
"modification_type": "breaking change",
"modification_title": "新しいリソースグループに関する画像の削除"
}
Explanation
このコードの差分は、新しいリソースグループを作成する際に関連する画像ファイルnew-resource-group.png
がドキュメントから削除されたことを示しています。この画像は、Azureサービスポータルでのリソースグループ作成手順を視覚的に説明するために使用されていた可能性があります。
画像の削除により、該当の手順を示すためのビジュアルリソースが失われ、ユーザーが操作手順を正確に理解するのが難しくなる可能性があります。この変更はドキュメントの整理や最新化の一環として行われたものであるかもしれませんが、重要な情報が失われることは、利用者にとって不便さを引き起こすことが考えられます。
articles/search/media/search-create-service-portal/new-service3.png
Summary
{
"modification_type": "breaking change",
"modification_title": "新しいサービスに関する画像の削除"
}
Explanation
このコードの差分は、新しいサービスに関連する画像ファイルnew-service3.png
がドキュメントから削除されたことを示しています。この画像は、Azureサービスポータルでの新しいサービスの作成過程やその手順を説明するための視覚的な補助として使用されていた可能性があります。
画像の削除は、関連する機能や操作に関する情報が視覚的に伝えられなくなるため、ユーザーの理解を妨げたり、手順の実行が難しくなったりする可能性があります。この変更は、ドキュメントの整理や更新の一環であるかもしれませんが、視覚情報の欠如により、利用者が正確に手順を理解する上で不便を引き起こす懸念があります。
articles/search/media/search-create-service-portal/portal-notifications.png
Summary
{
"modification_type": "new feature",
"modification_title": "ポータル通知に関する画像の追加"
}
Explanation
このコードの差分は、ポータル通知に関連する画像ファイルportal-notifications.png
がドキュメントに新たに追加されたことを示しています。この画像は、ユーザーがAzureサービスポータル内での通知の動作や利用方法を理解するのに役立つビジュアルリソースです。
新しい画像が追加されることで、ユーザーは通知に関する情報を視覚的に把握しやすくなり、操作手順がより明確になります。これにより、ドキュメントのユーザビリティが向上し、利用者がポータル内の通知機能を適切に活用できるようになることが期待されます。この変更は、ドキュメントの内容を充実させるための重要な改善と考えられます。
articles/search/media/search-create-service-portal/quota-search.png
Summary
{
"modification_type": "minor update",
"modification_title": "クォータ検索に関する画像の修正"
}
Explanation
このコードの差分は、クォータ検索に関連する画像ファイルquota-search.png
が修正されたことを示しています。修正内容の具体的な詳細は示されていませんが、一般的には画像の内容や表示方法が改善された可能性があります。
画像の更新は、ユーザーがAzureサービスポータルにおけるクォータ機能をより理解しやすくするために重要です。最新の情報やインターフェースに合わせたビジュアル素材が提供されることにより、ユーザーの操作体験が向上し、クォータに関する手続きを円滑に実施できるようになります。この変更は、ドキュメント全体の整合性や質を向上させるための良いステップといえます。
articles/search/media/search-create-service-portal/request-adjustment-icon.png
Summary
{
"modification_type": "new feature",
"modification_title": "リクエスト調整アイコンの追加"
}
Explanation
このコードの差分は、リクエスト調整に関連するアイコン画像ファイルrequest-adjustment-icon.png
が新たに追加されたことを示しています。このアイコンは、ユーザーがAzureサービスポータル内でリクエストの調整機能を視覚的に理解するのに役立つ重要なビジュアル要素です。
新しいアイコンの追加は、ドキュメントやインターフェースのユーザビリティを向上させるための一環として重要です。ユーザーが調整リクエストの機能を迅速に認識し、利用できるようになることで、操作の効率性が高まります。この変更は、システム全体の使い勝手を改善し、ユーザーにとっての操作の明確さを強化するための重要なステップです。
articles/search/media/search-create-service-portal/scale-settings.png
Summary
{
"modification_type": "new feature",
"modification_title": "スケール設定のアイコン追加"
}
Explanation
このコードの差分は、スケール設定に関連するアイコン画像ファイルscale-settings.png
が新しく追加されたことを示しています。このアイコンは、ユーザーがAzureサービスポータルにおけるスケーリング機能を理解しやすくするために役立ちます。
新たに追加された画像は、ユーザーインターフェースをより直感的にし、機能の利用を促進します。スケーリングの設定が視覚的に示されることで、ユーザーは作業を進めやすくなり、効率的にリソースを管理できるようになります。この変更は、全体的なユーザーエクスペリエンスの向上を目指しており、Azureサービスの利用を容易にする重要な改善といえます。
articles/search/media/search-create-service-portal/select-pricing-tier.png
Summary
{
"modification_type": "minor update",
"modification_title": "料金プラン選択アイコンの修正"
}
Explanation
このコードの差分は、料金プランを選択するためのアイコン画像ファイルselect-pricing-tier.png
が修正されたことを示しています。この変更は、アイコンのデザインや表示に関する小さな更新であり、ユーザーが料金プランを視覚的に理解するのに役立ちます。
アイコンの修正は、ユーザーインターフェースの一貫性や視認性を向上させることを目的としており、ユーザーが適切なプランを選択する際の導線を明確にします。この変更は、ユーザーエクスペリエンスの向上に寄与し、Azureサービスポータルでの操作をよりスムーズにするための重要なステップです。
articles/search/media/search-create-service-portal/set-authentication-options.png
Summary
{
"modification_type": "breaking change",
"modification_title": "認証オプション設定アイコンの削除"
}
Explanation
このコードの差分は、認証オプションを設定するためのアイコン画像ファイルset-authentication-options.png
が削除されたことを示しています。この変更は、関連する機能やコンテンツの改訂に伴って行われた可能性があります。
アイコンの削除は、ユーザーインターフェースにおける重要な変更を反映しており、ユーザーに提供される情報が簡素化されることを意味します。この変更によって、従来の認証オプション設定が廃止されるか、または再設計された可能性があり、ユーザーが新しい方法で認証オプションを設定することを促しています。
このような変更は、ユーザーにとっては慣れ親しんだ機能のアクセスが制限される場合があるため、注意が必要です。新しい認証方法や設定方法についての明確なガイダンスが求められるでしょう。
articles/search/media/search-create-service-portal/settings-scale.png
Summary
{
"modification_type": "breaking change",
"modification_title": "スケール設定アイコンの削除"
}
Explanation
このコードの差分は、スケール設定を示すアイコン画像ファイルsettings-scale.png
が削除されたことを示しています。この変更は、サービスポータル内での設定や機能に関する重要な改訂を反映している可能性があります。
アイコンの削除は、ユーザーインターフェースにおける機能の変更や廃止を意味しており、ユーザーは新しいスケール設定の方法や代替手段について理解する必要があります。この変更は、従来のスケーリングオプションが無効になるか、別の方法で提供されることを示唆しています。
ユーザーにとって、重要なビジュアル要素の削除は混乱を招く可能性があるため、今後の変更や新しい設定手順についての明確な説明が提供されることが望まれます。特に、スケーラビリティに関して依存しているユーザーにとっては、注意が必要です。
articles/search/media/search-create-service-portal/usage-filter.png
Summary
{
"modification_type": "new feature",
"modification_title": "使用状況フィルターアイコンの追加"
}
Explanation
このコードの差分は、使用状況フィルターを示すアイコン画像ファイルusage-filter.png
が新たに追加されたことを示しています。この追加により、サービスポータル内での使用状況に関するデータのフィルタリング機能が強化されることが予期されます。
新しいアイコンは、ユーザーがフィルタリングオプションを視覚的に認識しやすくするためにデザインされています。これにより、ユーザーは特定の条件やニーズに基づいてデータを簡単に絞り込むことができ、効率的に情報を管理する手助けとなります。
この変更は、全体的なユーザーエクスペリエンスを向上させ、より直感的にフィルタリング機能を利用できるようにすることを目的としているため、ユーザーにとって非常に重要な新機能と言えるでしょう。ユーザーガイドやヘルプセクションを通じて、この新しいアイコンと機能についての詳細な説明が提供されることが期待されます。
articles/search/search-create-service-portal.md
Diff
@@ -4,85 +4,94 @@ titleSuffix: Azure AI Search
description: Learn how to set up an Azure AI Search resource in the Azure portal. Choose resource groups, regions, and a pricing tier.
manager: nitinme
-author: HeidiSteen
-ms.author: heidist
+author: haileytap
+ms.author: haileytapia
ms.service: azure-ai-search
ms.custom:
- references_regions
- build-2024
-ms.topic: conceptual
-ms.date: 01/15/2025
+ms.topic: how-to
+ms.date: 02/20/2025
---
# Create an Azure AI Search service in the Azure portal
-[**Azure AI Search**](search-what-is-azure-search.md) is an information retrieval platform for the enterprise. It supports traditional search and conversational AI-driven search for "chat with your data" experiences over your proprietary content.
+[Azure AI Search](search-what-is-azure-search.md) is an information retrieval platform for the enterprise. It supports traditional search and conversational, AI-driven search for "chat with your data" experiences across your proprietary content.
-The easiest way to create a service is using the [Azure portal](https://portal.azure.com/), which is covered in this article.
+The easiest way to create a search service is through the [Azure portal](https://portal.azure.com/), which is covered in this article.
-You can also use [Azure PowerShell](search-manage-powershell.md#create-or-delete-a-service), [Azure CLI](search-manage-azure-cli.md#create-or-delete-a-service), the [Management REST API](search-manage-rest.md#create-or-update-a-service), an [Azure Resource Manager service template](search-get-started-arm.md), a [Bicep file](search-get-started-bicep.md), or [Terraform](search-get-started-terraform.md).
+[](./media/search-create-service-portal/AnimatedGif-AzureSearch.gif#lightbox)
-[](./media/search-create-service-portal/AnimatedGif-AzureSearch.gif#lightbox)
+You can also use:
-## Before you start
-
-A few service properties are fixed for the lifetime of the service. Before creating the service, decide on a name, region, and tier.
++ [Azure PowerShell](search-manage-powershell.md#create-or-delete-a-service)
++ [Azure CLI](search-manage-azure-cli.md#create-or-delete-a-service)
++ [Management REST API](search-manage-rest.md#create-or-update-a-service)
++ [Azure Resource Manager template](search-get-started-arm.md)
++ [Bicep](search-get-started-bicep.md)
++ [Terraform](search-get-started-terraform.md)
-+ [Service name](#name-the-service) becomes part of the URL endpoint. The name must be unique and it must conform to naming rules.
+## Before you start
-+ [Region](search-region-support.md) determines data residency and the availability of certain features. Semantic ranker and Azure AI integration come with region requirements. Make sure your region of choice supports the features you need.
+Some properties are fixed for the lifetime of the search service. Before creating your service, decide on the following properties:
-+ [Service tier](search-sku-tier.md) determines infrastructure, service limits, and billing. Some features aren't available on lower or specialized tiers.
+| Property | Description |
+|--|--|
+| [Name](#name-your-service) | Becomes part of the URL endpoint. The name must be unique and follow naming rules. |
+| [Region](search-region-support.md) | Determines data residency and availability of certain features. For example, semantic ranker and Azure AI integration have region requirements. Choose a region that supports the features you need. |
+| [Tier](search-sku-tier.md) | Determines infrastructure, service limits, and billing. Some features aren't available on lower or specialized tiers. |
-## Subscribe (free or paid)
+## Subscribe to Azure
-Paid (or billable) search occurs when you choose a billable tier (Basic or higher) when creating the resource on a billable Azure subscription.
+Azure AI Search requires a free or pay-as-you-go Azure subscription.
-To try Azure AI Search for free, [open a trial subscription](https://azure.microsoft.com/pricing/free-trial/?WT.mc_id=A261C142F) and then create your search service by choosing the **Free** tier. You can have one free search service per Azure subscription. Free search services are intended for short-term evaluation of the product for nonproduction applications. Generally, you can complete all of the quickstarts and most tutorials, except for those featuring semantic ranker (it requires a billable service). Free services that are inactive for an extended period of time can be deleted by Microsoft to make room for other services.
+To try Azure AI Search for free, [start a trial subscription](https://azure.microsoft.com/pricing/free-trial/?WT.mc_id=A261C142F) and then [create your search service on the Free tier](#choose-a-tier). Each Azure subscription can have one free search service, which is intended for short-term, non-production evaluation of the product. You can complete all of our quickstarts and most of our tutorials on the Free tier. For more information, see [Try Azure AI Search for free](search-try-for-free.md).
-Alternatively, you can use free credits to try out paid Azure services. With this approach, you can create your search service at **Basic** or higher to get more capacity. Your credit card is never charged unless you explicitly change your settings and ask to be charged. Another approach is to [activate Azure credits in a Visual Studio subscription](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details/?WT.mc_id=A261C142F). A Visual Studio subscription gives you credits every month you can use for paid Azure services.
+> [!IMPORTANT]
+> To make room for other services, Microsoft might delete free services that are inactive for an extended period of time.
## Find the Azure AI Search offering
1. Sign in to the [Azure portal](https://portal.azure.com/).
-1. Select (**Create Resource"**) in the top-left corner.
+1. In the upper-left corner of your dashboard, select **Create a resource**.
-1. Use the search bar to find "Azure AI Search*.
+ :::image type="content" source="media/search-create-service-portal/create-resource.png" lightbox="media/search-create-service-portal/create-resource.png" alt-text="Screenshot of the Create a Resource button in the Azure portal." border="true":::
-:::image type="content" source="media/search-create-service-portal/find-search3.png" lightbox="media/search-create-service-portal/find-search3.png" alt-text="Screenshot of the Create Resource page in the Azure portal." border="true":::
+1. Use the search box to find **Azure AI Search**.
+
+ :::image type="content" source="media/search-create-service-portal/azure-ai-search-tile.png" lightbox="media/search-create-service-portal/azure-ai-search-tile.png" alt-text="Screenshot of the Azure AI Search tile in the Azure portal." border="true":::
## Choose a subscription
-If you have more than one subscription, choose one for your search service. If you're implementing [customer-managed encryption](search-security-manage-encryption-keys.md) or if you use other features that depend on managed service identities for [external data access](search-indexer-securing-resources.md), choose the same subscription as the one used for Azure Key Vault or other services for which managed identities are used.
+If you have multiple Azure subscriptions, choose one for your search service.
-## Set a resource group
+If you're implementing [customer-managed encryption](search-security-manage-encryption-keys.md) or using other features that rely on managed service identities for [external data access](search-indexer-securing-resources.md), choose the same subscription you use for Azure Key Vault or other services that use managed identities.
-A resource group is a container that holds related resources for your Azure solution. It's useful for consolidating same-solution resources, monitoring costs, and for checking the creation date of your search service.
+## Set a resource group
-:::image type="content" source="media/search-create-service-portal/new-resource-group.png" lightbox="media/search-create-service-portal/new-resource-group.png" alt-text="Screenshot of the Create Resource Group page in the Azure portal." border="true":::
+A resource group is a container that holds related resources for an Azure solution. Use it to consolidate same-solution resources, monitor costs, and check the creation date of your search service.
-Over time, you can track current and projected costs all-up or you can view charges for individual resources. The following screenshot shows the kind of cost information you can expect to see when you combine multiple resources into one group.
+:::image type="content" source="media/search-create-service-portal/create-resource-group.png" lightbox="media/search-create-service-portal/create-resource-group.png" alt-text="Screenshot of the Create a Resource Group dialog on the Create a Search Service page." border="true":::
-:::image type="content" source="media/search-create-service-portal/resource-group-cost-management.png" lightbox="media/search-create-service-portal/resource-group-cost-management.png" alt-text="Screenshot of the Managing costs page in the Azure portal." border="true":::
+Over time, you can track current and projected costs for individual resources and for the overall resource group. The following screenshot shows the cost information that's available when you combine multiple resources into one group:
-> [!TIP]
-> Resource groups simplify cleanup because deleting a resource group deletes everything within it.
+:::image type="content" source="media/search-create-service-portal/resource-group-cost-management.png" lightbox="media/search-create-service-portal/resource-group-cost-management.png" alt-text="Screenshot of the Cost Management page in the Azure portal." border="true":::
-## Name the service
+## Name your service
-In Instance Details, provide a service name in the **URL** field. The name is part of the endpoint against which API calls are issued: `https://your-service-name.search.windows.net`. For example, if you want the endpoint to be `https://myservice.search.windows.net`, you would enter `myservice`.
+Enter a name for your search service. The name is part of the endpoint against which API calls are issued: `https://your-service-name.search.windows.net`. For example, if you enter `myservice`, the endpoint becomes `https://myservice.search.windows.net`.
-Service name requirements:
+When naming your service, follow these rules:
-+ Unique within the search.windows.net namespace
-+ Between 2-60 characters in length
-+ Consist of lowercase letters, digits, or dashes (`-`)
-+ Don't use dashes in the first two characters or as the last single character
-+ Don't use consecutive dashes anywhere
++ Use a name that's unique within the `search.windows.net` namespace.
++ Use between 2 and 60 characters.
++ Use only lowercase letters, digits, and dashes (-).
++ Don't use dashes as the first two characters or the last character.
++ Don't use consecutive dashes.
> [!TIP]
-> If you have multiple search services, it helps to include the region (or location) in the service name as a naming convention. A name like `mysearchservice-westus` can save you a trip to the properties page when deciding how to combine or attach resources.
+> If you have multiple search services, it's helpful to include the region in the service name. For example, when deciding how to combine or attach resources, the name `myservice-westus` might save you a trip to the Properties page.
## Choose a region
@@ -91,144 +100,149 @@ Service name requirements:
If you use multiple Azure services, putting all of them in the same region minimizes or voids bandwidth charges. There are no charges for data egress among same-region services.
-Generally, choose a region near you, unless the following considerations apply:
+In most cases, choose a region near you, unless any of the following apply:
-+ Your nearest region is [at capacity](search-sku-tier.md#region-availability-by-tier). One advantage to using the Azure portal for resource setup is that it provides only those regions and tiers that are available.
++ Your nearest region is [at capacity](search-sku-tier.md#region-availability-by-tier). The Azure portal has the advantage of hiding unavailable regions and tiers during resource setup.
+ You want to use integrated data chunking and vectorization or built-in skills for AI enrichment. Integrated operations have region requirements.
-+ You want to use Azure Storage for indexer-based indexing or you need to store application data that isn't in an index. Debug session state, enrichment caches, and knowledge stores are Azure AI Search features that have a dependency on Azure Storage. The region you choose for Azure Storage has implications for network security. Specifically, if you're setting up a firewall, you should place the resources in *separate regions*. For more information, see [Outbound connections from Azure AI Search to Azure Storage](search-indexer-securing-resources.md).
++ You want to use Azure Storage for indexer-based indexing, or you want to store application data that isn't in an index. Debug session state, enrichment caches, and knowledge stores are Azure AI Search features that depend on Azure Storage. The region you choose for Azure Storage has implications for network security. If you're setting up a firewall, you should place the resources in separate regions. For more information, see [Outbound connections from Azure AI Search to Azure Storage](search-indexer-securing-resources.md).
### Checklist for choosing a region
-1. Is Azure AI Search available in a nearby region? Check the [supported regions list](search-region-support.md).
+1. Is Azure AI Search available in a nearby region? Check the [list of supported regions](search-region-support.md).
1. Do you have a specific tier in mind? Check [region availability by tier](search-sku-tier.md#region-availability-by-tier).
1. Do you have business continuity and disaster recovery (BCDR) requirements? Create two or more search services in [regional pairs](/azure/reliability/cross-region-replication-azure#azure-paired-regions) within [availability zones](search-reliability.md#availability-zones). For example, if you're operating in North America, you might choose East US and West US, or North Central US and South Central US, for each search service.
1. Do you need [AI enrichment](cognitive-search-concept-intro.md), [integrated data chunking and vectorization](vector-search-integrated-vectorization.md), or [multimodal image search](search-get-started-portal-image-search.md)? Azure AI Search, Azure OpenAI, and Azure AI multiservice must coexist in the same region.
- + Start with [Azure OpenAI regions](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) because it has the most variability. Azure OpenAI provides embedding models and chat models for RAG and integrated vectorization.
+ + Start with [Azure OpenAI regions](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) because they have the most variability. Azure OpenAI provides embedding models and chat models for RAG and integrated vectorization.
- + Check [Azure AI Search regions](search-region-support.md) for a match to your Azure OpenAI region. If you're using OCR, entity recognition, or other skills backed by Azure AI, the **AI Integration** column indicates whether Azure AI multiservice is in the same region as Azure AI Search.
+ + Check [Azure AI Search regions](search-region-support.md#azure-public-regions) for a match to your Azure OpenAI region. If you're using OCR, entity recognition, or other skills backed by Azure AI, the **AI service integration** column indicates whether Azure AI multiservice and Azure AI Search are in the same region.
- + Check [multimodal embedding regions](/azure/ai-services/computer-vision/overview-image-analysis#region-availability) for multimodal APIs and image search. This API is accessed through an Azure AI multiservice account, but it's available in fewer regions than Azure AI multiservice in general.
+ + Check [multimodal embedding regions](/azure/ai-services/computer-vision/overview-image-analysis#region-availability) for multimodal APIs and image search. This API is accessed through an Azure AI multiservice account, but in general, it's available in fewer regions than Azure AI multiservice.
### Regions with the most overlap
-Currently, the following regions offer cross-region among all three services (Azure AI Search, Azure OpenAI, Azure AI Vision multimodal). This list isn't definitive, and there might be more choices beyond the regions listed here depending on the tier. Also, region status can change quickly, so be sure to confirm region choice before installing.
+Currently, the following regions offer cross-regional availability for Azure AI Search, Azure OpenAI, and Azure AI Vision multimodal:
-+ **Americas**: West US, East US
-+ **Europe**: Switzerland North, Sweden Central
++ Americas: West US, East US
++ Europe: Switzerland North, Sweden Central
+
+This list isn't definitive, and depending on your tier, you might have more choices. Region status can also change quickly, so confirm your region choice before creating your search service.
## Choose a tier
-Azure AI Search is offered in [multiple pricing tiers](https://azure.microsoft.com/pricing/details/search/): Free, Basic, Standard, or Storage Optimized. Each tier has its own [capacity and limits](search-limits-quotas-capacity.md). There are also several features that are tier-dependent.
+Azure AI Search is offered in multiple [pricing tiers](https://azure.microsoft.com/pricing/details/search/):
-Review the [tier descriptions](search-sku-tier.md) for computing characteristics, [feature availability](search-sku-tier.md#feature-availability-by-tier), and [region availability](search-sku-tier.md#region-availability-by-tier).
++ Free
++ Basic
++ Standard
++ Storage Optimized
-Basic and Standard are the most common choices for production workloads, but many customers start with the Free service. Among the billable tiers, key differences are partition size and speed, and limits on the number of objects you can create.
+Each tier has its own [capacity and limits](search-limits-quotas-capacity.md), and some features are tier dependent. For information about computing characteristics, feature availability, and region availability, see [Choose a service tier for Azure AI Search](search-sku-tier.md).
-:::image type="content" source="media/search-create-service-portal/select-pricing-tier.png" lightbox="media/search-create-service-portal/select-pricing-tier.png" alt-text="Screenshot of Select a pricing tier page." border="true":::
+The Basic and Standard tiers are the most common for production workloads, but many customers start with the Free tier. The billable tiers differ primarily in partition size, partition speed, and limits on the number of objects you can create.
-Search services created after April 3, 2024 have larger partitions and higher vector quotas at every billable tier.
+:::image type="content" source="media/search-create-service-portal/select-pricing-tier.png" lightbox="media/search-create-service-portal/select-pricing-tier.png" alt-text="Screenshot of the Select Pricing Tier page in the Azure portal." border="true":::
-Remember, a pricing tier can't be changed once the service is created. If you need a higher or lower tier, you should re-create the service.
+> [!NOTE]
+> + You can't change the tier after creating your search service, so choose carefully.
+> + Search services created after April 3, 2024 have larger partitions and higher vector quotas at every billable tier.
## Create your service
-After you've provided the necessary inputs, go ahead and create the service.
+After providing the necessary inputs, create your search service.
-:::image type="content" source="media/search-create-service-portal/new-service3.png" lightbox="media/search-create-service-portal/new-service3.png" alt-text="Screenshot of the Review and create the service page." border="true":::
+:::image type="content" source="media/search-create-service-portal/create-search-service.png" lightbox="media/search-create-service-portal/create-search-service.png" alt-text="Screenshot of the Review and Create button on the Create a Search Service page." border="true":::
-Your service is deployed within minutes. You can monitor progress through Azure notifications. Consider pinning the service to your dashboard for easy access in the future.
+Your service is deployed within minutes, and you can monitor its progress with Azure notifications. Consider pinning the service to your dashboard for easy access in the future.
-:::image type="content" source="media/search-create-service-portal/monitor-notifications.png" lightbox="media/search-create-service-portal/monitor-notifications.png" alt-text="Screenshot of the Monitor and pin the service page." border="true":::
+:::image type="content" source="media/search-create-service-portal/portal-notifications.png" lightbox="media/search-create-service-portal/portal-notifications.png" alt-text="Screenshot of the Notifications tab in the Azure portal." border="true":::
## Configure authentication
-Unless you're using the Azure portal, programmatic access to your new service requires that you provide the URL endpoint and an authenticated connection. You can use either or both of these options:
+When you create a search service, key-based authentication is the default, but it's not the most secure option. We recommend that you replace it with role-based access.
-+ [Connect using key-based authentication](search-security-api-keys.md)
-+ [Connect using Azure roles](search-security-rbac.md)
+To enable role-based access for your service:
-1. When setting up a programmatic connection, you need the search service endpoint. On the **Overview** page, locate and copy the URL endpoint on the right side of the page.
+1. Go to your search service in the [Azure portal](https://portal.azure.com/).
- :::image type="content" source="media/search-create-service-portal/get-endpoint.png" lightbox="media/search-create-service-portal/get-endpoint.png" alt-text="Screenshot of the service Overview page with URL endpoint." border="true":::
+1. From the left pane, select **Settings** > **Keys**. You can connect to your service using [API keys](search-security-api-keys.md), [Azure roles](search-security-rbac.md), or both. Select **Both** until you assign roles, after which you can select **Role-based access control**.
-1. To set authentication options, use the **Keys** page. Most quickstarts and tutorials use API keys for simplicity, but if you're setting up a service for production workloads, consider using Azure roles. You can copy keys from this page.
+ :::image type="content" source="media/search-create-service-portal/authentication-options.png" lightbox="media/search-create-service-portal/authentication-options.png" alt-text="Screenshot of the Keys tab with authentication options." border="true":::
- :::image type="content" source="media/search-create-service-portal/set-authentication-options.png" lightbox="media/search-create-service-portal/set-authentication-options.png" alt-text="Screenshot of the Keys page with authentication options." border="true":::
+## Scale your service
-An endpoint and key aren't needed for portal-based tasks. The Azure portal is already linked to your Azure AI Search resource with admin rights. For a portal walkthrough, start with [Quickstart: Create an Azure AI Search index in the Azure portal](search-get-started-portal.md).
+After deploying your search service, you can [scale it to meet your needs](search-limits-quotas-capacity.md). Azure AI Search offers two scaling dimensions: *replicas* and *partitions*. Replicas allow your service to handle a higher load of search queries, while partitions allow your service to store and search through more documents.
-## Scale your service
+Scaling is available only on billable tiers. On the Free tier, you can't scale your service or configure replicas and partitions.
-After a search service is provisioned, you can [scale it to meet your needs](search-limits-quotas-capacity.md). On a billable tier, you can scale the service in two dimensions: replicas and partitions. For the free service, scale up isn't available and replica and partition configuration isn't offered.
+> [!IMPORTANT]
+> Your service must have [two replicas for read-only SLA and three replicas for read/write SLA](https://azure.microsoft.com/support/legal/sla/search/v1_0/).
-***Partitions*** allow your service to store and search through more documents.
+Adding resources will increase your monthly bill. Use the [pricing calculator](https://azure.microsoft.com/pricing/calculator/) to understand the billing implications. You can adjust resources based on load, such as increasing resources for initial indexing and decreasing them later for incremental indexing.
-***Replicas*** allow your service to handle a higher load of search queries.
+To scale your service:
-Adding resources increases your monthly bill. The [pricing calculator](https://azure.microsoft.com/pricing/calculator/) can help you understand the billing ramifications of adding resources. Remember that you can adjust resources based on load. For example, you might increase resources to create a full initial index, and then reduce resources later to a level more appropriate for incremental indexing.
+1. Go to your search service in the [Azure portal](https://portal.azure.com/).
-> [!IMPORTANT]
-> A service must have [2 replicas for read-only SLA and 3 replicas for read/write SLA](https://azure.microsoft.com/support/legal/sla/search/v1_0/).
+1. From the left pane, select **Settings** > **Scale**.
-1. Go to your search service page in the Azure portal.
-1. In the left-navigation pane, select **Settings** > **Scale**.
-1. Use the slidebar to add resources of either type.
+ :::image type="content" source="media/search-create-service-portal/scale-settings.png" lightbox="media/search-create-service-portal/scale-settings.png" alt-text="Screenshot of the Scale tab with sliders for adding replicas and partitions." border="true":::
-:::image type="content" source="media/search-create-service-portal/settings-scale.png" lightbox="media/search-create-service-portal/settings-scale.png" alt-text="Screenshot of the scale page." border="true":::
+1. Use the sliders to add replicas and partitions.
## When to add a second service
-Most customers use just one service provisioned at a tier [sufficient for expected load](search-capacity-planning.md). One service can host multiple indexes, subject to the [maximum limits of the tier you select](search-limits-quotas-capacity.md#index-limits), with each index isolated from another. In Azure AI Search, requests can only be directed to one index, minimizing the chance of accidental or intentional data retrieval from other indexes in the same service.
+Most customers use a single search service at a tier [sufficient for the expected load](search-capacity-planning.md). One service can host multiple indexes, each isolated from the others, within the [maximum limits of your chosen tier](search-limits-quotas-capacity.md#index-limits). In Azure AI Search, you can direct requests to only one index, reducing the chance of retrieving data from other indexes in the same service.
-Although most customers use just one service, service redundancy might be necessary if operational requirements include the following:
+However, you might need a second service for the following operational requirements:
-+ [Business continuity and disaster recovery (BCDR)](/azure/reliability/cross-region-replication-azure). Azure AI Search doesn't provide instant failover if there's an outage.
++ [Business continuity and disaster recovery (BCDR)](/azure/reliability/cross-region-replication-azure). If there's an outage, Azure AI Search won't provide instant failover.
++ [Multitenant architectures](search-modeling-multitenant-saas-applications.md) that require two or more services.
++ Globally deployed applications that require services in each geography to minimize latency.
-+ [Multitenant architectures](search-modeling-multitenant-saas-applications.md) sometimes call for two or more services.
+> [!NOTE]
+> In Azure AI Search, you can't separate indexing and querying operations, so don't create multiple services for separate workloads. An index is always queried on the service in which it was created, and you can't copy an index to another service.
-+ Globally deployed applications might require search services in each geography to minimize latency.
+A second service isn't required for high availability. You achieve high availability for queries by using two or more replicas in the same service. Because the replicas are updated sequentially, at least one is operational when a service update is rolled out. For more information about uptime, see [Service Level Agreements](https://azure.microsoft.com/support/legal/sla/search/v1_0/).
-> [!NOTE]
-> In Azure AI Search, you can't segregate indexing and querying operations; thus, you would never create multiple services for segregated workloads. An index is always queried on the service in which it was created (you can't create an index in one service and copy it to another).
+## Add more services to your subscription
-A second service isn't required for high availability. High availability for queries is achieved when you use two or more replicas in the same service. Replica updates are sequential, which means at least one is operational when a service update is rolled out. For more information about uptime, see [Service Level Agreements](https://azure.microsoft.com/support/legal/sla/search/v1_0/).
+Azure AI Search limits the [number of search services](search-limits-quotas-capacity.md#subscription-limits) you can initially create in a subscription. If you reach your limit, you can request more quotas.
-## Add more services to a subscription
+You must have Owner or Contributor permissions for the subscription to request quota. Depending on your region and data center capacity, you might be able to automatically request quota to add services to your subscription. If the request fails, reduce the number or file a support ticket. Expect a one-month turnaround for a large quota increase, such as more than 30 extra services.
-Azure AI Search restricts the [number of search services](search-limits-quotas-capacity.md#subscription-limits) you can initially create in a subscription. If you exhaust your maximum limit, you can request more quota.
+To request more subscription quota:
-You must have Owner or Contributor permissions on the subscription to request quota.
-Depending on region and datacenter capacity, you can automatically request more quota to add services to your subscription. If the request fails, you should either decrease the number or file a support ticket. For a large increase in quota, such as more than 30 extra services, you should expect a one-month turnaround.
+1. Go to your dashboard in the [Azure portal](https://portal.azure.com/).
-1. Sign in to the Azure portal, search for "quotas" in your dashboard, and then select the **Quotas** service.
+1. Use the search box to find the **Quotas** service.
- :::image type="content" source="media/search-create-service-portal/quota-search.png" lightbox="media/search-create-service-portal/quota-search.png" alt-text="Screenshot of the quota search term and Quotas service in the results.":::
+ :::image type="content" source="media/search-create-service-portal/quota-search.png" lightbox="media/search-create-service-portal/quota-search.png" alt-text="Screenshot of the Quota search term and the Quotas service in the results.":::
-1. In the Quota's Overview page, select **Search**.
+1. On the **Overview** tab, select the **Search** tile.
- :::image type="content" source="media/search-create-service-portal/quota-overview-page.png" lightbox="media/search-create-service-portal/quota-overview-page.png" alt-text="Screenshot of the search tile in the Quota's overview page.":::
+ :::image type="content" source="media/search-create-service-portal/quota-overview-page.png" lightbox="media/search-create-service-portal/quota-overview-page.png" alt-text="Screenshot of the Search tile on the Overview page.":::
-1. Set filters so that you can review existing quota for search services in the current subscription. We recommend filtering by usage.
+1. Set filters to review the existing quota for search services in your current subscription. We recommend filtering by usage.
-1. Find the region and tier that needs more quota and select the **Edit** pencil icon to begin your request.
+ :::image type="content" source="media/search-create-service-portal/usage-filter.png" lightbox="media/search-create-service-portal/usage-filter.png" alt-text="Screenshot of the Usage filter for search services in your current subscription.":::
- :::image type="content" source="media/search-create-service-portal/quota-pencil-edit.png" lightbox="media/search-create-service-portal/quota-pencil-edit.png" alt-text="Screenshot of the My Quotas page with a region at maximum quota.":::
+1. Next to the tier and region that need more quotas, select **Request adjustment** <img src=media/search-create-service-portal/request-adjustment-icon.png alt="Screenshot of the Request Adjustment icon, which is the outline of a pencil." width="14">.
-1. In **Quota details**, specify the location, tier, and a new limit for your subscription quota. None of the values can be empty. The new limit must be greater than the current limit. If regional capacity is constrained, your request won't be automatically approved. In this scenario, an incident report is generated on your behalf for investigation and resolution.
+1. In **New Quota Request**, enter a new limit for your subscription quota. The new limit must be greater than your current limit. If regional capacity is constrained, your request won't be automatically approved, and an incident report will be generated on your behalf for investigation and resolution.
-1. Submit the request.
+1. Submit your request.
-1. Monitor notifications in the Azure portal for status updates on the new limit. Most requests are approved within 24 hours.
+1. Monitor notifications in the Azure portal for updates on the new limit. Most requests are approved within 24 hours.
## Next steps
-After provisioning a service, you can continue in the Azure portal to create your first index.
+Now that you've deployed your search service, continue in the Azure portal to create your first index:
> [!div class="nextstepaction"]
> [Quickstart: Create an Azure AI Search index in the Azure portal](search-get-started-portal.md)
Summary
{
"modification_type": "minor update",
"modification_title": "検索サービスポータルの文書更新"
}
Explanation
このコードの差分は、search-create-service-portal.md
という文書ファイルに対する修正を示しています。この変更は、114行の追加と100行の削除を伴い、主に内容の明確化、構造の改善、および最新の情報の反映を目的としています。
主な更新内容には、文書の著者情報の変更、トピックの分類の修正、手順の説明の改善、新しい画像やGIFの追加が含まれています。また、Azure AI Searchへのサブスクリプションの説明がより詳しくなり、ユーザーがサービスを効果的に作成および管理するための情報が強化されています。この文書は、ユーザーがAzureポータルで検索サービスを作成する際の参考資料として機能し、ユーザーエクスペリエンスの向上を図っています。
これにより、ユーザーは最新の手順や推奨事項に基づいてサービスを設定できるようになり、特に新しいユーザーにとっては利便性が向上しています。全体的に、この更新は情報の最新化と利用しやすさを重視したものです。
articles/search/search-data-sources-terms-of-use.md
Diff
@@ -8,8 +8,8 @@ ms.author: heidist
ms.service: azure-ai-search
ms.custom:
- ignite-2023
-ms.topic: reference
-ms.date: 01/10/2024
+ms.topic: concept-article
+ms.date: 02/19/2025
---
# Terms of Use: Partner data sources
Summary
{
"modification_type": "minor update",
"modification_title": "データソースの利用規約文書の更新"
}
Explanation
このコードの差分は、search-data-sources-terms-of-use.md
という文書ファイルに対する修正を示しています。この変更により、2行が追加され、2行が削除され、全体で4行の変更が行われました。
主な更新内容としては、文書のメタデータの変更が含まれています。具体的には、トピックの分類が「reference」から「concept-article」に変更され、文書の日付も更新されています。これにより、この文書がより概念的な記事として位置づけられることになりました。
この更新は、ユーザーに対してデータソースの利用規約に関する情報を提供する際に、より明確な分類と最新の日付を反映させることを目的としています。これにより、文書の信頼性と関連性が向上し、利用者は期待される情報を適切に把握できるようになります。
articles/search/search-more-like-this.md
Diff
@@ -8,8 +8,8 @@ ms.author: beloh
ms.service: azure-ai-search
ms.custom:
- ignite-2023
-ms.topic: reference
-ms.date: 12/10/2024
+ms.topic: concept-article
+ms.date: 02/20/2025
---
# moreLikeThis (preview) in Azure AI Search
Summary
{
"modification_type": "minor update",
"modification_title": "moreLikeThis 機能記事の更新"
}
Explanation
このコードの差分は、search-more-like-this.md
という文書ファイルに対する修正を示しています。この変更は、2行の追加と2行の削除を伴い、全体で4行の変更が行われました。
主な更新内容としては、文書のメタデータに関する変更が含まれています。具体的には、トピックの分類が「reference」から「concept-article」に変更され、文書の日付が更新されています。これにより、この文書がより概念的な記事としての位置づけを強調することになりました。
この更新の目的は、Azure AI Searchにおける「moreLikeThis」機能についての情報を提供する際に、より適切な文書カテゴリと最新の日付を反映させることです。これにより、ユーザーは文書の信頼性を感じやすくなり、最新の情報を基に理解を深めることができます。
articles/search/toc.yml
Diff
@@ -6,11 +6,11 @@ items:
items:
- name: What's Azure AI Search?
href: search-what-is-azure-search.md
- - name: New in Search
+ - name: New in AI Search
href: whats-new.md
- name: Features
href: search-features-list.md
- - name: Try search for free
+ - name: Try AI Search for free
href: search-try-for-free.md
- name: FAQ
href: search-faq-frequently-asked-questions.yml
Summary
{
"modification_type": "minor update",
"modification_title": "AI Searchに関する目次の更新"
}
Explanation
このコードの差分は、toc.yml
という目次ファイルに対する修正を示しています。この変更により、2行が追加され、2行が削除され、全体で4行の変更が行われました。
主な変更点は、目次の項目名の一部が更新されたことです。「New in Search」という項目名が「New in AI Search」に変更され、「Try search for free」という項目名が「Try AI Search for free」に改められています。これにより、文書がAzure AI Searchに特化した内容であることがより明確に表現されています。
この更新の目的は、目次内での表現を改善し、Azure AI Searchに関連する情報であることを強調することです。これによって、利用者は目次を通じてコンテンツの内容をより正確に理解しやすくなります。