Knowledge Sources - Create

Hizmet:: Search Service

API Sürümü:: 2025-11-01-preview

Yeni bir bilgi kaynağı oluşturur.

POST {endpoint}/knowledgesources?api-version=2025-11-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Arama hizmetinin uç nokta URL'si.
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ı.

İstek Gövdesi

İstek gövdesi şunlardan biri olabilir:

Name	Description
AzureBlobKnowledgeSource	Azure Blob Depolama bilgi kaynağı yapılandırması.
IndexedOneLakeKnowledgeSource	OneLake bilgi kaynağı için yapılandırma.
IndexedSharePointKnowledgeSource	SharePoint bilgi kaynağı yapılandırması.
RemoteSharePointKnowledgeSource	Uzak SharePoint bilgi kaynağı yapılandırması.
SearchIndexKnowledgeSource	Bir arama dizinini hedefleyen Bilgi Kaynağı.
WebKnowledgeSource	Web sonuçlarını hedefleyen Bilgi Kaynağı.

AzureBlobKnowledgeSource

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

Name	Gerekli	Tür	Description
azureBlobParameters	True	AzureBlobKnowledgeSourceParameters	Bilgi kaynağının türü.
kind	True	string: azureBlob	Bilgi kaynağının türü.
name	True	string	Bilgi kaynağının adı.
@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.

IndexedOneLakeKnowledgeSource

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

Name	Gerekli	Tür	Description
indexedOneLakeParameters	True	IndexedOneLakeKnowledgeSourceParameters	Bilgi kaynağı için parametreler.
kind	True	string: indexedOneLake	Bilgi kaynağının türü.
name	True	string	Bilgi kaynağının adı.
@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.

IndexedSharePointKnowledgeSource

SharePoint bilgi kaynağı yapılandırması.

Name	Gerekli	Tür	Description
indexedSharePointParameters	True	IndexedSharePointKnowledgeSourceParameters	Bilgi kaynağı için parametreler.
kind	True	string: indexedSharePoint	Bilgi kaynağının türü.
name	True	string	Bilgi kaynağının adı.
@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.

RemoteSharePointKnowledgeSource

Uzak SharePoint bilgi kaynağı yapılandırması.

Name	Gerekli	Tür	Description
kind	True	string: remoteSharePoint	Bilgi kaynağının türü.
name	True	string	Bilgi kaynağının adı.
@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.
remoteSharePointParameters		RemoteSharePointKnowledgeSourceParameters	Uzak SharePoint bilgi kaynağı parametreleri.

SearchIndexKnowledgeSource

Bir arama dizinini hedefleyen Bilgi Kaynağı.

Name	Gerekli	Tür	Description
kind	True	string: searchIndex	Bilgi kaynağının türü.
name	True	string	Bilgi kaynağının adı.
searchIndexParameters	True	SearchIndexKnowledgeSourceParameters	Bilgi kaynağı için parametreler.
@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.

WebKnowledgeSource

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

Name	Gerekli	Tür	Description
kind	True	string: web	Bilgi kaynağının türü.
name	True	string	Bilgi kaynağının adı.
@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.
webParameters		WebKnowledgeSourceParameters	Web bilgi kaynağı için parametreler.

Yanıtlar

Name	Tür	Description
201 Created	KnowledgeSource: AzureBlobKnowledgeSource IndexedOneLakeKnowledgeSource IndexedSharePointKnowledgeSource RemoteSharePointKnowledgeSource SearchIndexKnowledgeSource WebKnowledgeSource	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
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

SearchServiceCreateKnowledgeSource

SearchServiceCreateKnowledgeSourceAzureBlob

SearchServiceCreateKnowledgeSourceIndexedOneLake

SearchServiceCreateKnowledgeSourceIndexedSharePoint

SearchServiceCreateKnowledgeSourceWeb

SearchServiceCreateKnowledgeSource

Örnek isteği

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


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

Örnek yanıt

Durum kodu:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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": "preview-test",
    "semanticConfigurationName": "testconfig",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ]
  }
}

SearchServiceCreateKnowledgeSourceAzureBlob

Örnek isteği

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


{
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "azureBlob",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "dataSourceConnection": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceCreateKnowledgeSourceIndexedOneLake

Örnek isteği

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


{
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the OneLake knowledge source.",
  "kind": "indexedOneLake",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceIndexedSharePoint

Örnek isteği

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


{
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the SharePoint knowledge source.",
  "kind": "indexedSharePoint",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSharePoint",
  "description": "Description of the SharePoint knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceWeb

Örnek isteği

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


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

Örnek yanıt

Durum kodu:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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.
IndexedSharePointContainerName	Hangi SharePoint kitaplıklarına erişileceğini belirtir.
IndexedSharePointKnowledgeSource	SharePoint bilgi kaynağı yapılandırması.
IndexedSharePointKnowledgeSourceParameters	SharePoint bilgi kaynağı parametreleri.
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.
KnowledgeSourceIngestionPermissionOption	Belge içeriğiyle birlikte alınacak izin türleri.
KnowledgeSourceKind	Bilgi kaynağının türü.
RemoteSharePointKnowledgeSource	Uzak SharePoint bilgi kaynağı yapılandırması.
RemoteSharePointKnowledgeSourceParameters	Uzak SharePoint bilgi kaynağı parametreleri.
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

Numaralandırma

Kabul Et başlığı.

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

AIServices

Nesne

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

Nesne

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

Nesne

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

Numaralandırma

Ç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-4o	Gpt4o modeli.
gpt-4o-mini	Gpt4oMini modeli.
gpt-4.1	Gpt41 modeli.
gpt-4.1-mini	Gpt41Mini modeli.
gpt-4.1-nano	Gpt41Nano modeli.
gpt-5	Gpt5 modeli.
gpt-5-mini	Gpt5Mini modeli.
gpt-5-nano	Gpt5Nano modeli.

AzureOpenAIVectorizerParameters

Nesne

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: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	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

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info		Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

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

Nesne

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

Nesne

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

Nesne

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.

IndexedSharePointContainerName

Numaralandırma

Hangi SharePoint kitaplıklarına erişileceğini belirtir.

Değer	Description
defaultSiteLibrary	Sitenin varsayılan belge kitaplığından içeriği dizine ekleyin.
allSiteLibraries	Sitedeki her belge kitaplığından içeriği dizinleyin.
useQuery	SharePoint içeriğini filtrelemek için bir sorgu kullanın.

IndexedSharePointKnowledgeSource

Nesne

SharePoint bilgi kaynağı yapılandırması.

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.
indexedSharePointParameters	IndexedSharePointKnowledgeSourceParameters	Bilgi kaynağı için parametreler.
kind	string: indexedSharePoint	Bilgi kaynağının türü.
name	string	Bilgi kaynağının adı.

IndexedSharePointKnowledgeSourceParameters

Nesne

SharePoint bilgi kaynağı parametreleri.

Name	Tür	Description
connectionString	string	Biçime sahip SharePoint bağlantı dizesi: SharePointOnlineEndpoint=[SharePoint site url'si]; ApplicationId=[Azure AD Uygulama Kimliği]; ApplicationSecret=[Azure AD Uygulama istemci gizli dizisi]; TenantId=[SharePoint sitesi kiracı kimliği]
containerName	IndexedSharePointContainerName	Hangi SharePoint kitaplıklarına erişileceğini belirtir.
createdResources	object	Bilgi kaynağı tarafından oluşturulan kaynaklar.
ingestionParameters	KnowledgeSourceIngestionParameters	Tüm genel alım ayarlarını birleştirir.
query	string	SharePoint içeriğini filtrelemek için isteğe bağlı sorgu.

IndexingSchedule

Nesne

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

Nesne

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

Numaralandırma

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

Değer	Description
azureOpenAI	Sorgu planlaması için Azure Open AI modellerini kullanın.

KnowledgeSourceAzureOpenAIVectorizer

Nesne

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

Nesne

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: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		Bu bilgi kaynağı için kullanılacak açık bir kimlik.
ingestionPermissionOptions	KnowledgeSourceIngestionPermissionOption[]		Belge içeriğiyle birlikte alınacak izin türlerinin isteğe bağlı listesi. Belirtilirse, veri kaynağı için dizin oluşturucu izin seçeneklerini ayarlar.
ingestionSchedule	IndexingSchedule		Veri alımı için isteğe bağlı zamanlama.

KnowledgeSourceIngestionPermissionOption

Numaralandırma

Belge içeriğiyle birlikte alınacak izin türleri.

Değer	Description
userIds	Belge içeriğinin yanı sıra açık kullanıcı tanımlayıcılarını alın.
groupIds	Belge içeriğinin yanı sıra grup tanımlayıcılarını da alın.
rbacScope	Belge içeriğinin yanı sıra RBAC kapsam bilgilerini de alın.

KnowledgeSourceKind

Numaralandırma

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ğı.
indexedSharePoint	Indekslenmiş SharePoint'ten veri okuyan bir bilgi kaynağı.
indexedOneLake	Indekslenmiş OneLake'den veri okuyan bir bilgi kaynağı.
web	Web'den veri okuyan bir bilgi kaynağı.
remoteSharePoint	Uzak SharePoint'ten veri okuyan bir bilgi kaynağı.

RemoteSharePointKnowledgeSource

Nesne

Uzak SharePoint bilgi kaynağı yapılandırması.

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: remoteSharePoint	Bilgi kaynağının türü.
name	string	Bilgi kaynağının adı.
remoteSharePointParameters	RemoteSharePointKnowledgeSourceParameters	Uzak SharePoint bilgi kaynağı parametreleri.

RemoteSharePointKnowledgeSourceParameters

Nesne

Uzak SharePoint bilgi kaynağı parametreleri.

Name	Tür	Description
containerTypeId	string	SharePoint Embedded bağlantısı için kapsayıcı kimliği. Bu null olduğunda, SharePoint Online'ı kullanır.
filterExpression	string	Sorgu çalıştırılmadan önce alma kapsamının belirlenmesi için sorgulanabilir SharePoint özellikleri ve öznitelikleri ile Anahtar Sözcük Sorgu Dili (KQL) ifadesi.
resourceMetadata	string[]	Yanıttaki her öğe için döndürülecek meta veri alanlarının listesi. Bu listeye yalnızca alınabilir meta veri özellikleri eklenebilir. Varsayılan olarak, hiçbir meta veri döndürülmez.

SearchIndexerDataNoneIdentity

Nesne

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

Nesne

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	Genellikle "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" biçiminde yönetilen kimlik atanan bir kullanıcının tam Azure kaynak kimliği.

SearchIndexFieldReference

Nesne

Arama dizini için alan referansı.

Name	Tür	Description
name	string	Alanın adı.

SearchIndexKnowledgeSource

Nesne

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

Nesne

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

Nesne

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: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	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.net`olabilir.

VectorSearchVectorizerKind

Numaralandırma

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 AI Foundry Model Kataloğu aracılığıyla dağıtılan bir Azure Machine Learning uç noktası kullanarak eklemeler oluşturun.

WebKnowledgeSource

Nesne

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

Nesne

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

Nesne

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

Nesne

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ı.