Microsoft.Search searchServices 2020-03-13

發行項
02/23/2025

Bicep 資源定義

searchServices 資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.Search/searchServices 資源，請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.Search/searchServices@2020-03-13' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    hostingMode: 'string'
    networkRuleSet: {
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

屬性值

身份

名字	描述	價值
類型	識別類型。	'None' 'SystemAssigned' （必要）

IpRule

名字	描述	價值
價值	對應至單一 IPv4 位址的值（例如 123.1.2.3）或 CIDR 格式的 IP 範圍（例如 123.1.2.3/24）。	字串

Microsoft.Search/searchServices

名字	描述	價值
身份	資源的身分識別。	身分識別
位置	資源的地理位置。這必須是支持和註冊的 Azure 地理區域之一（例如美國西部、美國東部、東南亞等等）。建立新資源時需要這個屬性。	字串
名字	資源名稱	字串（必要）
性能	搜尋服務的屬性。	SearchServiceProperties
sku	Search Service 的 SKU，決定價格區間和容量限制。建立新的搜尋服務時，需要這個屬性。	Sku
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤

NetworkRuleSet

名字	描述	價值
ipRules	IP 限制規則清單，定義允許存取搜尋服務端點的輸入網路。同時，所有其他公用IP網路都會遭到防火牆封鎖。只有在搜尋服務的 'publicNetworkAccess' 已啟用時，才會套用這些限制規則;否則，即使有任何公用IP規則，也不允許透過公用介面的流量，而私人端點聯機會是獨佔存取方法。	IpRule[]

ResourceTags

名字	描述	價值

SearchServiceProperties

名字	描述	價值
hostingMode	僅適用於 standard3 SKU。您可以設定此屬性來啟用最多 3 個高密度分割區，允許最多 1000 個索引，這遠高於任何其他 SKU 允許的最大索引。針對 standard3 SKU，此值為 'default' 或 'highDensity'。對於所有其他 SKU，此值必須是 'default'。	'default' 'highDensity'
networkRuleSet	決定如何觸達 Azure 認知搜尋服務的網路特定規則。	NetworkRuleSet
partitionCount	搜尋服務中的數據分割數目;如果指定，它可以是 1、2、3、4、6 或 12。大於 1 的值僅適用於標準 SKU。對於 hostingMode 設定為 'highDensity' 的 'standard3' 服務，允許的值介於 1 到 3 之間。	int 約束：最小值 = 1 最大值 = 12
publicNetworkAccess	此值可以設定為「已啟用」，以避免現有客戶資源和範本發生重大變更。如果設定為『disabled』，則不允許透過公用介面的流量，而私人端點聯機會是獨佔存取方法。	'disabled' 'enabled'
replicaCount	搜尋服務中的複本數目。如果指定，它必須是標準 SKU 的 1 到 12 之間的值，或基本 SKU 的 1 到 3 之間。	int 約束：最小值 = 1 最大值 = 12

Sku

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

使用範例

Azure 已驗證的模組

下列 Azure 驗證模組可用來部署此資源類型。

模組	描述
Search Service	搜尋服務的 AVM 資源模組

Azure 快速入門範例

下列 Azure 快速入門範本包含用於部署此資源類型的 Bicep 範例。

Bicep 檔案	描述
Azure AI Studio 網路限制	這組範本示範如何使用Microsoft受控密鑰來加密和 AI 資源的 Microsoft 受控識別組態，來設定已停用私人鏈接和輸出的 Azure AI Studio。
Azure 認知搜尋服務	此範本會建立 Azure 認知搜尋服務
具有使用者受控識別的網路保護代理程式	這組範本示範如何使用 AI 服務 / AOAI 連線的使用者受控識別驗證和專用網連結，設定具有虛擬網路隔離的 Azure AI 代理程式服務，以將代理程式連線到您的安全數據。
標準代理程式設定	這組範本示範如何使用標準設定來設定 Azure AI 代理程式服務，這表示已啟用專案/中樞連線和公用因特網存取的受控識別驗證。代理程式會使用客戶擁有的單一租用戶搜尋和記憶體資源。透過此設定，您可以完全控制這些資源並查看這些資源，但會根據您的使用量產生成本。

ARM 樣本資源定義

searchServices 資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.Search/searchServices 資源，請將下列 JSON 新增至範本。

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2020-03-13",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "hostingMode": "string",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "publicNetworkAccess": "string",
    "replicaCount": "int"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

身份

名字	描述	價值
類型	識別類型。	'None' 'SystemAssigned' （必要）

IpRule

名字	描述	價值
價值	對應至單一 IPv4 位址的值（例如 123.1.2.3）或 CIDR 格式的 IP 範圍（例如 123.1.2.3/24）。	字串

Microsoft.Search/searchServices

名字	描述	價值
apiVersion	API 版本	'2020-03-13'
身份	資源的身分識別。	身分識別
位置	資源的地理位置。這必須是支持和註冊的 Azure 地理區域之一（例如美國西部、美國東部、東南亞等等）。建立新資源時需要這個屬性。	字串
名字	資源名稱	字串（必要）
性能	搜尋服務的屬性。	SearchServiceProperties
sku	Search Service 的 SKU，決定價格區間和容量限制。建立新的搜尋服務時，需要這個屬性。	Sku
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤
類型	資源類型	'Microsoft.Search/searchServices'

NetworkRuleSet

名字	描述	價值
ipRules	IP 限制規則清單，定義允許存取搜尋服務端點的輸入網路。同時，所有其他公用IP網路都會遭到防火牆封鎖。只有在搜尋服務的 'publicNetworkAccess' 已啟用時，才會套用這些限制規則;否則，即使有任何公用IP規則，也不允許透過公用介面的流量，而私人端點聯機會是獨佔存取方法。	IpRule[]

ResourceTags

名字	描述	價值

SearchServiceProperties

名字	描述	價值
hostingMode	僅適用於 standard3 SKU。您可以設定此屬性來啟用最多 3 個高密度分割區，允許最多 1000 個索引，這遠高於任何其他 SKU 允許的最大索引。針對 standard3 SKU，此值為 'default' 或 'highDensity'。對於所有其他 SKU，此值必須是 'default'。	'default' 'highDensity'
networkRuleSet	決定如何觸達 Azure 認知搜尋服務的網路特定規則。	NetworkRuleSet
partitionCount	搜尋服務中的數據分割數目;如果指定，它可以是 1、2、3、4、6 或 12。大於 1 的值僅適用於標準 SKU。對於 hostingMode 設定為 'highDensity' 的 'standard3' 服務，允許的值介於 1 到 3 之間。	int 約束：最小值 = 1 最大值 = 12
publicNetworkAccess	此值可以設定為「已啟用」，以避免現有客戶資源和範本發生重大變更。如果設定為『disabled』，則不允許透過公用介面的流量，而私人端點聯機會是獨佔存取方法。	'disabled' 'enabled'
replicaCount	搜尋服務中的複本數目。如果指定，它必須是標準 SKU 的 1 到 12 之間的值，或基本 SKU 的 1 到 3 之間。	int 約束：最小值 = 1 最大值 = 12

Sku

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

使用範例

Azure 快速入門範本

下列 Azure 快速入門範本部署此資源類型。

範本	描述
Azure AI Studio 網路限制	這組範本示範如何使用Microsoft受控密鑰來加密和 AI 資源的 Microsoft 受控識別組態，來設定已停用私人鏈接和輸出的 Azure AI Studio。
Azure 認知搜尋服務	此範本會建立 Azure 認知搜尋服務
使用私人端點 Azure 認知搜尋服務	此範本會建立具有私人端點的 Azure 認知搜尋服務。
具有使用者受控識別的網路保護代理程式	這組範本示範如何使用 AI 服務 / AOAI 連線的使用者受控識別驗證和專用網連結，設定具有虛擬網路隔離的 Azure AI 代理程式服務，以將代理程式連線到您的安全數據。
標準代理程式設定	這組範本示範如何使用標準設定來設定 Azure AI 代理程式服務，這表示已啟用專案/中樞連線和公用因特網存取的受控識別驗證。代理程式會使用客戶擁有的單一租用戶搜尋和記憶體資源。透過此設定，您可以完全控制這些資源並查看這些資源，但會根據您的使用量產生成本。
使用 SQL Database、Azure Cosmos DB、Azure 搜尋服務 Web 應用程式	此範本會布建 Web 應用程式、SQL Database、Azure Cosmos DB、Azure 搜尋服務和 Application Insights。

Terraform （AzAPI 提供者）資源定義

searchServices 資源類型可以使用目標作業來部署：

資源群組

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.Search/searchServices 資源，請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2020-03-13"
  name = "string"
  identity = {
    type = "string"
  }
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
    }
  })
}

屬性值

身份

名字	描述	價值
類型	識別類型。	'None' 'SystemAssigned' （必要）

IpRule

名字	描述	價值
價值	對應至單一 IPv4 位址的值（例如 123.1.2.3）或 CIDR 格式的 IP 範圍（例如 123.1.2.3/24）。	字串

Microsoft.Search/searchServices

名字	描述	價值
身份	資源的身分識別。	身分識別
位置	資源的地理位置。這必須是支持和註冊的 Azure 地理區域之一（例如美國西部、美國東部、東南亞等等）。建立新資源時需要這個屬性。	字串
名字	資源名稱	字串（必要）
性能	搜尋服務的屬性。	SearchServiceProperties
sku	Search Service 的 SKU，決定價格區間和容量限制。建立新的搜尋服務時，需要這個屬性。	Sku
標籤	資源標籤	標記名稱和值的字典。
類型	資源類型	“Microsoft.Search/searchServices@2020-03-13”

NetworkRuleSet

名字	描述	價值
ipRules	IP 限制規則清單，定義允許存取搜尋服務端點的輸入網路。同時，所有其他公用IP網路都會遭到防火牆封鎖。只有在搜尋服務的 'publicNetworkAccess' 已啟用時，才會套用這些限制規則;否則，即使有任何公用IP規則，也不允許透過公用介面的流量，而私人端點聯機會是獨佔存取方法。	IpRule[]

ResourceTags

名字	描述	價值

SearchServiceProperties

名字	描述	價值
hostingMode	僅適用於 standard3 SKU。您可以設定此屬性來啟用最多 3 個高密度分割區，允許最多 1000 個索引，這遠高於任何其他 SKU 允許的最大索引。針對 standard3 SKU，此值為 'default' 或 'highDensity'。對於所有其他 SKU，此值必須是 'default'。	'default' 'highDensity'
networkRuleSet	決定如何觸達 Azure 認知搜尋服務的網路特定規則。	NetworkRuleSet
partitionCount	搜尋服務中的數據分割數目;如果指定，它可以是 1、2、3、4、6 或 12。大於 1 的值僅適用於標準 SKU。對於 hostingMode 設定為 'highDensity' 的 'standard3' 服務，允許的值介於 1 到 3 之間。	int 約束：最小值 = 1 最大值 = 12
publicNetworkAccess	此值可以設定為「已啟用」，以避免現有客戶資源和範本發生重大變更。如果設定為『disabled』，則不允許透過公用介面的流量，而私人端點聯機會是獨佔存取方法。	'disabled' 'enabled'
replicaCount	搜尋服務中的複本數目。如果指定，它必須是標準 SKU 的 1 到 12 之間的值，或基本 SKU 的 1 到 3 之間。	int 約束：最小值 = 1 最大值 = 12

Sku

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

使用範例

Azure 已驗證的模組

下列 Azure 驗證模組可用來部署此資源類型。

模組	描述
Search Service	搜尋服務的 AVM 資源模組

共用方式為

Microsoft.Search searchServices 2020-03-13

Bicep 資源定義

資源格式

屬性值

身份

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

使用範例

Azure 已驗證的模組

Azure 快速入門範例

ARM 樣本資源定義

資源格式

屬性值

身份

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

使用範例

Azure 快速入門範本

Terraform （AzAPI 提供者） 資源定義

資源格式

屬性值

身份

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

使用範例

Azure 已驗證的模組

意見反應

其他資源

Terraform （AzAPI 提供者）資源定義