Microsoft.Search searchServices 2019-10-01-preview

2025-05-14

Bicep リソース定義

searchServices リソースの種類は、次を対象とする操作と共にデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Search/searchServices リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Search/searchServices@2019-10-01-preview' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    hostingMode: 'string'
    networkRuleSet: {
      endpointAccess: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    replicaCount: int
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.Search/searchServices

名前	形容	価値
同一性	リソースの ID。	ID
場所	リソースの地理的な場所。これは、サポートされ、登録されている Azure Geo リージョンの 1 つである必要があります (たとえば、米国西部、米国東部、東南アジアなど)。このプロパティは、新しいリソースを作成するときに必要です。	糸
名前	リソース名	string (必須)
プロパティ	Search サービスのプロパティ。	SearchServiceプロパティ
エスケーユー	価格レベルと容量の制限を決定する Search Service の SKU。このプロパティは、新しい Search Service を作成するときに必要です。	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

同一性

名前	形容	価値
種類	ID の種類。	「なし」 'SystemAssigned' (必須)

Ipルール

名前	形容	価値
価値	1 つの IPv4 アドレス (例: 123.1.2.3) または CIDR 形式の IP 範囲 (例: 123.1.2.3/24) に対応する値。	糸

ネットワークルールセット

名前	形容	価値
エンドポイントアクセス	検索サービスエンドポイントへのアクセスレベル。パブリック、検索サービスエンドポイントはインターネットから到達可能です。プライベート。検索サービスエンドポイントには、プライベートエンドポイント経由でのみアクセスできます。既定値は Public です。	「プライベート」「パブリック」
ipルール	検索サービスエンドポイントへの受信ネットワークアクセスを定義する IP 制限規則の一覧。これらの制限規則は、検索サービスの EndpointAccess がパブリックである場合にのみ適用されます。	Ipルール[]

リソースタグ

名前	形容	価値

SearchServiceプロパティ

名前	形容	価値
ホスティングモード	Standard3 SKU にのみ適用されます。このプロパティを設定すると、最大 3 つの高密度パーティションを有効にして、最大 1,000 個のインデックスを使用できます。これは、他の SKU で許可されている最大インデックスよりもはるかに大きくなります。 standard3 SKU の場合、値は 'default' または 'highDensity' です。他のすべての SKU の場合、この値は 'default' である必要があります。	'デフォルト' 「高密度」
ネットワークルールセット	Azure Cognitive Search サービスに到達する方法を決定するネットワーク固有のルール。	ネットワークルールセット
パーティション数	Search サービス内のパーティションの数。指定する場合は、1、2、3、4、6、または 12 にすることができます。 1 より大きい値は、標準 SKU でのみ有効です。 hostingMode が 'highDensity' に設定されている 'standard3' サービスの場合、許可される値は 1 から 3 の間です。	int 制約：最小値 = 1 最大値 = 12
replicaCount (レプリカ数)	Search サービス内のレプリカの数。指定する場合は、標準 SKU の場合は 1 から 12 までの値、Basic SKU の場合は 1 ~ 3 の値にする必要があります。	int 制約：最小値 = 1 最大値 = 12

SKU

名前	形容	価値
名前	Search サービスの SKU。有効な値には、'free': 共有サービスが含まれます。 "basic": 最大 3 つのレプリカを含む専用サービス。 'standard': 最大 12 個のパーティションと 12 個のレプリカを持つ専用サービス。 'standard2': 標準に似ていますが、検索ユニットあたりの容量が多くなります。 'standard3': 最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックスが多い最大 3 つのパーティション)。 'storage_optimized_l1': パーティションあたり 1 TB、最大 12 個のパーティションをサポートします。 'storage_optimized_l2': パーティションあたり 2 TB、最大 12 個のパーティションをサポートします。	「ベーシック」「無料」「スタンダード」「スタンダード2」 'スタンダード3' 「storage_optimized_l1」「storage_optimized_l2」

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュールを使用して、このリソースの種類をデプロイできます。

モジュール	形容
検索サービス	Search Service 用 AVM リソースモジュール

Azure クイックスタートのサンプル

次 Azure クイックスタートテンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	形容
Azure AI Foundry Network の制限付き	このテンプレートセットは、暗号化に Microsoft が管理するキーと AI リソースの Microsoft が管理する ID 構成を使用して、プライベートリンクとエグレスを無効にして Azure AI Foundry を設定する方法を示しています。
Azure Cognitive Search サービスの	このテンプレートは、Azure Cognitive Search サービスを作成します
ユーザーマネージド ID を使用してネットワークセキュリティで保護されたエージェントをする	この一連のテンプレートでは、AI サービス/AOAI 接続用のユーザーマネージド ID 認証とプライベートネットワークリンクを使用して仮想ネットワーク分離を使用して Azure AI エージェントサービスを設定し、エージェントをセキュリティで保護されたデータに接続する方法を示します。
Standard エージェントのセットアップ	この一連のテンプレートは、標準セットアップで Azure AI Agent Service を設定する方法を示しています。つまり、プロジェクト/ハブ接続のマネージド ID 認証とパブリックインターネットアクセスが有効になっています。エージェントは、顧客所有のシングルテナント検索およびストレージリソースを使用します。このセットアップでは、これらのリソースを完全に制御して表示できますが、使用量に基づいてコストが発生します。

ARM テンプレートリソース定義

searchServices リソースの種類は、次を対象とする操作と共にデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Search/searchServices リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2019-10-01-preview",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "hostingMode": "string",
    "networkRuleSet": {
      "endpointAccess": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "replicaCount": "int"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.Search/searchServices

名前	形容	価値
apiVersion (英語)	API のバージョン	'2019-10-01-プレビュー'
同一性	リソースの ID。	ID
場所	リソースの地理的な場所。これは、サポートされ、登録されている Azure Geo リージョンの 1 つである必要があります (たとえば、米国西部、米国東部、東南アジアなど)。このプロパティは、新しいリソースを作成するときに必要です。	糸
名前	リソース名	string (必須)
プロパティ	Search サービスのプロパティ。	SearchServiceプロパティ
エスケーユー	価格レベルと容量の制限を決定する Search Service の SKU。このプロパティは、新しい Search Service を作成するときに必要です。	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
種類	リソースの種類	'Microsoft.Search/searchServices'

同一性

名前	形容	価値
種類	ID の種類。	「なし」 'SystemAssigned' (必須)

Ipルール

名前	形容	価値
価値	1 つの IPv4 アドレス (例: 123.1.2.3) または CIDR 形式の IP 範囲 (例: 123.1.2.3/24) に対応する値。	糸

ネットワークルールセット

名前	形容	価値
エンドポイントアクセス	検索サービスエンドポイントへのアクセスレベル。パブリック、検索サービスエンドポイントはインターネットから到達可能です。プライベート。検索サービスエンドポイントには、プライベートエンドポイント経由でのみアクセスできます。既定値は Public です。	「プライベート」「パブリック」
ipルール	検索サービスエンドポイントへの受信ネットワークアクセスを定義する IP 制限規則の一覧。これらの制限規則は、検索サービスの EndpointAccess がパブリックである場合にのみ適用されます。	Ipルール[]

リソースタグ

名前	形容	価値

SearchServiceプロパティ

名前	形容	価値
ホスティングモード	Standard3 SKU にのみ適用されます。このプロパティを設定すると、最大 3 つの高密度パーティションを有効にして、最大 1,000 個のインデックスを使用できます。これは、他の SKU で許可されている最大インデックスよりもはるかに大きくなります。 standard3 SKU の場合、値は 'default' または 'highDensity' です。他のすべての SKU の場合、この値は 'default' である必要があります。	'デフォルト' 「高密度」
ネットワークルールセット	Azure Cognitive Search サービスに到達する方法を決定するネットワーク固有のルール。	ネットワークルールセット
パーティション数	Search サービス内のパーティションの数。指定する場合は、1、2、3、4、6、または 12 にすることができます。 1 より大きい値は、標準 SKU でのみ有効です。 hostingMode が 'highDensity' に設定されている 'standard3' サービスの場合、許可される値は 1 から 3 の間です。	int 制約：最小値 = 1 最大値 = 12
replicaCount (レプリカ数)	Search サービス内のレプリカの数。指定する場合は、標準 SKU の場合は 1 から 12 までの値、Basic SKU の場合は 1 ~ 3 の値にする必要があります。	int 制約：最小値 = 1 最大値 = 12

SKU

名前	形容	価値
名前	Search サービスの SKU。有効な値には、'free': 共有サービスが含まれます。 "basic": 最大 3 つのレプリカを含む専用サービス。 'standard': 最大 12 個のパーティションと 12 個のレプリカを持つ専用サービス。 'standard2': 標準に似ていますが、検索ユニットあたりの容量が多くなります。 'standard3': 最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックスが多い最大 3 つのパーティション)。 'storage_optimized_l1': パーティションあたり 1 TB、最大 12 個のパーティションをサポートします。 'storage_optimized_l2': パーティションあたり 2 TB、最大 12 個のパーティションをサポートします。	「ベーシック」「無料」「スタンダード」「スタンダード2」 'スタンダード3' 「storage_optimized_l1」「storage_optimized_l2」

使用例

Azure クイックスタートテンプレート

このリソースの種類デプロイする Azure クイックスタートテンプレート次に示します。

テンプレート	形容
Azure AI Foundry Network の制限付き Azure にデプロイする	このテンプレートセットは、暗号化に Microsoft が管理するキーと AI リソースの Microsoft が管理する ID 構成を使用して、プライベートリンクとエグレスを無効にして Azure AI Foundry を設定する方法を示しています。
Azure Cognitive Search サービスの Azure にデプロイする	このテンプレートは、Azure Cognitive Search サービスを作成します
プライベートエンドポイントを使用して Azure Cognitive Search サービスをする Azure にデプロイする	このテンプレートは、プライベートエンドポイントを使用して Azure Cognitive Search サービスを作成します。
ユーザーマネージド ID を使用してネットワークセキュリティで保護されたエージェントをする Azure にデプロイする	この一連のテンプレートでは、AI サービス/AOAI 接続用のユーザーマネージド ID 認証とプライベートネットワークリンクを使用して仮想ネットワーク分離を使用して Azure AI エージェントサービスを設定し、エージェントをセキュリティで保護されたデータに接続する方法を示します。
Standard エージェントのセットアップ Azure にデプロイする	この一連のテンプレートは、標準セットアップで Azure AI Agent Service を設定する方法を示しています。つまり、プロジェクト/ハブ接続のマネージド ID 認証とパブリックインターネットアクセスが有効になっています。エージェントは、顧客所有のシングルテナント検索およびストレージリソースを使用します。このセットアップでは、これらのリソースを完全に制御して表示できますが、使用量に基づいてコストが発生します。
SQL Database、Azure Cosmos DB、Azure Search を使用した Web アプリの Azure にデプロイする	このテンプレートは、Web アプリ、SQL Database、Azure Cosmos DB、Azure Search、Application Insights をプロビジョニングします。

Terraform (AzAPI プロバイダー) リソース定義

searchServices リソースの種類は、次を対象とする操作と共にデプロイできます。

リソースグループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Search/searchServices リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2019-10-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      hostingMode = "string"
      networkRuleSet = {
        endpointAccess = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      replicaCount = int
    }
    sku = {
      name = "string"
    }
  }
}

プロパティ値

Microsoft.Search/searchServices

名前	形容	価値
同一性	リソースの ID。	ID
場所	リソースの地理的な場所。これは、サポートされ、登録されている Azure Geo リージョンの 1 つである必要があります (たとえば、米国西部、米国東部、東南アジアなど)。このプロパティは、新しいリソースを作成するときに必要です。	糸
名前	リソース名	string (必須)
プロパティ	Search サービスのプロパティ。	SearchServiceプロパティ
エスケーユー	価格レベルと容量の制限を決定する Search Service の SKU。このプロパティは、新しい Search Service を作成するときに必要です。	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。
種類	リソースの種類	「Microsoft.Search/searchServices@2019-10-01-preview」

同一性

名前	形容	価値
種類	ID の種類。	「なし」 'SystemAssigned' (必須)

Ipルール

名前	形容	価値
価値	1 つの IPv4 アドレス (例: 123.1.2.3) または CIDR 形式の IP 範囲 (例: 123.1.2.3/24) に対応する値。	糸

ネットワークルールセット

名前	形容	価値
エンドポイントアクセス	検索サービスエンドポイントへのアクセスレベル。パブリック、検索サービスエンドポイントはインターネットから到達可能です。プライベート。検索サービスエンドポイントには、プライベートエンドポイント経由でのみアクセスできます。既定値は Public です。	「プライベート」「パブリック」
ipルール	検索サービスエンドポイントへの受信ネットワークアクセスを定義する IP 制限規則の一覧。これらの制限規則は、検索サービスの EndpointAccess がパブリックである場合にのみ適用されます。	Ipルール[]

リソースタグ

名前	形容	価値

SearchServiceプロパティ

名前	形容	価値
ホスティングモード	Standard3 SKU にのみ適用されます。このプロパティを設定すると、最大 3 つの高密度パーティションを有効にして、最大 1,000 個のインデックスを使用できます。これは、他の SKU で許可されている最大インデックスよりもはるかに大きくなります。 standard3 SKU の場合、値は 'default' または 'highDensity' です。他のすべての SKU の場合、この値は 'default' である必要があります。	'デフォルト' 「高密度」
ネットワークルールセット	Azure Cognitive Search サービスに到達する方法を決定するネットワーク固有のルール。	ネットワークルールセット
パーティション数	Search サービス内のパーティションの数。指定する場合は、1、2、3、4、6、または 12 にすることができます。 1 より大きい値は、標準 SKU でのみ有効です。 hostingMode が 'highDensity' に設定されている 'standard3' サービスの場合、許可される値は 1 から 3 の間です。	int 制約：最小値 = 1 最大値 = 12
replicaCount (レプリカ数)	Search サービス内のレプリカの数。指定する場合は、標準 SKU の場合は 1 から 12 までの値、Basic SKU の場合は 1 ~ 3 の値にする必要があります。	int 制約：最小値 = 1 最大値 = 12

SKU

名前	形容	価値
名前	Search サービスの SKU。有効な値には、'free': 共有サービスが含まれます。 "basic": 最大 3 つのレプリカを含む専用サービス。 'standard': 最大 12 個のパーティションと 12 個のレプリカを持つ専用サービス。 'standard2': 標準に似ていますが、検索ユニットあたりの容量が多くなります。 'standard3': 最大 12 個のパーティションと 12 個のレプリカを備えた最大の Standard オファリング (hostingMode プロパティも 'highDensity' に設定した場合は、インデックスが多い最大 3 つのパーティション)。 'storage_optimized_l1': パーティションあたり 1 TB、最大 12 個のパーティションをサポートします。 'storage_optimized_l2': パーティションあたり 2 TB、最大 12 個のパーティションをサポートします。	「ベーシック」「無料」「スタンダード」「スタンダード2」 'スタンダード3' 「storage_optimized_l1」「storage_optimized_l2」

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュールを使用して、このリソースの種類をデプロイできます。

モジュール	形容
検索サービス	Search Service 用 AVM リソースモジュール

次の方法で共有

Microsoft.Search searchServices 2019-10-01-preview

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.Search/searchServices

同一性

Ipルール

ネットワークルールセット

リソースタグ

SearchServiceプロパティ

SKU

使用例

Azure 検証済みモジュール

Azure クイック スタートのサンプル

ARM テンプレート リソース定義

リソースの形式

プロパティ値

Microsoft.Search/searchServices

同一性

Ipルール

ネットワークルールセット

リソースタグ

SearchServiceプロパティ

SKU

使用例

Azure クイック スタート テンプレート

Terraform (AzAPI プロバイダー) リソース定義

リソースの形式

プロパティ値

Microsoft.Search/searchServices

同一性

Ipルール

ネットワークルールセット

リソースタグ

SearchServiceプロパティ

SKU

使用例

Azure 検証済みモジュール

フィードバック

その他のリソース

Azure クイックスタートのサンプル

ARM テンプレートリソース定義

Azure クイックスタートテンプレート