Azure SDK for JavaScript (September 2023)
The Azure SDK team is pleased to announce our September 2023 client library releases.
44 packages released this month.
Stable Packages (18)
-
Cosmos DB
-
Identity
-
Resource Management - Api Management
-
Resource Management - Azure VMware Solution
-
Resource Management - Container Apps
-
Resource Management - Container Service
-
Resource Management - Dynatrace
-
Resource Management - Maps
-
Resource Management - Network
-
Resource Management - Network Cloud
-
Resource Management - Recovery Services
-
Resource Management - Recovery Services Backup
-
Resource Management - Resource Connector
-
Resource Management - Storage
-
Storage - Blobs
-
Storage - Files Data Lake
-
Storage - Files Share
-
Storage - Queues
Patch Updates (4)
-
Communication Chat
-
Core - Client - Core Rest Pipeline
-
Core - Client - HTTP
-
Service Bus
Beta Packages (17)
-
Communication Call Automation
-
Communication Chat
-
Communication Phone Numbers
-
Monitor Query
-
OpenAI
-
OpenTelemetry Exporter
-
OpenTelemetry Instrumentation
-
Resource Management - Apicenter
-
Resource Management - Chaos
-
Resource Management - Container Service
-
Resource Management - Container Service Fleet
-
Resource Management - Defendereasm
-
Resource Management - Hdinsightcontainers
-
Resource Management - Hybridconnectivity
-
Resource Management - IoT Hub
-
Resource Management - Maintenance
-
Resource Management - Resourcesdeploymentstacks
Release highlights
Communication Call Automation 1.1.0-beta.1 Changelog
Breaking Changes
- Maximum number of DTMF tones to be collected for startRecognizing is now need to set in DTMF sepecific recognizeOptions.
Features Added
- Play and recognize supports TTS and SSML source prompts.
- Recognize supports choices and freeform speech.
- Start/Stop continuous DTMF recognition by subscribing/unsubscribing to tones.
- Send DTMF tones to a participant in the call.
- Mute participant in the call.
Communication Call Automation 1.1.0-beta.2 Changelog
Features Added
- Add MicrosoftTeamsUserIdentifier to CallInvite model.
Communication Chat 1.4.0-beta.1 Changelog
Features Added
- Support
metadata
for chat thread and chat participant. - Updated @azure/communication-signaling to 1.0.0-beta.19 with thread and participant metadata support.
Communication Chat 1.3.2 Changelog
Features Added
- Updated to @azure/communication-signaling@1.0.0-beta.20. Added EUDB real-time notification support.
https://*.trouter.teams.microsoft.com
andhttps://teams.microsoft.com
needs to be allowed for real-time notifications.
Communication Phone Numbers 1.3.0-alpha.20230820.1 Changelog
- Added support for matchNumberToRoutes
Core - Client - Core Rest Pipeline 1.12.1 Changelog
Other Changes
- Set
init.duplex
to"half"
when streaming body viafetch()
PR #26890 - Defer Error construction PR #26897
Core - Client - HTTP 3.0.3 Changelog
Other Changes
- Defer error object creation
Cosmos DB 4.0.0 Changelog
Breaking Changes
- The definition of PartitionKey is changed, PartitionKeyDefinition is now a independent type. #23416
Features Added
- Added Changefeed support for partition keys, feed ranges, and entire container. #18062
- Added Diagnostics to all response objects, i.e. ResourceResponse (parent class for ItemRespone, ContainerResponse etc.), FeedResponse, ChangeFeedIteratorResponse, ErrorResponse, BulkOperationResponse. #21177
- Added support for hierarchical partitions. #23416
- Added support of index metrics. #20194
- Improved the retry utility to align with other language SDKs. Now, it automatically retries requests on the next available region when encountering HTTP 503 errors (Service Unavailable) and handles HTTP timeouts more effectively, enhancing the SDK’s reliability. #23475
- Added priority based throttling. docs #26393
Bugs Fixed
- Updated response codes for the getDatabase() method. #25932
- Fix Upsert operation failing when partition key of container is
/id
and/id
is missing in the document. #21383
Identity 3.3.0 Changelog
Features Added
- Enabled support for logging personally identifiable information, required for customer support through the
enableUnsafeSupportLogging
option onloggingOptions
underTokenCredentialOptions
. - Continuous Access Evaluation (CAE) is now configurable per-request by setting the
enable_cae
keyword argument toTrue
inget_token
. This applies to user credentials and service principal credentials. (#26614)
Breaking Changes
- CP1 client capabilities for CAE is no longer always-on by default for user credentials. This capability will now be configured as-needed in each
getToken
request by each SDK. (#26614) - Suffixes are now appended to persistent cache names to indicate whether CAE or non-CAE tokens are stored in the cache. This is to prevent CAE and non-CAE tokens from being mixed/overwritten in the same cache. This could potentially cause issues if you are trying to share the same cache between applications that are using different versions of the Azure Identity library as each application would be reading from a different cache file.
- Since CAE is no longer always enabled for user-credentials, the
AZURE_IDENTITY_DISABLE_CP1
environment variable is no longer supported.
Monitor Query 1.2.0-beta.1 Changelog
- Added
MetricsBatchQueryClient
to support batch querying of metrics.
Monitor Query 1.2.0-beta.2 Changelog
Breaking Changes
- In the
MetricsBatchOptionalParams
object, the casing of property namesendtime
,orderby
, andstarttime
changed toendTime
,orderBy
, andstartTime
respectively. - In the
MetricsBatchQueryClientOptions
object, thebatchEndPoint
has been removed as optional property. Instead, this has been changed to mandatory parameter in theMetricsBatchQueryClient
class. - In the
MetricsBatchOptionalParams
object, the data type properties ofstartTime
&endTime
have been changed fromstring
toDate
.
OpenAI 1.0.0-beta.5 Changelog
Breaking Changes
- Remove
beginAzureBatchImageGeneration
andgetAzureBatchImageGenerationOperationStatus
methods. getImages
has been updated to return the image URLs/payloads directly, rather than requiring the user to callgetAzureBatchImageGenerationOperationStatus
to retrieve them.
Features Added
- (Azure OpenAI specific) Chat completions with your own data is now supported, see Azure OpenAI’s quickstart guide for details.
- A list of AzureExtensionChatConfiguration may be populated on
ChatCompletionsOptions
via itsazureExtensionOption.extensions
property. These configurations include a type together with a JSON Schema representation of its parameters. The type is used to determine which extension to use when generating chat completions. See thebringYourOwnData.js
sample for an example of how to use this feature. - Functions for chat completions are now supported: see OpenAI’s blog post on the topic for much more detail.
- A list of
FunctionDefinition
objects may be populated onChatCompletionsOptions
via itsfunctions
property. These definitions include a name and description together with a serialized JSON Schema representation of its parameters. - NOTE: Chat Functions requires a minimum of the
-0613
model versions forgpt-4
andgpt-3.5-turbo
/gpt-35-turbo
. Please ensure you’re using these later model versions, as Functions are not supported with older model revisions. For Azure OpenAI, you can update a deployment’s model version or create a new model deployment with an updated version via the Azure AI Studio interface, also accessible through Azure Portal. - (Azure OpenAI specific) Completions and Chat Completions responses now include embedded content filter annotations for prompts and responses
OpenTelemetry Exporter 1.0.0-beta.15 Changelog
Bugs Fixed
- Fix issue with wrong name for OTELRESOURCE metric.
- Fix an issue with serializing nested log messages.
Breaking Changes
AzureMonitorExporterOptions.aadTokenCredential
is nowAzureMonitorExporterOptions.credential
.- No longer expose the
MonitorBase
,MonitorDomain
, orTelemetryItem
interfaces.
OpenTelemetry Exporter 1.0.0-beta.16 Changelog
Bugs Fixed
- Avoid dependency telemetry for ingestion endpoint calls.
OpenTelemetry Instrumentation 1.0.0-beta.5 Changelog
Other Changes
- Updated to latest OTEL libraries
Resource Management - Api Management 9.1.0 Changelog
Resource Management - Apicenter 1.0.0-beta.1 Changelog
Resource Management - Azure VMware Solution 4.0.0 Changelog
Resource Management - Chaos 1.0.0-beta.4 Changelog
Resource Management - Container Apps 2.0.0 Changelog
Resource Management - Container Service 19.2.0-beta.1 Changelog
Resource Management - Container Service 19.2.0 Changelog
Resource Management - Container Service 19.3.0 Changelog
Resource Management - Container Service 19.4.0-beta.1 Changelog
Resource Management - Container Service Fleet 1.0.0-beta.2 Changelog
Resource Management - Defendereasm 1.0.0-beta.1 Changelog
Resource Management - Dynatrace 2.0.0 Changelog
Resource Management - Hdinsightcontainers 1.0.0-beta.1 Changelog
Resource Management - Hybridconnectivity 1.0.0-beta.1 Changelog
Resource Management - IoT Hub 6.3.0-beta.3 Changelog
Resource Management - Maintenance 1.0.0-beta.1 Changelog
Resource Management - Maps 3.1.0 Changelog
Resource Management - Network 32.1.0 Changelog
Resource Management - Network Cloud 1.0.0 Changelog
Resource Management - Recovery Services 5.4.0 Changelog
Resource Management - Recovery Services Backup 11.0.0 Changelog
Resource Management - Resource Connector 1.0.0 Changelog
Resource Management - Resourcesdeploymentstacks 1.0.0-beta.1 Changelog
Resource Management - Storage 18.2.0 Changelog
Service Bus 7.9.1 Changelog
Other Changes
- Check whether we can send messages before making management requests. PR #26927
Storage - Blobs 12.16.0 Changelog
Features Added
- Includes all features released in 12.16.0-beta.1.
Storage - Files Data Lake 12.15.0 Changelog
Features Added
- Includes all features released in 12.15.0-beta.1.
Storage - Files Share 12.16.0 Changelog
Features Added
- Added support for service version 2023-08-03.
Storage - Queues 12.15.0 Changelog
Features Added
- Added support for service version 2023-08-03.
Latest Releases
View all the latest versions of JavaScript packages here.
Installation Instructions
To install the packages, copy and paste the below into a terminal.
$> npm install @azure/arm-apicenter@1.0.0-beta.1
$> npm install @azure/arm-apimanagement@9.1.0
$> npm install @azure/arm-appcontainers@2.0.0
$> npm install @azure/arm-avs@4.0.0
$> npm install @azure/arm-chaos@1.0.0-beta.4
$> npm install @azure/arm-containerservice@19.2.0-beta.1
$> npm install @azure/arm-containerservice@19.2.0
$> npm install @azure/arm-containerservice@19.3.0
$> npm install @azure/arm-containerservice@19.4.0-beta.1
$> npm install @azure/arm-containerservicefleet@1.0.0-beta.2
$> npm install @azure/arm-defendereasm@1.0.0-beta.1
$> npm install @azure/arm-dynatrace@2.0.0
$> npm install @azure/arm-hdinsightcontainers@1.0.0-beta.1
$> npm install @azure/arm-hybridconnectivity@1.0.0-beta.1
$> npm install @azure/arm-iothub@6.3.0-beta.3
$> npm install @azure/arm-maintenance@1.0.0-beta.1
$> npm install @azure/arm-maps@3.1.0
$> npm install @azure/arm-network@32.1.0
$> npm install @azure/arm-networkcloud@1.0.0
$> npm install @azure/arm-recoveryservices@5.4.0
$> npm install @azure/arm-recoveryservicesbackup@11.0.0
$> npm install @azure/arm-resourceconnector@1.0.0
$> npm install @azure/arm-resourcesdeploymentstacks@1.0.0-beta.1
$> npm install @azure/arm-storage@18.2.0
$> npm install @azure/communication-call-automation@1.1.0-beta.1
$> npm install @azure/communication-call-automation@1.1.0-beta.2
$> npm install @azure/communication-chat@1.4.0-beta.1
$> npm install @azure/communication-chat@1.3.2
$> npm install @azure/communication-phone-numbers@1.3.0-alpha.20230820.1
$> npm install @azure/core-http@3.0.3
$> npm install @azure/core-rest-pipeline@1.12.1
$> npm install @azure/cosmos@4.0.0
$> npm install @azure/identity@3.3.0
$> npm install @azure/monitor-opentelemetry-exporter@1.0.0-beta.15
$> npm install @azure/monitor-opentelemetry-exporter@1.0.0-beta.16
$> npm install @azure/monitor-query@1.2.0-beta.1
$> npm install @azure/monitor-query@1.2.0-beta.2
$> npm install @azure/openai@1.0.0-beta.5
$> npm install @azure/opentelemetry-instrumentation-azure-sdk@1.0.0-beta.5
$> npm install @azure/service-bus@7.9.1
$> npm install @azure/storage-blob@12.16.0
$> npm install @azure/storage-file-datalake@12.15.0
$> npm install @azure/storage-file-share@12.16.0
$> npm install @azure/storage-queue@12.15.0
Feedback
If you have a bug or feature request for one of the libraries, please post an issue at the azure-sdk-for-js repository