Data Sources - List
Bir arama hizmeti için kullanılabilen tüm veri kaynaklarını listeler.
GET {endpoint}/datasources?api-version=2026-10-01
GET {endpoint}/datasources?api-version=2026-10-01&$select={$select}&search={search}&pageSize={pageSize}&searchType=prefix
URI Parametreleri
| Veri Akışı Adı | İç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ü. |
|
$select
|
query |
string[] |
Hangi üst düzey özelliklerin alınacağını seçer. JSON özellik adlarının virgülle ayrılmış bir listesi veya tüm özellikler için '*' olarak belirtilir. Varsayılan değer tüm özellikler'dir. |
|
|
page
|
query |
integer (int32) minimum: 1maximum: 3000 |
Tek bir sayfada iade edilecek maksimum ürün sayısı. Sunucu maksimum bir zorunluluk uygular; eğer bu eksik edilirse, sunucu uygun bir varsayılan belirler. |
|
|
search
|
query |
string |
Daha az sonucu sayfa gibi incelemek için listeyi daraltmak için kullanılan bir dizidir. Eğer atlanırsa veya boş bir dizi geçirilirse, daraltma uygulanmaz. |
|
|
search
|
query |
Arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor. |
İstek Başlığı
| Veri Akışı Adı | Gerekli | Tür | Description |
|---|---|---|---|
| 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ı. |
|
| Accept |
Accept başlığı. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 200 OK |
İstek başarılı oldu. |
|
| Other Status Codes |
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
| Veri Akışı Adı | Description |
|---|---|
| https://search.azure.com/.default |
Örnekler
SearchServiceListDataSources
Örnek isteği
GET https://typespecstableexampleservice.search.windows.net/datasources?api-version=2026-10-01&$select=&search=&pageSize=&searchType=prefix
Örnek yanıt
{
"value": [
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "mydocdbdatasource",
"description": "My Azure Adls Gen2 data source with ACLs.",
"type": "adlsgen2",
"indexerPermissionOptions": [
"userIds",
"groupIds",
"rbacScope"
],
"credentials": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
},
"container": {
"name": "doc-extraction-skillset",
"query": "E2E_Dsat"
},
"dataChangeDetectionPolicy": {
"@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
"highWaterMarkColumnName": "metadata_storage_last_modified"
},
"dataDeletionDetectionPolicy": {
"@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
"softDeleteColumnName": "isDeleted",
"softDeleteMarkerValue": "true"
}
}
]
}
Tanımlar
| Veri Akışı Adı | Description |
|---|---|
| Accept |
Accept başlığı. |
|
Error |
Kaynak yönetimi hatasına ilişkin ek bilgiler. |
|
Error |
Hata ayrıntısı. |
|
Error |
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.). |
|
High |
Yüksek su işareti sütununun değerine göre değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar. |
|
Indexer |
Dizine eklenecek çeşitli izin verisi türlerine sahip seçenekler. |
|
List |
Veri Kaynaklarını Listele isteğinden gelen yanıt. Başarılı olursa, tüm veri kaynaklarının tam tanımlarını içerir. |
|
Listing |
Bir listeleme sonuç kümesini daraltırken arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor. |
|
Native |
Silme algılaması için Azure Blob Depolama'nın yerel geçici silme özelliğini kullanan bir veri silme algılama ilkesi tanımlar. |
|
Search |
Dizine eklenecek varlık (Azure SQL tablosu veya CosmosDB koleksiyonu gibi) hakkındaki bilgileri temsil eder. |
|
Search |
Veri kaynağının kimlik özelliğini temizler. |
|
Search |
Dizin oluşturucu yapılandırmak için kullanılabilecek bir veri kaynağı tanımını temsil eder. |
|
Search |
Bir veri kaynağının türünü tanımlar. |
|
Search |
Kullanılacak veri kaynağının kimliğini belirtir. |
|
Search |
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. |
|
Soft |
Geçici silme stratejisi uygulayan bir veri silme algılama ilkesi tanımlar. Belirtilen 'geçici silme' sütununun değerine göre bir öğenin silinip silinmeyeceğini belirler. |
|
Sql |
Azure SQL Veritabanı'nın Tümleşik Değişiklik İzleme özelliğini kullanarak değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar. |
Accept
Accept başlığı.
| Değer | Description |
|---|---|
| application/json;odata.metadata=minimal |
ErrorAdditionalInfo
Kaynak yönetimi hatasına ilişkin ek bilgiler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| info |
Ek bilgiler. |
|
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgisi. |
|
| code |
string |
Hata kodu. |
| details |
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.).
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
HighWaterMarkChangeDetectionPolicy
Yüksek su işareti sütununun değerine göre değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Türetilmiş türler için ayrımcı. |
| highWaterMarkColumnName |
string |
Yüksek su işareti sütununun adı. |
IndexerPermissionOption
Dizine eklenecek çeşitli izin verisi türlerine sahip seçenekler.
| Değer | Description |
|---|---|
| userIds |
ACL userId'lerini veri kaynağından dizine almak için dizin oluşturucu. |
| groupIds |
ACL groupId'lerini veri kaynağından dizine almak için dizin oluşturucu. |
| rbacScope |
Azure RBAC kapsamını veri kaynağından dizine almak için dizin oluşturucu. |
ListDataSourcesResult
Veri Kaynaklarını Listele isteğinden gelen yanıt. Başarılı olursa, tüm veri kaynaklarının tam tanımlarını içerir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.nextLink |
string |
Bir sonraki sonuç setini almak için kullanılabilecek URL. |
| value |
Arama hizmetindeki veri kaynakları. |
ListingSearchType
Bir listeleme sonuç kümesini daraltırken arama parametresinin nasıl yorumlandığını belirtir. Şu anda sadece 'preek' destekleniyor.
| Değer | Description |
|---|---|
| prefix |
Adı arama parametresinin değeriyle başlayan öğeleri eşleştirir. |
NativeBlobSoftDeleteDeletionDetectionPolicy
Silme algılaması için Azure Blob Depolama'nın yerel geçici silme özelliğini kullanan bir veri silme algılama ilkesi tanımlar.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Türetilmiş türler için ayrımcı. |
SearchIndexerDataContainer
Dizine eklenecek varlık (Azure SQL tablosu veya CosmosDB koleksiyonu gibi) hakkındaki bilgileri temsil eder.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| name |
string |
Dizine alınacak tablonun veya görünümün (Azure SQL veri kaynağı için) ya da koleksiyonun (CosmosDB veri kaynağı için) adı. |
| query |
string |
Bu veri kapsayıcısına uygulanan sorgu. Bu parametrenin söz dizimi ve anlamı veri kaynağına özgüdür. Azure SQL veri kaynakları tarafından desteklenmez. |
SearchIndexerDataNoneIdentity
Veri kaynağının kimlik özelliğini temizler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Kimlik türünü belirten bir URI parçası. |
SearchIndexerDataSource
Dizin oluşturucu yapılandırmak için kullanılabilecek bir veri kaynağı tanımını temsil eder.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.etag |
string |
Veri kaynağının ETag'i. |
| container |
Veri kaynağının veri kapsayıcısı. |
|
| credentials.connectionString |
string |
Veri kaynağının bağlantı dizesi. Bağlantı dizesinin güncelleştirilmesini istemiyorsanız (köşeli parantezlerle) olarak |
| dataChangeDetectionPolicy | DataChangeDetectionPolicy: |
Veri kaynağı için veri değişikliği algılama ilkesi. |
| dataDeletionDetectionPolicy | DataDeletionDetectionPolicy: |
Veri kaynağı için veri silme algılama ilkesi. |
| description |
string |
Veri kaynağının açıklaması. |
| encryptionKey |
Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, hiç kimsenin, hatta Microsoft'un bile veri kaynağı tanımınızın şifresini çözemeyeceğinden tam olarak emin olmak istediğinizde, veri kaynağı tanımınız için ek bir bekleyen şifreleme düzeyi sağlamak için kullanılır. Veri kaynağı tanımınızı şifreledikten sonra her zaman şifrelenmiş olarak kalır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek istiyorsanız bu özelliği gerektiği gibi değiştirebilirsiniz; Veri kaynağı tanımınız etkilenmez. 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. |
|
| identity | SearchIndexerDataIdentity: |
Bu veri kaynağı için kullanılacak açık bir yönetilen kimlik. Belirtilmezse ve bağlantı dizesi yönetilen kimlikse, sistem tarafından atanan yönetilen kimlik kullanılır. Belirtilmezse, değer değişmeden kalır. "Hiçbiri" belirtilirse, bu özelliğin değeri temizlenir. |
| indexerPermissionOptions |
Çeşitli izin verisi türleriyle besleme seçenekleri. |
|
| name |
string |
Veri kaynağının adı. |
| type |
Veri kaynağının türü. |
SearchIndexerDataSourceType
Bir veri kaynağının türünü tanımlar.
| Değer | Description |
|---|---|
| azuresql |
Bir Azure SQL veri kaynağını gösterir. |
| cosmosdb |
Bir CosmosDB veri kaynağını gösterir. |
| azureblob |
Bir Azure Blob veri kaynağını gösterir. |
| azuretable |
Bir Azure Tablo veri kaynağını gösterir. |
| mysql |
Bir MySql veri kaynağını gösterir. |
| adlsgen2 |
ADLS Gen2 veri kaynağını gösterir. |
| onelake |
Microsoft Fabric OneLake veri kaynağını gösterir. |
| sharepoint |
SharePoint veri kaynağını gösterir. |
SearchIndexerDataUserAssignedIdentity
Kullanılacak veri kaynağının kimliğini belirtir.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Kimlik türünü belirten bir URI parçası. |
| federatedIdentityClientId |
string |
Çok kiracılı User-Assigned Yönetilen Kimlik Desteği: Kullanıcı tarafından atanan yönetilen kimlik ile federasyon yapacak şekilde yapılandırılmış çoklu uygulamanın istemci kimliği. |
| 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. |
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.
| Veri Akışı Adı | 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 |
SoftDeleteColumnDeletionDetectionPolicy
Geçici silme stratejisi uygulayan bir veri silme algılama ilkesi tanımlar. Belirtilen 'geçici silme' sütununun değerine göre bir öğenin silinip silinmeyeceğini belirler.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Türetilmiş türler için ayrımcı. |
| softDeleteColumnName |
string |
Geçici silme algılaması için kullanılacak sütunun adı. |
| softDeleteMarkerValue |
string |
Bir öğeyi silinmiş olarak tanımlayan işaretçi değeri. |
SqlIntegratedChangeTrackingPolicy
Azure SQL Veritabanı'nın Tümleşik Değişiklik İzleme özelliğini kullanarak değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| @odata.type |
string:
#Microsoft. |
Türetilmiş türler için ayrımcı. |