Azure Bilişsel Arama API sürümleriAPI versions in Azure Cognitive Search

Azure Bilişsel Arama, özellik güncelleştirmelerini düzenli olarak kaydeder.Azure Cognitive Search rolls out feature updates regularly. Bazen, her zaman olmasa da, geriye dönük uyumluluğu korumak için bu güncelleştirmeler API 'nin yeni bir sürümünü gerektirir.Sometimes, but not always, these updates require a new version of the API to preserve backward compatibility. Yeni bir sürümü yayımlamak, kodunuzda arama hizmeti güncelleştirmelerini ne zaman ve nasıl tümleştirmenizi denetlemenize olanak tanır.Publishing a new version allows you to control when and how you integrate search service updates in your code.

Bir kural olarak, Azure Bilişsel Arama ekibi, kodunuzu yeni bir API sürümü kullanacak şekilde yükseltmek için biraz çaba içerebileceği için, yalnızca gerektiğinde yeni sürümler yayımlar.As a rule, the Azure Cognitive Search team publishes new versions only when necessary, since it can involve some effort to upgrade your code to use a new API version. Yeni bir sürüm yalnızca API 'nin bazı yönlerinin geriye dönük uyumluluğu kesen bir şekilde değişmesi durumunda gereklidir.A new version is needed only if some aspect of the API has changed in a way that breaks backward compatibility. Bu tür değişiklikler, mevcut özelliklerle ilgili düzeltmeler veya var olan API yüzey alanını değiştiren yeni özelliklerden kaynaklanıyor olabilir.Such changes can happen because of fixes to existing features, or because of new features that change existing API surface area.

Aynı kural SDK güncelleştirmeleri için de geçerlidir.The same rule applies for SDK updates. Azure Bilişsel Arama SDK, anlam sürümü oluşturma kurallarını izler, yani sürümünün üç bölümü vardır: Ana, ikincil ve derleme numarası (örneğin, 1.1.0).The Azure Cognitive Search SDK follows the semantic versioning rules, which means that its version has three parts: major, minor, and build number (for example, 1.1.0). SDK 'nın yeni bir ana sürümü yalnızca geriye dönük uyumluluğu kesen değişiklikler için serbest bırakılır.A new major version of the SDK is released only for changes that break backward compatibility. Önemli olmayan özellik güncelleştirmeleri ikincil sürümü artırır ve hata düzeltmeleri yalnızca derleme sürümünü artırır.Non-breaking feature updates will increment the minor version, and bug fixes will only increase the build version.

Önemli

.NET, Java, Python ve JavaScript için Azure SDK 'Ları, Azure Bilişsel Arama yönelik yeni istemci kitaplıklarını kullanıma alıyor.The Azure SDKs for .NET, Java, Python and JavaScript are rolling out new client libraries for Azure Cognitive Search. Şu anda Azure SDK kitaplıklarının hiçbiri en son arama REST API 'Lerini (2020-06-30) veya yönetim REST API 'Lerini (2020-03-13) tam olarak desteklemez, ancak bu zaman içinde değişecektir.Currently, none of the Azure SDK libraries fully support the most recent Search REST APIs (2020-06-30) or Management REST APIs (2020-03-13) but this will change over time. Bu sayfayı veya işlevsel geliştirmelerle ilgili duyurulara yönelik yenilikler ' i düzenli olarak denetleyebilirsiniz.You can periodically check this page or the What's New for announcements on functional enhancements.

Desteklenmeyen sürümlerUnsupported versions

Mevcut arama çözümlerini 15 Ekim 2020 ' e kadar en son REST API sürümüne yükseltin.Upgrade existing search solutions to the latest version of the REST API by October 15, 2020. Bu sırada, Azure Bilişsel Arama REST API aşağıdaki sürümleri kullanımdan kaldırılacak ve artık desteklenmeyecektir:At that time, the following versions of the Azure Cognitive Search REST API will be retired and no longer supported:

  • 2015-02-282015-02-28
  • 2015-02-28-Önizleme2015-02-28-Preview
  • 2014-07-31-Önizleme2014-07-31-Preview
  • 2014-10-20-Önizleme2014-10-20-Preview

Ayrıca, Azure Bilişsel Arama .NET SDK 'nın 3.0.0-RC ' den daha eski sürümleri de bu REST API sürümlerinden birini hedeflerse devre dışı bırakılacaktır.In addition, versions of the Azure Cognitive Search .NET SDK older than 3.0.0-rc will also be retired since they target one of these REST API versions.

Bu tarihten sonra, kullanımdan kaldırılan REST API veya SDK sürümlerinden herhangi birini kullanan uygulamalar artık çalışmaz ve yükseltilmesi gerekir.After this date, applications that use any of the deprecated REST API or SDK versions will no longer work and must be upgraded. Bu türde herhangi bir değişiklik yaparken, 12 aylık bir bildirim sunuyoruz, bu nedenle ayarlamak için yeterli zaman vardır.As with any change of this type, we are giving 12 months' notice, so you have adequate time to adjust.

Azure Bilişsel Arama 'yi kullanmaya devam etmek için lütfen REST API hedefleyen mevcut kodu REST API 2020-06-30 sürümünü veya daha yeni bir SDK 'yı 15 Ekim 2020 ' e geçirin.To continue using Azure Cognitive Search, please migrate existing code that targets the REST API to REST API version 2020-06-30 or to a newer SDK by October 15, 2020. En son sürüme güncelleştirme hakkında sorularınız varsa, azuresearch_contact@microsoft.com kodunuzu güncelleştirmek için yeterli zamana sahip olduğunuzdan emin olmak için lütfen 15 mayıs 2020 ' e kadar posta gönderin.If you have any questions about updating to the latest version, please send mail to azuresearch_contact@microsoft.com by May 15, 2020 to ensure you have enough time to update your code.

REST API'leriREST APIs

Azure Bilişsel Arama hizmet örneği, en son sürüm dahil olmak üzere birkaç REST API sürümü destekler.An Azure Cognitive Search service instance supports several REST API versions, including the latest one. Artık en son bir sürüm olmadığında bir sürümü kullanmaya devam edebilirsiniz, ancak kodunuzu en yeni sürümü kullanmak için geçirmeniz önerilir.You can continue to use a version when it is no longer the latest one, but we recommend that you migrate your code to use the newest version. REST API kullanırken, API sürümü parametresi aracılığıyla her istekte API sürümünü belirtmeniz gerekir.When using the REST API, you must specify the API version in every request via the api-version parameter. .NET SDK kullanıldığında, kullanmakta olduğunuz SDK sürümü REST API ilgili sürümünü belirler.When using the .NET SDK, the version of the SDK you're using determines the corresponding version of the REST API. Daha eski bir SDK kullanıyorsanız, hizmet daha yeni bir API sürümünü destekleyecek şekilde yükseltilse bile, bu kodu hiçbir değişiklik yapmadan çalıştırmaya devam edebilirsiniz.If you are using an older SDK, you can continue to run that code with no changes even if the service is upgraded to support a newer API version.

Aşağıdaki tabloda, Arama Hizmeti REST API geçerli ve daha önce yayımlanmış sürümlerinin sürüm geçmişi verilmiştir.The following table provides the version history of current and previously released versions of the Search Service REST API. Belgeler yalnızca en son kararlı ve önizleme sürümleri için yayımlanır.Documentation is published only for the most recent stable and preview versions.

Arama Hizmeti API 'LeriSearch Service APIs

Arama hizmetinde içerik oluşturun ve yönetin.Create and manage content on a search service.

Sürüm                                            Version                                             DurumStatus AçıklamaDescription
Arama 2020-06-30Search 2020-06-30 DengeliStable Arama REST API 'lerinin en yeni kararlı sürümü, ilgi Puanlama ve genellikle bilgi deposu için kullanılabilirlik ile yapılır.Newest stable release of the Search REST APIs, with advancements in relevance scoring and generally availability for knowledge store.
Arama 2020-06-30-PreviewSearch 2020-06-30-Preview ÖnizlemePreview Kararlı sürümle ilişkili önizleme sürümü.Preview version associated with stable version. Birden çok Önizleme özelliğiiçerir.Includes multiple preview features.
Arama 2019-05-06Search 2019-05-06 DengeliStable Karmaşık türlerekler.Adds complex types.
Arama 2019-05-06-PreviewSearch 2019-05-06-Preview ÖnizlemePreview Kararlı sürümle ilişkili önizleme sürümü.Preview version associated with stable version.
Arama 2017-11-11Search 2017-11-11 DengeliStable Becerileri ve AI zenginleştirmeekler.Adds skillsets and AI enrichment.
Arama 2017-11-11-ÖnizlemeSearch 2017-11-11-Preview ÖnizlemePreview Kararlı sürümle ilişkili önizleme sürümü.Preview version associated with stable version.
Arama 2016-09-01Search 2016-09-01 DengeliStable Dizin oluşturucularekler.Adds indexers.
Arama 2016-09-01-ÖnizlemeSearch 2016-09-01-Preview ÖnizlemePreview Kararlı sürümle ilişkili önizleme sürümü.Preview version associated with stable version.
Arama 2015-02-28Search 2015-02-28 10-10-2020 sonrasında desteklenmezUnsupported after 10-10-2020 İlk genel olarak kullanılabilir sürüm.First generally available release.
Arama 2015-02-28-ÖnizlemeSearch 2015-02-28-Preview 10-10-2020 sonrasında desteklenmezUnsupported after 10-10-2020 Kararlı sürümle ilişkili önizleme sürümü.Preview version associated with stable version.
Arama 2014-10-20-ÖnizlemeSearch 2014-10-20-Preview 10-10-2020 sonrasında desteklenmezUnsupported after 10-10-2020 İkinci genel önizleme.Second public preview.
Arama 2014-07-31-ÖnizlemeSearch 2014-07-31-Preview 10-10-2020 sonrasında desteklenmezUnsupported after 10-10-2020 İlk genel önizleme.First public preview.

Yönetim REST API’leriManagement REST APIs

Bir arama hizmeti oluşturup yapılandırın ve API anahtarlarını yönetin.Create and configure a search service, and manage API keys.

Sürüm                                            Version                                             DurumStatus AçıklamaDescription
Yönetim 2020-08-01Management 2020-08-01 DengeliStable Yönetim REST API 'lerinin en yeni kararlı sürümü.Newest stable release of the Management REST APIs. Önizleme sürümünde belirtilenler hariç tüm giden erişilen kaynaklar için genel kullanıma açık paylaşılan özel bağlantı kaynağı desteğini eklerAdds generally available shared private link resource support for all outbound-accessed resources except those noted in the preview version
Yönetim 2020-08-01-ÖnizlemeManagement 2020-08-01-Preview ÖnizlemePreview Şu anda önizlemede: Azure Işlevleri için paylaşılan özel bağlantı kaynağı ve MySQL için Azure veritabanı desteği.Currently in preview: shared private link resource support for Azure Functions and Azure Database for MySQL.
Yönetim 13.03.2020Management 2020-03-13 DengeliStable Özel bağlantı aracılığıyla özel uç nokta ve yeni hizmetler IÇIN ağ IP kuralları ekler.Adds private endpoint through private link, and network IP rules for new services. Daha fazla bilgi için bu Swagger belirtiminebakın.For more information, see this swagger specification.
Yönetim 2019-10-01-PreviewManagement 2019-10-01-Preview ÖnizlemePreview Bu listede tanıtılan önizleme özelliği yoktu.There were no preview features introduced in this list. Bu önizleme, işlevsel olarak 2020-03-13 ile eşdeğerdir.This preview is functionally equivalent to 2020-03-13. Daha fazla bilgi için bu Swagger belirtiminebakın.For more information, see this swagger specification.
Yönetim 2015-08-19Management 2015-08-19 DengeliStable Yönetim REST API 'lerinin ilk genel olarak kullanılabilir sürümü.The first generally available version of the Management REST APIs. Hizmet sağlama, ölçek artırma ve API anahtar yönetimi sağlar.Provides service provisioning, scale up, and api-key management. Daha fazla bilgi için bu Swagger belirtiminebakın.For more information, see this swagger specification.
Yönetim 2015-08-19-ÖnizlemeManagement 2015-08-19-Preview ÖnizlemePreview Yönetim REST API 'lerinin ilk önizleme sürümü.The first preview version of the Management REST APIs. Daha fazla bilgi için bu Swagger belirtiminebakın.For more information, see this swagger specification.

.NET için Azure SDKAzure SDK for .NET

Aşağıdaki tabloda, daha güncel SDK sürümlerinin bağlantıları verilmiştir.The following table provides links to more recent SDK versions.

SDK sürümüSDK version DurumStatus AçıklamaDescription
Azure.Search.Documstaları 11,0Azure.Search.Documents 11.0 DengeliStable Azure .NET SDK 'dan yeni istemci kitaplığı, 2020 Temmuz 'da yayınlandı.New client library from Azure .NET SDK, released July 2020. Arama REST API-Version = 2020-06-30 REST API, ancak henüz, coğrafi filtreler veya FieldBuilder'ı desteklemez.Targets the Search REST api-version=2020-06-30 REST API but does not yet support, geo-filters, or FieldBuilder.
Microsoft. Azure. Search 10,0Microsoft.Azure.Search 10.0 DengeliStable Yayınlanan 2019 Mayıs.Released May 2019. Arama REST API-Version = 2019-05-06 ' i hedefler.Targets the Search REST api-version=2019-05-06.
Microsoft. Azure. Management. Search 4.0.0Microsoft.Azure.Management.Search 4.0.0 DengeliStable Yönetim REST API-Version = 2020-08-01 ' i hedefler.Targets the Management REST api-version=2020-08-01.
Microsoft. Azure. Management. Search 3.0.0Microsoft.Azure.Management.Search 3.0.0 DengeliStable Yönetim REST API-Version = 2015-08-19 ' i hedefler.Targets the Management REST api-version=2015-08-19.

Java için Azure SDKAzure SDK for Java

SDK sürümüSDK version DurumStatus AçıklamaDescription
Java Azure-Arama-belgeler 11Java azure-search-documents 11 DengeliStable Azure .NET SDK 'dan yeni istemci kitaplığı, 2020 Temmuz 'da yayınlandı.New client library from Azure .NET SDK, released July 2020. Arama REST API-Version = 2019-05-06 ' i hedefler.Targets the Search REST api-version=2019-05-06.
Java yönetim Istemcisi 1.35.0Java Management Client 1.35.0 DengeliStable Yönetim REST API-Version = 2015-08-19 ' i hedefler.Targets the Management REST api-version=2015-08-19.

JavaScript için Azure SDKAzure SDK for JavaScript

SDK sürümüSDK version DurumStatus AçıklamaDescription
JavaScript Azure-Arama 11,0JavaScript azure-search 11.0 DengeliStable Azure .NET SDK 'dan yeni istemci kitaplığı, 2020 Temmuz 'da yayınlandı.New client library from Azure .NET SDK, released July 2020. Arama REST API-Version = 2016-09-01 ' i hedefler.Targets the Search REST api-version=2016-09-01.
JavaScript Azure-ARM-aramaJavaScript azure-arm-search DengeliStable Yönetim REST API-Version = 2015-08-19 ' i hedefler.Targets the Management REST api-version=2015-08-19.

Python için Azure SDKAzure SDK for Python

SDK sürümüSDK version DurumStatus AçıklamaDescription
Python Azure-Arama-belgeler 11,0Python azure-search-documents 11.0 DengeliStable Azure .NET SDK 'dan yeni istemci kitaplığı, 2020 Temmuz 'da yayınlandı.New client library from Azure .NET SDK, released July 2020. Arama REST API-Version = 2019-05-06 ' i hedefler.Targets the Search REST api-version=2019-05-06.
Python Azure-MGMT-arama 1,0Python azure-mgmt-search 1.0 DengeliStable Yönetim REST API-Version = 2015-08-19 ' i hedefler.Targets the Management REST api-version=2015-08-19.