SearchServiceProperties interface
検索サービスのプロパティ。
プロパティ
| auth |
検索サービスのデータ プレーン API が要求を認証する方法のオプションを定義します。 'disableLocalAuth' が true に設定されている場合、これは設定できません。 |
| compute |
既定のコンピューティングまたは Azure Confidential Compute を使用して検索サービスをサポートするように、このプロパティを構成します。 |
| data |
検索サービスに対して明示的に許可されていないデータ流出シナリオの一覧。 現在、サポートされる唯一の値は、将来計画されるより細かい制御を使用して、すべての可能なデータ エクスポート シナリオを無効にする 'All' です。 |
| disable |
true に設定すると、検索サービスの呼び出しで認証に API キーを使用することはできません。 'dataPlaneAuthOptions' が定義されている場合、これを true に設定することはできません。 |
| encryption |
検索サービス内でカスタマー マネージャー キーを使用するリソース (インデックスなど) の暗号化に関するポリシーを指定します。 |
| endpoint | Azure AI 検索 サービスのエンドポイント。 |
| e |
更新中にオプティミスティック コンカレンシー制御に使用できるサービスの etag を表すシステム生成プロパティ。 |
| hosting |
Standard3 SKU にのみ適用されます。 このプロパティを設定すると、最大 3 つの高密度パーティションを有効にして、最大 1,000 個のインデックスを使用できます。これは、他の SKU で許可されている最大インデックスよりもはるかに大きくなります。 standard3 SKU の場合、値は 'Default' または 'HighDensity' のいずれかです。 他のすべてのSKUの場合、この値は「デフォルト」である必要があります。 |
| knowledge |
Azure AI 検索サービス上のエージェント検索の請求プランを指定します。 この構成は特定の地域で特定の価格帯でのみ利用可能です。 |
| network |
Azure AI 検索 サービスに到達する方法を決定するネットワーク固有のルール。 |
| partition |
専用検索サービスのパーティション数;指定されれば、1、2、3、4、6、または12となります。 1 より大きい値は、標準 SKU でのみ有効です。 hostingMode が 'highDensity' に設定されている 'standard3' サービスの場合、許可される値は 1 から 3 の間です。 |
| private |
Azure AI 検索サービスへのプライベートエンドポイント接続のリスト。 |
| provisioning |
検索サービスで最後に実行されたプロビジョニング操作の状態。 プロビジョニングは、サービス容量の確立中に発生する中間状態です。 容量が設定されると、provisioningState が "Succeeded" または "Failed" に変わります。 クライアント アプリケーションは、Search Service の取得操作を使用して、プロビジョニングの状態 (推奨されるポーリング間隔は 30 秒から 1 分) をポーリングして、操作が完了したタイミングを確認できます。 無料サービスを使用している場合、この値は検索サービスの作成呼び出しで直接 "Succeeded" として返される傾向があります。 これは、無料サービスで既に設定されている容量が使用されるためです。 |
| public |
この値を '有効] に設定すると、既存の顧客リソースとテンプレートに対する重大な変更を回避できます。 「無効」に設定すると、パブリック インターフェイス経由のトラフィックは許可されず、プライベート エンドポイント接続が排他アクセス方法になります。 |
| replica |
専用検索サービス内のレプリカ数。 指定する場合は、標準 SKU の場合は 1 から 12 までの値、Basic SKU の場合は 1 ~ 3 の値にする必要があります。 |
| semantic |
Azure AI 検索サービスにおけるセマンティック検索の可用性および請求プランを規定しています。 この構成は特定の地域で特定の価格帯でのみ利用可能です。 |
| service |
検索サービスが最後にアップグレードされた日時。 このフィールドは、サービスが初めてアップグレードされるまで null になります。 |
| shared |
Azure AI 検索サービスによって管理されている共有プライベートリンクリソースのリスト。 |
| status | 検索サービスの状態。 可能な値は次のとおりです:"running": 検索サービスは実行中であり、プロビジョニング操作は進行中です。 'provisioning': 検索サービスがプロビジョニングまたはスケールアップまたはスケールダウンされています。 '削除中': 検索サービスが削除されています。 'degraded': 検索サービスが機能低下しています。 これは、基になる検索単位が正常でない場合に発生する可能性があります。 検索サービスは動作している可能性が最も高いですが、パフォーマンスが低下し、一部の要求が削除される可能性があります。 'disabled': 検索サービスが無効になっています。 この状態では、サービスはすべての API 要求を拒否します。 'error': 検索サービスがエラー状態です。 'stopped': 検索サービスが無効になっているサブスクリプション内にあります。 サービスが劣化、無効化、エラー状態にある場合、Azure AI 検索チームが根本的な問題を積極的に調査していることを意味します。 これらの状態の専用サービスは、プロビジョニングされた検索ユニットの数に基づいて引き続き課金されます。 |
| status |
検索サービスの状態の詳細。 |
| upgrade |
検索サービスにアップグレードが利用可能かどうかを示します。 |
プロパティの詳細
authOptions
検索サービスのデータ プレーン API が要求を認証する方法のオプションを定義します。 'disableLocalAuth' が true に設定されている場合、これは設定できません。
authOptions?: DataPlaneAuthOptions
プロパティ値
computeType
既定のコンピューティングまたは Azure Confidential Compute を使用して検索サービスをサポートするように、このプロパティを構成します。
computeType?: string
プロパティ値
string
dataExfiltrationProtections
検索サービスに対して明示的に許可されていないデータ流出シナリオの一覧。 現在、サポートされる唯一の値は、将来計画されるより細かい制御を使用して、すべての可能なデータ エクスポート シナリオを無効にする 'All' です。
dataExfiltrationProtections?: string[]
プロパティ値
string[]
disableLocalAuth
true に設定すると、検索サービスの呼び出しで認証に API キーを使用することはできません。 'dataPlaneAuthOptions' が定義されている場合、これを true に設定することはできません。
disableLocalAuth?: boolean
プロパティ値
boolean
encryptionWithCmk
検索サービス内でカスタマー マネージャー キーを使用するリソース (インデックスなど) の暗号化に関するポリシーを指定します。
encryptionWithCmk?: EncryptionWithCmk
プロパティ値
endpoint
Azure AI 検索 サービスのエンドポイント。
endpoint?: string
プロパティ値
string
eTag
更新中にオプティミスティック コンカレンシー制御に使用できるサービスの etag を表すシステム生成プロパティ。
eTag?: string
プロパティ値
string
hostingMode
Standard3 SKU にのみ適用されます。 このプロパティを設定すると、最大 3 つの高密度パーティションを有効にして、最大 1,000 個のインデックスを使用できます。これは、他の SKU で許可されている最大インデックスよりもはるかに大きくなります。 standard3 SKU の場合、値は 'Default' または 'HighDensity' のいずれかです。 他のすべてのSKUの場合、この値は「デフォルト」である必要があります。
hostingMode?: HostingMode
プロパティ値
knowledgeRetrieval
Azure AI 検索サービス上のエージェント検索の請求プランを指定します。 この構成は特定の地域で特定の価格帯でのみ利用可能です。
knowledgeRetrieval?: string
プロパティ値
string
networkRuleSet
partitionCount
専用検索サービスのパーティション数;指定されれば、1、2、3、4、6、または12となります。 1 より大きい値は、標準 SKU でのみ有効です。 hostingMode が 'highDensity' に設定されている 'standard3' サービスの場合、許可される値は 1 から 3 の間です。
partitionCount?: number
プロパティ値
number
privateEndpointConnections
Azure AI 検索サービスへのプライベートエンドポイント接続のリスト。
privateEndpointConnections?: PrivateEndpointConnection[]
プロパティ値
provisioningState
検索サービスで最後に実行されたプロビジョニング操作の状態。 プロビジョニングは、サービス容量の確立中に発生する中間状態です。 容量が設定されると、provisioningState が "Succeeded" または "Failed" に変わります。 クライアント アプリケーションは、Search Service の取得操作を使用して、プロビジョニングの状態 (推奨されるポーリング間隔は 30 秒から 1 分) をポーリングして、操作が完了したタイミングを確認できます。 無料サービスを使用している場合、この値は検索サービスの作成呼び出しで直接 "Succeeded" として返される傾向があります。 これは、無料サービスで既に設定されている容量が使用されるためです。
provisioningState?: ProvisioningState
プロパティ値
publicNetworkAccess
この値を '有効] に設定すると、既存の顧客リソースとテンプレートに対する重大な変更を回避できます。 「無効」に設定すると、パブリック インターフェイス経由のトラフィックは許可されず、プライベート エンドポイント接続が排他アクセス方法になります。
publicNetworkAccess?: string
プロパティ値
string
replicaCount
専用検索サービス内のレプリカ数。 指定する場合は、標準 SKU の場合は 1 から 12 までの値、Basic SKU の場合は 1 ~ 3 の値にする必要があります。
replicaCount?: number
プロパティ値
number
semanticSearch
Azure AI 検索サービスにおけるセマンティック検索の可用性および請求プランを規定しています。 この構成は特定の地域で特定の価格帯でのみ利用可能です。
semanticSearch?: string
プロパティ値
string
serviceUpgradedAt
検索サービスが最後にアップグレードされた日時。 このフィールドは、サービスが初めてアップグレードされるまで null になります。
serviceUpgradedAt?: Date
プロパティ値
Date
sharedPrivateLinkResources
Azure AI 検索サービスによって管理されている共有プライベートリンクリソースのリスト。
sharedPrivateLinkResources?: SharedPrivateLinkResource[]
プロパティ値
status
検索サービスの状態。 可能な値は次のとおりです:"running": 検索サービスは実行中であり、プロビジョニング操作は進行中です。 'provisioning': 検索サービスがプロビジョニングまたはスケールアップまたはスケールダウンされています。 '削除中': 検索サービスが削除されています。 'degraded': 検索サービスが機能低下しています。 これは、基になる検索単位が正常でない場合に発生する可能性があります。 検索サービスは動作している可能性が最も高いですが、パフォーマンスが低下し、一部の要求が削除される可能性があります。 'disabled': 検索サービスが無効になっています。 この状態では、サービスはすべての API 要求を拒否します。 'error': 検索サービスがエラー状態です。 'stopped': 検索サービスが無効になっているサブスクリプション内にあります。 サービスが劣化、無効化、エラー状態にある場合、Azure AI 検索チームが根本的な問題を積極的に調査していることを意味します。 これらの状態の専用サービスは、プロビジョニングされた検索ユニットの数に基づいて引き続き課金されます。
status?: SearchServiceStatus
プロパティ値
statusDetails
検索サービスの状態の詳細。
statusDetails?: string
プロパティ値
string
upgradeAvailable
検索サービスにアップグレードが利用可能かどうかを示します。
upgradeAvailable?: string
プロパティ値
string