Azure SDK for .NET (October 2023)
The Azure SDK team is pleased to announce our October 2023 client library releases.
33 packages released this month.
Stable Packages (11)
-
Event Grid
-
Monitor Ingestion
-
OpenTelemetry Exporter
-
Resource Management - Cosmos DB for PostgreSQL
-
Resource Management - IoT Hub
-
Resource Management - Managed Network Fabric
-
Resource Management - Marketplace
-
Resource Management - Network
-
Resource Management - Recovery Services Site Recovery
-
Resource Management - Resource Mover
-
WebJobs Extensions - Service Bus
Patch Updates (3)
-
Identity
-
Service Bus
-
WebJobs Extensions - Event Hubs
Beta Packages (18)
-
App Configuration
-
Cognitive Search
-
Communication Messages
-
Communication Rooms
-
Monitor Ingestion
-
OpenAI Inference
-
OpenTelemetry AspNetCore
-
Resource Management - Chaos
-
Resource Management - Container Service Fleet
-
Resource Management - Containerservicefleet
-
Resource Management - Data Factory
-
Resource Management - Data Protection
-
Resource Management - Databasefleetmanager
-
Resource Management - Machine Learning
-
Resource Management - Network
-
Resource Management - Recoveryservicesdatareplication
-
Resource Management - SQL
-
Resource Management - Security
Release highlights
App Configuration 1.3.0-beta.3 Changelog
Features Added
- Added a new type,
SnapshotSelector
, to encapsulate parameters likename
,fields
, andstatus
within theGetSnapshots
method.
Bugs Fixed
- Fixed
GetConfigurationSettings(SettingSelector)
not settingContentType
andLastModified
properties (#38524). FeatureFlagConfigurationSetting
will now allow custom attributes under theconditions
element in the setting value. Previously, onlyclient_filters
was recognized and other data would be discarded.
Cognitive Search 11.5.0-beta.5 Changelog
Breaking Changes
- In
SearchOptions
, theIList<SearchQueryVector> Vectors
property has been removed in favor of the abstract base typeIList<VectorQuery> VectorQueries
. - In
SearchField
, thevectorSearchConfiguration
property has been removed in favor of the newVectorSearchProfile
property. - In
VectorSearch
,AlgorithmConfigurations
has been renamed toAlgorithms
.
Features Added
- Added support for
VectorSearch.Vectorizers
, which contains configuration options for vectorizing text vector queries, andVectorSearch.Profiles
, which define combinations of configurations to use with vector search. - Added the
VectorSearchAlgorithmConfiguration
base type, containing configuration options specific to the algorithm used during indexing and/or querying. Derived classes includeExhaustiveKnnVectorSearchAlgorithmConfiguration
andHnswVectorSearchAlgorithmConfiguration
. - Added the
SearchOptions.VectorQueries
base type, which is used for the query parameters for vector and hybrid search queries. Derived classes includeVectorizableTextQuery
andRawVectorQuery
. WithRawVectorQuery
, users can pass raw vector values for vector search, whileVectorizableTextQuery
allows the passing of text values to be vectorized for vector search. - Added
SearchOptions.VectorFilterMode
, determining whether filters are applied before or after vector search is executed. - Added
SearchOptions.SemanticQuery
, which enables the setting of a dedicated search query for semantic reranking, semantic captions, and semantic answers. - Added support for
AzureOpenAIEmbeddingSkill
, which enables the generation of vector embeddings for given text inputs using the Azure Open AI service. - Added
SearchIndexStatistics.VectorIndexSize
, which reports the amount of memory consumed by vectors in the index. - Added
KnowledgeStore.Parameters
, which defines a dictionary of knowledge store-specific configuration properties. - Added
SearchIndexerSkillset.IndexProjections
, which specifies additional projections to secondary search indexes.
Communication Messages 1.0.0-beta.1 Changelog
This is the first Public Preview release of Azure Communication Services for advanced messages. For more information, please see the README and [documentation][documentation].
This is a Public Preview version, so breaking changes are possible in subsequent releases as we improve the product. To provide feedback, please submit an issue in our Azure SDK for .NET GitHub repo.
Communication Rooms 1.1.0-beta.1 Changelog
Features Added
- Added support for PSTN dial-out capability
Event Grid 4.19.0 Changelog
Features Added
- Added new system events for Resource Notifications and Azure Communication Services.
Identity 1.10.2 Changelog
Bugs Fixed
- Bug fixes for development time credentials.
Monitor Ingestion 1.1.0-beta.1 Changelog
Bugs Fixed
- Fix sovereign support for US Gov and China clouds
Monitor Ingestion 1.1.0 Changelog
Features Added
- Added
LogsIngestionAudience
for multi-cloud support to allow users to select the Azure cloud where the resource is located.
OpenAI Inference 1.0.0-beta.8 Changelog
Bugs Fixed
- Support for the described breaking change for
PromptFilterResults
was added and this library version will now again deserializePromptFilterResults
appropriately PromptFilterResults
andContentFilterResults
are now exposed on the result classes for streaming Completions and Chat Completions.Streaming(Chat)Completions.PromptFilterResults
will report an index-sorted list of all prompt annotations received so far whileStreaming(Chat)Choice.ContentFilterResults
will reflect the latest-received content annotations that were populated and received while streaming
Breaking Changes
- The underlying representation of
PromptFilterResults
(forCompletions
andChatCompletions
) has had its response body key changed fromprompt_annotations
toprompt_filter_results
- Prior versions of the
Azure.AI.OpenAI
library may no longer populatePromptFilterResults
as expected and it’s highly recommended to upgrade to this version if the use of Azure OpenAI content moderation annotations for input data is desired - If a library version upgrade is not immediately possible, it’s advised to use
Response<T>.GetRawResponse()
and manually extract theprompt_filter_results
object from the top level of theCompletions
orChatCompletions
responseContent
payload
Features Added
- Audio Transcription and Audio Translation using OpenAI Whisper models is now supported. See OpenAI’s API reference or the Azure OpenAI quickstart for detailed overview and background information.
- The new methods
GetAudioTranscription
andGetAudioTranscription
expose these capabilities onOpenAIClient
- Transcription produces text in the primary, supported, spoken input language of the audio data provided, together with any optional associated metadata
- Translation produces text, translated to English and reflective of the audio data provided, together with any optional associated metadata
- These methods work for both Azure OpenAI and non-Azure
api.openai.com
client configurations
OpenTelemetry AspNetCore 1.0.0-beta.7 Changelog
Other Changes
- Update OpenTelemetry dependencies (#38568) (#38833)
- OpenTelemetry 1.6.0
- OpenTelemetry.Extensions.Hosting 1.6.0
- OpenTelemetry.ResourceDetectors.Azure 1.0.0-beta.3
OpenTelemetry AspNetCore 1.0.0-beta.8 Changelog
Breaking Changes
- Removed package references to the beta versions of
OpenTelemetry.Instrumentation.AspNetCore
,OpenTelemetry.Instrumentation.Http
, andOpenTelemetry.Instrumentation.SqlClient
. Instead, these packages are now internally vendored within the distro. Due to this change, users will no longer be able to access the public APIs of these beta packages. Manually adding package references to these instrumentation libraries in an application will cause the internal vendored instrumentation from the distro to be ignored. If users choose to add these references, they must ensure to update their configuration subsequently. This includes incorporating the necessary instrumentation using either TracerProviderBuilder or MeterProviderBuilder.
OpenTelemetry Exporter 1.0.0 Changelog
Bugs Fixed
- Fixed an issue during network failures which prevented the exporter to store the telemetry offline for retrying at a later time. (#38832)
Resource Management - Chaos 1.0.0-beta.5 Changelog
Resource Management - Container Service Fleet 1.0.0-beta.2 Changelog
Resource Management - Containerservicefleet 1.0.0-beta.1 Changelog
Resource Management - Cosmos DB for PostgreSQL 1.0.0 Changelog
Resource Management - Data Factory 1.0.0-beta.4 Changelog
Resource Management - Data Protection 1.3.0-beta.1 Changelog
Resource Management - Databasefleetmanager 1.0.0-beta.1 Changelog
Resource Management - IoT Hub 1.1.0 Changelog
Resource Management - Machine Learning 1.2.0-beta.2 Changelog
Resource Management - Managed Network Fabric 1.1.0 Changelog
Resource Management - Marketplace 1.1.0 Changelog
Resource Management - Network 1.5.0 Changelog
Resource Management - Network 1.6.0-beta.1 Changelog
Resource Management - Recovery Services Site Recovery 1.1.0 Changelog
Resource Management - Recoveryservicesdatareplication 1.0.0-beta.1 Changelog
Resource Management - Resource Mover 1.1.0 Changelog
Resource Management - SQL 1.3.0-beta.3 Changelog
Resource Management - Security 1.2.0-beta.3 Changelog
Service Bus 7.16.2 Changelog
Bugs Fixed
- Fixed issue where
ActivitySource
activities were not being created even when the experimental flag was set.
WebJobs Extensions - Event Hubs 6.0.1 Changelog
Bugs Fixed
- Added support for the legacy checkpoint format when making scaling decisions.
WebJobs Extensions - Service Bus 5.13.0 Changelog
Features Added
- Added
MaxConcurrentCallsPerSession
toServiceBusOptions
to allow configuring the maximum number of concurrent calls per session.
Latest Releases
View all the latest versions of .NET packages here.
Installation Instructions
To install any of our packages, please search for them via Manage NuGet Packages...
in Visual Studio (with Include prerelease
checked) or copy these commands into your terminal:
$> dotnet add package Azure.AI.OpenAI --version 1.0.0-beta.8
$> dotnet add package Azure.Communication.Messages --version 1.0.0-beta.1
$> dotnet add package Azure.Communication.Rooms --version 1.1.0-beta.1
$> dotnet add package Azure.Data.AppConfiguration --version 1.3.0-beta.3
$> dotnet add package Azure.Identity --version 1.10.2
$> dotnet add package Azure.Messaging.EventGrid --version 4.19.0
$> dotnet add package Azure.Messaging.ServiceBus --version 7.16.2
$> dotnet add package Azure.Monitor.Ingestion --version 1.1.0-beta.1
$> dotnet add package Azure.Monitor.Ingestion --version 1.1.0
$> dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --version 1.0.0-beta.7
$> dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --version 1.0.0-beta.8
$> dotnet add package Azure.Monitor.OpenTelemetry.Exporter --version 1.0.0
$> dotnet add package Azure.ResourceManager.Chaos --version 1.0.0-beta.5
$> dotnet add package Azure.ResourceManager.ContainerServiceFleet --version 1.0.0-beta.2
$> dotnet add package Azure.ResourceManager.ContainerServiceFleet --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.CosmosDBForPostgreSql --version 1.0.0
$> dotnet add package Azure.ResourceManager.DataFactory --version 1.0.0-beta.4
$> dotnet add package Azure.ResourceManager.DataProtectionBackup --version 1.3.0-beta.1
$> dotnet add package Azure.ResourceManager.DatabaseFleetManager --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.IotHub --version 1.1.0
$> dotnet add package Azure.ResourceManager.MachineLearning --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.ManagedNetworkFabric --version 1.1.0
$> dotnet add package Azure.ResourceManager.Marketplace --version 1.1.0
$> dotnet add package Azure.ResourceManager.Network --version 1.5.0
$> dotnet add package Azure.ResourceManager.Network --version 1.6.0-beta.1
$> dotnet add package Azure.ResourceManager.RecoveryServicesDataReplication --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.RecoveryServicesSiteRecovery --version 1.1.0
$> dotnet add package Azure.ResourceManager.ResourceMover --version 1.1.0
$> dotnet add package Azure.ResourceManager.SecurityCenter --version 1.2.0-beta.3
$> dotnet add package Azure.ResourceManager.Sql --version 1.3.0-beta.3
$> dotnet add package Azure.Search.Documents --version 11.5.0-beta.5
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 6.0.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.13.0
Feedback
If you have a bug or feature request for one of the libraries, please file an issue in our repo.