github/azure-sdk-for-cpp
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
2630c06030
azure-sdk-for-cpp/sdk/core/azure-core/CHANGELOG.md
Azure SDK Bot 2630c06030
Increment package version after release of azure-core (#6654) 
---------

Co-authored-by: Anton Kolesnyk <antkmsft@users.noreply.github.com>
2025-07-10 11:09:06 -07:00

45 KiB
Raw Blame History

Release History

1.17.0-beta.1 (Unreleased)

Features Added

Breaking Changes

Bugs Fixed

Other Changes

1.16.0 (2025-07-10)

Features Added

  • [#6535] Enable SSL caching for libcurl transport by default, which is backwards compatible behavior with older libcurl versions, so using the default settings won't result in transport error when using libcurl >= 8.12. The option is controlled by CurlTransportOptions::EnableCurlSslCaching, and is on by default. (A community contribution, courtesy of sushshring)

Bugs Fixed

  • Fixed WinHTTP FailFast exception raised when a request is cancelled before the request is actually sent on the wire.

Other Changes

  • [#4952] Added internal support to pass connection timeout via context.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

  • Sushrut Shringarputale (GitHub)

1.16.0-beta.1 (2025-06-05)

Features Added

  • [#6535] Enable SSL caching for libcurl transport by default, which is backwards compatible behavior with older libcurl versions, so using the default settings won't result in transport error when using libcurl >= 8.12. The option is controlled by CurlTransportOptions::EnableCurlSslCaching, and is on by default. (A community contribution, courtesy of sushshring)

Other Changes

  • [#4952] Added internal support to pass connection timeout via context.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

  • Sushrut Shringarputale (GitHub)

1.15.0 (2025-03-06)

Features Added

  • Made default constructor for Azure::Core::Uuid implicit.
  • Added mTLS support to WinHTTP transport.
    • To enable mTLS, first create an appropriate Windows PCCERT_CONTEXT object and set the TlsClientCertificate field in WinHttpTransportOptions to that certificate before creating the WinHttpTransport object.

1.15.0-beta.2 (2025-01-09)

Features Added

  • Made default constructor for Azure::Core::Uuid implicit.

1.15.0-beta.1 (2024-11-13)

Features Added

  • Added mTLS support to WinHTTP transport.
    • To enable mTLS, first create an appropriate Windows PCCERT_CONTEXT object and set the TlsClientCertificate field in WinHttpTransportOptions to that certificate before creating the WinHttpTransport object.

1.14.1 (2024-11-01)

Bugs Fixed

  • Fixed warning for an unused function in curl.cpp when building the SDK using a version of libcurl older than 7.77.0.
  • Invalidate the token cache within BearerTokenAuthenticationPolicy whenever a token request comes back with a 401 response.

Other Changes

  • [#6087] Set version property for the compiled SDK binary files. (A community contribution, courtesy of chewi)
  • [#6064] Added internal support for the SDK packages to access more of telemetry features.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.14.0 (2024-10-03)

Features Added

  • Added a new constructor for Azure::Core::Context that takes an Azure::DateTime deadline. This enables creating a new context directly with a deadline.
  • Request logs to now include the accept-range, content-range, range, WWW-Authenticate, x-ms-date, x-ms-error-code, x-ms-range, and x-ms-version headers.
  • Added default constructor, Parse(), and equality comparison operators to Azure::Core::Uuid.
  • Added an Azure::Core::ResourceIdentifier type.

Breaking Changes

  • Deprecated the Azure::Core::Context::ApplicationContext object.
    • If customer code is using Azure::Core::Context::ApplicationContext, the customer should instead create their own root context object which is used wherever the customer would have previously used Azure::Core::Context::ApplicationContext, i.e. Azure::Core::Context(deadline) instead of Azure::Core::Context::ApplicationContext.WithDeadline(deadline).

Bugs Fixed

  • Throw std::invalid_argument if the value of TimeFractionFormat enum passed in to DateTime::ToString() is invalid.
  • Azure::Core::Uuid::ToString() is now const.
  • Make the HTTP transport behavior consistent between WinHTTP and libcurl by disabling automatically following redirects on Windows.
  • Added basic input validation to Azure::Core::ResourceIdentifier to ensure the prefix match what is expected.

Other Changes

  • [#5851] Remove unneeded <regex> includes. (A community contribution, courtesy of rschu1ze)
  • [#6014], [#6016] Fixes for Doxygen generation. (A community contribution, courtesy of chewi)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.14.0-beta.2 (2024-09-12)

Features Added

  • Request logs to now include the accept-range, content-range, range, WWW-Authenticate, x-ms-date, x-ms-error-code, x-ms-range, and x-ms-version headers.
  • Added default constructor, Parse(), and equality comparison operators to Azure::Core::Uuid.
  • Added an Azure::Core::ResourceIdentifier type.

Bugs Fixed

  • Throw std::invalid_argument if the value of TimeFractionFormat enum passed in to DateTime::ToString() is invalid.
  • Azure::Core::Uuid::ToString() is now const.

1.14.0-beta.1 (2024-08-01)

Features Added

  • Added a new constructor for Azure::Core::Context that takes an Azure::DateTime deadline. This enables creating a new context directly with a deadline.

Breaking Changes

  • Deprecated the Azure::Core::Context::ApplicationContext object.
    • If customer code is using Azure::Core::Context::ApplicationContext, the customer should instead create their own root context object which is used wherever the customer would have previously used Azure::Core::Context::ApplicationContext, i.e. Azure::Core::Context(deadline) instead of Azure::Core::Context::ApplicationContext.WithDeadline(deadline).

Other Changes

  • [#5851] Remove unneeded <regex> includes. (A community contribution, courtesy of rschu1ze)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.13.0 (2024-07-12)

Bugs Fixed

  • [#5589] Fix possible endless loop while polling curl socket. (A community contribution, courtesy of CurtizJ)

Other Changes

  • Updated JSON library to 3.11.3.
  • [#5622] Documentation fix for building the SDK with specific OpenSSL version. (A community contribution, courtesy of ByteYue)
  • [#5766] Add missing include. (A community contribution, courtesy of rschu1ze)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.13.0-beta.1 (2024-06-06)

Bugs Fixed

  • [#5589] Fix possible endless loop while polling curl socket. (A community contribution, courtesy of CurtizJ)

Other Changes

  • [#5622] Documentation fix for building the SDK with specific OpenSSL version. (A community contribution, courtesy of ByteYue)
  • [#5515] Add a ShouldRetry virtual method to the retry policy to enable customization of service-specific retry logic.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.12.0 (2024-05-09)

Bugs Fixed

  • [#5450] Fixed libcurl connection pool to use Connection response header values.

1.12.0-beta.1 (2024-04-10)

Bugs Fixed

  • [#5450] Fixed libcurl connection pool to use Connection response header values.

1.11.3 (2024-04-09)

Bugs Fixed

  • [#5450] Reverted libcurl connection pool to use more conservative caching strategy.
  • [#5371] Fix use of namespace qualifiers that have not been explicitly introduced. (A community contribution, courtesy of morten-ofstad)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.11.2 (2024-02-16)

Bugs Fixed

  • [#5244] WinHTTP transport not closing correctly in case of a request timeout.

Other Changes

  • Move the connection back to the connection pool when HTTP error 404 was received. This may improve the performance of a multithreaded application when libcurl transport adapter is being used. (A community contribution, courtesy of mchelnokov)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.11.1 (2024-02-02)

Bugs Fixed

  • [#5154] WinHTTP Transport logging (and exception strings) have dangling periods making it harder to read.

Other Changes

  • Improved log messages for WinHTTP Transport to help diagnose WinHTTP state machine related issues.

1.11.0 (2024-01-11)

Features Added

  • Added 'OPTIONS' HTTP method to Azure::Core::Http::HttpMethod enum.
  • Added TLS 1.3 support to WinHTTP transport.
  • Environment Log Level Listener now logs the ThreadID for the thread originating the trace.
  • [#4983] Added support for setting CURLOPT_CAPATH libcurl option on Linux. (A community contribution, courtesy of phoebusm)

Bugs Fixed

  • [#5172] Azure::Nullable::Emplace() does not set HasValue() to true.
  • [#5130] Url::AppendPath() and Url::SetPath() may end up with a double slash at the beginning of a path.
  • [#5007] Some versions of GCC no longer include stdint.h in cstdint.

Other Changes

  • [#4756] BearerTokenAuthenticationPolicy now uses shared mutex lock for read operations.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.11.0-beta.2 (2023-11-02)

Features Added

  • Added TLS 1.3 support to WinHTTP transport.
  • Environment Log Level Listener now logs the ThreadID for the thread originating the trace.

Bugs Fixed

  • [#5007] Some versions of GCC no longer include stdint.h in cstdint.

1.11.0-beta.1 (2023-10-05)

Features Added

  • [#4983] Added support for setting CURLOPT_CAPATH libcurl option on Linux. (A community contribution, courtesy of phoebusm)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.10.3 (2023-10-05)

Bugs Fixed

  • Concurrency issues in Azure::Core::Diagnostics::_internal::Log::Stream have been fixed.

Other Changes

  • SDK consumption documentation improvement. (A community contribution, courtesy of kou)
  • Fixed GCC 13 compilation error. (A community contribution, courtesy of adamdebreceni)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.10.2 (2023-08-04)

Bugs Fixed

  • [#4792] Only support CURL's root cert validation when CURL version is >= 7.77.0.

1.10.1 (2023-07-06)

Breaking Changes

  • [#4662] Azure::Core::Operation<T>::GetRawResponseInternal() is now deprecated and no longer requires an override.

Other Changes

  • Empty diagnostic messages will no longer be generated.

1.10.0 (2023-06-01)

Features Added

  • Added Azure::Core::Uuid::AsArray() and Azure::Core::Uuid::CreateFromArray() to enable reading or writing from an existing UUID. This is useful when the UUID was generated outside the Azure SDK, or needs to be used from a component outside the Azure SDK.

Other Changes

  • [#3964] Ensuring some Azure SDK types have the expected default operations. (A community contribution, courtesy of jnyfah)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.10.0-beta.1 (2023-05-04)

Features Added

  • Added Azure::Core::Uuid::AsArray() and Azure::Core::Uuid::CreateFromArray() to enable reading or writing from an existing UUID. This is useful when the UUID was generated outside the Azure SDK, or needs to be used from a component outside the Azure SDK.

1.9.0 (2023-05-04)

Features Added

  • Added the ability to ignore invalid certificate common name for TLS connections in WinHTTP transport.
  • Added DisableTlsCertificateValidation in TransportOptions.
  • Added TokenCredential::GetCredentialName() to be utilized in diagnostic messages. If you have any custom implementations of TokenCredential, it is recommended to pass the name of your credential to TokenCredential constructor. The old parameterless constructor is deprecated.
  • Added support for challenge-based and multi-tenant authentication.

Bugs Fixed

  • Fixed the UUID generation so the variant is RFC 4122 conforming.

Other Changes

  • [#4352] Fixed compilation error on Visual Studio 2017. (A community contribution, courtesy of jorgen)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.8.2 (2023-04-24)

Bugs Fixed

  • [#4490] Fixed WinHTTP memory leak during failed requests.

1.9.0-beta.1 (2023-04-06)

Features Added

  • Added the ability to ignore invalid certificate common name for TLS connections in WinHTTP transport.
  • Added DisableTlsCertificateValidation in TransportOptions.
  • Added TokenCredential::GetCredentialName() to be utilized in diagnostic messages. If you have any custom implementations of TokenCredential, it is recommended to pass the name of your credential to TokenCredential constructor. The old parameterless constructor is deprecated.
  • Added support for challenge-based and multi-tenant authentication.

Other Changes

  • [#4352] Fixed compilation error on Visual Studio 2017. (A community contribution, courtesy of jorgen)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.8.1 (2023-04-06)

Bugs Fixed

  • [#4213] Fixed a bug where Host request header is not set for non-default port (80, 443).
  • [#4443] Fixed potentially high CPU usage on Windows.

Other Changes

  • Libcurl transport doesn't add Content-Length request header for GET/HEAD/DELETE requests anymore.

1.8.0 (2023-02-02)

Features Added

  • Added support for parsing space character in place of 'T' in RFC3339 DateTimes.
  • Added support for HTTP proxy servers, both unauthenticated and with basic authentication.
  • Added universal support for several TLS options:
    • Added the ability to set the expected TLS root certificate for TLS connection (useful if a proxy server uses a TLS certificate that is not chained to a known root).
    • Added the ability to enable TLS certificate revocation list checks (off by default).
      • For libcurl only: Allow TLS connection to succeed if CRL retrieval fails.
      • NOTE: This change only applies if libcurl is built using the OpenSSL crypto backend. It does NOT apply if libcurl uses the schannel (Windows default) or SecureTransport (macOS/iOS default).

Breaking Changes

  • Changed the name of several distributed tracing HTTP span attributes:

    • requestId is renamed to az.client_request_id
    • serviceRequestId is renamed to az.service_request_id

  • Bearer token authentication will not work for endpoint URL protocol schemes other than "https". This ensures token security and is consistent with the Azure SDKs for other languages.

  • Removed noexcept specification from Azure::DateTime::clock::now().

  • Updated retry policy timeouts to conform to Azure guidelines.

    • The default delay between retries is changed from 4 seconds to 800ms.
    • The maximum retry delay is changed from 2 minutes to 60 seconds (one minute).

    If the original behavior is desired, customers can adjust these timeouts by changing the RetryDelay and MaxRetryDelay fields in the RetryOptions structure.

Bugs Fixed

  • Fixed bug in WinHTTP client which caused the IgnoreUnknownCertificateAuthority and EnableCertificateRevocationListCheck fields to be ignored if they were passed in from TransportOptions.
  • [#4206] Fixed connectivity issues in libcurl HTTP transport which can occur if a TCP connection is dropped prematurely. (A community contribution, courtesy of ahojnnes)

Other Changes

  • Update distributed tracing attributes to align with current Azure Distributed Tracing Conventions attributes and names.
  • Added the ability to consume version 1.1.1n of OpenSSL.
  • Added support for Identity token caching, and for configuring token refresh offset in BearerTokenAuthenticationPolicy.
  • Improved cancellation support for WinHTTP transport.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

  • Johannes Schonberger (GitHub)

1.8.0-beta.3 (2023-01-05)

Features Added

  • Added support for parsing space character in place of 'T' in RFC3339 DateTimes.

Breaking Changes

  • Bearer token authentication will not work for endpoint URL protocol schemes other than "https". This ensures token security and is consistent with the Azure SDKs for other languages.
  • Removed noexcept specification from Azure::DateTime::clock::now().

1.8.0-beta.2 (2022-11-03)

Other Changes

  • Added the ability to consume version 1.1.1n of OpenSSL.
  • Added support for Identity token caching, and for configuring token refresh offset in BearerTokenAuthenticationPolicy.
  • Improved cancellation support for WinHTTP transport.

1.8.0-beta.1 (2022-10-06)

Features Added

  • Added support for HTTP proxy servers, both unauthenticated and with Plain authentication.
  • Added universal support for several TLS options:
    • Added the ability to set the expected TLS root certificate for TLS connection (useful if a proxy server uses a TLS certificate that is not chained to a known root).
    • Added the ability to enable TLS certificate revocation list checks (off by default).
      • For libcurl only: Allow TLS connection to succeed if CRL retrieval fails.
      • NOTE: This change only applies if libcurl is built using the OpenSSL crypto backend. It does NOT apply if libcurl uses the schannel (Windows default) or SecureTransport (macOS/iOS default).

Breaking Changes

  • Updated retry policy timeouts to conform to Azure guidelines.

    • The default delay between retries is changed from 4 seconds to 800ms.
    • The maximum retry delay is changed from 2 minutes to 60 seconds (one minute).

    If the original behavior is desired, customers can adjust these timeouts by changing the RetryDelay and MaxRetryDelay fields in the RetryOptions structure.

1.7.2 (2022-09-01)

Bugs Fixed

  • WinHTTP Transport Adapter: Fixed missing reason phrase handling for HTTP/2 responses.

1.7.1 (2022-08-04)

Bugs Fixed

  • [#3794] Fix memory leak in CurlTransport.
  • [#3692] Interrupted poll calls cause spurious HTTP request failures. (A community contribution, courtesy of johnwheffner)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.7.0 (2022-06-30)

Features Added

  • Added prototypes and initial service support for Distributed Tracing.

1.7.0-beta.1 (2022-06-02)

Features Added

  • Added prototypes and initial service support for Distributed Tracing.

Breaking Changes

  • Removed noexcept specification from Azure::Core::Context::IsCancelled().

1.6.0 (2022-05-05)

Features Added

  • Add Azure::Core::Http::Request constructor overload to support payload and non-buffered response.

Bugs Fixed

  • [#3537] Updated field type CurlTransportOptions.Proxy from std::string to Azure::Nullable<std::string>. This allows libcurl to ignore the proxy settings from the environment when the string is empty.
  • [#3548], [#1098] Improve performance of the Http transport on Windows by reusing the same session handle across all requests.

Other Changes

  • [#3581] Update log level in retry policy from warning to informational.
  • Updated the MD5 Hash implementation to work on top of OpenSSL 3.0. (A community contribution, courtesy of jepio)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.5.0 (2022-03-31)

Features Added

  • When a RequestFailedException exception is thrown, the what() method now includes information about the HTTP request which failed.
  • Adding option WinHttpTransportOptions.IgnoreUnknownCertificateAuthority. It can be used to disable verifying server certificate for the WinHttpTransport.

Breaking Changes

  • Enforce TLS 1.2 or greater for CurlTransport and WinHttpTransport.

Other Changes

  • Improve output message for Azure::Core::Http::TransportException.

1.4.0 (2022-03-03)

Features Added

  • Stabilized the beta features and changes.

1.4.0-beta.1 (2022-02-04)

Features Added

  • Enabled environment-controlled console logging on UWP.

Breaking Changes

  • Removed the AzureNoReturnPath() function from the global namespace, and deprecated the associated macros, such as AZURE_ASSERT since they are meant for internal use only. If your code was using the AZURE_ASSERT macro, consider using the standard library's assert as an alternative.
  • Removed the two parameter RequestFailedException ctor, it has no use case and wasn't intended for public use.

Bugs Fixed

  • Fixed Azure::DateTime::Parse() validation if the result is going to exceed 9999-12-31T23:59:59.9999999 due to time zone, leap second, or fractional digits rounding up adjustments.
  • [#3224] Fixed intermittent crash on macOS when logging is turned on.
  • The Base64::Decode API will throw a std::runtime_error exception if presented with invalid inputs.

Other Changes

1.3.1 (2021-11-05)

Bugs Fixed

  • Fixed linking error when Azure SDK is being built as DLL.

1.3.0 (2021-11-04)

Features Added

  • Add NoSignal option to the CurlTransportAdapter.
  • Add ConnectionTimeout option to the CurlTransportAdapter.

Bugs Fixed

  • [#2848] Update the libcurl transport adapter to work with HTTP/1.1 only.

Other Changes

  • Updated base64 implementation to remove external dependency.
  • Updated Uuid implementation for Linux to remove external dependency.

1.2.1 (2021-09-02)

Bugs Fixed

Other Changes

  • Fixed compilation error on POSIX platforms where OpenSSL was not available.
  • Support CMake version 3.12

1.2.0 (2021-08-05)

Features Added

  • Added Azure::Core::IO::ProgressBodyStream type that wraps an existing BodyStream based type stream and reports progress via callback when the stream position is updated.

Bugs Fixed

  • [#2647] Make the curl transport adapter to check the connection close header.
  • [#2474] Fix compiling with MSVC and /analyze.
  • Make WinHTTP transport adapter to NOT use SSL/TLS for unsecured HTTP connections.

Other Changes

  • Updated source code to build with Clang 11. (A community contribution, courtesy of davidchisnall)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.1.0 (2021-07-02)

Bugs Fixed

  • Fixed a memory leak issue in Base64Encode(). (A community contribution, courtesy of jorgen)

Other Changes

  • Made internal-only changes to support the Azure Key Vault client library.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.0.0 (2021-06-04)

Bug Fixes

  • Make RequestFailedException copiable so it can be propagated across thread.
  • By default, add x-ms-request-id header to the allow list of headers to log.

1.0.0-beta.9 (2021-05-18)

New Features

  • Added Azure::PagedResponse<T>.

Breaking Changes

  • Added final specifier to classes and structures that are are not expected to be inheritable at the moment.
  • Removed Context::GetApplicationContext() in favor of a new static data member Context::ApplicationContext.
  • Renamed Request::IsDownloadViaStream() to ShouldBufferResponse().
  • Removed the Azure::Core::Http::Request ctor overload that takes both a bodyStream and a bufferedDownload boolean since it is not useful.
  • Changed integer size parameters for buffers from int64_t to size_t in various places such as Azure::Core::IO::BodyStream::Read() APIs.
  • Removed the Azure::Core::Diagnostics::Logger::Listener typedef.

Bug Fixes

  • Do not re-use a libcurl connection to same host but different port.
  • Fixed curl transport issue to avoid crash at exit when curl connection pool cleanup thread is running.
  • Ensure uniqueness of Azure::Core::Uuid on POSIX platforms.

Other Changes and Improvements

  • Modified precondition validation of function arguments to now result in assert failures rather than throwing an exception.
  • Remove exposing windows.h header from our public headers.
  • Improved performance of the WinHTTP transport layer on Windows for uploading large payloads.

1.0.0-beta.8 (2021-04-07)

New Features

  • Added Azure::Core::Url::GetScheme().
  • Added Azure::Core::Context::TryGetValue().
  • Added Azure::Core::Context::GetDeadline().
  • Added Azure::Core::Credentials::TokenCredentialOptions.
  • Added useful fields to the Azure::Core::RequestFailedException class such as StatusCode, ReasonPhrase, and the RawResponse, for better diagnosis of errors.

Breaking Changes

  • Simplified the Response<T> API surface to expose two public fields with direct access: T Value and a unique_ptr to an Azure::Core::Http::RawResponse.
  • Renamed Azure::Nullable<T>::GetValue() to Value().
  • Removed from Azure::Core::Http::Request:
    • SetUploadChunkSize().
    • GetHTTPMessagePreBody().
    • GetUploadChunkSize().
    • GetHeadersAsString().
  • Changes to Azure::Core::Http::RawResponse:
    • Removed SetHeader(std::string const& header)
    • Removed SetHeader(uint8_t const* const first, uint8_t const* const last).
    • Removed GetMajorVersion().
    • Removed GetMinorVersion().
    • Renamed GetBodyStream() to ExtractBodyStream().
  • Changes to Azure::Core::Context:
    • Removed Get() and HasKey() in favor of a new method TryGetValue().
    • Changed input parameter type of WithDeadline() to Azure::DateTime.
  • Removed Azure::Core::PackageVersion.
  • Removed from Azure::Core::Http::Policies namespace: HttpPolicyOrder, TransportPolicy, RetryPolicy, RequestIdPolicy, TelemetryPolicy, BearerTokenAuthenticationPolicy, LogPolicy.
  • Removed AppendQueryParameters(), GetUrlWithoutQuery() and GetUrlAuthorityWithScheme() from Azure::Core::Url.
  • Changed the Azure::Core::Http::HttpMethod regular enum into an extensible enum class and removed the HttpMethodToString() helper method.
  • Introduced Azure::Core::Context::Key class which takes place of std::string used for Azure::Core::Context keys previously.
  • Changed the casing of SSL in API names to Ssl:
    • Renamed type Azure::Core::Http::CurlTransportSSLOptions to CurlTransportSslOptions.
    • Renamed member Azure::Core::Http::CurlTransportOptions::SSLOptions to SslOptions.
    • Renamed member Azure::Core::Http::CurlTransportOptions::SSLVerifyPeer to SslVerifyPeer.

Other Changes and Improvements

  • Moved Azure::Core::Http::Request to its own header file from http.hpp to inc/azure/core/http/raw_response.hpp.
  • Moved Azure::Core::Http::HttpStatusCode to its own header file from http.hpp to inc/azure/core/http/http_status_code.hpp.

1.0.0-beta.7 (2021-03-11)

New Features

  • Added HttpPolicyOrder for adding custom Http policies to SDK clients.
  • Added Azure::Core::Operation<T>::GetRawResponse().
  • Added Azure::Core::PackageVersion.
  • Added support for logging to console when AZURE_LOG_LEVEL environment variable is set.

Breaking Changes

  • Changes to Azure::Core namespace:
    • Removed Response<void>, ValueBase, and ContextValue.
    • Removed Context::operator[], Get() introduced instead.
    • Renamed Uuid::GetUuidString() to ToString().
    • Changed return type of Operation<T>::Poll() from std::unique_ptr<RawResponse> to RawResponse const&.
    • Moved GetApplicationContext() to Context::GetApplicationContext()
    • Moved the Base64Encode() and Base64Decode() functions to be static members of a Convert class.
    • Moved Logging namespace entities to Diagnostics::Logger class.
    • Moved AccessToken, TokenCredential, and AuthenticationException to Credentials namespace.
    • Moved Context to be the last parameter for consistency, instead of first in various azure-core types. For example:
      • BodyStream::Read(uint8_t* buffer, int64_t count, Context const& context)
      • BodyStream::ReadToEnd(BodyStream& body, Context const& context)
      • HttpPolicy::Send(Request& request, NextHttpPolicy policy, Context const& context)
      • Operation<T>::PollUntilDone(std::chrono::milliseconds period, Context& context)
      • TokenCredential::GetToken(Http::TokenRequestOptions const& tokenRequestOptions, Context const& context)
    • Moved from Azure::Core to Azure namespace:
      • Response<T>, ETag, and Nullable<T>.
      • Split RequestConditions into MatchConditions and ModifiedConditions.
      • Renamed DateTime::GetString() to ToString(), and removed DateTime::GetRfc3339String().
  • Changes to Azure::Core::Http namespace:
    • Removed HttpPipeline, TransportKind, NullBodyStream, and LimitBodyStream.
    • Removed Request::StartTry().
    • Removed InvalidHeaderException and throw std::invalid_argument if the user provides invalid header arguments.
    • Renamed CurlTransportSSLOptions::NoRevoke to EnableCertificateRevocationListCheck.
    • Renamed Range to HttpRange.
    • Renamed TokenRequestOptions to TokenRequestContext, and moved it to Azure::Core::Credentials namespace.
    • Moved Url to Azure::Core namespace.
    • Request and RawResponse:
      • Renamed AddHeader() to SetHeader().
      • Introduced Azure::Core::CaseInsensitiveMap which is now used to store headers.
    • BodyStream and the types that derive from it:
      • Moved to Azure::Core::IO namespace.
      • Changed the static methods BodyStream::ReadToCount() and BodyStream::ReadToEnd() into instance methods.
      • Changed the constructor of FileBodyStream to accept a file name directly and take ownership of opening/closing the file, instead of accepting a file descriptor, offset, and length.
    • HTTP policies and their options:
      • Moved to Policies namespace.
      • Renamed TransportPolicyOptions to TransportOptions.
      • Renamed TelemetryPolicyOptions to TelemetryOptions.
      • Changed type of RetryOptions::StatusCodes from std::vector to std::set.
      • Renamed LoggingPolicy to LogPolicy, and introduced LogOptions as mandatory parameter for the constructor.
  • Moved header files:
    • Renamed azure/core/credentials.hpp to azure/core/credentials/credentials.hpp.
    • Renamed azure/core/logger.hpp to azure/core/diagnostics/logger.hpp.
    • Renamed azure/core/http/body_stream.hpp to azure/core/io/body_stream.hpp.
    • Renamed azure/core/http/policy.hpp to azure/core/http/policies/policy.hpp.
    • Renamed azure/core/http/curl/curl.hpp to azure/core/http/curl_transport.hpp.
    • Renamed azure/core/http/winhttp/win_http_client.hpp to azure/core/http/win_http_transport.hpp.

Bug Fixes

  • Make sure to rewind the body stream at the start of each request retry attempt, including the first.
  • Connection pool resets when all connections are closed.
  • Fix Azure::Context to support std::unique_ptr.
  • Throw std::runtime_error from Response<T>::GetRawResponse() if the response was already extracted.

1.0.0-beta.6 (2021-02-09)

New Features

  • Added support for HTTP conditional requests MatchConditions and RequestConditions.
  • Added the Hash base class and MD5 hashing APIs to the Azure::Core::Cryptography namespace available from azure/core/cryptography/hash.hpp.

Breaking Changes

  • Removed Context::CancelWhen().
  • Removed LogClassification and related functionality, added LogLevel instead.

Bug Fixes

  • Fixed computation of the token expiration time in BearerTokenAuthenticationPolicy. (A community contribution, courtesy of sjoubert)
  • Fixed Retry-After HTTP header to be treated as case-insensitive. (A community contribution, courtesy of sjoubert)
  • Fixed compilation dependency issue for MacOS when consuming the SDK from VcPkg.
  • Fixed support for sending requests to endpoints with a custom port within the url on Windows when using the WinHttp transport.

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.0.0-beta.5 (2021-02-02)

New Features

  • Added support for HTTP validators ETag.

Breaking Changes

  • Make ToLower() and LocaleInvariantCaseInsensitiveEqual() internal by moving them from Azure::Core::Strings to Azure::Core::Internal::Strings.
  • BearerTokenAuthenticationPolicy constructor takes TokenRequestOptions struct instead of scopes vector. TokenRequestOptions struct has scopes vector as data member.
  • TokenCredential::GetToken() takes TokenRequestOptions instead of scopes vector.

Bug Fixes

  • Fixed the parsing of the last chunk of a chunked response when using the curl transport adapter.
  • Fixed reading the value from retry-after header in RetryPolicy.
  • Fix link errors when producing a DLL and add UWP compilation support.
  • Do not pass a placeholder user-agent string as a fallback when using WinHttp.
  • Initialize local variables in implementation to fix warning within release builds on Linux.

1.0.0-beta.4 (2021-01-13)

New Features

  • Added a WinHTTP-based HttpTransport called WinHttpTransport and use that as the default TransportPolicyOptions.Transport on Windows when sending and receiving requests and responses over the wire.
  • Added Range type to Azure::Core::Http namespace.
  • Added support for long-running operations with Operation<T>.
  • Added support for setting a custom transport adapter by implementing the method std::shared_ptr<HttpTransport> ::AzureSdkGetCustomHttpTransport().
  • Added interoperability between std::chrono::system_clock types and DateTime.
  • Added default constructor to DateTime and support for dates since 0001.
  • Added Base64 encoding and decoding utility APIs to the Azure::Core namespace available from azure/core/base64.hpp.
  • Added Http::Response<void> template specialization.
  • Added GetHeadersAsString() on the Azure::Core::Http::Request class.
  • Added a platform.hpp header file for defining commonly used OS-specific #define constants.
  • Added IsCancelled() on the Azure::Core::Context class.

Breaking Changes

  • Removed DateTime::operator Duration(), DateTime::Duration typedef and DateTime::Now().
  • Moved Azure::Core::BearerTokenAuthenticationPolicy, defined in azure/core/credentials.hpp to Azure::Core::Http namespace in azure/core/http/policy.hpp header.
  • Changed type of Token::ExpiresOn to DateTime.
  • Renamed exception OperationCanceledException to OperationCancelledException and ThrowIfCanceled() to ThrowIfCancelled() on the Context class.
  • Moved Azure::Core::Version, defined in azure/core/version.hpp to the Azure::Core::Details namespace.
  • Changed Azure::Core::AuthenticationException to derive from std::exception instead of std::runtime_error.
  • Changed the BodyStream::Read API from being a pure virtual function to non-virtual.
  • Removed CurlConnection, CurlConnectionPool, CurlSession, and CurlNetworkConnection by making headers meant as implementation, private.
  • Removed option AllowBeast from CurlTransportSSLOptions in CurlTransportOptions.
  • Changed default option NoRevoke from CurlTransportSSLOptions for the CurlTransportOptions to true. This disables the revocation list checking by default.

Bug Fixes

  • Fixed the Curl transport adapter connection pooling when setting options.
  • Fixed setting up the default transport adapter.
  • Fixed linker error of missing pthread on Linux.
  • Initialize class data members to avoid MSVC warning.
  • Throw Azure::Core::Http::TransportException if curl_easy_init() returns a null handle. (A community contribution, courtesy of ku-sourav)

Other Changes and Improvements

  • Added support for distributing the C++ SDK as a source package via vcpkg.
  • Fixed installation error when the SDK is being installed under a non-standard prefix. (A community contribution, courtesy of juchem)
  • Fixed linker error when pthread is missing on Linux. (A community contribution, courtesy of lordgamez)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.0.0-beta.3 (2020-11-11)

New Features

  • Added strings.hpp with Azure::Core::Strings::LocaleInvariantCaseInsensitiveEqual and Azure::Core::Strings::ToLower.
  • Added GetPort() to Url.
  • Added TransportPolicyOptions.
  • Added TelemetryPolicyOptions.
  • Added RequestFailedException deriving from std::runtime_error.
  • Added CurlTransportOptions for the CurlTransport.
  • Added DateTime supporting dates since 1601.
  • Added OperationCanceledException.
  • Added Encode and Decode to Url.

Breaking Changes

  • Removed azure.hpp.
  • Removed macro AZURE_UNREFERENCED_PARAMETER.
  • Bump CMake version from 3.12 to 3.13.
  • Bump libcurl version from 7.4 to 7.44.
  • Moved ClientSecretCredential and EnvironmentCredential to the Identity library.
  • Url class changes:
    • AppendPath now does not encode the input by default.
    • Signature updated for SetHost, SetPath and AppendPath.
    • Removed SetFragment.
    • Renamed AppendQueries to AppendQueryParameters.
    • Renamed AppendQuery to AppendQueryParameter.
    • Renamed RemoveQuery to RemoveQueryParameter.
    • Renamed GetQuery to GetQueryParameters.

Bug Fixes

  • Prevent pipeline of length zero to be created.
  • Avoid re-using a connection when a request to upload data fails while using the CurlTransport.
  • Add entropy to Uuid generation.

Other Changes and Improvements

  • Add high-level and simplified core.hpp file for simpler include experience for customers.
  • Add code coverage using gcov with gcc.
  • Update SDK-defined exception types to be classes instead of structs.
  • Updated TransportException and InvalidHeaderException to derive from RequestFailedException.
  • Vcpkg dependency version updated to 2020.11.
  • Make libcurl network requests cancelable by Context::Cancel().
  • Validate HTTP headers for invalid characters.
  • Calling Cancel() from context now throws OperationCanceledException.

1.0.0-beta.2 (2020-10-09)

Breaking Changes

  • Throw Azure::Http::TransportException if creating new connection fails.
  • Response objects store Nullable<T>.

Bug Fixes

  • Switched to a more stable wait on sockets to address connection timeouts.
  • Replace Nullable(const T&) with Nullable(T) to avoid extra copy when initialized with an rvalue.

Other Changes and Improvements

  • Improved performance on windows when using libcurl.
  • Pinned the version of package dependencies.
  • Added NOTICE.txt for 3rd party dependencies.
  • Added build instructions for running tests. (A community contribution, courtesy of ku-sourav)
  • Updated vcpkg build instructions. (A community contribution, courtesy of ku-sourav)

Acknowledgments

Thank you to our developer community members who helped to make Azure Core better with their contributions to this release:

1.0.0-beta.1 (2020-09-09)

  • Initial release