Offerings - Fetch

Serviço:: Search Management

Versão da API:: 2026-09-01-preview

Recupera os recursos e SKUs oferecidos pelo serviço Pesquisa de IA do Azure em cada região, junto com a região padrão recomendada para criar novos serviços.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	OfferingsResult	A solicitação foi bem-sucedida.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	se passar pela sua conta de usuário

Exemplos

SearchFetchOfferings

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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
          }
        }
      ]
    }
  ]
}

Definições

Nome	Description
CloudError	Contém informações sobre um erro de API.
CloudErrorBody	Descreve um erro de API específico com um código de erro e uma mensagem.
FeatureOffering	Descreve a disponibilidade de uma característica específica em uma região.
OfferingsByRegion	Descreve os recursos e SKUs do Pesquisa de IA do Azure disponíveis em uma região específica do Azure.
OfferingsResult	Resposta contendo as ofertas disponíveis do Pesquisa de IA do Azure , organizadas por região, junto com a região padrão recomendada para criar novos serviços.
Sku	Define a SKU de um serviço de pesquisa, que determina a taxa de cobrança e os limites de capacidade.
SkuLimits	Descreve os limites associados a uma oferta de SKU.
SkuName	A SKU do serviço de pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até 3 réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': Suporta 2TB por partição, até 12 partições. 'Serverless': Nível serverless com capacidade de auto-escalonamento.
SkuOffering	Descreve uma oferta de SKU com seus limites em uma região específica.

CloudError

Objeto

Contém informações sobre um erro de API.

Nome	Tipo	Description
error	CloudErrorBody	Descreve um erro de API específico com um código de erro e uma mensagem.
message	string	Uma breve descrição do erro que indica o que deu errado (para obter detalhes/informações de depuração, consulte a propriedade 'error.message').

CloudErrorBody

Objeto

Descreve um erro de API específico com um código de erro e uma mensagem.

Nome	Tipo	Description
code	string	Um código de erro que descreve a condição de erro com mais precisão do que um código de status HTTP. Pode ser usado para lidar programaticamente com casos de erro específicos.
details	CloudErrorBody[]	Contém erros aninhados relacionados a esse erro.
message	string	Uma mensagem que descreve o erro em detalhes e fornece informações de depuração.
target	string	O destino do erro específico (por exemplo, o nome da propriedade com erro).

FeatureOffering

Objeto

Descreve a disponibilidade de uma característica específica em uma região.

Nome	Tipo	Description
name	string	O nome do recurso oferecido nesta região.

OfferingsByRegion

Objeto

Descreve os recursos e SKUs do Pesquisa de IA do Azure disponíveis em uma região específica do Azure.

Nome	Tipo	Description
features	FeatureOffering[]	A lista de recursos oferecidos nessa região.
regionName	string	O nome da região.
skus	SkuOffering[]	A lista de SKUs oferecidos nessa região.

OfferingsResult

Objeto

Resposta contendo as ofertas disponíveis do Pesquisa de IA do Azure , organizadas por região, junto com a região padrão recomendada para criar novos serviços.

Nome	Tipo	Description
defaultRegion	string	A região padrão recomendada para criar novos serviços do Pesquisa de IA do Azure .
regions	OfferingsByRegion[]	A lista de ofertas do Pesquisa de IA do Azure por região.

Sku

Objeto

Define a SKU de um serviço de pesquisa, que determina a taxa de cobrança e os limites de capacidade.

Nome	Tipo	Description
name	SkuName	A SKU do serviço de pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até 3 réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': Suporta 2TB por partição, até 12 partições. 'Serverless': Nível serverless com capacidade de auto-escalonamento.

SkuLimits

Objeto

Descreve os limites associados a uma oferta de SKU.

Nome	Tipo	Description
indexers	integer (int32)	O número máximo de indexadores disponíveis para este SKU.
indexes	integer (int32)	O número máximo de índices disponíveis para esse SKU.
partitionStorageInGigabytes	number (float)	O tamanho máximo de armazenamento em Gigabytes disponível para esse SKU por partição.
partitionVectorStorageInGigabytes	number (float)	O tamanho máximo de armazenamento vetorial em Gigabytes disponível para esse SKU por partição.
partitions	integer (int32)	O número máximo de partições disponíveis para esse SKU.
replicas	integer (int32)	O número máximo de réplicas disponíveis para esse SKU.
searchUnits	integer (int32)	O número máximo de unidades de pesquisa disponíveis para este SKU.

SkuName

Enumeração

A SKU do serviço de pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até 3 réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': Suporta 2TB por partição, até 12 partições. 'Serverless': Nível serverless com capacidade de auto-escalonamento.

Valor	Description
free	Camada gratuita, sem garantias de SLA e um subconjunto dos recursos oferecidos em camadas faturáveis.
basic	Camada faturável para um serviço dedicado com até 3 réplicas.
standard	Camada faturável para um serviço dedicado com até 12 partições e 12 réplicas.
standard2	Semelhante ao "padrão", mas com mais capacidade por unidade de pesquisa.
standard3	A maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity').
storage_optimized_l1	Camada faturável para um serviço dedicado que dá suporte a 1 TB por partição, até 12 partições.
storage_optimized_l2	Camada faturável para um serviço dedicado que dá suporte a 2 TB por partição, até 12 partições.
serverless	Nível serverless, oferecendo uma experiência de baixo toque, baseada no consumo e pay-as-you-go, com capacidade de auto-escalonamento.

SkuOffering

Objeto

Descreve uma oferta de SKU com seus limites em uma região específica.

Nome	Tipo	Description
limits	SkuLimits	Os limites associados a essa SKU oferecida nesta região.
sku	Sku	A definição do SKU.