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 매개 변수

속성	In(다음 안에)	필수	형식	Description
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

속성	형식	Description
200 OK	OfferingsResult	요청이 성공했습니다.
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

속성	Description
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
          }
        }
      ]
    }
  ]
}

정의

속성	Description
CloudError	API 오류에 대한 정보를 포함합니다.
CloudErrorBody	오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.
FeatureOffering	특정 지역에서 특정 기능의 가용성을 설명합니다.
OfferingsByRegion	특정 Azure 지역에서 이용 가능한 Azure AI 검색 기능과 SKU를 설명합니다.
OfferingsResult	응답은 지역별로 정리된 Azure AI 검색 제공 서비스와 신규 서비스 생성에 권장되는 기본 지역을 포함합니다.
Sku	청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU를 정의합니다.
SkuLimits	SKU 제공과 관련된 한도를 설명합니다.
SkuName	검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다. '서버리스': 자동 확장 기능이 있는 서버리스 계층입니다.
SkuOffering	특정 지역 내 한도를 가진 SKU 제공을 설명합니다.

CloudError

Object

API 오류에 대한 정보를 포함합니다.

속성	형식	Description
error	CloudErrorBody	오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.
message	string	오류에 대한 간략한 설명은 무엇이 잘못되었는지를 암시합니다(세부 정보/디버깅 정보는 'error.message' 속성을 참조).

CloudErrorBody

Object

오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.

속성	형식	Description
code	string	HTTP 상태 코드보다 오류 조건을 보다 정확하게 설명하는 오류 코드입니다. 프로그래밍 방식으로 특정 오류 사례를 처리하는 데 사용할 수 있습니다.
details	CloudErrorBody[]	이 오류와 관련된 중첩된 오류를 포함합니다.
message	string	오류를 자세히 설명하고 디버깅 정보를 제공하는 메시지입니다.
target	string	특정 오류의 대상(예: 오류가 있는 속성의 이름)입니다.

FeatureOffering

Object

특정 지역에서 특정 기능의 가용성을 설명합니다.

속성	형식	Description
name	string	이 지역에서 제공되는 기능의 이름입니다.

OfferingsByRegion

Object

특정 Azure 지역에서 이용 가능한 Azure AI 검색 기능과 SKU를 설명합니다.

속성	형식	Description
features	FeatureOffering[]	이 지역에서 제공되는 기능 목록입니다.
regionName	string	지역 이름입니다.
skus	SkuOffering[]	이 지역에서 제공되는 SKU 목록입니다.

OfferingsResult

Object

응답은 지역별로 정리된 Azure AI 검색 제공 서비스와 신규 서비스 생성에 권장되는 기본 지역을 포함합니다.

속성	형식	Description
defaultRegion	string	새로운 Azure AI 검색 서비스를 생성하기 위한 권장 기본 지역입니다.
regions	OfferingsByRegion[]	지역별 Azure AI 검색 제공 목록입니다.

Sku

Object

청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU를 정의합니다.

속성	형식	Description
name	SkuName	검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다. '서버리스': 자동 확장 기능이 있는 서버리스 계층입니다.

SkuLimits

Object

SKU 제공과 관련된 한도를 설명합니다.

속성	형식	Description
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': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다. '서버리스': 자동 확장 기능이 있는 서버리스 계층입니다.

값	Description
free	SLA 보장 및 청구 가능 계층에서 제공되는 기능의 하위 집합이 없는 무료 계층.
basic	최대 3개의 복제본이 있는 전용 서비스에 대한 청구 가능 계층입니다.
standard	최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스에 대한 청구 가능 계층입니다.
standard2	'표준'과 비슷하지만 검색 단위당 더 많은 용량이 있습니다.
standard3	최대 12개의 파티션과 12개의 복제본(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션을 최대 3개까지 포함)하는 가장 큰 표준 제품입니다.
storage_optimized_l1	파티션당 최대 12개의 파티션을 지원하는 전용 서비스에 대한 청구 가능 계층입니다.
storage_optimized_l2	파티션당 최대 12개의 파티션을 지원하는 전용 서비스에 대한 청구 가능 계층입니다.
serverless	서버리스 계층으로, 저건비, 소비 기반, 사용량 기반 지불 방식을 제공하며, 자동 확장 기능이 있습니다.

SkuOffering

Object

특정 지역 내 한도를 가진 SKU 제공을 설명합니다.

속성	형식	Description
limits	SkuLimits	이 지역에서 제공되는 이 SKU와 관련된 제한입니다.
sku	Sku	SKU 정의.