Microsoft.Search searchサービス 2020-08-01

2025-05-15

Bicep リソース定義

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

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

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

リソースの形式

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

resource symbolicname 'Microsoft.Search/searchServices@2020-08-01' = {
  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'
  }
}

プロパティ値

Microsoft.Search/searchServices

名前	形容	価値
同一性	リソースの ID。	ID
場所	リソースが存在する地理的な場所	string (必須)
名前	リソース名	string (必須)
プロパティ	検索サービスのプロパティ。	SearchServiceプロパティ
エスケーユー	価格レベルと容量の制限を決定する Search Service の SKU。このプロパティは、新しい Search Service を作成するときに必要です。	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

同一性

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

Ipルール

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

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

名前	形容	価値
ipルール	検索サービスエンドポイントへのアクセスを許可する受信ネットワークを定義する IP 制限規則の一覧。それまでは、他のすべてのパブリック IP ネットワークがファイアウォールによってブロックされます。これらの制限規則は、検索サービスの 'publicNetworkAccess' が '有効' の場合にのみ適用されます。それ以外の場合、パブリック IP ルールを使用してもパブリックインターフェイス経由のトラフィックは許可されず、プライベートエンドポイント接続は排他的アクセス方法になります。	Ipルール[]

SearchServiceプロパティ

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

SKU

名前	形容	価値
名前	検索サービスの 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": "2020-08-01",
  "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"
  }
}

プロパティ値

Microsoft.Search/searchServices

名前	形容	価値
apiVersion (英語)	API のバージョン	'2020-08-01'
同一性	リソースの ID。	ID
場所	リソースが存在する地理的な場所	string (必須)
名前	リソース名	string (必須)
プロパティ	検索サービスのプロパティ。	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) に対応する値。	糸

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

名前	形容	価値
ipルール	検索サービスエンドポイントへのアクセスを許可する受信ネットワークを定義する IP 制限規則の一覧。それまでは、他のすべてのパブリック IP ネットワークがファイアウォールによってブロックされます。これらの制限規則は、検索サービスの 'publicNetworkAccess' が '有効' の場合にのみ適用されます。それ以外の場合、パブリック IP ルールを使用してもパブリックインターフェイス経由のトラフィックは許可されず、プライベートエンドポイント接続は排他的アクセス方法になります。	Ipルール[]

SearchServiceプロパティ

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

SKU

名前	形容	価値
名前	検索サービスの 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@2020-08-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
    }
    sku = {
      name = "string"
    }
  }
}

プロパティ値

Microsoft.Search/searchServices

名前	形容	価値
同一性	リソースの ID。	ID
場所	リソースが存在する地理的な場所	string (必須)
名前	リソース名	string (必須)
プロパティ	検索サービスのプロパティ。	SearchServiceプロパティ
エスケーユー	価格レベルと容量の制限を決定する Search Service の SKU。このプロパティは、新しい Search Service を作成するときに必要です。	SKU
タグ	リソースタグ	タグ名と値のディクショナリ。
種類	リソースの種類	"Microsoft.Search/searchServices@2020-08-01"

同一性

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

Ipルール

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

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

名前	形容	価値
ipルール	検索サービスエンドポイントへのアクセスを許可する受信ネットワークを定義する IP 制限規則の一覧。それまでは、他のすべてのパブリック IP ネットワークがファイアウォールによってブロックされます。これらの制限規則は、検索サービスの 'publicNetworkAccess' が '有効' の場合にのみ適用されます。それ以外の場合、パブリック IP ルールを使用してもパブリックインターフェイス経由のトラフィックは許可されず、プライベートエンドポイント接続は排他的アクセス方法になります。	Ipルール[]

SearchServiceプロパティ

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

SKU

名前	形容	価値
名前	検索サービスの 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 searchサービス 2020-08-01

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 クイックスタートテンプレート