Offerings - Fetch

Служба:: Search Management

Версия API:: 2026-09-01-preview

Получает функции и SKU, предлагаемые сервисом Поиск с использованием ИИ Azure в каждом регионе, а также рекомендуемый регион по умолчанию для создания новых сервисов.

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

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
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	Описывает функции и SKU Поиск с использованием ИИ Azure, доступные в конкретном регионе Azure.
OfferingsResult	Ответ содержит доступные предложения Поиск с использованием ИИ Azure, организованные по регионам, а также рекомендуемый регион по умолчанию для создания новых сервисов.
Sku	Определяет номер SKU службы поиска, который определяет частоту выставления счетов и ограничения емкости.
SkuLimits	Описывает ограничения, связанные с предложением SKU.
SkuName	Номер SKU службы поиска. Допустимые значения: "бесплатный": общая служба. "базовый": выделенная служба с 3 репликами. "Стандартный": выделенная служба с 12 секциями и 12 репликами. "standard2": аналогично стандарту, но с большей емкостью на единицу поиска. "Standard3": наибольшее стандартное предложение с до 12 секций и 12 реплик (или до 3 секций с большим количеством индексов, если свойство hostingMode также имеет значение highDensity). "storage_optimized_l1": поддерживает 1TB на секцию до 12 секций. 'storage_optimized_l2': поддерживает 2 ТБ на раздел, до 12 разделов. 'serverless': уровень без сервера с возможностью автомасштабирования.
SkuOffering	Описывает предложение SKU с его ограничениями в конкретном регионе.

CloudError

Объект

Содержит сведения об ошибке API.

Имя.	Тип	Описание
error	CloudErrorBody	Описывает определенную ошибку API с кодом ошибки и сообщением.
message	string	Краткое описание ошибки, которая указывает на то, что пошло не так (для получения сведений или отладки см. свойство error.message).

CloudErrorBody

Объект

Описывает определенную ошибку API с кодом ошибки и сообщением.

Имя.	Тип	Описание
code	string	Код ошибки, описывающий условие ошибки точнее, чем код состояния HTTP. Можно использовать для программной обработки конкретных случаев ошибок.
details	CloudErrorBody[]	Содержит вложенные ошибки, связанные с этой ошибкой.
message	string	Сообщение, описывающее ошибку подробно и предоставляющее сведения об отладке.
target	string	Целевой объект конкретной ошибки (например, имя свойства в ошибке).

FeatureOffering

Объект

Описывает наличие конкретного объекта в регионе.

Имя.	Тип	Описание
name	string	Имя функции, предлагаемой в этом регионе.

OfferingsByRegion

Объект

Описывает функции и SKU Поиск с использованием ИИ Azure, доступные в конкретном регионе Azure.

Имя.	Тип	Описание
features	FeatureOffering[]	Список функций, предлагаемых в этом регионе.
regionName	string	Имя региона.
skus	SkuOffering[]	Список номеров SKU, предлагаемых в этом регионе.

OfferingsResult

Объект

Ответ содержит доступные предложения Поиск с использованием ИИ Azure, организованные по регионам, а также рекомендуемый регион по умолчанию для создания новых сервисов.

Имя.	Тип	Описание
defaultRegion	string	Рекомендуемый регион по умолчанию для создания новых сервисов Поиск с использованием ИИ Azure.
regions	OfferingsByRegion[]	Список предложений Поиск с использованием ИИ Azure по регионам.

Sku

Объект

Определяет номер SKU службы поиска, который определяет частоту выставления счетов и ограничения емкости.

Имя.	Тип	Описание
name	SkuName	Номер SKU службы поиска. Допустимые значения: "бесплатный": общая служба. "базовый": выделенная служба с 3 репликами. "Стандартный": выделенная служба с 12 секциями и 12 репликами. "standard2": аналогично стандарту, но с большей емкостью на единицу поиска. "Standard3": наибольшее стандартное предложение с до 12 секций и 12 реплик (или до 3 секций с большим количеством индексов, если свойство hostingMode также имеет значение highDensity). "storage_optimized_l1": поддерживает 1TB на секцию до 12 секций. 'storage_optimized_l2': поддерживает 2 ТБ на раздел, до 12 разделов. 'serverless': уровень без сервера с возможностью автомасштабирования.

SkuLimits

Объект

Описывает ограничения, связанные с предложением 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 службы поиска. Допустимые значения: "бесплатный": общая служба. "базовый": выделенная служба с 3 репликами. "Стандартный": выделенная служба с 12 секциями и 12 репликами. "standard2": аналогично стандарту, но с большей емкостью на единицу поиска. "Standard3": наибольшее стандартное предложение с до 12 секций и 12 реплик (или до 3 секций с большим количеством индексов, если свойство hostingMode также имеет значение highDensity). "storage_optimized_l1": поддерживает 1TB на секцию до 12 секций. 'storage_optimized_l2': поддерживает 2 ТБ на раздел, до 12 разделов. 'serverless': уровень без сервера с возможностью автомасштабирования.

Значение	Описание
free	Бесплатный уровень без гарантий обслуживания и подмножества функций, предлагаемых на платных уровнях.
basic	Оплачиваемый уровень для выделенной службы с 3 репликами.
standard	Уровень выставления счетов для выделенной службы с 12 секциями и 12 репликами.
standard2	Аналогично "стандарту", но с большей емкостью на единицу поиска.
standard3	Наибольшее предложение уровня "Стандартный" с до 12 секций и 12 реплик (или до 3 секций с большим количеством индексов, если свойство hostingMode также имеет значение highDensity).
storage_optimized_l1	Уровень выставления счетов для выделенной службы, поддерживающей 1TB на секцию, до 12 секций.
storage_optimized_l2	Уровень выставления счетов для выделенной службы, поддерживающей 2TB на секцию, до 12 секций.
serverless	Безсерверный уровень, предлагающий низкочувствительный, ориентированный на потребление и оплату по мере использования, с возможностью автоматического масштабирования.

SkuOffering

Объект

Описывает предложение SKU с его ограничениями в конкретном регионе.

Имя.	Тип	Описание
limits	SkuLimits	Ограничения, связанные с этим номером SKU, предлагаемые в этом регионе.
sku	Sku	Определение SKU.