dotnet release notes for the 2023-11 release (#6838)

* dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release * dotnet release notes for the 2023-11 release
2023-11-07 11:07:19 -08:00 · 2023-11-07 11:07:19 -08:00 · 775aa42dfe
--- a/_data/releases/2023-11/dotnet.yml
+++ b/_data/releases/2023-11/dotnet.yml
@ -189,4 +189,343 @@ entries:
  Hidden: false
  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Peering_1.2.0/sdk/peering/Azure.ResourceManager.Peering/CHANGELOG.md
  ChangelogContent: ""
+- Name: Azure.ResourceManager.ContainerServiceFleet
+  Version: 1.0.0-beta.3
+  DisplayName: Resource Management - Container Service Fleet
+  ServiceName: Container Service Fleet
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerServiceFleet_1.0.0-beta.3/sdk/fleet/Azure.ResourceManager.ContainerServiceFleet/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.ElasticSan
+  Version: 1.0.0-beta.5
+  DisplayName: Resource Management - ElasticSan
+  ServiceName: Elasticsan
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ElasticSan_1.0.0-beta.5/sdk/elasticsan/Azure.ResourceManager.ElasticSan/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.DesktopVirtualization
+  Version: 1.2.0
+  DisplayName: Resource Management - Desktop Virtualization
+  ServiceName: Desktop Virtualization
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DesktopVirtualization_1.2.0/sdk/desktopvirtualization/Azure.ResourceManager.DesktopVirtualization/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Microsoft.Extensions.Azure
+  Version: 1.7.1
+  DisplayName: Azure client library integration for ASP.NET Core
+  ServiceName: Extensions
+  VersionType: Patch
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Extensions.Azure_1.7.1/sdk/extensions/Microsoft.Extensions.Azure/CHANGELOG.md
+  ChangelogContent: |-
+    #### Other Changes
+
+    - Updated dependency `Azure.Identity` to version `1.10.3`.
+- Name: Azure.ResourceManager.HardwareSecurityModules
+  Version: 1.0.0-beta.1
+  DisplayName: Resource Management - Hardwaresecuritymodules
+  ServiceName: Hardwaresecuritymodules
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HardwareSecurityModules_1.0.0-beta.1/sdk/hardwaresecuritymodules/Azure.ResourceManager.HardwareSecurityModules/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.StorageMover
+  Version: 1.1.0
+  DisplayName: Resource Management - Storage Mover
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.StorageMover_1.1.0/sdk/storagemover/Azure.ResourceManager.StorageMover/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.CosmosDB
+  Version: 1.4.0-beta.4
+  DisplayName: Resource Management - Cosmos DB
+  ServiceName: Cosmos DB
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CosmosDB_1.4.0-beta.4/sdk/cosmosdb/Azure.ResourceManager.CosmosDB/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.Maintenance
+  Version: 1.2.0-beta.5
+  DisplayName: Resource Management - Maintenance
+  ServiceName: Maintenance
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maintenance_1.2.0-beta.5/sdk/maintenance/Azure.ResourceManager.Maintenance/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.ResourceHealth
+  Version: 1.1.0-beta.2
+  DisplayName: Resource Management - Resource Health
+  ServiceName: Resource Health
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ResourceHealth_1.1.0-beta.2/sdk/resourcehealth/Azure.ResourceManager.ResourceHealth/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.Developer.DevCenter
+  Version: 1.0.0-beta.3
+  DisplayName: Dev Center
+  ServiceName: Dev Center
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Developer.DevCenter_1.0.0-beta.3/sdk/devcenter/Azure.Developer.DevCenter/CHANGELOG.md
+  ChangelogContent: |-
+    #### Breaking Changes
+
+    - `EnvironmentsClient` renamed to `DeploymentEnvironmentsClient`
+    - `DevBoxesClient` and `DeploymentEnvironmentsClient` no longer accepts project as a constructor parameter
+    - `DeploymentEnvironmentsClient` now works with "environment definitions" instead of "catalog items"
+    - Creating a new environment requires passing `environmentDefinitionName` instead of `catalogItemName`
+    - Creating a new environment requires passing an additional parameter `catalogName`
+    - `DevCenterClientOptions` renamed to `AzureDeveloperDevCenterClientOptions`
+    - No more default parameters in the clients. `userId`, `filter`, `maxCount`, `hibernate` and `context` parameters need to be specified in the methods.
+    - `GetAction` renamed to `GetDevBoxAction`
+    - `GetActions` renamed to `GetDevBoxActions`
+- Name: Azure.ResourceManager.NetworkAnalytics
+  Version: 1.0.0-beta.1
+  DisplayName: Resource Management - Networkanalytics
+  ServiceName: Networkanalytics
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkAnalytics_1.0.0-beta.1/sdk/networkanalytics/Azure.ResourceManager.NetworkAnalytics/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.Analytics.Synapse.Artifacts
+  Version: 1.0.0-preview.19
+  DisplayName: Synapse - Artifacts
+  ServiceName: Synapse
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Artifacts_1.0.0-preview.19/sdk/synapse/Azure.Analytics.Synapse.Artifacts/CHANGELOG.md
+  ChangelogContent: |-
+    - Fix runNotebook sessionId from int to string
+    - Fix placeholder links causing 404s
+    - Sync expression Support From DataFactory To Synapse
+- Name: Azure.ResourceManager.MobileNetwork
+  Version: 1.1.0
+  DisplayName: Resource Management - Mobile Network
+  ServiceName: Mobile Network
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MobileNetwork_1.1.0/sdk/mobilenetwork/Azure.ResourceManager.MobileNetwork/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager
+  Version: 1.8.0
+  DisplayName: Resource Management - Resource Manager
+  ServiceName: Resource Manager
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager_1.8.0/sdk/resourcemanager/Azure.ResourceManager/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.Search
+  Version: 1.2.0
+  DisplayName: Resource Management - Cognitive Search
+  ServiceName: Search
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Search_1.2.0/sdk/search/Azure.ResourceManager.Search/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.ServiceNetworking
+  Version: 1.0.0
+  DisplayName: Resource Management - Service Networking
+  ServiceName: Service Networking
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.0.0/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.HybridNetwork
+  Version: 1.0.0-beta.1
+  DisplayName: Resource Management - Hybridnetwork
+  ServiceName: Hybridnetwork
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridNetwork_1.0.0-beta.1/sdk/hybridnetwork/Azure.ResourceManager.HybridNetwork/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.MySql
+  Version: 1.1.0-beta.3
+  DisplayName: Resource Management - MySQL
+  ServiceName: MySQL
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.1.0-beta.3/sdk/mysql/Azure.ResourceManager.MySql/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.Storage.Blobs
+  Version: 12.19.0
+  DisplayName: Storage - Blobs
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.19.0/sdk/storage/Azure.Storage.Blobs/CHANGELOG.md
+  ChangelogContent: '- Includes all features from 12.19.0-beta.1.'
+- Name: Azure.Storage.Files.DataLake
+  Version: 12.17.0
+  DisplayName: Storage - Files Data Lake
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.17.0/sdk/storage/Azure.Storage.Files.DataLake/CHANGELOG.md
+  ChangelogContent: '- Includes all features from 12.17.0-beta.1.'
+- Name: Azure.Storage.Blobs.Batch
+  Version: 12.16.0
+  DisplayName: Storage - Blobs Batch
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.Batch_12.16.0/sdk/storage/Azure.Storage.Blobs.Batch/CHANGELOG.md
+  ChangelogContent: '- Includes all features from 12.16.0-beta.1.'
+- Name: Azure.Storage.Files.Shares
+  Version: 12.17.0
+  DisplayName: Storage - Files Share
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.Shares_12.17.0/sdk/storage/Azure.Storage.Files.Shares/CHANGELOG.md
+  ChangelogContent: |-
+    - Includes all features from 12.17.0-beta.1.
+    - Fixed bug where the x-ms-file-request-intent request header was not being sent for ShareFileClient.UploadRangeFromUri() and .UploadRangeFromUriAsync().
+- Name: Azure.Storage.Blobs.ChangeFeed
+  Version: 12.0.0-preview.40
+  DisplayName: Storage - Blobs ChangeFeed
+  ServiceName: Storage
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.ChangeFeed_12.0.0-preview.40/sdk/storage/Azure.Storage.Blobs.ChangeFeed/CHANGELOG.md
+  ChangelogContent: '- This release contains bug fixes to improve quality.'
+- Name: Azure.Storage.Common
+  Version: 12.18.0
+  DisplayName: Storage - Common
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.18.0/sdk/storage/Azure.Storage.Common/CHANGELOG.md
+  ChangelogContent: '- Includes all features from 12.18.0-beta.1.'
+- Name: Azure.Storage.Queues
+  Version: 12.17.0
+  DisplayName: Storage - Queues
+  ServiceName: Storage
+  VersionType: GA
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.17.0/sdk/storage/Azure.Storage.Queues/CHANGELOG.md
+  ChangelogContent: '- Includes all features from 12.17.0-beta.1.'
+- Name: Azure.AI.OpenAI
+  Version: 1.0.0-beta.9
+  DisplayName: OpenAI Inference
+  ServiceName: Cognitive Services
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.OpenAI_1.0.0-beta.9/sdk/openai/Azure.AI.OpenAI/CHANGELOG.md
+  ChangelogContent: |-
+    #### Breaking Changes
+
+    This update includes a number of version-to-version breaking changes to the API.
+
+    ##### Streaming for completions and chat completions
+
+    Streaming Completions and Streaming Chat Completions have been significantly updated to use simpler, shallower usage
+    patterns and data representations. The goal of these changes is to make streaming much easier to consume in common
+    cases while still retaining full functionality in more complex ones (e.g. with multiple choices requested).
+    - A new `StreamingResponse<T>` type is introduced that implicitly exposes an `IAsyncEnumerable<T>` derived from
+    the underlying response.
+    - `OpenAI.GetCompletionsStreaming()` now returns a `StreamingResponse<Completions>` that may be directly
+    enumerated over. `StreamingCompletions`, `StreamingChoice`, and the corresponding methods are removed.
+    - Because Chat Completions use a distinct structure for their streaming response messages, a new
+    `StreamingChatCompletionsUpdate` type is introduced that encapsulates this update data.
+    - Correspondingly, `OpenAI.GetChatCompletionsStreaming()` now returns a
+    `StreamingResponse<StreamingChatCompletionsUpdate>` that may be enumerated over directly.
+    `StreamingChatCompletions`, `StreamingChatChoice`, and related methods are removed.
+    - For more information, please see
+    [the related pull request description](https://github.com/Azure/azure-sdk-for-net/pull/39347) as well as the
+    updated snippets in the project README.
+
+    ##### `deploymentOrModelName` moved to `*Options.DeploymentName`
+
+    `deploymentOrModelName` and related method parameters on `OpenAIClient` have been moved to `DeploymentName`
+    properties in the corresponding method options. This is intended to promote consistency across scenario,
+    language, and Azure/non-Azure OpenAI use.
+
+    As an example, the following:
+
+    ```csharp
+    ChatCompletionsOptions chatCompletionsOptions = new()
+    {
+    Messages = { new(ChatRole.User, "Hello, assistant!") },
+    };
+    Response<ChatCompletions> response = client.GetChatCompletions("gpt-4", chatCompletionsOptions);
+    ```
+
+    ...is now re-written as:
+
+    ```csharp
+    ChatCompletionsOptions chatCompletionsOptions = new()
+    {
+    DeploymentName = "gpt-4",
+    Messages = { new(ChatRole.User, "Hello, assistant!") },
+    };
+    Response<ChatCompletions> response = client.GetChatCompletions(chatCompletionsOptions);
+    ```
+
+    ##### Consistency in complex method options type constructors
+
+    With the migration of `DeploymentName` into method complex options types, these options types have now been snapped to
+    follow a common pattern: each complex options type will feature a default constructor that allows `init`-style setting
+    of properties as well as a single additional constructor that accepts *all* required parameters for the corresponding
+    method. Existing constructors that no longer meet that "all" requirement, including those impacted by the addition of
+    `DeploymentName`, have been removed. The "convenience" constructors that represented required parameter data
+    differently -- for example, `EmbeddingsOptions(string)`, have also been removed in favor of the consistent "set of
+    directly provide" choice.
+
+    More exhaustively, *removed* are:
+
+    - `AudioTranscriptionOptions(BinaryData)`
+    - `AudioTranslationOptions(BinaryData)`
+    - `ChatCompletionsOptions(IEnumerable<ChatMessage>)`
+    - `CompletionsOptions(IEnumerable<string>)`
+    - `EmbeddingsOptions(string)`
+    - `EmbeddingsOptions(IEnumerable<string>)`
+
+    And *added* as replacements are:
+
+    - `AudioTranscriptionOptions(string, BinaryData)`
+    - `AudioTranslationOptions(string, BinaryData)`
+    - `ChatCompletionsOptions(string, IEnumerable<ChatMessage>)`
+    - `CompletionsOptions(string, IEnumerable<string>)`
+    - `EmbeddingsOptions(string, IEnumerable<string>)`
+
+    ##### Embeddings now represented as `ReadOnlyMemory<float>`
+
+    Changed the representation of embeddings (specifically, the type of the `Embedding` property of the `EmbeddingItem` class)
+    from `IReadOnlyList<float>` to `ReadOnlyMemory<float>` as part of a broader effort to establish consistency across the
+    .NET ecosystem.
+
+    ##### `SearchKey` and `EmbeddingKey` properties replaced by `SetSearchKey` and `SetEmbeddingKey` methods
+
+    Replaced the `SearchKey` and `EmbeddingKey` properties of the `AzureCognitiveSearchChatExtensionConfiguration` class with
+    new `SetSearchKey` and `SetEmbeddingKey` methods respectively. These methods simplify the configuration of the Azure Cognitive
+    Search chat extension by receiving a plain string instead of an `AzureKeyCredential`, promote more sensible key and secret
+    management, and align with the Azure SDK guidelines.
+- Name: Azure.ResourceManager.SelfHelp
+  Version: 1.1.0-beta.1
+  DisplayName: Resource Management - Self Help
+  ServiceName: Self Help
+  VersionType: Beta
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SelfHelp_1.1.0-beta.1/sdk/selfhelp/Azure.ResourceManager.SelfHelp/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager
+  Version: 1.8.1
+  DisplayName: Resource Management - Resource Manager
+  ServiceName: Resource Manager
+  VersionType: Patch
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager_1.8.1/sdk/resourcemanager/Azure.ResourceManager/CHANGELOG.md
+  ChangelogContent: ""
+- Name: Azure.ResourceManager.NetApp
+  Version: 1.4.1
+  DisplayName: Resource Management - NetApp Files
+  ServiceName: NetApp Files
+  VersionType: Patch
+  Hidden: false
+  ChangelogUrl: https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetApp_1.4.1/sdk/netapp/Azure.ResourceManager.NetApp/CHANGELOG.md
+  ChangelogContent: ""