Offerings - Fetch

Usługa:: Search Management

Wersja interfejsu API:: 2026-09-01-preview

Pobiera funkcje i SKU oferowane przez usługę Wyszukiwanie AI platformy Azure w każdym regionie, wraz z zalecanym domyślnym regionem do tworzenia nowych usług.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	OfferingsResult	Żądanie zakończyło się pomyślnie.
Other Status Codes	CloudError	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

SearchFetchOfferings

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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
          }
        }
      ]
    }
  ]
}

Definicje

Nazwa	Opis
CloudError	Zawiera informacje o błędzie interfejsu API.
CloudErrorBody	Opisuje określony błąd interfejsu API z kodem błędu i komunikatem.
FeatureOffering	Opisuje dostępność konkretnej cechy w danym regionie.
OfferingsByRegion	Opisuje funkcje i SKU Wyszukiwanie AI platformy Azure dostępne w konkretnym regionie Azure.
OfferingsResult	Odpowiedź zawierająca dostępne oferty Wyszukiwanie AI platformy Azure, uporządkowane według regionów, wraz z zalecanym domyślnym regionem do tworzenia nowych usług.
Sku	Definiuje jednostkę SKU usługi wyszukiwania, która określa stawkę rozliczeń i limity pojemności.
SkuLimits	Opisuje ograniczenia związane z ofertą SKU.
SkuName	Jednostka SKU usługi wyszukiwania. Prawidłowe wartości to: "bezpłatna": usługa udostępniona. "basic": Dedykowana usługa z maksymalnie 3 replikami. "Standardowa": Dedykowana usługa z maksymalnie 12 partycjami i 12 replikami. "standard2": podobny do standardowego, ale z większą pojemnością na jednostkę wyszukiwania. "standard3": największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycje z większą większa większa liczba indeksów, jeśli ustawisz również właściwość hostingMode na wartość "highDensity"). "storage_optimized_l1": obsługuje 1 TB na partycję, maksymalnie 12 partycji. 'storage_optimized_l2': Obsługuje 2TB na partycję, do 12 partycji. 'serverless': Tier serverless z możliwością automatycznego skalowania.
SkuOffering	Opisuje ofertę SKU z jej ograniczeniami w określonym regionie.

CloudError

Objekt

Zawiera informacje o błędzie interfejsu API.

Nazwa	Typ	Opis
error	CloudErrorBody	Opisuje określony błąd interfejsu API z kodem błędu i komunikatem.
message	string	Krótki opis błędu, który wskazuje, co poszło nie tak (aby uzyskać szczegółowe informacje/debugowanie, zapoznaj się z właściwością "error.message").

CloudErrorBody

Objekt

Opisuje określony błąd interfejsu API z kodem błędu i komunikatem.

Nazwa	Typ	Opis
code	string	Kod błędu opisujący warunek błędu dokładniej niż kod stanu HTTP. Może służyć do programowego obsługi określonych przypadków błędów.
details	CloudErrorBody[]	Zawiera zagnieżdżone błędy związane z tym błędem.
message	string	Komunikat opisujący szczegółowo błąd i zawierający informacje o debugowaniu.
target	string	Element docelowy określonego błędu (na przykład nazwa właściwości w błędzie).

FeatureOffering

Objekt

Opisuje dostępność konkretnej cechy w danym regionie.

Nazwa	Typ	Opis
name	string	Nazwa funkcji oferowanej w tym regionie.

OfferingsByRegion

Objekt

Opisuje funkcje i SKU Wyszukiwanie AI platformy Azure dostępne w konkretnym regionie Azure.

Nazwa	Typ	Opis
features	FeatureOffering[]	Lista funkcji oferowanych w tym regionie.
regionName	string	Nazwa regionu.
skus	SkuOffering[]	Lista jednostek SKU oferowanych w tym regionie.

OfferingsResult

Objekt

Odpowiedź zawierająca dostępne oferty Wyszukiwanie AI platformy Azure, uporządkowane według regionów, wraz z zalecanym domyślnym regionem do tworzenia nowych usług.

Nazwa	Typ	Opis
defaultRegion	string	Zalecany domyślny region do tworzenia nowych usług Wyszukiwanie AI platformy Azure.
regions	OfferingsByRegion[]	Lista ofert Wyszukiwanie AI platformy Azure według regionów.

Sku

Objekt

Definiuje jednostkę SKU usługi wyszukiwania, która określa stawkę rozliczeń i limity pojemności.

Nazwa	Typ	Opis
name	SkuName	Jednostka SKU usługi wyszukiwania. Prawidłowe wartości to: "bezpłatna": usługa udostępniona. "basic": Dedykowana usługa z maksymalnie 3 replikami. "Standardowa": Dedykowana usługa z maksymalnie 12 partycjami i 12 replikami. "standard2": podobny do standardowego, ale z większą pojemnością na jednostkę wyszukiwania. "standard3": największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycje z większą większa większa liczba indeksów, jeśli ustawisz również właściwość hostingMode na wartość "highDensity"). "storage_optimized_l1": obsługuje 1 TB na partycję, maksymalnie 12 partycji. 'storage_optimized_l2': Obsługuje 2TB na partycję, do 12 partycji. 'serverless': Tier serverless z możliwością automatycznego skalowania.

SkuLimits

Objekt

Opisuje ograniczenia związane z ofertą SKU.

Nazwa	Typ	Opis
indexers	integer (int32)	Maksymalna liczba indeksatorów dostępnych dla tej jednostki SKU.
indexes	integer (int32)	Maksymalna liczba indeksów dostępnych dla tej jednostki SKU.
partitionStorageInGigabytes	number (float)	Maksymalny rozmiar magazynu w gigabajtach dostępny dla tej jednostki SKU na partycję.
partitionVectorStorageInGigabytes	number (float)	Maksymalny rozmiar magazynu wektorów w gigabajtach dostępny dla tej jednostki SKU na partycję.
partitions	integer (int32)	Maksymalna liczba partycji dostępnych dla tej jednostki SKU.
replicas	integer (int32)	Maksymalna liczba replik dostępnych dla tej jednostki SKU.
searchUnits	integer (int32)	Maksymalna liczba jednostek wyszukiwania dostępnych dla tej jednostki SKU.

SkuName

Wyliczenie

Jednostka SKU usługi wyszukiwania. Prawidłowe wartości to: "bezpłatna": usługa udostępniona. "basic": Dedykowana usługa z maksymalnie 3 replikami. "Standardowa": Dedykowana usługa z maksymalnie 12 partycjami i 12 replikami. "standard2": podobny do standardowego, ale z większą pojemnością na jednostkę wyszukiwania. "standard3": największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycje z większą większa większa liczba indeksów, jeśli ustawisz również właściwość hostingMode na wartość "highDensity"). "storage_optimized_l1": obsługuje 1 TB na partycję, maksymalnie 12 partycji. 'storage_optimized_l2': Obsługuje 2TB na partycję, do 12 partycji. 'serverless': Tier serverless z możliwością automatycznego skalowania.

Wartość	Opis
free	Warstwa Bezpłatna bez gwarancji SLA i podzbiór funkcji oferowanych w warstwach rozliczanych.
basic	Rozliczana warstwa dla dedykowanej usługi z maksymalnie 3 replikami.
standard	Warstwa rozliczana dla dedykowanej usługi z maksymalnie 12 partycjami i 12 replikami.
standard2	Podobnie jak w przypadku warstwy "Standardowa", ale z większą pojemnością na jednostkę wyszukiwania.
standard3	Największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycjami z większą większa większa liczba indeksów, jeśli ustawisz również właściwość hostingMode na wartość "highDensity").
storage_optimized_l1	Warstwa rozliczana dla dedykowanej usługi, która obsługuje 1 TB na partycję, do 12 partycji.
storage_optimized_l2	Warstwa rozliczana dla dedykowanej usługi, która obsługuje 2 TB na partycję, do 12 partycji.
serverless	Poziom serwerless, oferujący doświadczenie o niskim kontakcie, konsumpcji i płatności na bieżąco, z możliwością automatycznego skalowania.

SkuOffering

Objekt

Opisuje ofertę SKU z jej ograniczeniami w określonym regionie.

Nazwa	Typ	Opis
limits	SkuLimits	Limity skojarzone z tą jednostkę SKU oferowaną w tym regionie.
sku	Sku	Definicja SKU.