Offerings - Fetch

サービス:: Search Management

API バージョン:: 2026-09-01-preview

各地域でAzure AI 検索サービスが提供する機能やSKUを取得し、新規サービス作成のための推奨デフォルトリージョンも取得します。

POST https://management.azure.com/providers/Microsoft.Search/fetchOfferings?api-version=2026-09-01-preview

URI パラメーター

名前	/	必須	型	説明
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	OfferingsResult	要求は成功しました。
Other Status Codes	CloudError	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	あなたのユーザーアカウントになりすます

例

SearchFetchOfferings

要求のサンプル

POST https://management.azure.com/providers/Microsoft.Search/fetchOfferings?api-version=2026-09-01-preview


/**
 * Samples for Offerings Fetch.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-09-01-preview/SearchFetchOfferings.json
     */
    /**
     * Sample code: SearchFetchOfferings.
     * 
     * @param manager Entry point to SearchServiceManager.
     */
    public static void searchFetchOfferings(com.azure.resourcemanager.search.SearchServiceManager manager) {
        manager.serviceClient().getOfferings().fetchWithResponse(com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armsearch_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/search/armsearch/v2"
)

// Generated from example definition: 2026-09-01-preview/SearchFetchOfferings.json
func ExampleOfferingsClient_Fetch() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsearch.NewClientFactory("<subscriptionID>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewOfferingsClient().Fetch(ctx, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armsearch.OfferingsClientFetchResponse{
	// 	OfferingsResult: armsearch.OfferingsResult{
	// 		DefaultRegion: to.Ptr("centralus"),
	// 		Regions: []*armsearch.OfferingsByRegion{
	// 			{
	// 				RegionName: to.Ptr("East US"),
	// 				Features: []*armsearch.FeatureOffering{
	// 					{
	// 						Name: to.Ptr("SemanticRanker"),
	// 					},
	// 					{
	// 						Name: to.Ptr("QueryRewriting"),
	// 					},
	// 				},
	// 				SKUs: []*armsearch.SKUOffering{
	// 					{
	// 						SKU: &armsearch.SKU{
	// 							Name: to.Ptr(armsearch.SKUNameStandard),
	// 						},
	// 						Limits: &armsearch.SKULimits{
	// 							Indexes: to.Ptr[int32](50),
	// 							Indexers: to.Ptr[int32](50),
	// 							PartitionStorageInGigabytes: to.Ptr[float32](160),
	// 							PartitionVectorStorageInGigabytes: to.Ptr[float32](35),
	// 							SearchUnits: to.Ptr[int32](36),
	// 							Replicas: to.Ptr[int32](12),
	// 							Partitions: to.Ptr[int32](12),
	// 						},
	// 					},
	// 					{
	// 						SKU: &armsearch.SKU{
	// 							Name: to.Ptr(armsearch.SKUNameStandard2),
	// 						},
	// 						Limits: &armsearch.SKULimits{
	// 							Indexes: to.Ptr[int32](200),
	// 							Indexers: to.Ptr[int32](200),
	// 							PartitionStorageInGigabytes: to.Ptr[float32](512),
	// 							PartitionVectorStorageInGigabytes: to.Ptr[float32](150),
	// 							SearchUnits: to.Ptr[int32](36),
	// 							Replicas: to.Ptr[int32](12),
	// 							Partitions: to.Ptr[int32](12),
	// 						},
	// 					},
	// 				},
	// 			},
	// 			{
	// 				RegionName: to.Ptr("West Europe"),
	// 				Features: []*armsearch.FeatureOffering{
	// 					{
	// 						Name: to.Ptr("Grok"),
	// 					},
	// 					{
	// 						Name: to.Ptr("ImageVectorization"),
	// 					},
	// 				},
	// 				SKUs: []*armsearch.SKUOffering{
	// 					{
	// 						SKU: &armsearch.SKU{
	// 							Name: to.Ptr(armsearch.SKUNameStandard),
	// 						},
	// 						Limits: &armsearch.SKULimits{
	// 							Indexes: to.Ptr[int32](50),
	// 							Indexers: to.Ptr[int32](50),
	// 							PartitionStorageInGigabytes: to.Ptr[float32](160),
	// 							PartitionVectorStorageInGigabytes: to.Ptr[float32](35),
	// 							SearchUnits: to.Ptr[int32](36),
	// 							Replicas: to.Ptr[int32](12),
	// 							Partitions: to.Ptr[int32](12),
	// 						},
	// 					},
	// 					{
	// 						SKU: &armsearch.SKU{
	// 							Name: to.Ptr(armsearch.SKUNameStandard2),
	// 						},
	// 						Limits: &armsearch.SKULimits{
	// 							Indexes: to.Ptr[int32](200),
	// 							Indexers: to.Ptr[int32](200),
	// 							PartitionStorageInGigabytes: to.Ptr[float32](512),
	// 							PartitionVectorStorageInGigabytes: to.Ptr[float32](150),
	// 							SearchUnits: to.Ptr[int32](36),
	// 							Replicas: to.Ptr[int32](12),
	// 							Partitions: to.Ptr[int32](12),
	// 						},
	// 					},
	// 				},
	// 			},
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { SearchManagementClient } = require("@azure/arm-search");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to fetches the features and SKUs offered by the Azure AI Search service in each region, along with the recommended default region for creating new services.
 *
 * @summary fetches the features and SKUs offered by the Azure AI Search service in each region, along with the recommended default region for creating new services.
 * x-ms-original-file: 2026-09-01-preview/SearchFetchOfferings.json
 */
async function searchFetchOfferings() {
  const credential = new DefaultAzureCredential();
  const client = new SearchManagementClient(credential);
  const result = await client.offerings.fetch();
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "defaultRegion": "centralus",
  "regions": [
    {
      "regionName": "East US",
      "features": [
        {
          "name": "SemanticRanker"
        },
        {
          "name": "QueryRewriting"
        }
      ],
      "skus": [
        {
          "sku": {
            "name": "standard"
          },
          "limits": {
            "indexes": 50,
            "indexers": 50,
            "partitionStorageInGigabytes": 160,
            "partitionVectorStorageInGigabytes": 35,
            "searchUnits": 36,
            "replicas": 12,
            "partitions": 12
          }
        },
        {
          "sku": {
            "name": "standard2"
          },
          "limits": {
            "indexes": 200,
            "indexers": 200,
            "partitionStorageInGigabytes": 512,
            "partitionVectorStorageInGigabytes": 150,
            "searchUnits": 36,
            "replicas": 12,
            "partitions": 12
          }
        }
      ]
    },
    {
      "regionName": "West Europe",
      "features": [
        {
          "name": "Grok"
        },
        {
          "name": "ImageVectorization"
        }
      ],
      "skus": [
        {
          "sku": {
            "name": "standard"
          },
          "limits": {
            "indexes": 50,
            "indexers": 50,
            "partitionStorageInGigabytes": 160,
            "partitionVectorStorageInGigabytes": 35,
            "searchUnits": 36,
            "replicas": 12,
            "partitions": 12
          }
        },
        {
          "sku": {
            "name": "standard2"
          },
          "limits": {
            "indexes": 200,
            "indexers": 200,
            "partitionStorageInGigabytes": 512,
            "partitionVectorStorageInGigabytes": 150,
            "searchUnits": 36,
            "replicas": 12,
            "partitions": 12
          }
        }
      ]
    }
  ]
}

定義

名前	説明
CloudError	API エラーに関する情報が含まれています。
CloudErrorBody	エラーコードとメッセージを含む特定の API エラーについて説明します。
FeatureOffering	地域における特定の機能の利用可能性を記述します。
OfferingsByRegion	特定のAzureリージョンで利用可能なAzure AI 検索の機能とSKUについて説明します。
OfferingsResult	回答には、利用可能なAzure AI 検索の提供内容を地域別に整理し、新規サービス作成のための推奨デフォルトリージョンを含みます。
Sku	課金レートと容量の制限を決定する検索サービスの SKU を定義します。
SkuLimits	SKUの提供に関連する制限を説明します。
SkuName	検索サービスの SKU。有効な値には、'free': 共有サービスが含まれます。 "basic": 最大 3 つのレプリカを含む専用サービス。 'standard': 最大 12 個のパーティションと 12 個のレプリカを持つ専用サービス。 'standard2': 標準に似ていますが、検索ユニットあたりの容量が多くなります。 'standard3': 最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックスが多い最大 3 つのパーティション)。 'storage_optimized_l1': パーティションあたり 1 TB、最大 12 個のパーティションをサポートします。「storage_optimized_l2」:パーティションあたり2TB、最大12パーティションをサポートします。「サーバーレス」:自動スケーリング機能を備えたサーバーレス層。
SkuOffering	特定の地域におけるSKUの提供を記述します。

CloudError

Object

API エラーに関する情報が含まれています。

名前	型	説明
error	CloudErrorBody	エラーコードとメッセージを含む特定の API エラーについて説明します。
message	string	問題の原因を示すエラーの簡単な説明 (詳細/デバッグ情報については、'error.message' プロパティを参照してください)。

CloudErrorBody

Object

エラーコードとメッセージを含む特定の API エラーについて説明します。

名前	型	説明
code	string	HTTP 状態コードよりも正確にエラー状態を記述するエラーコード。特定のエラーケースをプログラムで処理するために使用できます。
details	CloudErrorBody[]	このエラーに関連する入れ子になったエラーが含まれています。
message	string	エラーの詳細を説明し、デバッグ情報を提供するメッセージ。
target	string	特定のエラーのターゲット (たとえば、エラーのプロパティの名前)。

FeatureOffering

Object

地域における特定の機能の利用可能性を記述します。

名前	型	説明
name	string	このリージョンで提供される機能の名前。

OfferingsByRegion

Object

特定のAzureリージョンで利用可能なAzure AI 検索の機能とSKUについて説明します。

名前	型	説明
features	FeatureOffering[]	このリージョンで提供される機能の一覧。
regionName	string	リージョンの名前。
skus	SkuOffering[]	このリージョンで提供される SKU の一覧。

OfferingsResult

Object

回答には、利用可能なAzure AI 検索の提供内容を地域別に整理し、新規サービス作成のための推奨デフォルトリージョンを含みます。

名前	型	説明
defaultRegion	string	新しいAzure AI 検索サービスを作成するための推奨デフォルトのリージョン。
regions	OfferingsByRegion[]	地域別Azure AI 検索の提供内容一覧。

Sku

Object

課金レートと容量の制限を決定する検索サービスの SKU を定義します。

名前	型	説明
name	SkuName	検索サービスの SKU。有効な値には、'free': 共有サービスが含まれます。 "basic": 最大 3 つのレプリカを含む専用サービス。 'standard': 最大 12 個のパーティションと 12 個のレプリカを持つ専用サービス。 'standard2': 標準に似ていますが、検索ユニットあたりの容量が多くなります。 'standard3': 最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックスが多い最大 3 つのパーティション)。 'storage_optimized_l1': パーティションあたり 1 TB、最大 12 個のパーティションをサポートします。「storage_optimized_l2」:パーティションあたり2TB、最大12パーティションをサポートします。「サーバーレス」:自動スケーリング機能を備えたサーバーレス層。

SkuLimits

Object

SKUの提供に関連する制限を説明します。

名前	型	説明
indexers	integer (int32)	この SKU で使用できるインデクサーの最大数。
indexes	integer (int32)	この SKU で使用できるインデックスの最大数。
partitionStorageInGigabytes	number (float)	パーティションごとにこの SKU で使用できる最大ストレージサイズ (ギガバイト単位)。
partitionVectorStorageInGigabytes	number (float)	パーティションごとにこの SKU で使用できる最大ベクトルストレージサイズ (ギガバイト単位)。
partitions	integer (int32)	この SKU で使用できるパーティションの最大数。
replicas	integer (int32)	この SKU で使用できるレプリカの最大数。
searchUnits	integer (int32)	この SKU で使用できる検索ユニットの最大数。

SkuName

列挙

検索サービスの SKU。有効な値には、'free': 共有サービスが含まれます。 "basic": 最大 3 つのレプリカを含む専用サービス。 'standard': 最大 12 個のパーティションと 12 個のレプリカを持つ専用サービス。 'standard2': 標準に似ていますが、検索ユニットあたりの容量が多くなります。 'standard3': 最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックスが多い最大 3 つのパーティション)。 'storage_optimized_l1': パーティションあたり 1 TB、最大 12 個のパーティションをサポートします。「storage_optimized_l2」:パーティションあたり2TB、最大12パーティションをサポートします。「サーバーレス」:自動スケーリング機能を備えたサーバーレス層。

値	説明
free	無料レベル。SLA が保証されておらず、課金対象レベルで提供される機能のサブセットも含まれます。
basic	最大 3 つのレプリカを持つ専用サービスの課金対象レベル。
standard	最大 12 個のパーティションと 12 個のレプリカを持つ専用サービスの課金対象レベル。
standard2	"standard" に似ていますが、検索ユニットあたりの容量が多くなります。
standard3	最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックス数が多い最大 3 つのパーティション)。
storage_optimized_l1	パーティションあたり 1 TB、最大 12 個のパーティションをサポートする専用サービスの課金対象レベル。
storage_optimized_l2	パーティションあたり 2 TB、最大 12 個のパーティションをサポートする専用サービスの課金対象レベル。
serverless	サーバーレス層で、低タッチで消費型かつ従量課金型の体験を提供し、自動スケーリング機能を備えています。

SkuOffering

Object

特定の地域におけるSKUの提供を記述します。

名前	型	説明
limits	SkuLimits	このリージョンで提供されるこの SKU に関連付けられている制限。
sku	Sku	SKUの定義。