Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Azure Search] Upgrade Management SDK to version 2.0 #3993

Merged
merged 10 commits into from
Jan 11, 2018

Conversation

brjohnstmsft
Copy link
Member

This change brings the version of the Azure Search management SDK from 1.0.2 to 2.0.0. Changes include:

  1. The Operations API is now exposed through the SDK.
  2. Services.CreateOrUpdate is now synchronous. The operation will not return until service provisioning has completed. Whereas before users of the SDK had to write code to poll the provisioning state, now the SDK does this polling automatically.
  3. Services.BeginCreateOrUpdate has been introduced for scenarios where users still want to do the aforementioned polling themselves.
    Some of these are breaking changes, hence the major version bump.

I recommend reviewing each commit separately.

Note: I am fixing an oversight in the global generate.cmd as part of this PR. It will now target the master branch of azure-rest-api-specs by default instead of the old current branch.

Swagger PR: Azure/azure-rest-api-specs#2242

FYI @Yahnoosh @natinimni @mhko @chaosrealm @shahabhijeet

Description


This checklist is used to make sure that common guidelines for a pull request are followed.

General Guidelines

  • Title of the pull request is clear and informative.
  • There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

  • Pull request includes test coverage for the included changes.

SDK Generation Guidelines

  • If an SDK is being regenerated based on a new swagger spec, a link to the pull request containing these swagger spec changes has been included above.
  • The generate.cmd file for the SDK has been updated with the version of AutoRest, as well as the commitid of your swagger spec or link to the swagger spec, used to generate the code.
  • The *.csproj and AssemblyInfo.cs files have been updated with the new version of the SDK.

The stock generate.cmd script takes way too many parameters to be useful
when iterating on a private Swagger spec.
Added new generated code, plus a scenario test and corresponding session
record.
A major version bump is necessary because the behavior of
Services.CreateOrUpdate has changed. Specifically, service creation and
scaling is now synchronous instead of asynchronous. Also, there is new API
surface area that represents breaking changes from the .NET point of view
(i.e. -- new methods added to existing interfaces).
Since the refactor, the default branch is master, not current.
@shahabhijeet shahabhijeet merged commit 434d767 into Azure:psSdkJson6 Jan 11, 2018
@brjohnstmsft brjohnstmsft deleted the upgrade-search-mgmt branch January 11, 2018 20:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants