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 參數

名稱 位於 必要 類型 Description
api-version
 query True

string

minLength: 1

用於此作業的 API 版本。

回覆

名稱 類型 Description
200 OK

OfferingsResult

要求已成功。
Other Status Codes

CloudError

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: 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

範例回覆

狀態碼:
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。 有效值包括：「免費」：共享服務。 'basic'：最多 3 個複本的專用服務。 'standard'： 專用服務，最多可有 12 個分割區和 12 個復本。 'standard2'：類似於標準，但每個搜尋單位的容量較多。 'standard3'：最大標準供應專案，最多可有 12 個分割區和 12 個復本（如果您也將 hostingMode 屬性設定為 'highDensity'，則最多 3 個具有更多索引的數據分割）。 'storage_optimized_l1'：支援每個分割區 1TB，最多 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。 有效值包括：「免費」：共享服務。 'basic'：最多 3 個複本的專用服務。 'standard'： 專用服務，最多可有 12 個分割區和 12 個復本。 'standard2'：類似於標準，但每個搜尋單位的容量較多。 'standard3'：最大標準供應專案，最多可有 12 個分割區和 12 個復本（如果您也將 hostingMode 屬性設定為 'highDensity'，則最多 3 個具有更多索引的數據分割）。 'storage_optimized_l1'：支援每個分割區 1TB，最多 12 個分割區。 「storage_optimized_l2」：支援每個分割區 2TB，最多可支援 12 個分割區。 「無伺服器」：無伺服器層級，具備自動擴展功能。

SkuLimits

Object

描述與 SKU 產品相關的限制。

名稱 類型 Description
indexers

integer (int32)

此 SKU 可用的索引子數目上限。
indexes

integer (int32)

此 SKU 可用的索引數目上限。
partitionStorageInGigabytes

number (float)

每個分割區此 SKU 可用的儲存體大小上限 （以 GB 為單位）。
partitionVectorStorageInGigabytes

number (float)

每個分割區此 SKU 可用的向量儲存體大小上限 （以 GB 為單位）。
partitions

integer (int32)

此 SKU 可用的分割區數目上限。
replicas

integer (int32)

此 SKU 可用的複本數目上限。
searchUnits

integer (int32)

此 SKU 可用的搜尋單位數目上限。

SkuName

列舉型別

搜尋服務的 SKU。 有效值包括：「免費」：共享服務。 'basic'：最多 3 個複本的專用服務。 'standard'： 專用服務，最多可有 12 個分割區和 12 個復本。 'standard2'：類似於標準，但每個搜尋單位的容量較多。 'standard3'：最大標準供應專案，最多可有 12 個分割區和 12 個復本（如果您也將 hostingMode 屬性設定為 'highDensity'，則最多 3 個具有更多索引的數據分割）。 'storage_optimized_l1'：支援每個分割區 1TB，最多 12 個分割區。 「storage_optimized_l2」：支援每個分割區 2TB，最多可支援 12 個分割區。 「無伺服器」：無伺服器層級，具備自動擴展功能。

值 Description
free

免費層，沒有 SLA 保證，以及計費層上所提供的功能子集。
basic

專用服務的計費層最多有 3 個複本。
standard

專用服務的計費層最多可有12個分割區和12個複本。
standard2

類似於「標準」，但每個搜尋單位的容量較多。
standard3

最大標準供應專案，最多可有12個分割區和12個複本（如果您也將hostingMode屬性設定為 'highDensity'，則最多3個具有更多索引的數據分割）。
storage_optimized_l1

專用服務的計費層支援每個分割區 1TB，最多 12 個分割區。
storage_optimized_l2

支援每個分割區 2TB 的專用服務計費層，最多 12 個分割區。
serverless

無伺服器層級，提供低接觸、以消費為基礎且隨用付費的體驗，並具備自動擴展功能。

SkuOffering

Object

描述特定區域內的 SKU 產品限制。

名稱 類型 Description
limits

SkuLimits

與此區域中提供的此 SKU 相關聯的限制。
sku

Sku

SKU 定義。