Knowledge Sources - Get

Bir bilgi kaynağı tanımı alır.

GET {endpoint}/knowledgesources('{sourceName}')?api-version=2026-04-01

URI Parametreleri

Name İçinde Gerekli Tür Description
endpoint
path True

string (uri)

Arama hizmetinin uç nokta URL'si.

sourceName
path True

string

Bilgi kaynağının adı.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Name Gerekli Tür Description
Accept

Accept

Kabul Et başlığı.

x-ms-client-request-id

string (uuid)

İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı.

Yanıtlar

Name Tür Description
200 OK KnowledgeSource:

İstek başarılı oldu.

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

api-key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

Name Description
https://search.azure.com/.default

Örnekler

SearchServiceGetKnowledgeSource
SearchServiceGetKnowledgeSourceAzureBlob
SearchServiceGetKnowledgeSourceIndexedOneLake
SearchServiceGetKnowledgeSourceWeb

SearchServiceGetKnowledgeSource

Örnek isteği

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Örnek yanıt

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "example-index",
    "semanticConfigurationName": "testconfig",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ]
  }
}

SearchServiceGetKnowledgeSourceAzureBlob

Örnek isteği

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Örnek yanıt

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-5-nano"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "dataSourceConnection": "ks-example-index-datasource",
      "indexer": "ks-example-index-indexer",
      "skillset": "ks-example-index-skillset",
      "index": "ks-example-index-index"
    }
  }
}

SearchServiceGetKnowledgeSourceIndexedOneLake

Örnek isteği

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Örnek yanıt

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "indexedOneLake",
  "description": "Description of the OneLake knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "<redacted>",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-5-nano"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "dataSourceConnection": "ks-example-index-datasource",
      "indexer": "ks-example-index-indexer",
      "skillset": "ks-example-index-skillset",
      "index": "ks-example-index-index"
    }
  }
}

SearchServiceGetKnowledgeSourceWeb

Örnek isteği

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Örnek yanıt

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "web",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  }
}

Tanımlar

Name Description
Accept

Kabul Et başlığı.

AIServices

Yapay Zeka Hizmetleri için Parametreler.

AzureBlobKnowledgeSource

Azure Blob Depolama bilgi kaynağı yapılandırması.

AzureBlobKnowledgeSourceParameters

Azure Blob Depolama bilgi kaynağı için parametreler.

AzureOpenAIModelName

Çağrılacak Azure Open AI model adı.

AzureOpenAIVectorizerParameters

Azure OpenAI kaynağına bağlanmak için parametreleri belirtir.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

IndexedOneLakeKnowledgeSource

OneLake bilgi kaynağı için yapılandırma.

IndexedOneLakeKnowledgeSourceParameters

OneLake bilgi kaynağı için parametreler.

IndexingSchedule

Dizin oluşturucu yürütme zamanlamasını temsil eder.

KnowledgeBaseAzureOpenAIModel

Sorgu planlaması yapmak için kullanılan Azure OpenAI kaynağını belirtir.

KnowledgeBaseModelKind

Sorgu planlaması için kullanılacak yapay zeka modeli.

KnowledgeSourceAzureOpenAIVectorizer

Bir sorgu dizesini vektörleştirmek için kullanılan Azure OpenAI kaynağını belirtir.

KnowledgeSourceIngestionParameters

Bilgi kaynakları için tüm genel alım ayarlarını birleştirir.

KnowledgeSourceKind

Bilgi kaynağının türü.

SearchIndexerDataNoneIdentity

Veri kaynağının kimlik özelliğini temizler.

SearchIndexerDataUserAssignedIdentity

Kullanılacak veri kaynağının kimliğini belirtir.

SearchIndexFieldReference

Arama dizini için alan referansı.

SearchIndexKnowledgeSource

Bir arama dizinini hedefleyen Bilgi Kaynağı.

SearchIndexKnowledgeSourceParameters

Arama dizini bilgi kaynağı için parametreler.

SearchResourceEncryptionKey

Azure Key Vault'ta müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.

VectorSearchVectorizerKind

Sorgu sırasında kullanılacak vektörleştirme yöntemi.

WebKnowledgeSource

Web sonuçlarını hedefleyen Bilgi Kaynağı.

WebKnowledgeSourceDomain

Web bilgi kaynağı etki alanı için yapılandırma.

WebKnowledgeSourceDomains

Web bilgi kaynağı için etki alanı izin verme/engelleme yapılandırması.

WebKnowledgeSourceParameters

Web bilgi kaynağı için parametreler.

Accept

Kabul Et başlığı.

Değer Description
application/json;odata.metadata=minimal

AIServices

Yapay Zeka Hizmetleri için Parametreler.

Name Tür Description
apiKey

string

AI Hizmetlerine erişim için API anahtarı.

uri

string (uri)

AI Hizmetleri uç noktasının URI'si.

AzureBlobKnowledgeSource

Azure Blob Depolama bilgi kaynağı yapılandırması.

Name Tür Description
@odata.etag

string

Bilgi kaynağının ETag'ı.

azureBlobParameters

AzureBlobKnowledgeSourceParameters

Bilgi kaynağının türü.

description

string

İsteğe bağlı kullanıcı tanımlı açıklama.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.

kind string:

azureBlob

Bilgi kaynağının türü.

name

string

Bilgi kaynağının adı.

AzureBlobKnowledgeSourceParameters

Azure Blob Depolama bilgi kaynağı için parametreler.

Name Tür Default value Description
connectionString

string

Anahtar tabanlı bağlantı dizesi veya yönetilen kimlik kullanılıyorsa ResourceId biçimi.

containerName

string

Blob depolama kapsayıcısının adı.

createdResources

object

Bilgi kaynağı tarafından oluşturulan kaynaklar.

folderPath

string

Kapsayıcı içindeki isteğe bağlı klasör yolu.

ingestionParameters

KnowledgeSourceIngestionParameters

Tüm genel alım ayarlarını birleştirir.

isADLSGen2

boolean

False

ADLS Gen2 depolama hesabına bağlanıyorsanız true olarak ayarlayın. Varsayılan değer false'tur.

AzureOpenAIModelName

Çağrılacak Azure Open AI model adı.

Değer Description
text-embedding-ada-002

TextEmbeddingAda002 modeli.

text-embedding-3-large

TextEmbedding3Large modeli.

text-embedding-3-small

TextEmbedding3Small modeli.

gpt-5-mini

Gpt5Mini modeli.

gpt-5-nano

Gpt5Nano modeli.

gpt-5.4-mini

Gpt54Mini modeli.

gpt-5.4-nano

Gpt54Nano modeli.

AzureOpenAIVectorizerParameters

Azure OpenAI kaynağına bağlanmak için parametreleri belirtir.

Name Tür Description
apiKey

string

Belirlenen Azure OpenAI kaynağının API anahtarı.

authIdentity SearchIndexerDataIdentity:

Giden bağlantılar için kullanılan kullanıcı tarafından atanan yönetilen kimlik.

deploymentId

string

Belirlenen kaynakta Azure OpenAI modeli dağıtımının kimliği.

modelName

AzureOpenAIModelName

Sağlanan deploymentId yolunda dağıtılan ekleme modelinin adı.

resourceUri

string (uri)

Azure OpenAI kaynağının kaynak URI'si.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi

ErrorResponse

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

Name Tür Description
error

ErrorDetail

Hata nesnesi.

IndexedOneLakeKnowledgeSource

OneLake bilgi kaynağı için yapılandırma.

Name Tür Description
@odata.etag

string

Bilgi kaynağının ETag'ı.

description

string

İsteğe bağlı kullanıcı tanımlı açıklama.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.

indexedOneLakeParameters

IndexedOneLakeKnowledgeSourceParameters

Bilgi kaynağı için parametreler.

kind string:

indexedOneLake

Bilgi kaynağının türü.

name

string

Bilgi kaynağının adı.

IndexedOneLakeKnowledgeSourceParameters

OneLake bilgi kaynağı için parametreler.

Name Tür Description
createdResources

object

Bilgi kaynağı tarafından oluşturulan kaynaklar.

fabricWorkspaceId

string

OneLake çalışma alanı kimliği.

ingestionParameters

KnowledgeSourceIngestionParameters

Tüm genel alım ayarlarını birleştirir.

lakehouseId

string

Hangi OneLake göl evine erişileceğini belirtir.

targetPath

string

OneLake içeriğini filtrelemek için isteğe bağlı OneLakehouse klasörü veya kısayolu.

IndexingSchedule

Dizin oluşturucu yürütme zamanlamasını temsil eder.

Name Tür Description
interval

string (duration)

Dizin oluşturucu yürütmeleri arasındaki zaman aralığı.

startTime

string (date-time)

Dizin oluşturucunun çalışmaya başlaması gereken zaman.

KnowledgeBaseAzureOpenAIModel

Sorgu planlaması yapmak için kullanılan Azure OpenAI kaynağını belirtir.

Name Tür Description
azureOpenAIParameters

AzureOpenAIVectorizerParameters

Azure OpenAI parametreleri.

kind string:

azureOpenAI

Sorgu planlaması için kullanılacak yapay zeka modeli.

KnowledgeBaseModelKind

Sorgu planlaması için kullanılacak yapay zeka modeli.

Değer Description
azureOpenAI

Sorgu planlaması için Azure Open AI modellerini kullanın.

KnowledgeSourceAzureOpenAIVectorizer

Bir sorgu dizesini vektörleştirmek için kullanılan Azure OpenAI kaynağını belirtir.

Name Tür Description
azureOpenAIParameters

AzureOpenAIVectorizerParameters

Azure OpenAI katıştırma vektörleştirmesine özgü parametreleri içerir.

kind string:

azureOpenAI

Vektör aramasıyla kullanılmak üzere yapılandırılan vektörleştirme yönteminin adı.

KnowledgeSourceIngestionParameters

Bilgi kaynakları için tüm genel alım ayarlarını birleştirir.

Name Tür Default value Description
aiServices

AIServices

İçerik işleme için isteğe bağlı AI Hizmetleri yapılandırması.

chatCompletionModel KnowledgeBaseModel:

KnowledgeBaseAzureOpenAIModel

Görüntü sözlüleştirme veya bağlam çıkarma için isteğe bağlı sohbet tamamlama modeli.

contentExtractionMode enum:
  • minimal
  • standard
minimal

İsteğe bağlı içerik çıkarma modu. Varsayılan değer 'minimal'dir.

disableImageVerbalization

boolean

False

Görüntü sözlülüğünün devre dışı bırakılması gerekip gerekmediğini belirtir. Varsayılan değer false'tur.

embeddingModel KnowledgeSourceVectorizer:

KnowledgeSourceAzureOpenAIVectorizer

İçeriği vektörleştirmek için isteğe bağlı vektörleştirici yapılandırması.

identity SearchIndexerDataIdentity:

Bu bilgi kaynağı için kullanılacak açık bir kimlik.

ingestionSchedule

IndexingSchedule

Veri alımı için isteğe bağlı zamanlama.

KnowledgeSourceKind

Bilgi kaynağının türü.

Değer Description
searchIndex

Bir Arama Dizini'nden veri okuyan bir bilgi kaynağı.

azureBlob

Azure Blob Depolama'dan bir Arama Dizini'ne veri okuyan ve alan bir bilgi kaynağı.

indexedOneLake

Indekslenmiş OneLake'den veri okuyan bir bilgi kaynağı.

web

Web'den veri okuyan bir bilgi kaynağı.

SearchIndexerDataNoneIdentity

Veri kaynağının kimlik özelliğini temizler.

Name Tür Description
@odata.type string:

#Microsoft.Azure.Search.DataNoneIdentity

Kimlik türünü belirten bir URI parçası.

SearchIndexerDataUserAssignedIdentity

Kullanılacak veri kaynağının kimliğini belirtir.

Name Tür Description
@odata.type string:

#Microsoft.Azure.Search.DataUserAssignedIdentity

Kimlik türünü belirten bir URI parçası.

userAssignedIdentity

string

Kullanıcı tarafından atanan yönetilen kimliğin tam Azure kaynak kimliği genellikle arama hizmetine atanması gereken "/subscriptions/12345678-1234-1234-1234-123467890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" biçimindedir.

SearchIndexFieldReference

Arama dizini için alan referansı.

Name Tür Description
name

string

Alanın adı.

SearchIndexKnowledgeSource

Bir arama dizinini hedefleyen Bilgi Kaynağı.

Name Tür Description
@odata.etag

string

Bilgi kaynağının ETag'ı.

description

string

İsteğe bağlı kullanıcı tanımlı açıklama.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.

kind string:

searchIndex

Bilgi kaynağının türü.

name

string

Bilgi kaynağının adı.

searchIndexParameters

SearchIndexKnowledgeSourceParameters

Bilgi kaynağı için parametreler.

SearchIndexKnowledgeSourceParameters

Arama dizini bilgi kaynağı için parametreler.

Name Tür Description
searchFields

SearchIndexFieldReference[]

Arama dizininde hangi alanların aranacağını kısıtlamak için kullanılır.

searchIndexName

string

Arama dizininin adı.

semanticConfigurationName

string

Hedef arama dizininde varsayılandan farklı bir anlamsal yapılandırma belirtmek için kullanılır.

sourceDataFields

SearchIndexFieldReference[]

Başvurulan kaynak veriler için ek alanlar istemek için kullanılır.

SearchResourceEncryptionKey

Azure Key Vault'ta müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.

Name Tür Description
accessCredentials.applicationId

string

Bekleyen verilerinizi şifrelerken kullanılacak Azure Key Vault'a gerekli erişim izinleri verilmiş bir AAD Uygulama Kimliği. Uygulama Kimliği, AAD Uygulamanızın Nesne Kimliği ile karıştırılmamalıdır.

accessCredentials.applicationSecret

string

Belirtilen AAD uygulamasının kimlik doğrulama anahtarı.

identity SearchIndexerDataIdentity:

Bu şifreleme anahtarı için kullanılacak açık bir yönetilen kimlik. Belirtilmezse ve erişim kimlik bilgileri özelliği null ise, sistem tarafından atanan yönetilen kimlik kullanılır. Kaynağa güncelleştirildiğinde, açık kimlik belirtilmezse değişmeden kalır. "Hiçbiri" belirtilirse, bu özelliğin değeri temizlenir.

keyVaultKeyName

string

Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın adı.

keyVaultKeyVersion

string

Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın sürümü.

keyVaultUri

string

Bekleyen verilerinizi şifrelemek için kullanılacak anahtarı içeren, DNS adı olarak da adlandırılan Azure Key Vault URI'sidir. Örnek bir URI https://my-keyvault-name.vault.azure.netolabilir.

VectorSearchVectorizerKind

Sorgu sırasında kullanılacak vektörleştirme yöntemi.

Değer Description
azureOpenAI

Sorgu zamanında bir Azure OpenAI kaynağı kullanarak eklemeler oluşturun.

customWebApi

Sorgu zamanında özel bir web uç noktası kullanarak eklemeler oluşturun.

aiServicesVision

Azure AI Services Vision Vectorize API'sini kullanarak sorgu zamanında bir görüntü veya metin girişi için eklemeler oluşturun.

aml

Sorgu zamanında Azure Yapay Zeka Atölyesi Model Kataloğu aracılığıyla dağıtılan bir Azure Machine Learning uç noktası kullanarak eklemeler oluşturun.

WebKnowledgeSource

Web sonuçlarını hedefleyen Bilgi Kaynağı.

Name Tür Description
@odata.etag

string

Bilgi kaynağının ETag'ı.

description

string

İsteğe bağlı kullanıcı tanımlı açıklama.

encryptionKey

SearchResourceEncryptionKey

Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, bilgi kaynağı tanımınız için ek bir şifreleme seviyesi sağlamak için kullanılır; çünkü kimsenin, hatta Microsoft'un bile şifrelerini çözemeyeceğine tam güven vermek istersiniz. Bilgi kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek isterseniz bu özelliği gerektiğinde değiştirebilirsiniz; Bilgi kaynağı tanımınız değişmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetlerinde kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.

kind string:

web

Bilgi kaynağının türü.

name

string

Bilgi kaynağının adı.

webParameters

WebKnowledgeSourceParameters

Web bilgi kaynağı için parametreler.

WebKnowledgeSourceDomain

Web bilgi kaynağı etki alanı için yapılandırma.

Name Tür Description
address

string

Etki alanının adresi.

includeSubpages

boolean

Bu etki alanından alt sayfaların dahil edilip edilmeyeceği.

WebKnowledgeSourceDomains

Web bilgi kaynağı için etki alanı izin verme/engelleme yapılandırması.

Name Tür Description
allowedDomains

WebKnowledgeSourceDomain[]

Web sonuçları için izin verilen alan adları.

blockedDomains

WebKnowledgeSourceDomain[]

Web sonuçlarından engellenen alan adları.

WebKnowledgeSourceParameters

Web bilgi kaynağı için parametreler.

Name Tür Description
domains

WebKnowledgeSourceDomains

Web sonuçları için etki alanı izin verme/engelleme yapılandırması.